サンプル: 相互つながりロールの作成

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

注意

エンティティとテーブルの違いがわかりませんか？ Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。

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

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

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

このリポジトリにあるサンプルのうち、Dataverse インスタンスに接続する必要があるものには、cds/App.config ファイルを参照するリンクが含まれます。

このサンプルの概要

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

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

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

セットアップ

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

使用方法

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

クリーンアップ

セットアップ で作成されたサンプル データを削除するためのオプションを表示します。 サンプルによって作成されたテーブルとデータを調べる場合、削除はオプションです。 手動でレコードを削除することで同じ結果を得られます。

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。