フィードバック

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

  • [アーティクル]

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

注意

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

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

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

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

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

このサンプルの概要

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

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

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

セットアップ

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

実際にやってみます

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

クリーンアップ

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

注意

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

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