このサンプルは、相互関係ロールを作成する方法を示します。 取引先企業の接続ロールと取引先担当者の接続ロールをそれぞれ 1 つ作成し、それらを互いに関連付けて相互ロールにします
このサンプルを実行する方法
- サンプル リポジトリをダウンロードまたは複製して、ローカル コピーを用意します。
- (オプション) dataverse/App.config ファイルを編集して、接続先の Microsoft Dataverse インスタンスを指定した接続文字列を定義します。
- サンプル ソリューションを Visual Studio で開き、F5 キーを押してサンプルを実行します。 Dataverse/App.config 内に接続文字列を指定した後、サンプルを実行すると、その接続情報が使用されます。
dataverse/App.config ファイル内に接続文字列を指定しない場合は、サンプルを実行するたびにダイアログが開き、接続先の Dataverse インスタンスと使用する資格情報についての情報を入力する必要があります。 このダイアログには以前の接続がキャッシュされているため、以前に使用した接続を選ぶことができます。
このリポジトリにあるサンプルで、実行するために Dataverse インスタンスへの接続を必要とするものには、dataverse/App.config ファイルへのリンクされた参照が含まれます。
このサンプルの概要
ConnectionRole および ConnectionRoleObjectTypeCode メッセージは、新しいつながりロールとつながりロール オブジェクト タイプを作成する必要があるデータが含まれているシナリオで使用するためのものです。
このサンプルがどのように動作するか
このサンプルの概要で説明されているシナリオをシミュレートするために、サンプルは次のことを行います:
セットアップ
- 組織の現在のバージョンをチェックします。
-
ConnectionRoleメッセージは、サンプルに必要なつながりロールを作成します。 -
ConnectionRoleObjectTypeCodeメッセージは、取引先企業に対するつながりロールのオブジェクトの種類のレコードを作成します。 -
AssociateRequestメッセージは、つながりロールを相互に関連付けます。
使用方法
- 初期要求を実行して、
DataTokenなどの結果をキャッシュします。 - セットアップ で作成されたレコードを更新する
- 2 番目の要求を実行します。今回は、初期要求から取得された
DataToken値を使用してDataVersionを渡します。 - 2 番目のリクエストによって返されたテーブルの変更を表示する
クリーンアップ
設定で作成されたサンプル データを削除するためのオプションを表示します。 サンプルによって作成されたテーブルとデータを調べる場合、削除はオプションです。 手動でレコードを削除することで同じ結果を得られます。
接続を使用してレコードを相互にリンクする
接続ロールを持つテーブル間のリレーションシップについて説明する
サンプル: 接続を作成する
サンプル: 接続ロールを作成する
サンプル: レコードによる接続のクエリ (事前バインド)
サンプル: エンティティ型コード (事前バインド) による接続ロールのクエリ
サンプル: 相互ロールによるつながりのクエリ (事前バインド)
サンプル: つながりロールの更新 (事前バインド)