Condividi tramite

Contribuire alla documentazione di Dynamics 365

  • Articolo

Puoi contribuire a migliorare la documentazione Microsoft per Dynamics 365 in due modi. Se un articolo contiene informazioni errate o fuorvianti oppure se conosci una buona soluzione alternativa a un problema ricorrente, puoi farcelo sapere utilizzando il collegamento commenti presente nell'articolo.

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

Fornire feedback

Ogni articolo della sezione Learn presente nel sito Web learn.microsoft.com offre ai lettori l'opportunità di inviare il proprio feedback. Puoi scegliere l'azione Feedback che si trova sotto il titolo dell'articolo in alto a destra o una delle opzioni di feedback in fondo all'articolo nella sezione Feedback. Assegna una valutazione all'articolo, seleziona il motivo del tuo feedback e, preferibilmente, lascia un commento. Il feedback viene inviato all'autore dell'articolo e al team proprietario della documentazione.

Se un articolo non può essere modificato direttamente o se non ti senti a tuo agio nel modificarlo, ti invitiamo a utilizzare il meccanismo di feedback per dirci cosa ne pensi dell'articolo o del prodotto.

Contributi esterni alla documentazione Microsoft

I file di origine per i nostri contenuti principali sono archiviati in repository GitHub pubblici. Chiunque può esaminarli e, in molti casi, modificarli. Accogliamo con favore suggerimenti e correzioni, sia sotto forma di contributi diretti sia come problemi di GitHub per segnalare un bug o porre una domanda. Possiamo accettare solo feedback e contributi ai contenuti di origine in lingua inglese.

La maggior parte degli articoli presenta un'icona a forma di matita con la descrizione comando Modifica questo documento. Seleziona l'icona per aprire l'articolo in GitHub, quindi inizia a modificare. Inizia come contributore con la guida per i contributori di Microsoft Learn.

Se vuoi approfondire alcuni articoli concettuali o contribuire pubblicandone di nuovi, usa i modelli che trovi in https://github.com/MicrosoftDocs/dynamics365-docs-templates.

Contenuto di orientamento di Dynamics 365

Il contenuto di orientamento di Dynamics 365 utilizza gli stessi processi della maggior parte della documentazione in Microsoft Learn. In questa sezione, evidenziamo gli strumenti e i processi puoi utilizzare per integrare le linee guida per l'implementazione.

Il termine contenuto di orientamento copre la guida all'implementazione, le descrizioni di processi aziendali, i nuovi modelli, le procedure consigliate e le architetture di riferimento di Dynamics 365. Abbiamo pubblicato il primo contenuto di orientamento in aprile 2023 e aggiungiamo aggiornamenti ogni due settimane. Dai un'occhiata all'hub delle indicazioni e facci sapere secondo te quali contenuti sono ben fatti e cosa manca.

Alcuni dei contenuti di orientamento sono forniti da contributori interni. Invitiamo gli esperti in materia in tutta la community ad aiutarci a creare procedure consigliate. Continua a leggere se hai una procedura consigliata o altre informazioni dettagliate che ritieni dovrebbero far parte di Microsoft Learn.

Perché contribuire?

Crediamo che i nuovi contenuti di orientamento aiutino ad accelerare i progetti di implementazione delle soluzioni Dynamics 365. I nostri partner e clienti possono utilizzare la guida per prepararsi all'implementazione e per acquisire competenze in nuove aree o formare nuovo personale. Gli sviluppatori di software possono usare i contenuti come piattaforma per promuovere la proprietà intellettuale o le proprie competenze nel settore.

Ma noi di Microsoft non siamo gli unici esperti di implementazione di soluzioni con Dynamics 365. La community include molte persone che sono esperte di vari aspetti dell'implementazione. Hai uno schema, una procedura consigliata, una configurazione o un'architettura di integrazione che funziona bene in diverse implementazioni? Potresti condividerla qui su Microsoft Learn per aiutare l'intera community a diventare ancora più produttiva ed efficiente nei progetti di implementazione.

In futuro speriamo di poter offrire premi o altri riconoscimenti per i contributi. Nel 2023, riconosciamo i contributori negli articoli.

Come contribuire

Da novembre 2023 puoi trovare i file di origine del contenuto di orientamento di Microsoft Dynamics 365 in un repository GitHub pubblico. Puoi anche modificare gli articoli sul sito learn.microsoft.com/dynamics365/guidance come descritto nella Guida per i contributori di Microsoft Learn.

Consigliamo di inviare le tue correzioni nello stesso modo in cui invii una correzione ad altre aree di Microsoft Learn. Per inviare nuovo contenuto, invece, ti chiediamo di caricare i file markdown del nuovo contenuto di orientamento in un altro repository: Dynamics 365 Patterns and Practices. In questo modo, possiamo assicurarci che la tua architettura di riferimento o il tuo modello siano rivisti da altri esperti di dominio. Sono disponibili vari modelli tra cui scegliere, ma se vuoi contribuire al contenuto di un processo aziendale, devi seguire un altro processo.

Modelli

Microsoft fornisce i modelli in due posizioni, a seconda del tipo di modello:

Con il tempo aggiungeremo ulteriori modelli e contenuti. È consigliabile seguire i repository o salvarli con una stella, in modo da ricevere una notifica quando vengono modificati.

Condividi il feedback nella scheda https://github.com/microsoft/dynamics365patternspractices/discussions nel repository Dynamics 365 Patterns and Practices.

Se non disponi già di un account GitHub, inizia con la Guida per i contributori di Microsoft Learn.

Suggerimento

Sfoglia i nostri file di origine nel repository https://github.com/MicrosoftDocs/dynamics365-guidance. Studia il modo in cui strutturiamo i diversi tipi di articoli in modo che i tuoi articoli seguano la stessa struttura. In questo modo, il processo di revisione sarà più veloce.

Architetture

Sono graditi i contributi di orientamento architettonico, compresi i modelli di progettazione e le idee di soluzioni. Se hai una procedura consigliata o un'implementazione di riferimento, invia la tua proposta al team di Azure o a noi di Dynamics 365.

Per contribuire con nuovo articoli alle linee guida sull'architettura di Dynamics 365, segui questi passaggi principali:

Microsoft elabora l'articolo e lo pubblica nella documentazione di orientamento di Dynamics 365.

Per un'introduzione generale al contenuto di orientamento in Microsoft, vedi il Centro architetture di Azure. Per la guida per i contributori, vedi Contributi del Centro architetture di Azure.

Il repository di GitHub dynamics365-docs-templates contiene i modelli Markdown seguenti per l'orientamento architettonico nella cartella guidance-templates:

  • Modello di architettura generalizzato: questo tipo di modello funge da architettura di base con una soluzione comune applicabile a molti scenari. Ad esempio, le idee di soluzione possono costituire un articolo sull'architettura per fornire una sezione per un settore specifico o una soluzione di partner specifica e un collegamento all'architettura da ciascuna idea di soluzione. Il modello è basato sul modello Guida all'architettura di Azure. Usalo per diversi tipi di architetture, incluse le architetture di riferimento.

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

    • Un diagramma di architettura
    • Un flusso di dati
    • Componenti, vale a dire un elenco dei servizi usati
    • Crediti al contributore
    • Collegamenti ai passaggi successivi e alle risorse correlate, come le guide e le architetture correlate

  • Soluzione di esempio: le soluzioni di esempio sono carichi di lavoro di esempio con architetture "medie". Guidano i lettori attraverso il processo di progettazione delle soluzioni per risolvere problemi specifici nelle implementazioni di Dynamics 365. Le soluzioni di esempio offrono una guida pratica all'architettura basata su esempi di clienti reali. L'obiettivo è ridurre la curva di apprendimento dei clienti raccontando loro la storia di un altro cliente che ha avuto lo stesso percorso. Oltre alle sezioni del modello Idea di soluzione le soluzioni di esempio includono le sezioni seguenti:

    • Alternative, altri servizi che puoi collegare all'architettura
    • Considerazioni, indicazioni che si basano sul nostro framework Success by Design e, facoltativamente, includono una distribuzione

  • Schema progettuale: gli schemi progettuali di Dynamics 365 risolvono sfide specifiche nelle implementazioni e si basano su uno scenario specifico o su una procedura consigliata specifica. Usa questo modello per acquisire un modello di processo aziendale. In alternativa, usa il modello di Word disponibile in dynamics365patternspractices/templates/business-processes.

Contributi ai processi aziendali

Il termine processo aziendale copre un'ampia gamma di attività od operazioni strutturate, spesso in sequenza, volte a raggiungere un obiettivo precedentemente stabilito dall'organizzazione. Il termine può anche fare riferimento agli effetti cumulativi di tutti i passaggi che avanzano verso un obiettivo aziendale. I processi aziendali sono specifici delle soluzioni che includono Dynamics 365. Riteniamo che questo nuovo tipo di contenuto crei una struttura che aiuta i clienti e i partner a prepararsi meglio all'adozione di Dynamics 365. Ogni processo aziendale include un diagramma di un processo aziendale standard. Le sezioni del documento delineano i passaggi di configurazione e le entità di dati usate per ogni passaggio. Ogni passaggio è collegato alla pagina pertinente nella documentazione del prodotto e tutti i documenti contengono collegamenti ai passaggi successivi e alle risorse correlate per aiutare i lettori nel loro percorso di apprendimento.

I processi aziendali sono strutturati in un catalogo. Tale catalogo è una cartella di lavoro di Excel che noi di Microsoft utilizziamo per organizzare a priorità il nostro lavoro sulla documentazione dei processi aziendali. Il formato è Excel perché semplifica l'ordinamento delle voci e l'applicazione di filtri. Riteniamo inoltre che i nostri partner possano utilizzare la cartella di lavoro di Excel per organizzare i propri percorsi di onboarding, i propri progetti di implementazione e i propri processi aziendali.

Scarica la versione più recente del catalogo da https://aka.ms/BusinessProcessCatalog.

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 problema GitHub a https://github.com/microsoft/dynamics365patternspractices/issues.

Contenuto del catalogo

Il catalogo definisce quattro livelli di contenuto:

  1. Processi completi

    Abbiamo identificato 15 scenari completi. Descriviamo gli scenari in termini commerciali, non in termini di tecnologia software.

    Per ogni processo completo, l'articolo introduttivo descrive il nostro approccio al processo completo. Elenchiamo i principali stakeholder e in che modo Dynamics 365 aiuta il processo completo. Forniamo anche una panoramica, insieme a un diagramma di processo aziendale, di come il processo completo interagisce con altri processi completi. L'introduzione elenca i prerequisiti per l'implementazione di una soluzione a supporto del processo completo.

  2. Aree di processo aziendale

    Ogni scenario completo copre due o più aree di processo aziendale. Questo livello è solo un modo per raggruppare i processi aziendali per facilitare la ricerca e la navigazione. Nella maggior parte dei casi, le aree di processo aziendale sono separate in base alle funzioni lavorative o ai reparti in un'organizzazione. Attualmente il catalogo definisce più di 90 aree di processi aziendali.

  3. Processi aziendali

    Il termine processo aziendale copre un'ampia gamma di attività od operazioni strutturate, spesso in sequenza, volte a raggiungere un obiettivo precedentemente stabilito dall'organizzazione. Il termine può anche fare riferimento 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 circa 700 processi aziendali. Alcuni processi aziendali si applicano a una singola app Dynamics 365 ed è possibile che un processo sia già descritto nella documentazione dell'app. Raccogliendo tutti i processi aziendali qui nella guida, ci auguriamo di fornire un unico punto di accesso con collegamenti a contenuti specifici del prodotto pertinenti.

  4. Criteri

    In Dynamics 365, i criteri sono configurazioni ripetibili che supportano un processo aziendale specifico. I criteri includono i casi d'uso, gli scenari e i settori più comuni. Spesso esistono molti modi di implementare Dynamics 365 per soddisfare i requisiti aziendali. Il nostro obiettivo con i criteri è quello di fornire una base per chi si deve occupare di un'implementazione. Abbiamo identificato oltre 2000 criteri e ci aspettiamo che il numero aumenti in modo significativo nel tempo.

Altre informazioni introduttive sul catalogo dei processi aziendali sono disponibili in Informazioni sulla guida ai processi aziendali.

Scrivi il tuo contributo

In Microsoft, stiamo lavorando duramente per convertire note interne, anni di esperienza e documenti vari in indicazioni sui processi aziendali. Accogliamo con grande favore i contributi della community.

Il repository GitHub contiene modelli di Word che puoi utilizzare per scrivere il tuo contributo. Tutti i modelli di Word si trovano nella cartella /templates/business-processes. La cartella contiene anche un modello di PowerPoint che puoi usare per progettare i diagrammi di cui hai bisogno. In alternativa, puoi usare Visio o un'altra finestra di progettazione.

Quando sei pronto per inviare un nuovo articolo, compila il nostro modulo di invio e allega il tuo file.

Se lo desideri, puoi aggiungere il tuo profilo LinkedIn per essere citato come autore originale.

Riconoscimento dei contributori

La piattaforma Microsoft Learn indica nella parte superiore di ogni articolo i contributori interni ed esterni che hanno inviato il loro contributo tramite GitHub. Alcune persone contribuiscono in altri modi, pertanto aggiungiamo una sezione Contributori verso la fine dell'articolo.

Nella sezione Contributori sono elencati i contributori principali, con il relativo nome e un eventuale collegamento al profilo LinkedIn o ad altro profilo. Lo screenshot seguente è una versione anonima della sezione Contributori in un articolo di Centro architetture di Azure.

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

Ecco come appare nel linguaggio 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

Questo tipo di inserimento nell'elenco dei contributori è facoltativo. In Microsoft consigliamo di usare la sezione Contributori se i contributori esterni inviano nuovi contenuti, ad esempio architetture di riferimento e schemi progettuali, mediante mezzi diversi da GitHub.