Partager via

Contribuer à la documentation de Dynamics 365

Vous pouvez contribuer à la documentation Microsoft pour Dynamics 365 de deux manières. 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 retour dans l’article pour nous en informer.

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

Envoyer des commentaires

Sur le site learn.microsoft.com , chaque article de Learn vous offre la possibilité de donner votre avis. Vous pouvez choisir l’action Retour qui se trouve sous le titre de l’article en haut à droite ou l’une des options de retour en bas de l’article dans la section Commentaires . Attribuez une note à l’article, sélectionnez la raison de votre retour, et envisagez de laisser un commentaire. Les retours sont transmis à 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 faire, nous vous encourageons à utiliser le mécanisme de retour 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 GitHub. N’importe qui peut les examiner et, dans de nombreux cas, les modifier. Nous accueillons vos suggestions et corrections, que ce soit sous forme de contributions directes ou en tant que publications GitHub pour signaler un bug ou poser une question. Nous ne pouvons accepter que les retours 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 en tant que contributeur avec le guide du contributeur Microsoft Learn.

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

Contenu des conseils Dynamics 365

Le contenu des directives Dynamics 365 utilise les mêmes processus que la plupart de la documentation sur Microsoft Learn. Dans cette section, nous citons les outils et processus que vous pouvez utiliser pour enrichir les consignes de mise en œuvre.

Le terme contenu d’orientation couvre le guide d’implémentation de Dynamics 365, les descriptions des processus métier, les nouveaux schémas, 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 orientations est fournie par des contributeurs internes. Nous encourageons les experts de la communauté à nous aider à établir les meilleures pratiques. Lisez la suite si vous avez une bonne pratique ou un autre conseil que vous pensez devoir faire partie de Microsoft Learn.

Pourquoi contribuer ?

Nous pensons 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 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 sectorielle.

Mais chez Microsoft, nous ne sommes pas les seuls experts en 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 schéma, 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 ses 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 manières 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 également 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 de nouveaux contenus, nous vous demandons de télécharger vos fichiers Markdown pour les nouveaux contenus de directives dans un autre dépôt, Dynamics 365 Patterns and Practices. De cette façon, nous pouvons nous assurer que votre architecture ou modèle de référence soit examiné par d’autres experts du sujet. Il existe différents modèles parmi lesquels choisir, et si vous souhaitez contribuer au contenu des processus métier, il existe un processus complètement différent.

Modèles

Microsoft propose des modèles en deux emplacements, 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 informé en cas de changement.

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

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

Conseil

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. Ainsi, le processus d’évaluation est plus rapide.

Architectures

Nous accueillons volontiers les contributions de conseils architecturaux, y compris des idées de solutions et des schémas 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 via 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 d’orientation 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 d’Azure.

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

  • Modèle 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 architectural pour offrir une perspective à une solution sectorielle ou 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 associées, telles que des guides et architectures associées

  • Solution d’exemple : Les solutions d’exemple sont des charges de travail d’exemple avec des architectures « intermédiaires ». Ils guident les lecteurs dans 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 ayant vécu le même parcours. Ils incluent les sections du modèle d’Idée de solution et ajoutent les sections suivantes :

    • Alternatives, autres services que vous pouvez brancher dans l’architecture à la place
    • Considérations, directives qui correspondent à notre cadre Success by Design et, en option, 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 métier. Sinon, utilisez le modèle Word sur dynamics365patternspractices/templates/business-processes.

Contributions aux processus métier

Le terme processus métier 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 également désigner les effets cumulatifs de toutes les étapes progressant vers un objectif commercial. Les processus métier sont spécifiques aux solutions incluant Dynamics 365. Nous pensons 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 métier comprend un diagramme d’un flux standard de processus métier. 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 de la documentation produit, et tous les documents contiennent des liens vers les prochaines étapes et les ressources associées pour accompagner les lecteurs tout au long de leur parcours d’apprentissage.

Nous structurions les processus métier dans un catalogue. Le catalogue des processus métier est un classeur Excel que nous, chez Microsoft, utilisons pour organiser et prioriser notre travail sur la documentation des processus métier. Le format est Excel car il facilite le tri et le filtrage des 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 dernière version du catalogue depuis https://aka.ms/BusinessProcessCatalog.

Note

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 numéro GitHub à https://github.com/microsoft/dynamics365patternspractices/issuesl’adresse .

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 commercial. Nous avons identifié 15 scénarios de bout en bout. Nous décrivons les scénarios en termes commerciaux, 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 listons les principaux acteurs 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 métier, de la manière 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 métier

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

  3. Processus métier

    Le terme processus métier 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 également désigner les effets cumulatifs de toutes les étapes progressant vers un objectif commercial. Chaque processus métier décrit une fonction ou un processus que Dynamics 365 prend en charge. Jusqu’à présent, nous avons identifié plus de 800 processus métier. Certaines concernent une seule application Dynamics 365, et la documentation de l’application décrit peut-être déjà le processus. En rassemblant tous les processus métier ici dans le guide, nous espérons fournir un point d’entrée unique avec des liens vers des contenus spécifiques à un produit pertinent.

  4. Scénarios

    Dans Dynamics 365, les scénarios sont des schémas de configurations répétables qui prennent en charge un processus métier spécifique. Ils incluent les cas d’usage, scénarios et industries les plus courants. Souvent, il existe de nombreuses façons de mettre en œuvre Dynamics 365 pour répondre aux besoins de votre entreprise. Notre objectif avec les patterns 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 métier qui utilise un formulaire, une page ou un élément d’interface utilisateur spécifique dans Dynamics 365.

  6. Cas tests

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 garantir que le logiciel répond à ses exigences et fonctionne comme prévu. Les cas de test servent à identifier les défauts, à garantir 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 modifiez pas le texte qui n’est pas surligné en jaune et qui n’est pas formaté en rouge. Ces phrases standard 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 complémentaire au catalogue des processus métier sur le guide About the business process guide. En option, consultez les TechTalks où nous expliquons comment utiliser le catalogue des processus métier et contribuer à la bibliothèque de contenu.

Soumettez votre contribution

En interne chez Microsoft, nous travaillons dur pour convertir les notes internes, les années d’expérience et divers documents en guides sur les processus métier. 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 le type d’article auquel le modèle est destiné.

Reconnaissance des contributeurs

La plateforme Microsoft Learn affiche en haut de chaque article les contributeurs internes et externes s’ils ont soumis leur contribution via GitHub. Certaines personnes contribuent d’autres manières, c’est pourquoi 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’une section exemple de contributeurs, montrant l’auteur principal plus trois contributeurs listé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 inscrit comme contributeur de cette manière 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 modèles de conception, par d’autres moyens que GitHub.

  • Last updated on