複合 ID キーを使用したリソースの呼び出し calling-a-resource-using-a-composite-identification-key
場合によっては、リソースに、2 つのフィールドで構成される ID キーを定義する必要があります。 ID キーが設定されたら、この ID キーを使用してリソースをCampaign Standardインターフェイスまたは API から呼び出せるように、フィルター定義を設定する必要があります。
このユースケースでは、プロファイル リソースをカスタム 「CRM ID」および 「カテゴリ フィールドで拡張し した。 これらの 2 つのフィールドで構成される、プロファイルリソースの識別キーを作成します。 次に、識別キーを使用してプロファイルリソースにアクセスできるように、フィルター定義を設定します。
このユースケースの主な手順は次のとおりです。
- 2 つのフィールドに基づいて、プロファイルリソースの識別キーを設定します。
- 識別キーを使用してプロファイルリソースを呼び出せるように、フィルター定義を設定します。
- インターフェイスまたは API からプロファイルリソースを呼び出します。
関連トピック ：
手順 1：識別キーの設定 step-1-configure-the-identification-key
-
識別キーを設定する前に、リソースが目的のフィールドを使用して拡張されていることと、リソースが公開されていることを確認してください。 詳しくは、この節を参照してください。
-
Administration / Development / Custom resources メニューに移動し、Profile リソースを開きます。
-
Identification keys セクションで、「Create element」ボタンをクリックします。
-
2 つのカスタム「CRM ID」および「カテゴリ」フィールドを追加し、「Confirm」をクリックします。
note note NOTE プロファイルのインターフェイスに 2 つのカスタムフィールドを表示する場合は、「Screen definition」タブを設定します。 詳しくは、この節を参照してください。 -
識別キーを使用してリソースを呼び出せるようにフィルター定義を設定できるようになりました。
手順 2：フィルター定義の設定 step-2-configure-the-filter-definition
-
「Filter definition」タブで「Add an element」をクリックし、フィルター定義のラベルと ID を入力します。
-
フィルター定義のプロパティを編集し、そのルールを設定します。
-
ID キーで使用されるフィールドを含むテーブルをワークスペースにドラッグ&ドロップします。
-
識別キー（「CRM ID」）で使用される最初のフィールドを選択し、「Switch to parameters」オプションをアクティブ化します。
-
「Filter conditions」セクションで、Equal 演算子を保持し、パラメーターの名前を定義した後、プラス記号をクリックしてパラメーターを作成します。
note note NOTE + ボタンをクリックすると、パラメーターの名前が自動的に生成されます。 この情報は、API からフィルターを使用するために必要なので、注意してください。 -
識別キー（「カテゴリ」）を構成するすべてのフィールドで上記の手順を繰り返し、変更を保存します。
-
これで、フィルター定義が設定されました。 リソースを公開すると、フィルターを使用できるようになります。
手順 3：識別キーに基づくリソースの呼び出し step-3-call-the-resource-based-on-its-identification-key
識別キーとそのフィルター定義を設定したら、それらを使用して Campaign Standard インターフェイスまたは REST API からリソースを呼び出すことができます。
インターフェイスからフィルター定義を使用するには、ワークフローで Query アクティビティを使用します（ この節を参照）。 フィルターは左側のパネルで使用できます。
Campaign Standard REST API のフィルター定義を使用するには、次の構文を使用します。
GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>
この場合、「spring」カテゴリから CRM ID 「123456」を持つプロファイルを取得する構文は次のようになります。
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456
詳しくは、Campaign Standard REST API ドキュメントを参照してください。