サンプル: キューへのレコードの追加 (事前バインド)

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

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

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

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

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

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

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

このサンプルの概要

AddToQueueRequest メッセージは、エンティティ レコードを元のキューから宛先キューに移動する必要があるデータが含まれているシナリオで使用するためのものです。

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

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

セットアップ

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

使用方法

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

クリーンアップ

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