Hozzájárulás a Dynamics 365 dokumentációjához
A Microsoft Dynamics 365 dokumentációjához kétféleképpen járulhat hozzá. Ha egy cikk helytelen vagy megtévesztő információkat tartalmaz, vagy ha ismer egy jó alternatív megoldást egy ismétlődő problémára, tudassa velünk a cikkben található visszajelzés hivatkozást használva.
A dokumentáció nagy része esetében közvetlenül is szerkeszthet egy cikket, hogy elindítsa az áttekintési folyamatot.
Visszajelzés küldése
A learn.microsoft.com webhelyen minden egyes Learn cikk lehetőséget nyújt visszajelzés küldésére. Kiválaszthatja a jobb felső részen található cikk címe alatti Visszajelzés szakaszt vagy a cikk alján található visszajelzés lehetőségek valamelyikében kiválaszthatja a Visszajelzés szakaszt. Értékelheti a cikket, kiválaszthatja a visszajelzés okát, és megjegyzést is fűzhet hozzá. A visszajelzés a cikk szerzőjéhez és a dokumentumokat birtokló csapathoz érkezik.
Ha egy cikket nem lehet közvetlenül szerkeszteni, vagy ha nem szeretné azt saját maga szerkeszteni, javasoljuk, hogy használja a visszajelzési mechanizmust, így elmondhatja nekünk véleményét a cikkel vagy a termékkel kapcsolatosan.
Külső hozzájárulások a Microsoft-dokumentációhoz
Az alaptartalmunk forrásfájljait nyilvános GitHub-tárházakban tároljuk. Ezeket bárki véleményezheti, és – sok esetben – szerkesztheti is. Szívesen várjuk a javaslatokat és a javításokat, akár közvetlen hozzájárulás formájában, vagy GitHub-problémaként is jelenthet hibát, vagy feltehet kérdéseket. A forrástartalomra vonatkozó visszajelzéseket és észrevételeket csak angol nyelven tudjuk fogadni.
A legtöbb cikknél megjelenik egy Ceruza ikon a Dokumentum szerkesztése elemleírással. Az ikon kiválasztásával megnyithatja a cikket a GitHubban, és el is kezdheti a szerkesztést. Tegye meg az első lépéseket közreműködőként a Microsoft Learn közreműködői útmutatóval.
Ha alapos ismeretekkel rendelkezik, és szeretne új elméleti cikkekkel hozzájárulni tartalmainkhoz, használja a https://github.com/MicrosoftDocs/dynamics365-docs-templates oldalon található sablonokat.
Dynamics 365 útmutató tartalom
A Dynamics 365 útmutató tartalma ugyanazokat a folyamatokat használja, mint a Microsoft Learn legtöbb dokumentációja. Ebben a részben olyan eszközökről és folyamatokról számolunk be, amelyek kiegészítőül szolgálhatnak a megvalósítási útmutatóhoz.
Az útmutató tartalom a Dynamics 365 implementációs útmutató, az üzleti folyamatok leírásai, az új minták, az ajánlott eljárások és a hivatkozási architektúrák témaköreivel foglalkozik. Az első útmutató tartalmat 2023 áprilisában jelentettük meg, és kéthetente frissítjük a tartalmat. Böngésszen az útmutatóközpontban, és tudassa velünk, hogy mi az, ami elnyerte a tetszését, és mi az, ami még hiányzik.
Az útmutató tartalom egy részét belső közreműködők biztosítják. Bátorítjuk a téma szakértőit az egész közösségben, hogy segítsenek az ajánlott eljárások kialakításában. Olvasson tovább, ha van olyan ajánlott eljárása vagy más meglátása, amelyről úgy gondolja, hogy a Microsoft Learn részét kellene képeznie.
Miért érdemes közreműködni?
Úgy gondoljuk, hogy az útmutató tartalom segít a Dynamics 365 megvalósítási projektjeinek gyorsabb futtatásában. Partnereink és ügyfeleink az útmutatást használva felkészülhetnek a bevezetésre, illetve elmélyíthetik tudásukat az új területeken, az új személyzet ismereteit. A szoftverfejlesztők platformként használhatják útmutatónk tartalmát, hogy így népszerűsítsék szellemi tulajdonukat vagy iparági szaktudásukat.
A Microsoft azonban nem az egyetlen szakértő a Dynamics 365 megoldásainak megvalósításában. A közösség számos olyan taggal rendelkezik, akik a megvalósítások különféle aspektusainak szakértői. Van olyan mintája, ajánlott eljárása, konfigurációja vagy esetleg integrációs architektúrája, amely számos megvalósításban jól működik? Fontolja meg annak megosztását a Microsoft Learn felületén, hogy az egész közösség még produktívabb és hatékonyabb lehessen a megvalósítási projektjeikben.
Reményeink szerint a későbbiekben a közreműködésért jutalmakat vagy egyéb elismeréseket is fel tudunk majd ajánlani. 2023-ban elismerjük a cikkek közreműködőinek munkáját.
A közreműködés módja
2023 novemberétől a Microsoft Dynamics 365 útmutató tartalmának forrásfájljait megtalálhatja a nyilvános GitHub adattárban. A cikkeket a learn.microsoft.com/dynamics365/guidance webhelyen is szerkesztheti a Microsoft Learn közreműködői útmutatóban leírtak szerint.
Javasoljuk, hogy ugyanúgy küldje be javításait, ahogyan a Microsoft Learn más területeihez küld javítást. Az új tartalom beküldéséhez arra kérjük azonban, hogy az új útmutató tartalomhoz kapcsolódó Markdown-fájlokat töltse fel egy másik, Dynamics 365 minták és ajánlott eljárások nevű adattárba. Ezzel biztosíthatjuk, hogy referenciaarchitektúráját vagy mintáját a témakör más szakértői is felülvizsgálják. Különböző sablonok közül választhat, és ha hozzá szeretne járulni az üzleti folyamat tartalmához, azt egy más folyamaton keresztül is megteheti.
Sablonok
A Microsoft a sablon típusától függően két helyen biztosít sablonokat:
A Markdown-sablonok az https://github.com/MicrosoftDocs/dynamics365-docs-templates adattárban vannak.
A docs-templates mappa tartalmazza az elméleti és navigációs cikkek sablonjait.
A /guidance-templates/ mappa sablonokat tartalmaz az architektúrákhoz, a megoldási ötletekhez és a mintákhoz. Ezek ugyanazok, amelyeket az egész Microsoft szintjén használunk, de Dynamics 365-specifikusak.
A Word- és PowerPoint-sablonok a Dynamics 365 minták és gyakorlatok adattárban találhatók.
A /templates/business-processes/ mappa tartalmazza az üzleti folyamatokhoz készült összes Word-sablont. Arra bíztatunk minden szakértőt, hogy segítsenek megírni ezeket nekünk. A mappa egy Excel-fájlt is tartalmaz, amelyben az általunk azonosított üzleti folyamatok aktuális listája szerepel. A lista idővel bővülni fog.
A /graphics/ mappa PowerPoint-fájlokat tartalmaz minden átfogó esethez, amelyekhez saját diagramokat is hozzá lehet adni.
Idővel további sablonokat és útmutatást fogunk majd hozzáadni. Javasoljuk, hogy kövesse az adattárakat, vagy mentse el azokat csillagozással, így értesítést kap, ha valami változás történik.
Ossza meg visszajelzését a Dynamics 365 minták és gyakorlatok adattárának https://github.com/microsoft/dynamics365patternspractices/discussions lapján.
Ha még nem rendelkezik GitHub-fiókkal, akkor tegye meg az első lépéseket a Microsoft Learn közreműködési útmutatóval.
Tipp
Böngésszen forrásfájljaink között az https://github.com/MicrosoftDocs/dynamics365-guidance adattárban. Tanulmányozza, hogyan strukturáljuk a különböző típusú cikkeket, hogy a cikkei ugyanazt a szerkezetet kövessék. Így a felülvizsgálati folyamat is gyorsabb ütemben zajlik.
Architektúrák
Szívesen vesszük az architektúrákkal kapcsolatos útmutatást, beleértve a megoldási ötleteket és a tervmintákat is. Ha van egy ajánlott eljárása vagy referencia megvalósítása, küldje be a javaslatot az Azure-csapatnak vagy nekünk a Dynamics 365-ben.
A Dynamics 365 architektúrákkal kapcsolatos útmutatás új cikkekkel való bővítéséhez kövesse ezeket a főbb lépéseket:
- Kérje le a megfelelő Markdown-sablonokat a GitHub dynamics365-docs-templates nevű adattár guidance-templates mappájából.
- Írja meg hozzájárulását.
- Küldje be cikkét lekéréses kérelemként mentett Markdown-fájlként a GitHub dynamics365patternspractices nevű adattárába. A
/submit-architecture/mappa készen áll a hozzájárulás fogadására.
A Microsoft ez után feldolgozza a cikket, és közzéteszi azt a Dynamics 365 útmutató dokumentációjának részeként.
Amennyiben a Microsoft által kiadott útmutatók tartalmának általános bemutatására kíváncsi, látogasson el az Azure Architecture Center webhelyére. A közreműködőknek készült útmutatót az Azure Architecture Center közreműködői oldalán találja.
A dynamics365-docs-templates nevű GitHub-adattár guidance-templates mappájában közzétett alábbi Markdown-sablonok architektúrákkal kapcsolatos útmutatást nyújtanak:
Általánosított architektúraminta: Az általánosított architektúraminta alaparchitektúraként működik, és számos helyzetben felhasználható általános megoldást kínál. Megoldási ötletek használatával például összeállítható egy architektúrával foglalkozó cikk, amely közelebbről is bemutat egy adott iparági vagy partneri megoldást, és hivatkozik az egyes megoldásötletekből származó architektúrára. A sablon az Azure Architecture útmutatósablonján alapul. Különféle típusú architektúrákhoz használható, köztük referenciaarchitektúrákhoz.
Megoldásötlet:A megoldásötletek a Dynamics 365-implementációk „kicsinyített” másaiként működő architektúrák. Ezek rövid áttekintést adnak a Dynamics 365 és az Azure szolgáltatásaival kiépített megoldásokról. Minden egyes megoldási javaslat a következő elemeket tartalmazza:
- Architektúra-diagram
- Adatfolyam
- Összetevők, azaz a használt szolgáltatások listája
- Közreműködői elismerések
- A következő lépésekre és a kapcsolódó erőforrásokra, például a kapcsolódó útmutatókra és architektúrákra mutató hivatkozások
Mintamegoldás: A mintamegoldások „közepes” volumenű architektúrákat tartalmazó munkaterhelés-példák. Végigvezetik az olvasókat a Dynamics 365-implementációkkal kapcsolatos konkrét problémák megoldásának tervezési folyamatán. A mintamegoldások valós ügyfélpéldákon alapuló, döntéstámogató útmutatást nyújtanak az architektúrákhoz. Céljuk az, hogy lerövidítsék az ügyfél tanulási folyamatát azzal, hogy megismertetik vele egy másik ügyfél hasonló területen szerzett tapasztalatait. Megtalálhatók bennük a Megoldásötlet sablon szakaszai, továbbá az alábbi szakaszok:
- Az alternatívák alatt, olyan helyettesítő szolgáltatásokat értünk, amelyek összekapcsolhatók az architektúrával
- A szempontok, egyfajta útmutatást jelentenek, amely bemutatja Success by Design-keretrendszerünket, és esetlegesen egy üzemelő példányt is tartalmaz
Tervminta: A Dynamics 365-tervminták az implementálás során fellépő konkrét nehézségekkel foglalkoznak, és egy adott forgatókönyvön vagy ajánlott eljáráson alapulnak. Ezzel a sablonnal rögzítheti az üzleti folyamat mintáját. Másik lehetőségként használja a Word-sablont a következő címen: dynamics365patternspractices/templates/business-processes.
Üzleti folyamatok támogatása
Az üzleti folyamat kifejezés egy előre meghatározott szervezeti cél elérése érdekében végzett strukturált, gyakran sorrendbe rendezett tevékenységekre vagy feladatokra utal. A kifejezés utalhat az üzleti cél felé vezető lépések összesített hatásaira is. Az üzleti folyamatok olyan megoldásokra vonatkoznak, amelyek tartalmazzák a Dynamics 365 szolgáltatást. Azt reméljük, hogy ez az új tartalomtípus olyan szerkezetet ad az ügyfelek és partnerek számára amely segít nekik abban, hogy jobban fel tudnak készülni a Dynamics 365 bevezetésére. Minden üzleti folyamat tartalmaz egy diagramot egy standard üzleti folyamatról. A dokumentum szakaszai felvázolják a konfigurációs lépéseket és az egyes lépésekhez használt adatentitásokat. Minden lépés a termékdokumentáció megfelelő lapjára mutató hivatkozásokat tartalmaz, és minden dokumentum tartalmaz a következő lépésekre és az ahhoz kapcsolódó erőforrásokra mutató hivatkozásokat, amelyek segítik az olvasót a tanulásban.
Az üzleti folyamatokat egy katalógusban strukturáljuk. Az üzletifolyamat-katalógus egy Excel-munkafüzet, amit a Microsoftnál az üzleti folyamat dokumentációján végzett munka rendszerezéséhez és fontossági sorrendjének meghatározásához használunk. A formátum Excel, hiszen ez megkönnyíti a bejegyzések rendezését és szűrését. Úgy gondoljuk hogy partnereink az Excel-munkafüzet segítségével rendszerezhetik onboarding-utazásokat, a megvalósítási projektjeiket és saját üzleti folyamataikat.
A katalógus legújabb verzióját a következő webhelyről töltheti le: https://aka.ms/BusinessProcessCatalog.
Megjegyzés
Ha közre szeretne működni az üzleti folyamatokban, regisztrálja a munkáját, mielőtt nekilátna, így kisebb a kockázata annak, hogy esetleg már valaki más is dolgozik ugyanazon az üzleti folyamaton. Munkája regisztrálásához küldjön be egy GitHub-problémát a következő címen: https://github.com/microsoft/dynamics365patternspractices/issues.
A katalógus tartalma
A katalógus négy tartalomszintet határoz meg:
Teljes körű folyamatok
15 teljes körű forgatókönyvet azonosítottunk. A forgatókönyveket üzleti, nem pedig szoftvertechnológiai szempontból írjuk le.
A bevezető cikk minden teljes körű folyamat esetében leírja, hogyan gondolkodunk az adott teljes körű folyamatról. Felsoroljuk a legfontosabb résztvevőket és azt, hogy a Dynamics 365 hogyan segíti a teljes folyamatot. Áttekintést – illetve egy üzleti folyamatot leíró ábrát – adunk arról is, hogy a teljes körű folyamat hogyan működik együtt más teljes körű folyamatokkal. A bevezető felsorolja a teljes körű folyamatot támogató megoldás megvalósításának előfeltételeit.
Az üzleti folyamatok területei
Mindegyik teljes körű forgatókönyv két vagy több üzleti folyamatterületet fed le. Ez a szint az üzleti folyamatok csoportosításának egy módja, amely megkönnyíti a keresést és a navigációt. A legtöbb esetben az üzleti folyamatterületeket a szervezetben fontosabb beosztási funkciók vagy részlegek választják el egymástól. A katalógus jelenleg több mint 90 üzletifolyamat-területet határoz meg.
Üzleti folyamatok
Az üzleti folyamat kifejezés egy előre meghatározott szervezeti cél elérése érdekében végzett strukturált, gyakran sorrendbe rendezett tevékenységekre vagy feladatokra utal. A kifejezés utalhat az üzleti cél felé vezető lépések összesített hatásaira is. Minden üzleti folyamat egy olyan funkciót vagy folyamatot ír le, amelyet a Dynamics 365 támogat. Eddig közel 700 üzleti folyamatot azonosítottunk. Egyes üzleti folyamatok egyetlen Dynamics 365-alkalmazásra vonatkoznak, és az adott alkalmazáshoz tartozó dokumentáció már tartalmazhatja a folyamat leírását. Bízunk benne, hogy az összes üzleti folyamatot magában foglaló útmutató segítségével támpontot tudunk nyújtani a vonatkozó termékspecifikus tartalomra mutató hivatkozásokkal.
Minták
A Dynamics 365-ben a minták olyan megismételhető konfigurációk, amelyek egy adott üzleti folyamatot támogatnak. A leggyakoribb használati eseteket, forgatókönyveket és ágazatokat tartalmazzák. A Dynamics 365 rendszert gyakran többféleképpen implementálhatja üzleti igényeinek kielégítése érdekében. A mintákkal az a célunk, hogy kiindulási alapot adjunk a megvalósításhoz. Több mint 2000 mintát azonosítottunk, és arra számítunk, hogy a minták száma idővel jelentősen növekedni fog.
Az üzleti folyamatok katalógusáról bővebben az Üzleti folyamatok útmutatója oldalon olvashat.
Küldje be hozzájárulását
A Microsofton belül keményen dolgozunk a belső feljegyzések, a több éves tapasztalat és a különféle dokumentumok üzleti folyamatokat bemutató útmutatásokká való átalakításán. Nagyon szívesen fogadjuk a közösség hozzájárulását.
A cikk típusa alapján különböző sablonok érhetők el a hozzájárulások benyújtásához. A közreműködőknek a megfelelő típusú cikkhez ki kell választaniuk a megfelelő sablont. A sablonok Word-fájlokként érhetők el és elmagyarázzák, hogy milyen típusú cikkre használható a sablon.
Közreműködők elismerése
A Microsoft Learn-platformon a cikkek elején feltüntetjük mind a belső, mind a külső közreműködőket, feltéve, hogy a GitHubon keresztül működtek közre. Minden személy más módon működik közre, ezért a cikk végéhez hozzáadunk egy Közreműködők szakaszt.
Az opcionális Közreműködők szakasz felsorolja azokat a fő közreműködőket a nevükkel és a LinkedIn-profiljukra vagy más profilra való hivatkozással együtt, ha megadtak ilyet. A következő képernyőkép egy Azure Architecture Center-cikkKözreműködők szakaszának anonimizált változata.
Markdownban ez a következőképpen néz ki:
## 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
A közreműködőként való feltüntetés ilyen módon nem kötelező. A Microsofton belül a Közreműködők szakasz használatát javasoljuk, ha külső közreműködők a GitHubon kívül, más módon küldenek be új tartalmat, például referenciaarchitektúrát vagy tervmintát.