選択を使って作業する

[アーティクル]
04/22/2022

このサンプルでは、選択の使用方法を示します。一般的には、選択肢を使って列を設定し、異なる列が同じ選択肢を共有できるようにします。これは 1 つの場所で管理されます。特定の列に対してのみ定義されるローカルオプションセットとは異なり、選択肢を再利用することができます。要求パラメーターの中で列挙体のときと同じように使われる例もあります。

CreateOptionSetRequest を使って選択肢の列を定義した場合、システムで値を割り当てることをお勧めします。具体的には新規の OptionMetadata インスタンスを作成するとき、引数として NULL 値を渡します。オプションを定義すると、選択肢の列が作成されたソリューションのパブリッシャーセットのコンテキストに固有のオプション値の接頭辞が含まれます。この接頭辞により、マネージドソリューションや、マネージドソリューションがインストールされている組織で定義されている選択肢欄に、重複した選択肢が作成される可能性を減らすことができます。詳細については、選択オプションをマージするを参照してください。

次のメッセージ要求クラスを使用して、選択肢を操作します:

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

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

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

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

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

このサンプルの概要

CreateOptionSetRequest、DeleteOptionSetRequest、RetrieveOptionSetRequest、UpdateOptionSetRequest メッセージは、選択肢を扱うために必要なデータが含まれているというシナリオで使用することを想定しています。

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

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

セットアップ

組織の現在のバージョンをチェックします。

実際にやってみます

CreateOptionSetRequest メソッドは選択列を作成します。 IsGlobal=true パラメーターを設定する必要があります。
CreateAttributeRequest メソッドは、選択にリンクした選択列を作成します。
UpdateOptionSetRequest メソッドは、選択列の基本情報を更新します。
PublishXmlRequest メソッドは選択列を公開します。
InsertOptionValueRequest メソッドは、新しいオプションを選択列に挿入します。
RetrieveOptionSetRequest メソッドは、選択の列をその名前で取得します。

クリーンアップ

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

注意

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

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