Partager via

Contribuer à la documentation Dynamics 365

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

Pour la plupart de notre documentation, vous pouvez également modifier un article directement pour démarrer un processus de révision.

Fournir des commentaires

Sur le site web learn.microsoft.com , chaque article Learn vous offre la possibilité de fournir des commentaires. Vous pouvez choisir l’action Commentaires qui se trouve sous le titre de l’article en haut à droite ou l’une des options de commentaires en bas de l’article dans la section Commentaires . Donnez à l’article une évaluation, sélectionnez la raison de vos commentaires et envisagez de laisser un commentaire. Les commentaires sont dirigés vers l’auteur de l’article et l’équipe propriétaire de la documentation.

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 GitHub publics. Tout le monde peut les examiner et, dans de nombreux cas, les modifier. Nous accueillons vos suggestions et corrections, soit sous la forme de contributions directes, soit sous forme de problèmes sur GitHub pour signaler un bogue ou poser une question. Nous ne pouvons accepter que des commentaires et des contributions au contenu source en anglais.

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

Si vous souhaitez obtenir des articles conceptuels approfondis et contribuer, utilisez les modèles à l’adresse https://github.com/MicrosoftDocs/dynamics365-docs-templates.

Contenu des conseils Dynamics 365

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

Le terme contenu d'orientation comprend le guide de mise en œuvre de Dynamics 365, les descriptions des processus métier, les nouveaux modèles, les meilleures pratiques et les architectures de référence. Nous avons publié le premier contenu d’aide en avril 2023 et nous ajoutons des mises à jour toutes les deux semaines. Parcourez le hub d’aide et faites-nous savoir ce qui est génial et ce qui manque.

Certains contenus de conseils sont fournis par les contributeurs internes. Nous encourageons les experts de la communauté à nous aider à établir des meilleures pratiques. Lisez si vous avez une bonne pratique ou d’autres idées que vous pensez devraient faire partie de Microsoft Learn.

Pourquoi contribuer ?

Nous pensons que le contenu des conseils aide à accélérer l’exécution des projets d’implémentation Dynamics 365. Nos partenaires et nos clients peuvent utiliser les conseils pour préparer l’implémentation et pour acquérir des compétences dans de nouveaux domaines ou pour acquérir de nouvelles compétences en personnel. Les développeurs de logiciels peuvent utiliser le contenu comme plateforme pour promouvoir leur propriété intellectuelle ou leur expertise industrielle.

Mais nous ne sommes pas les seuls experts sur la façon d’implémenter des solutions avec Dynamics 365. La communauté comprend des personnes qui sont des experts à différents aspects de la mise en œuvre. Avez-vous un modèle, une bonne pratique, une configuration ou une architecture d’intégration qui fonctionne bien dans plusieurs implémentations ? Envisagez de le partager ici sur Microsoft Learn pour rendre l’ensemble de la communauté encore plus productive et efficace dans leurs projets d’implémentation.

Nous espérons pouvoir offrir des récompenses ou d’autres accusés de réception 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 du contributeur .

Comment contribuer

Vous trouverez les fichiers sources pour le contenu des conseils Dynamics 365 de Microsoft dans un dépôt GitHub public. Vous pouvez également modifier les articles sur le 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 façon que vous envoyez une correction à d’autres domaines de Microsoft Learn. Toutefois, pour envoyer un nouveau contenu, nous vous demandons de charger vos fichiers Markdown pour obtenir de nouveaux contenus d’aide dans un autre dépôt, Dynamics 365 Patterns and Practices. Ainsi, nous pouvons nous assurer que votre architecture de référence ou votre modèle est examiné par d’autres experts en matière. Il existe différents modèles à choisir et, si vous souhaitez contribuer au contenu du processus métier, il existe un processus différent.

Modèles

Microsoft fournit des modèles à deux emplacements, en fonction du type de modèle :

Nous allons ajouter d’autres modèles et conseils au fil du temps. Nous vous recommandons de suivre les dépôts ou de les enregistrer avec une étoile afin que vous soyez averti lorsque quelque chose change.

Partagez vos commentaires sous l’onglet https://github.com/microsoft/dynamics365patternspractices/discussions dans le référentiel Dynamics 365 Patterns and Practices.

Si vous n’avez pas encore de compte GitHub, commencez à utiliser le guide du contributeur Microsoft Learn.

Conseil / Astuce

Parcourez nos fichiers sources dans le https://github.com/MicrosoftDocs/dynamics365-guidance référentiel. Découvrez comment nous structurerons les différents types d’articles afin que vos articles suivent la même structure. Ainsi, le processus de révision s’exécute plus rapidement.

Architectures

Nous accueillons les contributions des conseils architecturaux, y compris les idées de solution et les modèles de conception. Si vous avez une meilleure pratique ou une implémentation de référence, envoyez votre proposition à l’équipe Azure ou à nous dans Dynamics 365.

Pour contribuer de nouveaux articles au guide d'architecture Dynamics 365, procédez comme suit :

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

Pour obtenir une présentation générale du contenu des conseils sur Microsoft, consultez le Centre d’architecture Azure. Pour obtenir le guide du contributeur, consultez les contributions du Centre d’architecture Azure.

Le référentiel GitHub dynamics365-docs-templates contient les modèles Markdown suivants pour obtenir des 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 solution peuvent s'appuyer sur un article architectural pour offrir une perspective pour un secteur particulier ou une solution partenaire, et se lier à l'architecture à partir de chaque idée de solution. Le modèle est basé sur le modèle du 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 des architectures « petites » des implémentations Dynamics 365. Ils fournissent de brèves présentations des solutions avec les services Dynamics 365 et Azure. Chaque idée de solution contient les éléments suivants :

    • Diagramme d’architecture
    • Un flux de données
    • Composants, ce qui signifie une liste des services utilisés
    • Crédits contributeurs
    • Liens vers les étapes suivantes et les ressources associées, telles que les guides connexes et les architectures

  • 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 Dynamics 365. Les exemples de solutions fournissent des conseils d’architecture actionnables basés sur des exemples de clients réels. L’objectif est de raccourcir la courbe d’apprentissage des clients en leur racontant l’histoire d’un autre client qui avait le même parcours. Ils incluent les sections du modèle Idée de solution et ajoutent les sections suivantes :

    • Alternatives, autres services que vous pouvez connecter à l’architecture à la place
    • Considérations, conseils qui correspondent à notre cadre Success by Design et, éventuellement, 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 spécifique ou une meilleure pratique. Utilisez ce modèle pour capturer un modèle de processus métier. Vous pouvez également utiliser le modèle Word sur dynamics365patternspractices/templates/business-process.

Contributions aux processus métier

Le terme processus métier couvre un large éventail d’activités structurées, souvent séquencées, d’activités ou de tâches pour atteindre un objectif organisationnel prédéterminé. Le terme peut également faire référence aux effets cumulatifs de toutes les étapes qui progressent 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 à être mieux préparés à adopter Dynamics 365. Chaque processus métier comprend un diagramme d’un flux de processus métier standard. Sections des étapes de configuration hiérarchique du document et des entités de données utilisées dans chacune d’elles. Chaque étape est liée à la page correspondante dans la documentation du produit, et tous les documents ont des liens vers les étapes suivantes et les ressources associées pour aider les lecteurs à suivre leur parcours d’apprentissage.

Nous avons structuré les processus métier 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 du 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 d’implémentation et leurs propres processus métier.

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

Note

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

Contenu du 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 métier. Nous avons identifié 15 scénarios de bout en bout. Nous décrivons les scénarios en termes métier, pas en termes de technologie logicielle.

    Pour chaque processus de bout en bout, l’article d’introduction décrit comment nous pensons au processus de bout en bout. Nous listons les principales parties prenantes et la façon dont Dynamics 365 aide le processus de bout en bout. Nous fournissons également une vue d’ensemble, ainsi qu’un diagramme de flux de processus métier, 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 conditions préalables à l’implémentation d’une solution pour prendre en charge le processus de bout en bout.

  2. Domaines de processus métier

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

  3. Processus d’entreprise

    Le terme processus métier couvre un large éventail d’activités structurées, souvent séquencées, d’activités ou de tâches pour atteindre un objectif organisationnel prédéterminé. Le terme peut également faire référence aux effets cumulatifs de toutes les étapes qui progressent 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 métier. Certaines s’appliquent à une application Dynamics 365 unique, et la documentation de l’application peut déjà décrire le processus. En collectant tous les processus métier ici dans le guide, nous espérons fournir un point d’entrée unique avec des liens vers du contenu spécifique au produit pertinent.

  4. Scénarios

    Dans Dynamics 365, les scénarios sont des modèles de configurations reproductibles qui prennent en charge un processus métier spécifique. Ils incluent les cas d’usage les plus courants, les scénarios et les industries. Souvent, il existe de nombreuses façons d’implémenter Dynamics 365 pour répondre à vos besoins métier. Notre objectif avec des modèles est de fournir une base de référence pour votre implémentation. Nous avons identifié plus de 3 000 scénarios et modèles, et nous nous attendons à ce que ce nombre augmente au fil du 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 de test

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

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

Découvrez plus en détail le catalogue de processus métier dans le guide Sur le processus métier. Si vous le souhaitez, passez en revue TechTalks où nous parlons de la façon dont vous pouvez utiliser le catalogue de processus métier et contribuer à la bibliothèque de contenu.

Soumettre votre contribution

En interne chez Microsoft, nous travaillons dur pour convertir des notes internes, des années d’expérience et divers documents en conseils sur les processus métier. Nous nous réjouissons beaucoup des 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 modèle approprié 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 pour lequel le modèle est destiné.

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 contribuent d’autres façons, nous ajoutons donc une section Contributeurs vers la fin de l’article.

La section Contributeurs facultatifs répertorie les contributeurs clés avec leur nom et un lien vers leur LinkedIn ou un autre profil s’ils en ont fourni un. La capture d’écran suivante est une version anonymisée de la section Contributeurs dans un article du Centre d’architecture 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 ressemble 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

L’obtention de la liste en tant que contributeur de cette façon est facultative. Dans Microsoft, nous vous recommandons d’utiliser la section Contributeurs si des contributeurs externes soumettent de nouveaux contenus, tels que des architectures de référence et des modèles de conception, par le biais d’autres moyens que GitHub.

  • Last updated on