Dynamics 365 のドキュメントに投稿する
Dynamics 365 に関する Microsoft のコンテンツを改善する方法は 2 つあります。 不正確または分かりにくい情報が記事に含まれている場合、または繰り返し発生する問題に対する適切な回避策をご存知の場合は、記事内のフィードバック リンクから Microsoft に通知できます。
また、ほとんどのドキュメントでは、記事を直接編集して確認プロセスを開始できます。
フィードバックを提供する
Web サイト learn.microsoft.com に掲載されたそれぞれの学習記事では、フィードバックを提供することができます。 右上の記事タイトルの下に表示されたフィードバック アクション、または記事の下部のフィードバック セクションにあるフィードバック オプションの 1 つを選択できます。 記事を評価して、そのフィードバックの理由を選択し、必要に応じてコメントを残すことができます。 寄せられたフィードバックは、その記事の著者とドキュメントを所有するチームに送信されます。
記事を直接編集できない場合や、自分で編集したくない場合は、フィードバック メカニズムを使用して、その記事や製品に関するご意見をぜひお寄せください。
Microsoft のドキュメントへの外部からの投稿
コア コンテンツのソース ファイルは、GitHub の公開リポジトリに格納されています。 これらは誰でもレビューでき、多くの場合編集もできます。 直接訂正する方法や、GitHub の問題としてバグの報告や質問を行う方法で、ご提案や訂正をぜひお寄せください。 フィードバックと訂正を受け付けているのは、英語のソース コンテンツのみです。
ほとんどの記事には、ヒント このドキュメントを編集する が付いた鉛筆のアイコンが表示されます。このアイコンを選択して GitHub で記事を開き、編集を開始します。 Microsoft Learn 投稿者ガイドを利用して、投稿者として活動を開始しましょう。
完了して新しい概念の記事に貢献する場合は、https://github.com/MicrosoftDocs/dynamics365-docs-templates のテンプレートを使用してください。
Dynamics 365 ガイダンスのコンテンツ
Dynamics 365 ガイダンスのコンテンツは、Microsoft Learn のほとんどのドキュメントと同じプロセスを使用します。 このセクションでは、実装ガイダンスに追加する際に役立つツールとプロセスについて説明します。
このガイダンス コンテンツでは、Dynamics 365 実装ガイド、ビジネス プロセスの説明、新しいパターン、ベスト プラクティス、参照アーキテクチャについて説明します。 2023 年 4 月に最初のガイダンス コンテンツを公開し、2 週間ごとに最新情報を追加しています。 ガイダンス ハブを参照して、優れた点や足りない情報を報告してください。
一部のガイダンス コンテンツは、内部の投稿者によって提供されます。 ベスト プラクティスの確立を支援するために、コミュニティ全体で対象分野の専門家を推薦します。 ベスト プラクティスをご存知の場合や、他のインサイトを Microsoft Learn に含めるべきとお考えの場合は、このまま読み進めてください。
投稿する理由
ガイダンス コンテンツを利用することで、Dynamics 365 実装プロジェクトを加速できると、当社は考えています。 当社のパートナーと顧客は、このガイダンスを活用して実装準備を整えて、新しい分野のスキル獲得や、新規導入者のスキル向上を実現できます。 ソフトウェア開発者は、知的財産や業界の専門知識をアピールするプラットフォームとして、このコンテンツを利用できます。
しかし、Dynamics 365 を使用したソリューションの実装方法に関するエキスパートは Microsoft だけではありません。 コミュニティには、実装のさまざまな段階に精通したエキスパートが参加しています。 いくつかの実装で機能するパターン、ベスト プラクティス、コンフィギュレーション、または統合アーキテクチャがありますか。 実装プロジェクトの生産性と効率をコミュニティ全体でさらに高めるために、それを Microsoft Learn で共有することをご検討ください。
最終的には、貢献に対して謝礼や、その他の謝辞を授与できるようにしたいと考えています。 2023 年には記事の投稿者を表彰します。
投稿する方法
2023 年 11 月以降、Microsoft が用意した Dynamics 365 ガイダンス コンテンツのソース ファイルを、GitHub の公開リポジトリ から利用できます。 また、Microsoft Learn 投稿者ガイド で説明されているとおり、learn.microsoft.com/dynamics365/guidance サイトでも記事を編集できます。
訂正 を送信する際は、Microsoft Learn の他の領域に訂正を送信する場合と同じ方法を推奨します。 ただし、新しいコンテンツを送信する際は、新しいガイダンス コンテンツの Markdown ファイルを、別のリポジトリである Dynamics 365 のパターンとプラクティス にアップロードしてください。 この方法により、その主題に詳しい他のエキスパートによって、あなたの参照アーキテクチャやパターンが確実にレビューされます。 さまざまなテンプレートを選択でき、ビジネス プロセスのコンテンツに貢献する場合は、まったく別のプロセスが用意されています。
テンプレート
Microsoft は、テンプレートを以下のように種類分けして 2 つの場所で提供しています。
Markdown 形式のテンプレートは、https://github.com/MicrosoftDocs/dynamics365-docs-templates リポジトリにあります。
docs-templates フォルダーには、概念や操作方法を記載する記事用のテンプレートが含まれています。
/guidance-templates/ フォルダーには、アーキテクチャ、ソリューションのアイデア、パターンのテンプレートが含まれています。 これらは Microsoft 全体で使用しているテンプレートと同じですが、Dynamics 365 に特化して作成されています。
Word と PowerPoint のテンプレートは Dynamics 365 のパターンとプラクティス リポジトリにあります。
/templates/business-processes/ フォルダーには、ビジネス プロセス記事の Word テンプレートが含まれています。 すべての主題のエキスパートは、ぜひ執筆にご協力ください。 また、このフォルダーには、特定したビジネス プロセスのリストが記載された Excel ファイルも含まれています。 このリストは今後も継続的に充実させていきます。
/graphics/ フォルダーには、各エンドツーエンド シナリオの PowerPoint ファイルが含まれており、ここに独自の図を追加できます。
今後もテンプレートやガイダンスを追加する予定です。 リポジトリをフォローするか、またはスターを付けて保存し、変更された際に通知を受け取ることを推奨します。
https://github.com/microsoft/dynamics365patternspractices/discussions Dynamics 365 のパターンとプラクティス リポジトリのタブから、フィードバックを共有してください。
GitHub アカウントをお持ちでない場合は、最初にMicrosoft Learn 投稿者ガイドをご覧ください。
ヒント
https://github.com/MicrosoftDocs/dynamics365-guidance リポジトリのソース ファイルを参照します。 さまざまなタイプの記事を構造化する方法を確認して、あなたの記事も同じ構造で記述してください。 これによりレビュー プロセスを高速化できます。
アーキテクチャ
ソリューションのアイデアや設計パターンなどの、アーキテクチャ ガイダンスに対する投稿をお寄せください。 ベスト プラクティスや参考になる実装をお持ちの場合は、Azure チームまたは Dynamics 365 の担当者に提案をお寄せください。
Dynamics 365 アーキテクチャ ガイダンスに新しい記事を投稿する際は、次の主な手順に従います。
- dynamics365-docs-templates GitHub リポジトリの guidance-templates フォルダーから、適切な Markdown テンプレートを取得します。
- 投稿内容を入力します。
- dynamics365patternspractices リポジトリのプル要求で、Markdown ファイルとして記事を送信します。 これで、
/submit-architecture/フォルダーに投稿が保存されます。
その記事は Microsoft によって処理され、Dynamics 365 ガイダンス ドキュメントの一部として公開されます。
Microsoft のガイダンス コンテンツの概要については、Azure アーキテクチャ センターを参照してください。 投稿者ガイドについては、Azure アーキテクチャ センターへの投稿を参照してください。
GitHub リポジトリ dynamics365-docs-templates のguidance-templates フォルダーには、アーキテクチャ ガイダンス用に、次の Markdown 形式のテンプレートが用意されています。
一般化されたアーキテクチャ パターン: 一般化されたアーキテクチャ パターンは、多くのシナリオに導入される一般的なソリューションを備えるコア アーキテクチャの構築に使用されます。 たとえば、ソリューションのアイデアは、特定の業界向けまたはパートナー 向けソリューション用のレンズを提供するアーキテクチャ記事から構築して、各ソリューションのアイデアからアーキテクチャにリンクできます。 このテンプレートは、Azure アーキテクチャ ガイド テンプレートに基づいています。 参照アーキテクチャをはじめとするさまざまな種類のアーキテクチャに使用します。
ソリューションのアイデア: ソリューションのアイデアは、Dynamics 365 実装の "小規模" なアーキテクチャです。 これらは Dynamics 365 サービスや Azure サービスを使用するソリューションの簡単な概要を提供します。 各ソリューションのアイデアには次の要素が含まれています。
- アーキテクチャ図
- データフロー
- コンポーネント (使用するサービスの一覧)
- 投稿者クレジット
- 次のステップおよび関連するリソース (関連するガイドやアーキテクチャなど) へのリンク
サンプル ソリューション: サンプル ソリューションは、"中規模" のアーキテクチャを含むワークロード例です。 これらは、Dynamics 365 実装で発生する特定の問題に対応するソリューションの設計プロセスについて、読者をガイドします。 サンプル ソリューションは、実際のお客様事例に基づく、実用的なアーキテクチャ ガイダンスを提供します。 目標は、同じ経験をした別の顧客の事例を伝えることで、顧客の学習曲線を短縮することです。 これらにはソリューションのアイデア テンプレートのセクションが含まれており、次のセクションが追加されます。
- その代わりに、アーキテクチャに追加できる他のサービス
- Success by Design フレームワークにマップする考慮事項とガイダンス。これにはオプションで展開も含まれます
設計パターン: Dynamics 365 の設計パターンは、実装における特定の課題に対応しており、特定のシナリオまたはベスト プラクティスに基づいています。 ビジネス プロセス パターンを導入する場合は、このテンプレートを使用します。 または、dynamics365patternspractices/templates/business-processes の Word 形式のテンプレートをご利用ください。
ビジネス プロセスの投稿
ビジネス プロセスという用語は、あらかじめ設定された組織目標を達成するために構造化された、通常は順序付けられた、幅広い活動またはタスクで使用されます。 この用語で、ビジネス目標に向かって進行中のすべてのステップの累積結果に言及こともできます。 ビジネス プロセスは、Dynamics 365 を含むソリューションに特有のものです。 この新しいコンテンツ タイプは、顧客とパートナーが Dynamics 365 の導入準備を整える際に役立つ構造を生み出すと、当社は考えています。 各ビジネス プロセスには、標準のビジネス プロセス フローを示す図が含まれます。 このドキュメントのセクションでは、構成手順と各手順で使用するデータ エンティティについて概説します。 それぞれの手順は製品ドキュメントの関連ページとリンクしています。さらに、すべてのドキュメントには次の手順と関連リソースへのリンクが用意され、読者の学習体験に貢献します。
ビジネス プロセスをカタログに構造化しました。 ビジネス プロセス カタログは Excel ワークブックであり、ビジネス プロセス ドキュメントの作業を整理して優先順位を付けるために Microsoft が使用します。 エントリの並べ替えやフィルター処理が容易であるため、形式は Excel です。 また、オンボーディングの体験、実装プロジェクト、独自のビジネス プロセスを整理する際に、当社のパートナーは Excel ワークブックを使用できると確信しています。
https://aka.ms/BusinessProcessCatalog から最新バージョンのカタログをダウンロードします。
メモ
このビジネス プロセスに貢献していただける場合は、最初に自分の作業を登録することで、他のユーザーが同じビジネス プロセスに取り組むリスクを軽減できます。 自分の作業を登録する際は、https://github.com/microsoft/dynamics365patternspractices/issues から GitHub の問題を送信してください。
カタログに含まれるコンテンツ
カタログには、次の 4 つのレベルでコンテンツが定義されています。
エンドツーエンド プロセス
15 のエンドツーエンド シナリオが識別されています。 シナリオは、ソフトウェア技術用語ではなくビジネス用語で記述されます。
各エンドツープロセスについての紹介記事では、エンドツーエンド プロセスに関する考え方について説明します。 主要な関係者と、Dynamics 365 のエンドツーエンド プロセスへの活用方法を示します。 また、ビジネス プロセス フローの図とともに、エンドツーエンド プロセスと他のエンドツーエンド プロセスとの対話方法の概要も示します。 この概要は、エンドツーエンドのプロセスに対応したソリューションを実装するための、前提条件を一覧で示します。
ビジネス プロセス領域
各エンドツーエンド シナリオには、2 つ以上のビジネス プロセス領域があります。 このレベルは、ビジネス プロセスをグループ化して、検索やナビゲーションを簡単にします。 通常は、ビジネス プロセス領域は組織内の主要な職務権限または部門で区切られます。 現在のカタログでは 90 を超えるビジネス プロセスの分野が定義されています。
ビジネス プロセス
ビジネス プロセスという用語は、あらかじめ設定された組織目標を達成するために構造化された、通常は順序付けられた、幅広い活動またはタスクで使用されます。 この用語で、ビジネス目標に向かって進行中のすべてのステップの累積結果に言及こともできます。 各ビジネス プロセスで、Dynamics 365 がサポートする機能またはプロセスについて説明します。 これまでに当社は、ほぼ 700 件のビジネス プロセスを特定しています。 一部は単一の Dynamics 365 アプリに適用され、アプリのドキュメントには、そのプロセスがすでに記載されている場合があります。 ここのすべてのビジネス プロセスをガイドで収集することで、関連する製品固有のコンテンツへのリンクを単一のエントリ ポイントに提供することができます。
パターン
Dynamics 365 でパターンとは、特定のビジネス プロセスに対応した反復可能な構成です。 これには、最も一般的な使用例、シナリオ、業界が含まれます。 多くの場合、さまざまな方法で Dynamics 365 を実装し、固有のビジネス要件を満たすことができます。 パターンを使用する目的は、実装のベースラインを提供することです。 当社は既に 2000 件を超えるパターンを特定しましたが、その数は今後大幅に増加すると予想されます。
ビジネス プロセス カタログのその他の概要については、ビジネス プロセス ガイドについてを参照してください。
投稿内容を送信する
Microsoft 内部では、内部メモ、経験年数、およびさまざまなドキュメントを、ビジネス プロセス ガイダンスに変換する取り組みを行っています。 コミュニティによる貢献をとても歓迎しています。
記事の種類に応じた、さまざまなテンプレートが用意されており、提出する投稿に利用できます。 投稿者は投稿する記事の種類に応じて、適切なテンプレートを必ず選択してください。 テンプレートは Word ファイルとして利用でき、そのテンプレートが対象とする記事を表す名前が付けられています。
投稿者の表彰
GitHub を通じて内容を投稿すると、Microsoft Learn プラットフォームの各記事の上部に、内部および外部の投稿者が掲載されます。 他の方法でユーザーが投稿する場合は、投稿者セクションを記事の最後に追加します。
オプションの投稿者セクションには、主要な投稿者の名前と、提供された場合は LinkedIn や他のプロファイルへのリンクが一覧表示されます。 次のスクリーンショットは、Azure アーキテクチャ センターの記事が含む投稿者セクションの、匿名化されたバージョンを示しています。
これは 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
この方法で投稿者として一覧表示するのはオプションです。 GitHub 以外の方法で外部の投稿者が、リファレンス アーキテクチャや設計パターンなどの新しいコンテンツを投稿する際は、Microsoft 全体で投稿者セクションの使用を推奨します。