Contribuer à la documentation de Dynamics 365

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. Commencez comme contributeur avec le guide Microsoft Learn pour contributeur.

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

Contenu d’orientation de Dynamics 365

Le contenu des directives Dynamics 365 utilise les mêmes processus que la plupart des documents sur 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. 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 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 de mise en œuvre 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 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. En savoir plus dans 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 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à de compte GitHub, commencez avec le guide des contributeurs Microsoft Learn.

Astuce

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 d’orientation de Microsoft, consultez le Centre des architectures Azure. Pour le guide du contributeur, consultez le Contributions du 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, directives qui correspondent à notre cadre Success by Design et, optionnellement, incluent 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 métier 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 métier comprend un diagramme d’un flux de processus métier 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 métier est un classeur Excel que nous utilisons chez Microsoft pour organiser et hiérarchiser notre travail sur la documentation des processus métier. 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 d’entreprise, enregistrez votre travail avant de commencer afin de réduire le risque que quelqu’un d’autre travaille sur le même processus d’entreprise. Pour enregistrer votre travail, soumettez un problème à 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 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 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 de processus d’entreprise sont séparés par des fonctions ou départements principaux dans une organisation. Actuellement, le catalogue définit plus de 100 domaines de processus d’affaires.

  3. Processus métier

    L’expression processus métier 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é plus de 800 processus d’affaires. 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. Scénarios

    Dans Dynamics 365, les scénarios sont des motifs de configurations répétables qui supportent un processus d’affaires 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 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.

Pour obtenir une présentation plus détaillée du catalogue des processus métier, accédez à À propos du guide des processus métier. É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.

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é.

Il existe différents modèles pour soumettre des contributions en fonction du 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 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 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 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.

  • Last updated on