Partage via

Contribuer à la documentation de Dynamics 365

Vous pouvez contribuer à la documentation Microsoft pour Dynamics 365 de deux façons. Si un article contient des informations incorrectes ou confuses, ou si vous connaissez une bonne solution de contournement pour un problème récurrent, vous pouvez utiliser le lien de rétroaction dans l’article pour nous en informer.

Pour la plupart de notre documentation, vous pouvez aussi éditer un article directement pour commencer un processus de révision.

Formulez des commentaires

Sur le site learn.microsoft.com , chaque article de Learn vous offre l’occasion de donner votre avis. Vous pouvez choisir l’action de rétroaction qui se trouve sous le titre de l’article en haut à droite ou l’une des options de rétroaction en bas de l’article, dans la section Rétroaction . Donnez une note à l’article, choisissez la raison de votre commentaire, et envisagez de laisser un commentaire. Les commentaires vont à l’auteur de l’article et à l’équipe qui possède la documentation.

Si un article ne peut pas être édité directement, ou si vous n’êtes pas à l’aise de le réviser, nous vous encourageons à utiliser le mécanisme de rétroaction pour nous dire ce que vous pensez de l’article ou du produit.

Contributions externes à la documentation Microsoft

Les fichiers sources de notre contenu principal sont stockés dans des dépôts publics sur GitHub. N’importe qui peut les examiner et, dans bien des cas, les modifier. Nous accueillons volontiers vos suggestions et corrections, que ce soit sous forme de contributions directes ou en tant que numéros GitHub pour signaler un bogue ou poser une question. Nous ne pouvons accepter que les commentaires et contributions au contenu source en anglais.

La plupart des articles ont une icône de crayon avec l’infobulle Modifier ce document. Sélectionnez l’icône pour ouvrir l’article sur GitHub, puis commencez à éditer. Commencez comme contributeur avec le guide Microsoft Learn pour contributeur.

Si vous voulez être complet et contribuer à de nouveaux articles conceptuels, utilisez les modèles à https://github.com/MicrosoftDocs/dynamics365-docs-templates.

Contenu des directives Dynamics 365

Le contenu des directives de Dynamics 365 utilise les mêmes processus que la plupart de la documentation sur Microsoft Learn. Dans cette section, nous mentionnons les outils et processus que vous pouvez utiliser pour aider à enrichir les consignes d’implémentation.

Le terme contenu des orientations couvre le guide d’implémentation de Dynamics 365, les descriptions des processus d’affaires, les nouveaux patrons, les meilleures pratiques et les architectures de référence. Nous avons publié le premier contenu d’orientation en avril 2023, et nous ajoutons des mises à jour toutes les deux semaines. Parcourez le centre d’orientation et dites-nous ce qui est excellent et ce qui manque.

Une partie du contenu des directives est fournie par des contributeurs internes. Nous encourageons les experts de la communauté à nous aider à établir les meilleures pratiques. Lisez la suite pour savoir si vous avez une meilleure pratique ou une autre idée qui, selon vous, devrait faire partie de Microsoft Learn.

Pourquoi contribuer?

Nous croyons que le contenu des directives aide à accélérer le déroulement des projets d’implémentation de Dynamics 365. Nos partenaires et clients peuvent utiliser ces conseils pour se préparer à la mise en œuvre et pour se perfectionner dans de nouveaux domaines ou pour former de nouveaux employés. Les développeurs de logiciels peuvent utiliser ce contenu comme plateforme pour promouvoir leur propriété intellectuelle ou leur expertise dans l’industrie.

Mais chez Microsoft, nous ne sommes pas les seuls experts sur la mise en œuvre de solutions avec Dynamics 365. La communauté comprend des experts dans divers aspects de la mise en œuvre. Avez-vous un motif, une bonne pratique, une configuration ou une architecture d’intégration qui fonctionne bien à travers plusieurs implémentations? Envisagez de le partager ici sur Microsoft Learn pour rendre toute la communauté encore plus productive et efficace dans leurs projets de mise en œuvre.

Nous espérons pouvoir offrir des récompenses ou d’autres reconnaissances pour les contributions. Pour l’instant, nous reconnaissons les contributeurs dans les articles de deux façons différentes. Pour en savoir plus, consultez la section Reconnaissance des contributeurs .

Comment contribuer

Vous pouvez trouver les fichiers sources du contenu des directives Dynamics 365 de Microsoft dans un dépôt public GitHub. Vous pouvez aussi modifier les articles sur le site learn.microsoft.com/dynamics365/guidance comme décrit dans le guide des contributeurs Microsoft Learn.

Nous vous recommandons de soumettre des corrections de la même manière que vous soumettez une correction à d’autres domaines de Microsoft Learn. Cependant, pour soumettre du nouveau contenu, nous vous demandons de téléverser vos fichiers Markdown pour le nouveau contenu d’orientation vers un autre dépôt, Dynamics 365 Patterns and Practices. De cette façon, nous pouvons nous assurer que votre architecture ou votre modèle de référence soit examiné par d’autres experts du sujet. Il y a différents modèles parmi lesquels choisir, et si vous voulez contribuer au contenu des processus d’affaires, il y a un processus complètement différent.

Modèles

Microsoft fournit des modèles à deux endroits, selon le type de modèle :

Nous ajouterons plus de modèles et de conseils au fil du temps. Nous vous recommandons de suivre les dépôts ou de les sauvegarder avec une étoile, afin d’être averti quand quelque chose change.

Partagez vos commentaires sur l’onglet https://github.com/microsoft/dynamics365patternspractices/discussions du dépôt Patterns and Practices de Dynamics 365.

Si vous n’avez pas encore de compte GitHub, commencez avec le guide des contributeurs Microsoft Learn.

Astuce

Parcourez nos fichiers sources dans le https://github.com/MicrosoftDocs/dynamics365-guidance dépôt. Apprenez de la façon dont nous structurons les différents types d’articles afin que vos articles suivent la même structure. De cette façon, le processus d’évaluation est plus rapide.

Architectures

Nous accueillons favorablement les contributions de conseils architecturaux, y compris des idées de solutions et des modèles de conception. Si vous avez une mise en œuvre de bonnes pratiques ou de référence, soumettez votre proposition soit à l’équipe Azure , soit à nous dans Dynamics 365.

Pour contribuer de nouveaux articles aux directives architecturales Dynamics 365, suivez ces étapes principales :

Microsoft traite l’article et le publie dans la documentation des directives Dynamics 365 .

Pour une introduction générale au contenu d’orientation chez Microsoft, consultez le Centre d’architecture Azure. Pour le guide des contributeurs, voir les contributions du Centre d’architecture Azure.

Le dépôt GitHub dynamics365-docs-templates contient les modèles Markdown suivants pour des conseils architecturaux dans le dossier guidance-templates :

  • Patron d’architecture généralisé : Un modèle d’architecture généralisé agit comme une architecture centrale avec une solution commune applicable à de nombreux scénarios. Par exemple, les idées de solutions peuvent s’appuyer sur un article d’architecture pour offrir une perspective à une industrie ou une solution partenaire particulière et faire un lien vers l’architecture de chaque idée. Le modèle est basé sur le modèle Azure Architecture Guide. Utilisez-le pour différents types d’architectures, y compris les architectures de référence.

  • Idée de solution : Les idées de solution sont des architectures « petites » d’implémentations de Dynamics 365. Ils fournissent des aperçus brefs des solutions avec Dynamics 365 et les services Azure. Chaque idée de solution contient les éléments suivants :

    • Un diagramme d’architecture
    • Un flux de données
    • Composantes, c’est-à-dire une liste des services utilisés
    • Crédits des contributeurs
    • Liens vers les prochaines étapes et ressources connexes, telles que des guides et architectures connexes

  • Solution d’exemple : Les solutions d’exemple sont des charges de travail d’exemple avec des architectures « moyennes ». Ils guident les lecteurs à travers le processus de conception de solutions pour des problèmes spécifiques dans les implémentations de Dynamics 365. Les solutions d’exemple fournissent des conseils d’architecture exploitables basés sur des exemples réels de clients. L’objectif est de raccourcir la courbe d’apprentissage des clients en leur racontant l’histoire d’un autre client qui a vécu le même parcours. Ils incluent les sections du modèle d’Idée de solution et ajoutent les sections suivantes :

    • Alternatives, d’autres services que vous pouvez brancher dans l’architecture à la place
    • Considérations, directives qui correspondent à notre cadre Success by Design et, optionnellement, incluent un déploiement

  • Modèle de conception : Les patrons de conception Dynamics 365 répondent à des défis spécifiques dans les implémentations et sont basés sur un scénario ou une bonne pratique précise. Utilisez ce modèle pour capturer un schéma de processus d’affaires. Sinon, utilisez le modèle Word à dynamics365patternspractices/templates/business-processes.

Contributions aux processus d’affaires

Le terme processus d’affaires englobe un large éventail d’activités ou de tâches structurées, souvent séquencées, visant à atteindre un objectif organisationnel prédéterminé. Le terme peut aussi désigner les effets cumulatifs de toutes les étapes progressant vers un objectif d’affaires. Les processus d’affaires sont spécifiques aux solutions qui incluent Dynamics 365. Nous croyons que ce nouveau type de contenu crée une structure qui aide les clients et partenaires à mieux se préparer à adopter Dynamics 365. Chaque processus d’affaires comprend un diagramme d’un flux standard de processus d’affaires. Des sections du document décrivent les étapes de configuration et les entités de données utilisées dans chacune d’elles. Chaque étape renvoie à la page pertinente dans la documentation produit, et tous les documents contiennent des liens vers les prochaines étapes et ressources connexes pour aider les lecteurs tout au long de leur parcours d’apprentissage.

Nous avons structuré les processus d’affaires dans un catalogue. Le catalogue des processus d’affaires est un cahier Excel que nous utilisons chez Microsoft pour organiser et prioriser notre travail sur la documentation des processus d’affaires. Le format est Excel parce qu’il facilite le tri et le filtrage des entrées. Nous croyons aussi que nos partenaires peuvent utiliser le cahier Excel pour organiser leurs parcours d’intégration, leurs projets de mise en œuvre et leurs propres processus d’affaires.

Téléchargez la dernière version du catalogue à partir de https://aka.ms/BusinessProcessCatalog.

Remarque

Si vous voulez contribuer aux processus d’affaires, enregistrez votre travail avant de commencer afin de réduire le risque que quelqu’un d’autre travaille sur le même processus d’affaires. Pour enregistrer votre travail, soumettez un numéro GitHub à https://github.com/microsoft/dynamics365patternspractices/issues.

Ce que contient le catalogue

Le catalogue définit six niveaux de contenu :

  1. Processus de bout en bout

    Un processus de bout en bout représente le flux complet des activités, du déclencheur initial au résultat final. Elle englobe toutes les étapes intermédiaires et sous-processus nécessaires pour atteindre l’objectif d’affaires. Nous avons identifié 15 scénarios de bout en bout. Nous décrivons les scénarios en termes d’affaires, pas en termes de technologie logicielle.

    Pour chaque processus de bout en bout, l’article d’introduction décrit comment nous pensons le processus de bout en bout. Nous énumérons les principaux intervenants et comment Dynamics 365 aide le processus de bout en bout. Nous fournissons également un aperçu, accompagné d’un diagramme de flux des processus d’affaires, de la façon dont le processus de bout en bout interagit avec d’autres processus de bout en bout. L’introduction énumère les prérequis pour mettre en œuvre une solution soutenant le processus de bout en bout.

  2. Domaines des processus d’affaires

    Chaque scénario de bout en bout couvre deux domaines ou plus des processus d’affaires. Ce niveau représente un regroupement important d’activités connexes qui contribuent à l’objectif global, et il offre une manière logique de regrouper les processus d’affaires. Dans la plupart des cas, les domaines des processus d’affaires sont séparés par les principales fonctions ou départements d’une organisation. Actuellement, le catalogue définit plus de 100 domaines de processus d’affaires.

  3. Processus d’affaires

    Le terme processus d’affaires englobe un large éventail d’activités ou de tâches structurées, souvent séquencées, visant à atteindre un objectif organisationnel prédéterminé. Le terme peut aussi désigner les effets cumulatifs de toutes les étapes progressant vers un objectif d’affaires. Chaque processus d’affaires décrit une fonction ou un processus que Dynamics 365 supporte. Jusqu’à présent, nous avons identifié plus de 800 processus d’affaires. Certains s’appliquent à une seule application Dynamics 365, et la documentation de l’application décrit peut-être déjà le processus. En rassemblant tous les processus d’affaires ici dans le guide, nous espérons offrir un point d’entrée unique avec des liens vers du contenu spécifique aux produits pertinents.

  4. Scénarios

    Dans Dynamics 365, les scénarios sont des schémas de configurations répétables qui supportent un processus d’affaires spécifique. Ils incluent les cas d’utilisation, scénarios et industries les plus courants. Souvent, il existe plusieurs façons d’implémenter Dynamics 365 pour répondre aux besoins de votre entreprise. Notre objectif avec les patrons est de fournir une base de référence pour votre mise en œuvre. Nous avons identifié plus de 3000 scénarios et schémas, et nous prévoyons que ce nombre augmentera avec le temps.

  5. Processus système

    Un processus système est une partie d’un processus d’affaires qui utilise un formulaire, une page ou un élément d’interface utilisateur spécifique dans Dynamics 365.

  6. Cas d’essai

Un cas de test est un ensemble détaillé de conditions et d’étapes utilisés pour déterminer si une application logicielle ou un système fonctionne correctement. C’est une partie essentielle du processus de test logiciel, conçue pour s’assurer que le logiciel répond à ses exigences et fonctionne comme prévu. Les cas de test servent à identifier les défauts, à assurer la qualité et à vérifier que le logiciel se comporte comme prévu dans diverses conditions.

Il existe des modèles Word pour chaque type de contenu. Les instructions sont formatées en rouge entourées de crochets comme dans l’exemple suivant :[Text in red] Supprimez ces instructions lorsque vous finalisez le document. Le texte surligné en jaune doit être remplacé ou ajusté par vous. Ne changez pas le texte qui n’est pas surligné en jaune et qui n’est pas formaté en rouge. Ces phrases standards aident les utilisateurs à reconnaître le modèle afin qu’ils puissent scanner et trouver plus facilement le contenu qu’ils recherchent.

Obtenez une introduction supplémentaire au catalogue des processus d’affaires dans About the business process guide. Éventuellement, consultez les TechTalks où nous parlons de la façon dont vous pouvez utiliser le catalogue des processus d’affaires et contribuer à la bibliothèque de contenu.

Soumettez votre contribution

À l’interne chez Microsoft, nous travaillons fort pour convertir les notes internes, les années d’expérience et divers documents en conseils sur les processus d’affaires. Nous accueillons vivement les contributions de la communauté.

Il existe différents modèles pour soumettre des contributions selon le type d’article. Les contributeurs doivent choisir le bon modèle pour le type d’article approprié auquel ils souhaitent contribuer. Les modèles sont disponibles sous forme de fichiers Word, nommés pour expliquer à quel type d’article le modèle est destiné.

Reconnaissance des contributeurs

La plateforme Microsoft Learn affiche à la fois les contributeurs internes et externes en haut de chaque article s’ils ont soumis leur contribution via GitHub. Certaines personnes contribuent d’autres façons, alors nous ajoutons une section Contributeurs vers la fin de l’article.

La section optionnelle des contributeurs liste les contributeurs clés avec leur nom et un lien vers leur profil LinkedIn ou autre s’ils en ont fourni un. La capture d’écran suivante est une version anonymisée de la section Contributeurs dans un article du Azure Architecture Center.

Capture d’écran d’un exemple de section Contributeurs, montrant l’auteur principal plus trois contributeurs listés avec des liens vers leurs profils LinkedIn.

Voici à quoi ça ressemble dans 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

Être inscrit comme contributeur de cette façon est optionnel. Chez Microsoft, nous recommandons d’utiliser la section Contributeurs si des contributeurs externes soumettent du nouveau contenu, comme des architectures de référence et des patrons de conception, par d’autres moyens que GitHub.

  • Last updated on