Bijdragen leveren aan Dynamics 365-documentatie
U kunt op twee manieren bijdragen aan Microsoft-documentatie voor Dynamics 365. Als een artikel onjuiste of verwarrende informatie bevat, of als u een goede oplossing voor een terugkerend probleem weet, kunt u dit met de feedbackkoppeling in het artikel aan ons laten weten.
Bij de meeste van onze documentatie kunt u ook een artikel rechtstreeks bewerken om een controleproces te starten.
Feedback geven
Op de website learn.microsoft.com wordt u in elk Learn-artikel de kans geboden om feedback te geven. U kunt de actie Feedback onder de artikeltitel rechtsboven of een van de feedbackopties onder aan het artikel in de sectie Feedback kiezen. Geef het artikel een beoordeling, selecteer de reden voor uw feedback en laat desgewenst een opmerking achter. De feedback gaat naar de auteur van het artikel en het team dat eigenaar is van de documenten.
Als een artikel niet direct kan worden bewerkt of als u niet vertrouwd bent met het bewerken, raden we u aan het feedbackmechanisme te gebruiken om ons te laten weten wat u van het artikel of het product vindt.
Externe bijdragen aan de documentatie van Microsoft
De bronbestanden voor onze kerninhoud worden opgeslagen in openbare GitHub-opslagplaatsen. Iedereen kan deze beoordelen en, in veel gevallen, bewerken. Uw suggesties en correcties zijn van harte welkom, in de vorm van directe bijdragen of als GitHub-kwesties om een bug te melden of een vraag te stellen. We kunnen feedback en bijdragen aan de inhoud alleen in het Engels accepteren.
De meeste artikelen hebben een potloodpictogram met het knopinfo Dit document bewerken. Selecteer het pictogram om het artikel in GitHub te openen en begin vervolgens met bewerken. Ga aan de slag als inzender met de Microsoft Learn-guide voor inzenders.
Als u grondig wilt zijn en nieuwe conceptartikelen wilt bijdragen, gebruikt u de sjablonen op https://github.com/MicrosoftDocs/dynamics365-docs-templates.
Begeleidingsinhoud voor Dynamics 365
De inhoud van Dynamics 365-begeleiding gebruikt dezelfde processen als de meeste documentatie in Microsoft Learn. In deze sectie bespreken we hulpmiddelen en processen die u kunt gebruiken als aanvulling op de implementatierichtlijnen.
De term begeleidingsinhoud omvat de Dynamics 365-implementatieguide, beschrijvingen van bedrijfsprocessen, nieuwe patronen, best practices en referentiearchitecturen. De eerste begeleidingsinhoud werd in april 2023 door ons gepubliceerd en sinds die tijd voegen we elke twee weken updates toe. Blader door de begeleidingshub en laat ons weten wat goed is en wat ontbreekt.
Een deel van de begeleidingsinhoud wordt geleverd door interne inzenders. We moedigen materiedeskundigen in de hele community aan ons te helpen bij het vaststellen van best practices. Lees verder als u een best practice of ander inzicht hebt waarvan u denkt dat deze moet worden opgenomen in Microsoft Learn.
Waarom bijdragen leveren?
We zijn van mening dat de nieuwe begeleidingsinhoud helpt om Dynamics 365-implementatieprojecten sneller uit te voeren. Onze partners en klanten kunnen de richtlijnen gebruiken om de implementatie voor te bereiden en vaardigheden op nieuwe gebieden op te doen of nieuw personeel te trainen. Softwareontwikkelaars kunnen de inhoud gebruiken als platform voor de promotie van intellectuele eigendom of industrie-expertise.
Maar Microsoft is niet de enige die experts levert op het gebied van het implementeren van oplossingen met Dynamics 365. De community als geheel omvat mensen die expert zijn in diverse aspecten van implementatie. Hebt u een patroon, een best practice, een configuratie of een integratiearchitectuur die goed werkt in verschillende implementaties? Overweeg deze dan hier te delen op Microsoft Learn om de gehele community nog productiever en efficiënter te maken in hun implementatieprojecten.
We hopen uiteindelijk beloningen of andere vormen van erkenning voor bijdragen te kunnen aanbieden. In 2023 geven wij inzenders erkenning in de artikelen.
Bijdragen leveren
Vanaf november 2023 kunt u nu de bronbestanden voor de Dynamics 365-begeleidingsinhoud van Microsoft vinden in een openbare GitHub-opslagplaats. U kunt de artikelen op de site learn.microsoft.com/dynamics365/guidance ook bewerken, zoals beschreven in de Microsoft Learn-guide voor inzenders.
We adviseren u correcties op dezelfde wijze in te dienen als bij het indienen van een correctie voor andere gebieden van Microsoft Learn. Als u echter nieuwe inhoud wilt indienen, vragen wij u uw Markdown-bestanden voor nieuwe richtlijninhoud naar een andere opslagplaats te uploaden, namelijk Dynamics 365-patronen en -werkwijzen. Op deze manier kunnen we ervoor zorgen dat uw referentiearchitectuur of patroon wordt beoordeeld door andere vakexperts. Er zijn verschillende sjablonen waaruit u kunt kiezen en als u wilt bijdragen aan de inhoud over bedrijfsprocessen, komt u weer bij een geheel ander proces terecht.
Sjablonen
Microsoft levert sjablonen op twee locaties, afhankelijk van het type sjabloon:
Markdown-sjablonen bevinden zich in de https://github.com/MicrosoftDocs/dynamics365-docs-templates-opslagplaats.
De map docs-templates bevat sjablonen voor concept- en navigatieartikelen.
De map /guidance-templates/ bevat sjablonen voor architecturen, oplossingsideeën en patronen. Deze sjablonen zijn gelijk aan de sjablonen die in heel Microsoft worden gebruikt, maar zijn Dynamics 365-specifiek gemaakt.
Word- en PowerPoint-sjablonen zijn te vinden in de opslagplaats Dynamics 365-patronen en -werkwijzen.
De map /templates/business-processes bevat Word-sjablonen voor de artikelen over bedrijfsprocessen. We vragen alle experts om ons te helpen bij het schrijven. De map bevat ook een Excel-bestand met de lijst met bedrijfsprocessen die we hebben geïdentificeerd. De lijst zal in de loop van de tijd groeien.
De map /graphics/ bevat PowerPoint-bestanden voor elk end-to-end-scenario waaraan u uw eigen diagrammen kunt toevoegen.
We zullen meer sjablonen en begeleiding toevoegen. Het is raadzaam om de opslagplaatsen te volgen of ze op te slaan met een ster, zodat u een melding krijgt wanneer er iets verandert.
Deel uw feedback op het tabblad https://github.com/microsoft/dynamics365patternspractices/discussions in de opslagplaats Dynamics 365-patronen en -werkwijzen.
Als u nog geen GitHub-account hebt, gaat u aan de slag met de Microsoft Learn-guide voor inzenders.
Tip
Blader door onze bronbestanden in de https://github.com/MicrosoftDocs/dynamics365-guidance-opslagplaats. Leer van de manier waarop we de verschillende typen artikelen structureren, zodat uw artikelen dezelfde structuur volgen. Op die manier verloopt het beoordelingsproces sneller.
Architecturen
We ontvangen graag bijdragen met begeleiding voor architecturen, waaronder oplossings- en ontwerppatronen. Als u over een best practice of verwijzingsimplementatie beschikt, dient u uw voorstel in bij het Azure-team of bij ons in Dynamics 365.
Volg deze hoofdstappen om nieuwe artikelen bij te dragen aan de architectuurrichtlijnen voor Dynamics 365:
- Haal de desbetreffende Markdown-sjablonen op uit de map guidance-templates in de GitHub-opslagplaats dynamics365-docs-templates.
- Schrijf uw bijdrage.
- Dien uw artikelen in als Markdown-bestand in een pull-aanvraag in de opslagplaats dynamics365patternspractices. De map
/submit-architecture/
is klaar om uw bijdragen te ontvangen.
Microsoft verwerkt het artikel vervolgens en publiceert het als onderdeel van de Dynamics 365-begeleidingsdocumentatie.
Zie het Azure Architecture Center voor een algemene inleiding in de richtlijnen van Microsoft. Zie Bijdragen van het Azure Architecture Center voor de guide voor inzenders.
De GitHub-opslagplaats dynamics365-docs-templates bevat de volgende Markdown-sjablonen voor architectuuradvies in de map guidance-templates:
Algemeen architectuurpatroon: een algemeen architectuurpatroon fungeert als een basisarchitectuur met een veelgebruikte oplossing die op veel scenario's van toepassing is. Met oplossingsideeën kan bijvoorbeeld een architectuurartikel worden opgebouwd die als lens voor een specifieke bedrijfstak of partneroplossing kan worden gebruikt en kan vanuit elk oplossingsidee een koppeling tot stand worden gebracht met de architectuur. De sjabloon is gebaseerd op de sjabloon voor Azure-architectuurguide. Gebruik deze voor verschillende typen architectuur, waaronder verwijzingsarchitecturen.
Oplossingsidee: oplossingsideeën zijn 'kleine' architecturen van Dynamics 365-implementaties. Zij bieden korte overzichten van oplossingen met Dynamics 365 en Azure-services. Elk oplossingsidee bevat de volgende elementen:
- Een architectuurdiagram
- Een gegevensstroom
- Onderdelen, dat wil zeggen een lijst met de gebruikte services
- Credits voor inzenders
- Koppelingen naar volgende stappen en gerelateerde resources, zoals verwante guides en architecturen
Voorbeeldoplossing: voorbeeldoplossingen zijn voorbeelden van workloads met 'medium' architecturen. Zij helpen lezers bij het proces voor het ontwerpen van oplossingen voor specifieke problemen in Dynamics 365-implementaties. Voorbeeldoplossingen bieden bruikbare architectuurbegeleiding op basis van echte klantvoorbeelden. Het doel is om de leercurve van klanten te verkorten door ze het verhaal van een andere klant te vertellen die eerder deze beleving heeft gehad. Deze bevatten de secties van de sjabloon Oplossingsidee en voegen de volgende secties toe:
- Alternatieve, andere services die u in plaats daarvan in de architectuur kunt opnemen
- Overwegingen, richtlijnen die bij ons Success by Design-framework passen en, optioneel, een implementatie omvatten
Ontwerppatroon: ontwerppatronen van Dynamics 365 gaan in op specifieke implementaties en zijn gebaseerd op een bepaald scenario of een bepaalde best practice. Met deze sjabloon kunt u een bedrijfsprocespatroon vastleggen. U kunt ook gebruikmaken van de Word-sjabloon onder dynamics365patternspractices/templates/business-processes.
Bijdragen aan bedrijfsprocessen
De term bedrijfsproces omvat een groot aantal gestructureerde, vaak op volgorde uitgevoerde, activiteiten of taken om een vooraf bepaalde organisatiedoel te bereiken. De term kan ook verwijzen naar de cumulatieve effecten van alle stappen die worden uitgevoerd op weg naar het realiseren van een bedrijfsdoel. Bedrijfsprocessen zijn specifiek voor oplossingen die Dynamics 365 bevatten. We denken dat dit nieuwe inhoudstype een structuur waarmee klanten en partners beter gebruik kunnen maken van Dynamics 365 en beter voorbereid zullen zijn op het invoeren hiervan. Elk bedrijfsproces bevat een diagram van een standaardbedrijfsprocesstroom. Secties van het document bevatten de configuratiestappen en de gegevensentiteiten die in elk hiervan worden gebruikt. Elke stap bevat koppelingen naar de relevante pagina in de productdocumentatie en alle documenten bevatten koppelingen naar volgende stappen en gerelateerde resources om lezers te helpen in het leertraject.
De bedrijfsprocessen zijn opgenomen in een catalogus. De catalogus met bedrijfsprocessen is een Excel-werkmap die door Microsoft wordt gebruikt voor het organiseren en prioriteren van het werk aan de documentatie voor bedrijfsprocessen. Dankzij de Excel-indeling kunt u deze items eenvoudig sorteren en filteren. Onze partners kunnen de Excel-werkmap ook gebruiken om hun onboardingstrajecten, implementatieprojecten en eigen bedrijfsprocessen te organiseren.
Download de meest recente versie van de catalogus van https://aka.ms/BusinessProcessCatalog.
Opmerking
Als u een bijdrage wilt leveren aan de bedrijfsprocessen, registreert u uw werk voordat u begint om het risico te verkleinen dat iemand anders aan hetzelfde bedrijfsproces werkt. U kunt uw werk registreren door een GitHub-kwestie in te dienen op https://github.com/microsoft/dynamics365patternspractices/issues.
De inhoud van de catalogus
De catalogus definieert vier inhoudsniveaus:
End-to-end-processen
Er zijn 15 end-to-end-scenario's gevonden. We beschrijven de scenario's in bedrijfstermen, niet in termen van softwaretechnologie.
In het introductieartikel wordt voor elk end-to-end-proces beschreven hoe we over het end-to-end-proces denken. We geven een overzicht van de meest relevante belanghebbenden en de manier waarop Dynamics 365 helpt bij het uitvoeren van het end-to-end-proces. Wij geven ook een overzicht, compleet met stroomdiagram van het bedrijfsproces, van de interactie tussen dit end-to-end-proces en andere end-to-end-processen. In de inleiding worden de vereisten vermeld voor het implementeren van een oplossing ter ondersteuning van het end-to-end-proces.
Bedrijfsprocesgebieden
Elk end-to-end-scenario beslaat twee of meer bedrijfsprocesgebieden. Dit niveau is slechts een manier om de bedrijfsprocessen te groeperen om het zoeken en navigeren te vergemakkeijken. In de meeste gevallen worden de bedrijfsprocesgebieden gescheiden door hoofdtaken of afdelingen in een organisatie. Momenteel worden in de catalogus meer dan 90 bedrijfsprocesgebieden definieert.
Bedrijfsprocessen
De term bedrijfsproces omvat een groot aantal gestructureerde, vaak op volgorde uitgevoerde, activiteiten of taken om een vooraf bepaalde organisatiedoel te bereiken. De term kan ook verwijzen naar de cumulatieve effecten van alle stappen die worden uitgevoerd op weg naar het realiseren van een bedrijfsdoel. Elk bedrijfsproces omschrijft een functie of proces dat door Dynamics 365 wordt ondersteund. Tot nu toe hebben we bijna 700 bedrijfsprocessen geïdentificeerd. Sommige zijn van toepassing op een enkele Dynamics 365-app, waarbij het proces mogelijk al wordt beschreven in de documentatie voor de app. Door alle bedrijfsprocessen in de guide te verzamelen, bieden we een enkel invoerpunt met koppelingen naar relevante productspecifieke inhoud.
Patronen
In Dynamics 365 zijn patronen herhaalbare configuraties die een specifiek bedrijfsproces ondersteunen. Zij omvatten de meest algemene gebruiksgevallen, scenario's en bedrijfstakken. Vaak zijn er tal van manieren om Dynamics 365 te implementeren om aan uw zakelijke vereisten te voldoen. Met patronen willen we een basis bieden voor uw implementatie. We hebben meer dan 2000 patronen geïdentificeerd en verwachten dat dit aantal na verloop van tijd aanzienlijk zal groeien.
Meer informatie over de catalogus van het bedrijfsproces kunt u vinden in De guide voor bedrijfsprocessen.
Uw bijdrage indienen
Intern bij Microsoft werken we er hard aan om interne notities, jaren ervaring en verschillende documenten om te zetten in begeleidingsinhoud voor bedrijfsprocessen. We ontvangen graag bijdragen vanuit de community.
De GitHub-opslagplaats bevat Word-sjablonen die u kunt gebruiken om uw bijdrage vast te leggen. Alle Word-sjablonen bevinden zich in de map /templates/business-processes. De map bevat ook een PowerPoint-sjabloon die u kan helpen bij het ontwerpen van de diagrammen die u nodig hebt. U kunt ook Visio of een andere ontwerper gebruiken.
Sjabloon voor end-to-end-bedrijfsproces: https://aka.ms/E2ETemplate
Sjabloon voor bedrijfsprocesgebied: https://aka.ms/BizProcessAreaTemplate
Bedrijfsprocessjabloon: https://aka.ms/BizProcessTemplate
Patroon- of praktijksjabloon: https://aka.ms/PatternPracticeTemplate
Sjabloon voor PowerPoint-afbeelding: https://aka.ms/BizProcessPPTTemplate
Wanneer u gereed bent om een nieuw artikel in te dienen, vult u ons indieningsformulier in en voegt u uw bestand of bestanden toe.
Voeg eventueel uw LinkedIn-profiel toe, zodat u kunt worden weergegeven als de oorspronkelijke auteur.
Vermelding van inzenders
Het Microsoft Learn-platform toont zowel interne als externe inzenders boven aan elk artikel als zij hun bijdrage hebben ingediend via GitHub. Sommige inzenders leveren op een andere manier een bijdrage, dus voegen we aan het einde van het artikel een sectie Inzenders toe.
In de optionele sectie Inzenders worden de belangrijkste inzenders vermeld met hun naam en een koppeling naar hun LinkedIn-profiel of een ander profiel, als zij deze hebben verstrekt. De volgende schermopname is een geanonimiseerde versie van de sectie Inzenders in een artikel over het Azure-architectuurcentrum.
Hieronder ziet u hoe het er in Markdown uitziet:
## 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
De vermelding als inzender is optioneel. Binnen Microsoft is het raadzaam de sectie Inzenders te gebruiken als externe inzenders nieuwe inhoud indienen. zoals verwijzingsarchitecturen en ontwerppatronen, via andere middelen dan GitHub.