サンプル: チームにセキュリティ ロールを関連付ける

このサンプルでは、 AssignRequest メッセージを使用してチームに セキュリティ ロールを割り当てる方法を示します。 この例では、チームまたはユーザーに割り当てることができるのはその部署のロールのみであることを考慮していません。 割り当てを行う ロール は、 RetrieveMultiple メソッド によって返された コレクション の最初の ロールです。 そのレコードが要求チームの部署以外のものである場合、割り当ては失敗します。

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

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

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

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

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

このサンプルの概要

AssignRequest メッセージは、レコードの OwnerId 属性を変更して、指定されたレコードを新たな所有者（ユーザーまたはチーム）に割り当てる際に必要となるデータを含むシナリオで使用することを目的としています。

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

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

セットアップ

1. 組織の現在のバージョンをチェックします。
2. CreateRequiredRecords メソッドは、サンプルに必要なレコードを作成します。

実際にやってみます

1. queryメソッドは Dataverse からロールを取得します。
2. Associate メッセージはチームに役割を割り当てします。

クリーンアップ

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