Jaa


Microsoft Dynamics 365 Online July 2017 Update: 新しい開発者ガイドの使い方

みなさん、こんにちは。

前回は、新しい開発者ガイドについて紹介しました。本記事は、その中で出てきた新しいアセンブリやツールの取得方法など重要な部分について紹介します。前回の記事を見ていない方は、参照ください。

Microsoft Dynamics 365 Online July 2017 Update: 新しい開発者ガイドの紹介

使い方

- 新しい開発者ガイドのダウンロード
- 新しいアセンブリやツールの取得
- サンプルコードの取得

新しい開発者ガイドのダウンロード

新しい開発者ガイドは、Dynamics 365 Customer Engagement の開発者ガイド より参照することが可能です。
一方、オフラインで参照する場合は、PDF 形式でガイドをダウンロードすることができます。

1. 新しい開発者ガイドのサイトにアクセスする

https://docs.microsoft.com/en-us/dynamics365/customer-engagement/developer/developer-guide

2. 右下にある [Download PDF] をクリックします。

image

3. ダウンロードが始まります

image

4. PDF 形式で表示されたことがわかります。(13,036 ページにわたる巨大なもの)

image

5. ローカルに保存します。

image

6. 約 80 MB の開発者ガイドです。

image

7. PDF にはブックマークがついており、見たい項目へ即座に移動することができます。

image

新しいアセンブリやツールの取得

続いて新しいアセンブリやツールをどのように取得するかについて紹介します。

ローカルに取得する

最初に、自分のローカルに最新のアセンブリやツールを取得する方法を紹介します。

1. PowerShell を起動します。

image

2. ダウンロードしたい場所へ移動します。

実行するコマンド

image

場所

image

3. 新しい開発者ガイドにアクセスします。

https://docs.microsoft.com/en-us/dynamics365/customer-engagement/developer/download-tools-nuget

4. “Download tools using PowerShell” クリックします。

image

5. PowerShell コマンドをコピーします

image

6. PowerShell に貼り付けます。

image

7. 実行します。

image

8. 実行されます。

image

9. 完了します。

image

10. ファイルが取得できたことがわかります。

image

image

以上です。このコマンドによって常に最新のアセンブリやツールを取得することができます。

プロジェクトに追加

続いて、プラグインやカスタムページといった開発物に新しいアセンブリを追加する手順を紹介します。
ポイントは、アセンブリのバージョンを指定することができる点です。

Visual Studio のプロジェクトにアセンブリを追加する例で見てみましょう。

1. Visual Studio を開きます。

image

2. 新しいプロジェクトを作成します。

image

3. ライブラリを選択します。

image

4. ソリューションエクスプローラーを開くと、Dynamics 365 のアセンブリは追加されていません。

image

5. パッケージコンソールを開きます。

image

6. 開かれます。

image

6. 新しい開発者ガイドのサイトにアクセスします。

https://docs.microsoft.com/en-us/dynamics365/customer-engagement/developer/org-service/subscribe-sdk-assembly-updates-using-nuget#where-to-find-the-nuget-sdk-packages

image

7. パッケージの中から追加したいものを選択します。今回は “Microsoft.CrmSdk.CoreAssemblies” を追加してみます。

image

8. リンクをクリックします。

image

9. 最新バージョンを追加してみます。コピーします。

image

10. Visual Studio に戻り、貼り付けます。

image

11. Enter を押すと実行されます。

image

12. 完了しました。

image

13. 最新バージョンのアセンブリと、付随するアセンブリがプロジェクトに追加されたことがわかります。

image

14. CRM 2011, 2013, 2015, 2016 といった過去のバージョンのアセンブリを取得することができます。

15. 開発者ガイドの各リンク先に行くと過去のバージョンが記載されています。

https://www.nuget.org/packages/Microsoft.CrmSdk.CoreAssemblies/

16. Version History で取得したいバージョンをクリックします。

image

17. 実行するコマンドをコピーできます。

image

サンプルコードの取得

最後にサンプルコードの取得手順を紹介します。

1. コードサイトにアクセスします。

code.msdn.microsoft.com

2. 英語の検索結果を有効にします。

image

3. 88 件ものサンプルコードが表示されます。

image

C#, JScript のサンプルコードが取得できます。

まとめ

いかがだったでしょうか。個人的には、プロジェクトに追加する際に、
バージョンを指定して取得できることは、開発者には役立つと感じました。

- プレミアフィールドエンジニアリング 河野 高也

※本情報の内容(添付文書、リンク先などを含む)は、作成日時点でのものであり、予告なく変更される場合があります