Partage via

Contribuer à la documentation de Dynamics 365

  • Article

Vous pouvez contribuer à la documentation de Microsoft pour Dynamics 365 de deux manières. Si un article contient des informations incorrectes ou confuses, ou si vous connaissez une bonne solution à un problème récurrent, vous pouvez utiliser le lien de commentaires dans l’article pour nous le faire savoir.

Pour la majeure partie de notre documentation, vous pouvez également modifier un article directement pour lancer un processus de révision.

Fournir des commentaires

Sur le site web learn.microsoft.com, chaque article Learn vous offre la possibilité de nous faire part de vos commentaires. Vous pouvez choisir l’action Commentaires située sous le titre de l’article en haut à droite ou l’une des options de commentaires situées au bas de l’article dans la section Commentaires. Donnez une note à l’article, sélectionnez la raison de votre commentaire et pensez à laisser un commentaire. Les commentaires sont transmis à l’auteur de l’article et à l’équipe propriétaire des documents.

Si un article ne peut pas être modifié directement, ou si vous n’êtes pas à l’aise avec la modification, nous vous encourageons à utiliser le mécanisme de commentaires 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 référentiels publics GitHub. N’importe qui peut les consulter et, dans de nombreux cas, les modifier. Nous apprécions vos suggestions et corrections, soit sous forme de contributions directes, soit sous forme de problèmes GitHub pour signaler un bogue ou poser une question. Nous n’acceptons que les commentaires et les contributions relatifs au contenu source qu’en anglais.

La plupart des articles comportent une icône en forme de crayon avec l’info-bulle Modifier ce document. Sélectionnez l’icône pour ouvrir l’article dans GitHub, puis commencez à le modifier. Démarrez en tant que contributeur avec le Microsoft Learn guide du contributeur.

Si vous souhaitez approfondir et contribuer à de nouveaux articles conceptuels, utilisez les modèles sur https://github.com/MicrosoftDocs/dynamics365-docs-templates.

Contenu de conseils de Dynamics 365

Le contenu des conseils Dynamics 365 utilise les mêmes processus que la plupart des documentations Microsoft Learn. Dans cette section, nous présentons les outils et processus que vous pouvez utiliser pour vous aider à compléter les conseils de mise en œuvre.

Le terme contenu d’orientation couvre le guide de mise en œuvre de Dynamics 365, les descriptions des processus d’entreprise, les nouveaux modèles, les meilleures pratiques partagées et les architectures de référence. Nous avons publié le premier contenu de conseils en avril 2023 et nous ajoutons des mises à jour au contenu toutes les deux semaines. Consultez le hub de conseils et dites-nous ce qui est intéressant et s’il manque des informations.

Une partie du contenu de conseils est fournie par des contributeurs internes. Nous encourageons les experts en la matière de toute la communauté à nous aider à établir de bonnes pratiques. Poursuivez votre lecture si vous avez une bonne pratique ou une autre idée qui devrait être incluse dans Microsoft Learn.

Pourquoi contribuer ?

Nous croyons que le contenu de conseils permet d’accélérer l’exécution de projets d’implémentation Dynamics 365. Nos partenaires et clients peuvent utiliser ces conseils pour préparer l’implémentation et se perfectionner dans de nouveaux domaines ou former de nouveaux employés. Les développeurs de logiciels peuvent utiliser le contenu comme plateforme pour promouvoir leur propriété intellectuelle ou leur expertise sectorielle.

Mais chez Microsoft, nous ne sommes pas les seuls experts en matière d’implémentation de solutions avec Dynamics 365. La communauté comprend de nombreuses personnes qui sont des experts dans divers aspects de cette implémentation. Avez-vous un modèle, une meilleure pratique, une configuration ou une architecture d’intégration qui fonctionne bien sur plusieurs implémentations ? Envisagez de les partager ici sur Microsoft Learn afin de renforcer la productivité et l’efficacité de toute la communauté dans le cadre de ses projets d’implémentation.

Nous espérons pouvoir offrir des récompenses ou d’autres reconnaissances pour les contributions à l’avenir. En 2023, nous mentionnons les contributeurs dans les articles.

Comment contribuer

À partir de novembre 2023, vous pouvez désormais trouver les fichiers sources du contenu des conseils Dynamics 365 de Microsoft dans un référentiel GitHub public. Vous pouvez également modifier les articles du site learn.microsoft.com/dynamics365/guidance comme décrit dans le guide du contributeur Microsoft Learn.

Nous vous recommandons de soumettre des corrections de la même manière que vous soumettriez une correction ou un nouveau contenu à d’autres domaines de Microsoft Learn. Cependant, pour soumettre du nouveau contenu, nous vous demandons de charger vos fichiers Markdown pour le nouveau contenu de conseils vers un autre référentiel, Modèles et pratiques de Dynamics 365. De cette façon, nous pouvons nous assurer que votre architecture de référence ou modèle est examiné par d’autres experts en la matière. Il existe divers modèles parmi lesquels choisir et si vous souhaitez contribuer au contenu du processus d’entreprise, il existe un autre processus différent.

Modèles

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

Nous ajouterons d’autres modèles et conseils au fil du temps. Nous vous recommandons de suivre les référentiels ou de les enregistrer avec une étoile, afin d’être averti lorsque quelque chose change.

Partagez vos commentaires dans l’onglet https://github.com/microsoft/dynamics365patternspractices/discussions du référentiel Modèles et pratiques Dynamics 365.

Si vous n’avez pas déjà un compte GitHub, commencez par le Guide du contributeur Microsoft Learn.

Conseil

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

Architectures

Les contributions de conseils architecturaux, y compris les idées de solutions et les modèles de conception sont les bienvenus. Si vous disposez d’une meilleure pratique ou d’une implémentation de référence, soumettez votre proposition soit à l’équipe Azure ou à nous dans Dynamics 365.

Pour contribuer de nouveaux articles aux conseils architecturaux de Dynamics 365, suivez ces grandes étapes :

Microsoft traite ensuite l’article et le publie dans le cadre de la documentation de conseils Dynamics 365.

Pour une introduction générale au contenu de conseils de Microsoft, consultez le Centre des architectures Azure. Pour le guide du contributeur, consultez Contributions au Centre des architectures Azure.

Le référentiel GitHub dynamics365-docs-templates contient les modèles Markdown suivants pour les conseils architecturaux dans le dossier guidance-templates :

  • Modèle d’architecture généralisée : un modèle d’architecture généralisée agit comme une architecture de base avec une solution commune qui s’applique à de nombreux scénarios. Par exemple, les idées de solutions peuvent s’appuyer sur un article architectural pour fournir une perspective pour un secteur d’activité particulier ou une solution partenaire et un lien à l’architecture à partir de chaque idée de solution. Le modèle est basé sur le modèle de guide d’architecture Azure. 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 de « petites » architectures d’implémentations de Dynamics 365. Elles fournissent de brèves vues d’ensemble des solutions avec les services Dynamics 365 et Azure. Chaque idée de solution contient les éléments suivants :

    • Un schéma d’architecture
    • Un flux de données
    • Des composants, c’est-à-dire une liste des services utilisés
    • Des crédits de contributeur
    • Des liens vers les étapes suivantes et les ressources associées, comme les guides et architectures associés

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

    • D’autres possibilités, d’autres services que vous pouvez connecter à l’architecture à la place.
    • Considérations et conseils qui correspondent à notre cadre Success by Design et, en option, inclut un déploiement.

  • Modèle de conception : les modèles 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 meilleure pratique spécifique. Utilisez ce modèle pour capturer un modèle de processus métier. Vous pouvez également utiliser le modèle Word disponible dans dynamics365patternspractices/templates/business-processes.

Contributions aux processus métier

L’expression processus d’entreprise couvre un large éventail d’activités ou de tâches structurées, souvent séquencées, pour atteindre un objectif organisationnel prédéterminé. Elle peut également faire référence aux effets cumulatifs de toutes les étapes progressant vers un objectif métier. Les processus métier sont spécifiques aux solutions qui incluent Dynamics 365. Nous pensons que ce nouveau type de contenu crée une structure qui aide les clients et les partenaires à mieux se préparer à l’adoption de Dynamics 365. Chaque processus d’entreprise comprend un diagramme d’un flux de processus d’entreprise standard. Les sections du document décrivent les étapes de configuration et les entités de données utilisées à chacune. Chaque étape renvoie à la page correspondante de la documentation du produit, et tous les documents contiennent des liens vers les étapes suivantes et des ressources associées pour aider les lecteurs tout au long de leur parcours d’apprentissage.

Nous avons structuré les processus d’entreprise dans un catalogue. Le catalogue de processus d’entreprise est un classeur Excel que nous utilisons chez Microsoft pour organiser et hiérarchiser notre travail sur la documentation des processus d’entreprise. Le format est Excel car il permet de trier et de filtrer facilement les entrées. Nous pensons également que nos partenaires peuvent utiliser le classeur Excel pour organiser leurs parcours d’intégration, leurs projets de mise en œuvre et leurs propres processus métier.

Téléchargez la version la plus récente du catalogue à partir de https://aka.ms/BusinessProcessCatalog.

Remarque

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

Ce que contient le catalogue

Le catalogue définit quatre niveaux de contenu :

  1. Processus de bout en bout

    Nous avons identifié 15 scénarios de bout en bout. Nous décrivons les scénarios en termes métier, et non en termes de technologie logicielle.

    Pour chaque processus de bout en bout, l’article d’introduction décrit notre façon d’envisager le processus de bout en bout. Nous énumérons les principales parties prenantes et comment Dynamics 365 aide le processus de bout en bout. Nous fournissons également un aperçu, ainsi qu’un diagramme de flux des processus d’entreprise, de la façon dont le processus de bout en bout interagit avec d’autres processus de bout en bout. L’introduction répertorie les prérequis pour l’implémentation d’une solution permettant de prendre en charge le processus de bout en bout.

  2. Zones des processus métier

    Chaque scénario de bout en bout couvre au moins deux domaines de processus métier. Ce niveau n’est qu’un moyen de regrouper les processus métier pour faciliter la recherche et la navigation. Dans la plupart des cas, les domaines de processus métier sont séparés par des fonctions de tâche ou départements principaux dans une organisation. Actuellement, le catalogue définit plus de 90 domaines de processus métier.

  3. Processus métier

    L’expression processus d’entreprise couvre un large éventail d’activités ou de tâches structurées, souvent séquencées, pour atteindre un objectif organisationnel prédéterminé. Elle peut également faire référence aux effets cumulatifs de toutes les étapes progressant vers un objectif métier. Chaque processus métier décrit une fonction ou un processus pris en charge par Dynamics 365. Jusqu’à présent, nous avons identifié près de 700 processus métier. Certains s’appliquent à une seule application Dynamics 365 et il est possible que la documentation de l’application décrive déjà le processus. En rassemblant tous les processus d’entreprise ici dans le guide, nous espérons fournir un point d’entrée unique avec des liens vers les contenus spécifiques aux produits pertinents.

  4. Modèles

    Dans Dynamics 365, les modèles sont des configurations qui peuvent être répétées pour prendre en charge un processus d’entreprise spécifique. Ils incluent les cas d’utilisation, les scénarios et les secteurs les plus courants. Il existe souvent de nombreuses façons d’implémenter Dynamics 365 pour répondre aux besoins de votre entreprise. Notre objectif avec les modèles est de fournir une base de référence pour votre implémentation. Nous avons identifié plus de 2 000 modèles et nous nous attendons à ce que ce nombre augmente considérablement avec le temps.

Pour obtenir une présentation plus détaillée du catalogue des processus d’entreprise, accédez à À propos du guide des processus d’entreprise.

Soumettre vos contributions

En interne chez Microsoft, nous nous efforçons de convertir des notes internes, des années d’expérience et divers documents en conseils sur les processus d’entreprise. Nous apprécions beaucoup les contributions de la communauté.

Le référentiel GitHub contient des modèles Word que vous pouvez utiliser pour capturer votre contribution. Tous les modèles Word se trouvent dans le dossier /templates/business-processes. Le dossier contient également un modèle PowerPoint qui peut vous aider à concevoir les diagrammes dont vous avez besoin. Vous pouvez également utiliser Visio ou un autre concepteur.

Lorsque vous êtes prêt à soumettre un nouvel article, complétez notre formulaire de soumission et joignez votre ou vos fichiers.

Si vous le souhaitez, ajoutez votre profil LinkedIn afin que vous puissiez être répertorié comme l’auteur d’origine.

Reconnaissance des contributeurs

La plateforme Microsoft Learn affiche les contributeurs internes et externes en haut de chaque article s’ils ont soumis leur contribution via GitHub. Certaines personnes extérieures à Microsoft contribuent d’autres manières, nous ajoutons donc une section Contributeurs vers la fin de l’article.

La section facultative Contributeurs répertorie les principaux contributeurs avec leur nom et un lien vers leur profil LinkedIn ou un autre profil, s’ils en fournissent un. La capture d’écran suivante est une version anonymisée de la section Contributeurs dans un article du Centre des architectures Azure.

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

Voici à quoi cela 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 répertorié comme contributeur de cette manière est facultatif. Au sein de Microsoft, nous vous recommandons d’utiliser la section Contributeurs si des contributeurs externes soumettent du nouveau contenu, tel que des architectures de référence et des modèles de conception, par d’autres moyens que GitHub.