サンプル: キューへのレコードの追加

このサンプルはキューにレコードを追加する方法を示します。 ソース キューと宛先キューを作成します。 レター活動をソース キューに追加してから、宛先キューに移動します。 サンプルは ここ からダウンロードできます。

注意

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

このサンプルでは、システムに存在しない追加のユーザーが必要です。 Microsoft 365 でユーザーを手動で作成し、サンプルがエラーなしで実行されるようにします。 このサンプルでは、次に示す 現状有姿 でユーザー プロファイルを作成します。

名: Kevin
姓: Cook
セキュリティ ロール: 営業課長
ユーザー名: kcook@yourorg.onmicrosoft.com

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

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

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

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

このサンプルの概要

AddToQueueRequest メッセージは、テーブル レコードをソース キューから宛先キューに移動させるために必要なデータを含むシナリオで使用されることを意図しています。

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

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

セットアップ

1. 組織の現在のバージョンをチェックします。
2. Queue メソッドでは元のキューおよび宛先キューを作成し、変数で返された GUID を保存します。
3. レター テーブルを作成します。
4. AddToQueueRequest メソッドはテーブル レコードをキューに追加します。このサンプルでは、レターを最初のキューに関連付けます。
5. キュー アイテムをユーザー キューに割り当てるため、Microsoft 365 で手動で作成したユーザーを取得します。

使用方法

1. RetrieveUserQueueRequest メッセージでは、ユーザーに対する既知のプライベート キューを取得します。
2. AddToQueueRequest メッセージでは、元のキューから宛先キューへレコードが追加されます。

クリーンアップ

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

注意

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

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