Dataverse 検索列に複数種類のテーブルを入力可能にする｜マルチテーブル検索機能

意外と知られていないDataverseの機能の一つ「マルチテーブル検索」を試してみた。

マルチテーブル検索
やりたいこと
実現方法
PostmanからAPI「CreatePolymophicLookupAttribute」を使う
動作確認
注意：追加は簡単だけど、編集や削除は大変

マルチテーブル検索

あまり知られていないDataverseの機能の一つとして、「マルチテーブル検索」という機能がある。

これは、テーブルの検索列に対し複数のテーブルを設定できるようにする機能のことで、この機能を使用するとポリモーフィック関連を実現できる。

言葉で説明するのは難しいので実際にやりたいことと操作を交えて説明。

※公式はこちら

複数テーブルのルックアップ列を使用する - Power Apps

単一ルックアップタイプの列を使用して、他の複数テーブルのデータを参照する方法について説明します。

やりたいこと

例えばこんなテーブルがあるとして、

「ねこ」テーブルに「大好物」という列を追加するとき、この列に「お肉」「お魚」「ちゅーる」の3つのテーブルの中の好きなレコードを設定できるようにしたい、といったときの話。
※普通に検索列を追加するとどれか1つのテーブルしか選べない。

実現方法

今回は冒頭で話した「マルチテーブル検索」機能を使用して、「ねこ」テーブルの「大好物」列に3つのテーブルをどれでも入力できるようにしていく。

本記事執筆時点で、「マルチテーブル検索」はWebAPIやSDKからのみ設定可能（Power Apps Studioからは設定できない）。

そこで今回はPostmanを使用してWebAPI経由で設定する。

※Postmanを使用したWebAPIの呼び出し方はこちら

Postmanを使用しDataverseにWebAPI経由でアクセスしてみる

Postmanを使用し、DataverseにWebAPI経由でアクセスする方法を調べてみたので、メモ。2024/9/1追記：Dataverse Acceleratorを使用してAPIアクセスできるようになりました。DataverseはWeb...

PostmanからAPI「CreatePolymophicLookupAttribute」を使う

Postmanでの事前準備「アクセストークンの取得」まで完了したら、POSTリクエストを使用してAPI「CreatePolymorphicLookupAttribute」を呼び出す。

ボディの中身はこちらで、列を作成する際のオプションも設定することが可能。

{
  "OneToManyRelationships": [
    {
      "SchemaName": "cr9cb_favorite_fish",
      "ReferencedEntity": "cr9cb_fish",
      "ReferencingEntity": "cr9cb_cat"
    },
    {
      "SchemaName": "cr9cb_favorite_meat",
      "ReferencedEntity": "cr9cb_meat",
      "ReferencingEntity": "cr9cb_cat"
    },
    {
      "SchemaName": "cr9cb_favorite_ciaochuru",
      "ReferencedEntity": "cr9cb_churu",
      "ReferencingEntity": "cr9cb_cat",
      "CascadeConfiguration": {
        "Assign": "NoCascade",
        "Delete": "RemoveLink",
        "Merge": "NoCascade",
        "Reparent": "NoCascade",
        "Share": "NoCascade",
        "Unshare": "NoCascade"
      }
    }
  ],
  "Lookup": {
    "AttributeType": "Lookup",
    "AttributeTypeName": {
      "Value": "LookupType"
    },
    "Description": {
      "@odata.type": "Microsoft.Dynamics.CRM.Label",
      "LocalizedLabels": [
        {
          "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
          "Label": "大好物の食べ物",
          "LanguageCode": 1041
        }
      ],
      "UserLocalizedLabel": {
        "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
        "Label": "大好物の食べ物",
        "LanguageCode": 1041
      }
    },
    "DisplayName": {
      "@odata.type": "Microsoft.Dynamics.CRM.Label",
      "LocalizedLabels": [
        {
          "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
          "Label": "大好物",
          "LanguageCode": 1033
        }
      ],
      "UserLocalizedLabel": {
        "@odata.type": "Microsoft.Dynamics.CRM.LocalizedLabel",
        "Label": "大好物",
        "LanguageCode": 1033
      }
    },
    "SchemaName": "cr9cb_favorite_food",
    "@odata.type": "Microsoft.Dynamics.CRM.ComplexLookupAttributeMetadata"
  }
}

※JSONを見るとなんとなくわかるけど、OneToManyRelationshipsですべての関連（ねこと魚、ねこと肉、ねことちゅーる）を定義している。

呼び出しが成功すると「ねこ」テーブルに列「大好物」が作られる。