サンプル: ライセンス情報の取得

このサンプルでは、 IDeploymentService.RetrieveDeploymentLicenseTypeRequest メッセージおよび IOrganizationService.RetrieveLicenseInfoRequest メッセージを使用して、ライセンスに関する情報を取得する方法を示します。

サンプルは ここ からダウンロードできます。

Note

このサンプルは、Dynamics 365 Customer Engagement (on-premises) と Dataverse の両方に適用されます。

このサンプルを実行する方法

すべてのサンプルのローカル コピーを取得してビルドするには、次の手順を実行します。

1. サンプル リポジトリをダウンロードまたは複製して、ローカル コピーを用意します。
2. (オプション) dataverse/App.config ファイルを編集して、接続先のインスタンスまたは組織を指定した接続文字列を定義します。
3. サンプル ソリューションを Visual Studio で開き、F5 キーを押してサンプルを実行します。 Dataverse/App.config 内に接続文字列を指定した後、サンプルを実行すると、その接続情報が使用されます。

dataverse/App.config ファイル内に接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先のインスタンスまたは組織についての情報と、使用する資格情報についての情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。

このサンプルの概要

IDeploymentService.RetrieveDeploymentLicenseTypeRequest メッセージは、 Dataverse 展開のライセンスのタイプを取得するために必要なデータが含まれているシナリオで使用することを目的としています。

IOrganizationService.RetrieveLicenseInfoRequest メッセージは、 Dataverse の展開で使用済みおよび使用可能なライセンスの数を取得するために必要なデータが含まれているシナリオで使用することを目的としています。

このサンプルがどのように動作するか

このサンプルは何をするか で説明されているシナリオをシミュレートするために、サンプルは次のことを行います:

セットアップ

組織の現在のバージョンをチェックします。

実際にやってみます

1. deploymentTypeRequest メソッドでは、展開ライセンス タイプを取得する要求を作成します。
2. licenseInfoRequest メッセージでは、ライセンス情報要求を取得する要求を作成します。

クリーンアップ

このサンプルでは、レコードは作成されません。 クリーンアップの必要はありません。