Condividi tramite

Contribuisci alla documentazione di Dynamics 365

Puoi contribuire alla documentazione Microsoft per Dynamics 365 in due modi. Se un articolo contiene informazioni errate o confuse, o se conosci una buona soluzione per un problema ricorrente, puoi usare il link dei feedback nell'articolo per farcelo sapere.

Per la maggior parte della nostra documentazione, puoi anche modificare direttamente un articolo per avviare un processo di revisione.

Invia un feedback

Sul sito learn.microsoft.com , ogni articolo di Learn offre l'opportunità di fornire feedback. Puoi scegliere l'azione Feedback che si trova sotto il titolo dell'articolo in alto a destra oppure una delle opzioni di feedback in basso nell'articolo nella sezione Feedback . Dai una valutazione all'articolo, scegli il motivo del tuo feedback e valuta di lasciare un commento. Il feedback va all'autore dell'articolo e al team che possiede la documentazione.

Se un articolo non può essere modificato direttamente, o se non ti senti a tuo agio a modificare, ti incoraggiamo a usare il meccanismo di feedback per dirci cosa pensi dell'articolo o del prodotto.

Contributi esterni alla documentazione Microsoft

I file sorgente dei nostri contenuti principali sono memorizzati in depositi pubblici di GitHub. Chiunque può rivederli e, in molti casi, modificarli. Accogliamo con piacere i vostri suggerimenti e correzioni, sia sotto forma di contributi diretti sia come questioni su GitHub per segnalare un bug o porre domande. Possiamo accettare solo feedback e contributi ai contenuti originali in inglese.

La maggior parte degli articoli ha un'icona a matita con il tooltip Modifica questo documento. Seleziona l'icona per aprire l'articolo in GitHub, e poi inizia a modificare. Inizia come collaboratore con la guida per i collaboratori di Microsoft Learn.

Se vuoi approfondire e contribuire con nuovi articoli concettuali, usa i modelli su .

Contenuti delle linee guida Dynamics 365

I contenuti delle guide di Dynamics 365 utilizzano gli stessi processi della maggior parte della documentazione su Microsoft Learn. In questa sezione, elenchiamo strumenti e processi che puoi utilizzare per contribuire ad aggiungere ulteriori linee guida per l'implementazione.

Il termine contenuto delle linee guida copre la guida Dynamics 365 implementazione, le descrizioni dei processi aziendali, i nuovi pattern, le migliori pratiche e le architetture di riferimento. Abbiamo pubblicato il primo contenuto delle linee guida nell'aprile 2023 e aggiungiamo aggiornamenti ogni due settimane. Sfoglia l'hub di guida e facci sapere cosa è ottimo e cosa manca.

Alcuni contenuti delle indicazioni sono forniti da collaboratori interni. Incoraggiamo esperti della materia in tutta la comunità ad aiutarci a stabilire le migliori pratiche. Continua a leggere se hai qualche best practice o altra intuizione che pensi dovrebbe far parte di Microsoft Learn.

Perché contribuire?

Crediamo che il contenuto delle guide aiuti a far sì che i progetti di implementazione di Dynamics 365 si sviluppino più velocemente. I nostri partner e clienti possono utilizzare le indicazioni per prepararsi all'implementazione e per migliorare le competenze in nuove aree o per migliorare il personale nuovo. Gli sviluppatori software possono utilizzare i contenuti come piattaforma per promuovere la propria proprietà intellettuale o la propria esperienza nel settore.

Ma noi di Microsoft non siamo gli unici esperti su come implementare soluzioni con Dynamics 365. La community include persone esperte in vari aspetti dell'implementazione. Hai un pattern, una best practice, una configurazione o un'architettura di integrazione che funziona bene tra diverse implementazioni? Valuta di condividerlo qui su Microsoft Learn per rendere l'intera comunità ancora più produttiva ed efficiente nei loro progetti di implementazione.

Speriamo di poter offrire ricompense o altri riconoscimenti per i contributi. Per ora, riconosciamo i contributori negli articoli in due modi diversi. Scopri di più nella sezione Riconoscimento dei Contributori .

Come contribuire

Puoi trovare i file sorgente per il contenuto delle linee guida Dynamics 365 Microsoft in a repository pubblico GitHub. Puoi anche modificare gli articoli sul sito learn.microsoft.com/dynamics365/guidance come descritto nella guida per i collaboratori di Microsoft Learn.

Ti consigliamo di inviare le correzioni allo stesso modo in cui invii una correzione ad altre aree di Microsoft Learn. Tuttavia, per inviare contenuti nuovi, vi chiediamo di caricare i vostri file Markdown per i nuovi contenuti delle linee guida su un altro repository, Dynamics 365 Patterns and Practices. In questo modo, possiamo assicurarci che la tua architettura o modello di riferimento venga esaminata da altri esperti della materia. Ci sono diversi modelli tra cui scegliere, e se vuoi contribuire ai contenuti dei processi aziendali, c'è un processo completamente diverso.

Modelli

Microsoft fornisce modelli in due località, a seconda del tipo di modello:

  • I template di markdown sono nel repository.

    • La cartella docs-template contiene modelli per articoli concettuali e di navigazione.

    • La cartella /guidance-templates/ contiene modelli per architetture, idee di soluzioni e pattern. Questi template sono gli stessi usati da Microsoft ma sono stati resi specifici per Dynamics 365.

  • Word e PowerPoint template si trovano nel repository Dynamics 365 Patterns and Practices.

    • La cartella /templates/business-processes/ contiene Word template per gli articoli sui processi aziendali. Invitiamo tutti gli esperti della materia ad aiutarci a scriverli. La cartella contiene anche un file Excel con l'elenco dei processi aziendali che abbiamo identificato. La lista si evolverà nel tempo.

    • La cartella /graphics/ contiene PowerPoint file per ogni scenario end-to-end, ai quali puoi aggiungere i tuoi diagrammi.

Aggiungeremo altri modelli e indicazioni nel tempo. Ti consigliamo di seguire i repository, o salvarli con una stella, così da ricevere una notifica quando qualcosa cambia.

Condividi il tuo feedback nella scheda https://github.com/microsoft/dynamics365patternspractices/discussions nel repertorio Dynamics 365 Schemi e Pratiche.

Se non hai già un account GitHub, inizia con la guida Microsoft Learn contributor guide.

Suggerimento

Sfoglia i nostri file sorgente nel repository. Impara dal modo in cui strutturiamo i diversi tipi di articoli affinché i tuoi articoli seguano la stessa struttura. In questo modo, il processo di revisione procede più velocemente.

Architetture

Accogliamo con favore contributi di orientamento architettonico, inclusi idee di soluzione e modelli progettuali. Se hai un'implementazione di best practice o di riferimento, invia la tua proposta a il team Azure oppure a noi in Dynamics 365.

Per contribuire con nuovi articoli alla guida architettonica di Dynamics 365, segui questi passaggi principali:

  • Recupera i template Markdown appropriati dalla cartella guidance-templates nel repository dynamics365-docs-templates GitHub.
  • Scrivi il tuo contributo.
  • Invia il tuo articolo come file Markdown in una pull request nel repository dynamics365patternspractices . La cartella è pronta per ricevere i tuoi contributi.

Microsoft elabora l'articolo e lo pubblica come parte della documentazione Dynamics 365 guide.

Per un'introduzione generale ai contenuti di orientamento su Microsoft, consulta il Azure Architecture Center. Per la guida ai contributori, vedi Azure contributi del Centro di Architettura.

Il repository GitHub dynamics365-docs-templates contiene i seguenti template Markdown per la guida architettonica nella cartella guidance-templates:

  • Pattern architettonico generalizzato: Un pattern architettonico generalizzato agisce come un'architettura centrale con una soluzione comune che si applica a molti scenari. Ad esempio, le idee di soluzione possono basarsi su un articolo architettonico per fornire una prospettiva a una determinata soluzione industriale o partner e collegarsi all'architettura di ciascuna idea. Il template si basa sul modello Azure Architecture Guide. Usalo per diversi tipi di architetture, comprese quelle di riferimento.

  • : Le idee di soluzione sono architetture "piccole" di implementazioni Dynamics 365. Forniscono brevi panoramiche delle soluzioni con i servizi Dynamics 365 e Azure. Ogni idea di soluzione contiene i seguenti elementi:

    • Un diagramma architettonico
    • Un flusso di dati
    • Componenti, ovvero un elenco dei servizi utilizzati
    • Crediti dei collaboratori
    • Collegamenti ai prossimi passi e alle risorse correlate, come guide e architetture correlate

  • Soluzione di esempio: Le soluzioni di esempio sono carichi di lavoro di esempio con architetture "media". Guidano i lettori nel processo di progettazione di soluzioni per problemi specifici nelle implementazioni di Dynamics 365. Le soluzioni di esempio forniscono indicazioni pratiche sull'architettura basate su esempi reali di clienti. L'obiettivo è accorciare la curva di apprendimento dei clienti raccontando loro la storia di un altro cliente che ha vissuto lo stesso percorso. Includono le sezioni del modello Idea di Soluzione e aggiungono le seguenti sezioni:

    • Alternative, altri servizi che puoi collegare all'architettura invece
    • Considerazioni, linee guida che si corrispondono al nostro framework Success by Design e, opzionalmente, includono una distribuzione

  • Design pattern: Dynamics 365 pattern di design affrontano sfide specifiche nelle implementazioni e si basano su uno scenario o best practice specifico. Usa questo modello per catturare un modello di processo aziendale. In alternativa, usa il template Word su dynamics365patternspractices/templates/business-processes.

Contributi ai processi aziendali

Il termine processo aziendale comprende un'ampia gamma di attività o compiti strutturati, spesso sequenziati, per raggiungere un obiettivo organizzativo predeterminato. Il termine può anche riferirsi agli effetti cumulativi di tutti i passaggi che avanzano verso un obiettivo aziendale. I processi aziendali sono specifici per soluzioni che includono Dynamics 365. Crediamo che questo nuovo tipo di contenuto crei una struttura che aiuti clienti e partner a essere meglio preparati ad adottare Dynamics 365. Ogni processo aziendale include un diagramma di un flusso standard di processo aziendale. Le sezioni del documento illustrano i passaggi di configurazione e le entità dati utilizzate in ciascuno. Ogni passaggio è collegato alla pagina pertinente nella documentazione del prodotto, e tutti i documenti hanno link ai passaggi successivi e alle risorse correlate per aiutare i lettori nel loro percorso di apprendimento.

Abbiamo strutturato i processi aziendali in un catalogo. Il catalogo dei processi aziendali è un workbook Excel che noi di Microsoft usiamo per organizzare e dare priorità al nostro lavoro sulla documentazione dei processi aziendali. Il formato è Excel perché rende facile ordinare e filtrare le voci. Crediamo inoltre che i nostri partner possano utilizzare il workbook Excel per organizzare i loro percorsi di onboarding, i progetti di implementazione e i propri processi aziendali.

Scarica l'ultima versione del catalogo da .

Nota

Se vuoi contribuire ai processi aziendali, registra il tuo lavoro prima di iniziare per ridurre il rischio che qualcun altro stia lavorando sullo stesso processo aziendale. Per registrare il tuo lavoro, invia un numero GitHub a https://github.com/microsoft/dynamics365patternspractices/issues.

Cosa contiene il catalogo

Il catalogo definisce sei livelli di contenuto:

  1. Processi end-to-end

    Un processo end-to-end rappresenta il flusso completo delle attività dal trigger iniziale fino all'esito finale. Comprende tutti i passaggi intermedi e i sottoprocessi necessari per raggiungere l'obiettivo aziendale. Abbiamo identificato 15 scenari end-to-end. Descriviamo gli scenari in termini di business, non in termini di tecnologia software.

    Per ogni processo end-to-end, l'articolo introduttivo descrive come pensiamo al processo end-to-end. Elenchiamo i principali stakeholder e come Dynamics 365 aiuti il processo end-to-end. Forniamo inoltre una panoramica, insieme a un diagramma di flusso dei processi aziendali, di come il processo end-to-end interagisce con altri processi end-to-end. L'introduzione elenca i prerequisiti per implementare una soluzione che supporti il processo end-to-end.

  2. Aree dei processi aziendali

    Ogni scenario end-to-end copre due o più aree di processo aziendale. Questo livello rappresenta un importante raggruppamento di attività correlate che contribuiscono all'obiettivo complessivo e fornisce un modo logico per raggruppare i processi aziendali. Nella maggior parte dei casi, le aree dei processi aziendali sono separate per funzioni o dipartimenti principali all'interno di un'organizzazione. Attualmente, il catalogo definisce più di 100 aree di processo aziendale.

  3. Processi aziendali

    Il termine processo aziendale comprende un'ampia gamma di attività o compiti strutturati, spesso sequenziati, per raggiungere un obiettivo organizzativo predeterminato. Il termine può anche riferirsi agli effetti cumulativi di tutti i passaggi che avanzano verso un obiettivo aziendale. Ogni processo aziendale descrive una funzione o un processo supportato da Dynamics 365. Finora abbiamo identificato più di 800 processi aziendali. Alcuni si applicano a una singola app Dynamics 365, e la documentazione dell'app potrebbe già descrivere il processo. Raccogliendo tutti i processi aziendali qui nella guida, speriamo di fornire un unico punto di ingresso con link a contenuti specifici per il prodotto rilevanti.

  4. Scenari

    In Dynamics 365, gli scenari sono schemi di configurazioni ripetibili che supportano un processo aziendale specifico. Includono i casi d'uso, gli scenari e le industrie più comuni. Spesso esistono molti modi per implementare Dynamics 365 per soddisfare le esigenze aziendali. Il nostro obiettivo con i pattern è fornire una base per la tua implementazione. Abbiamo identificato più di 3000 scenari e schemi, e prevediamo che questo numero crescerà nel tempo.

  5. Processi di sistema

    Un processo di sistema è una parte di un processo aziendale che utilizza un modulo, una pagina o un elemento UI specifico in Dynamics 365.

  6. Casi di prova

Un caso di test è un insieme dettagliato di condizioni e fasi utilizzati per determinare se un'applicazione software o un sistema funziona correttamente. È una parte essenziale del processo di testing del software, progettata per garantire che il software soddisfi i requisiti e funzioni come previsto. I casi di test vengono utilizzati per identificare difetti, garantire la qualità e verificare che il software si comporti come previsto in varie condizioni.

Ci sono modelli Word per ogni tipo di contenuto. Le istruzioni sono formattate in rosso circondate da parentesi quadrate come nel seguente esempio: Elimina queste istruzioni quando finalizzi il documento. Il testo evidenziato in giallo deve essere sostituito o modificato da te. Non cambiare il testo che non è evidenziato in giallo e non è formattato in rosso. Queste frasi standard aiutano gli utenti a riconoscere il modello così da poter scansionare e trovare più facilmente i contenuti che cercano.

Ricevi un'ulteriore introduzione al catalogo dei processi aziendali su About the business process guide. Opzionalmente, consulta i TechTalks dove parliamo di come puoi utilizzare il catalogo dei processi aziendali e contribuire alla libreria di contenuti.

Invia il tuo contributo

Internamente in Microsoft, stiamo lavorando duramente per convertire note interne, anni di esperienza e vari documenti in linee guida sui processi aziendali. Accogliamo con entusiasmo i contributi della comunità.

Esistono diversi modelli per inviare contributi in base al tipo di articolo. I contributori devono scegliere il modello giusto per il tipo di articolo appropriato a cui desiderano contribuire. I modelli sono disponibili come file Word nominati per spiegare a che tipo di articolo è destinato il modello.

Riconoscimento dei contributori

La piattaforma Microsoft Learn mostra sia i contributori interni che esterni in cima a ogni articolo se hanno inviato il loro contributo tramite GitHub. Alcune persone contribuiscono in altri modi, quindi aggiungiamo una sezione Contributori verso la fine dell'articolo.

La sezione opzionale Contributors elenca i contributori chiave con il loro nome e un link al loro LinkedIn o a un altro profilo, se ne hanno fornito uno. Lo screenshot seguente è una versione anonima della sezione Contributors in un articolo Azure Architecture Center.

Screenshot di una sezione di esempio Contributori, che mostra l'autore principale più tre contributori elencati con link ai loro profili LinkedIn.

Ecco come appare in Markdown.

## Contributors

*This article is maintained by Microsoft. It was originally written by the following contributors.*

Principal author:

* [Author's Name](https://www.linkedin.com/in/author-account/) | Author's job title or similar  

Other contributors:

* [Contributor's Name](https://www.linkedin.com/in/contributor-account/) | Contributor's job title or similar  
* [Contributor's Name](https://www.linkedin.com/in/contributor-account/) | Contributor's job title or similar

Essere elencati come contributori in questo modo è opzionale. In tutta Microsoft, consigliamo di utilizzare la sezione Contributors se i contributori esterni inviano nuovi contenuti, come architetture di riferimento e pattern di design, tramite mezzi diversi dal GitHub.

  • Last updated on