Web API による選択肢 (オプション セット) の作成と更新

注意

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

一般的に、テーブルの列を設定する際には、グローバル オプション セットを使用して、異なる列が同じオプション セットを共有できるようにします。 特定の列に対してのみ定義される ローカル オプション セットとは異なり、グローバル オプション セットは再利用することができます。 要求パラメーターの中で列挙体のときと同じように使われる例もあります。

自社組織のURI/api/data/v9.0/GlobalOptionSetDefinitions への POST 要求を使用してグローバル オプション セットを設定するときは、値の設定をシステムに委任することを推奨します。 具体的には新規の OptionMetadata インスタンスを作成するとき、引数として null 値を渡します。 オプションを変更すると、そのオプション セットが作成されたソリューションに設定されている発行者のコンテキストに固有の接頭辞がオプション値に含められます。 この接頭辞により、マネージド ソリューションのオプション セットや、マネージド ソリューションがインストールされている環境で定義されているオプション セットに、重複したオプション セットが作成される可能性を削減できます。 詳細については、オプション セット オプションのマージ を参照してください。

メッセージ

次の表に、グローバル オプション セットで使用できるメッセージを示します。

メッセージ	Web API 操作
CreateOptionSet	自社組織のURI/api/data/v9.0/GlobalOptionSetDefinitions への POST リクエストを使用します。
DeleteOptionSet	自社組織のURI/api/data/v9.0/GlobalOptionSetDefinitions(metadataid) への DELETE リクエストを使用します。
RetrieveAllOptionSets	自社組織のURI/api/data/v9.0/GlobalOptionSetDefinitions への GET リクエストを使用します。
RetrieveOptionSet	自社組織のURI/api/data/v9.0/GlobalOptionSetDefinitions(metadataid) への GET リクエストを使用します。

次の表に、ローカルおよびグローバル オプション セットで使用できるメッセージを示します。

メッセージ	Web API 操作
DeleteOptionValue グローバル オプション セットから値の 1 つを削除します。	DeleteOptionValue Action /
InsertOptionValue 新しいオプションをグローバル オプション セットに挿入します。	InsertOptionValue Action /
InsertStatusValue Status 列で使用しているグローバル オプション セットに新しいオプションを挿入します。	InsertStatusValue Action /
OrderOption オプション セット内のオプションの相対順序を変更します。	OrderOption Action /
UpdateOptionSet	自社組織の URI/api/data/v9.0/GlobalOptionSetDefinitions(metadataid) への PUT リクエストを OptionSetMetadataBase EntityType / とともに使用します。 OptionSetMetadataBase で定義されたプロパティのみを更新することができます。 これにはオプションは含まれません。 他のアクションを使用して、オプションを変更します。
UpdateOptionValue グローバル オプション セットのオプションを更新します。	UpdateOptionValue Action /
UpdateStateValue Status 列で使用しているオプション セットに新しいオプションを挿入します。	UpdateStateValue Action /

関連情報

選択肢のカスタマイズ
グローバルな選択肢の概要を作成および編集
選択肢の作成

注意

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

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