サンプル: キューへのセキュリティ プリンシパル (ユーザーまたはチーム) の追加

注意

Effective November 2020:

  • Common Data Service has been renamed to Microsoft Dataverse. Learn more
  • Some terminology in Microsoft Dataverse has been updated. For example, entity is now table and field is now column. Learn more

This article will be updated soon to reflect the latest terminology.

このサンプルは、ユーザーまたはチームにキューへのアクセス権を与える方法を紹介します。 AddPrincipalToQueueRequest では、キュー メンバーの一覧に指定したプリンシパルが追加されます。 渡されたセキュリティ プリンシパルがチームの場合、キューにチームの各メンバーが追加されます。 サンプルは ここ からダウンロードできます。

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

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

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

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

このサンプルの概要

AddPrincipalToQueueRequest メッセージは、キュー メンバーの一覧に指定したプリンシパルが追加する必要があるデータが含まれているシナリオで使用するためのものです。 プリンシパルがチームの場合、キューに各チーム メンバーを追加します。

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

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

セットアップ

  1. 組織の現在のバージョンをチェックします。
  2. Queue メソッドではキュー インスタンスが作成され、プロパティ値が設定されます。 返された GUID は変数で保存されます。
  3. QueryExpression は、チームおよびロールの作成に対する既定の部署を取得します。
  4. サンプルに必要な、新しいチームおよびロールの例を作成します。
  5. prvReadQueue および prvAppendToQueue 特権を取得します。
  6. AddPrivilegeRoleRequest メソッドでは、 prvReadQueueprvAppendToQueue の権限が役割に追加されます。

実際にやってみます

AddPrincipalToQueueRequest メソッドでは、キューにチームが追加されます。

クリーンアップ

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