サンプル: 相互つながりロールの作成 (事前バインド)

このサンプルは、相互関係ロールを作成する方法を示します。 取引先企業のつながりロールを 1 つと取引先担当者のつながりロールを 1 つ作成し、それらを互いに関連付けて相互ロールにします。 サンプルは ここ からダウンロードできます。

Note

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

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

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

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

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

このサンプルの概要

ConnectionRole および ConnectionRoleObjectTypeCode メッセージは、新しいつながりロールとつながりロール オブジェクト タイプを作成する必要があるデータが含まれているシナリオで使用するためのものです。

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

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

セットアップ

1. 組織の現在のバージョンをチェックします。
2. ConnectionRole メッセージは、サンプルに必要なつながりロールを作成します。
3. ConnectionRoleObjectTypeCode メッセージは、取引先企業に対するつながりロールのオブジェクトの種類のレコードを作成します。
4. AssociateRequest メッセージは、つながりロールを相互に関連付けます。

使用方法

1. 初期要求を実行して、DataToken などの結果をキャッシュします
2. セットアップ で作成されたレコードを更新する
3. 2 番目の要求を実行します。今回は、初期要求から取得された DataToken 値を使用して DataVersion を渡します。
4. 第 2 の要求により返されたエンティティの変更を表示する

クリーン アップ

セットアップ で作成されたサンプル データを削除するためのオプションを表示します。 サンプルで作成されるエンティティおよびデータを検証する場合、削除は任意です。 手動でレコードを削除することで同じ結果を得られます。