複合 ID キーを使用したリソースの呼び出し calling-a-resource-using-a-composite-identification-key

場合によっては、リソースに、2 つのフィールドで構成される ID キーを定義する必要があります。 ID キーが設定されたら、この ID キーを使用してリソースをCampaign Standardインターフェイスまたは API から呼び出せるように、フィルター定義を設定する必要があります。

このユースケースでは、プロファイル リソースをカスタム 「CRM ID」および 「カテゴリ フィールドで拡張し した。 これらの 2 つのフィールドで構成される、プロファイルリソースの識別キーを作成します。 次に、識別キーを使用してプロファイルリソースにアクセスできるように、フィルター定義を設定します。

このユースケースの主な手順は次のとおりです。

  1. 2 つのフィールドに基づいて、プロファイルリソースの識別キーを設定します。
  2. 識別キーを使用してプロファイルリソースを呼び出せるように、フィルター定義を設定します。
  3. インターフェイスまたは API からプロファイルリソースを呼び出します。

関連トピック :

手順 1:識別キーの設定 step-1-configure-the-identification-key

NOTE
識別キーを設定する際の全体的な概念については、 この節を参照してください。
  1. 識別キーを設定する前に、リソースが目的のフィールドを使用して拡張されていることと、リソースが公開されていることを確認してください。 詳しくは、この節を参照してください。

  2. Administration / Development / Custom resources メニューに移動し、Profile リソースを開きます。

  3. Identification keys セクションで、「Create element」ボタンをクリックします。

  4. 2 つのカスタム「CRM ID」および「カテゴリ」フィールドを追加し、「Confirm」をクリックします。

    note note
    NOTE
    プロファイルのインターフェイスに 2 つのカスタムフィールドを表示する場合は、「Screen definition」タブを設定します。 詳しくは、この節を参照してください。
  5. 識別キーを使用してリソースを呼び出せるようにフィルター定義を設定できるようになりました。

手順 2:フィルター定義の設定 step-2-configure-the-filter-definition

NOTE
フィルター定義を設定する際の全体的な概念については、 この節を参照してください。
  1. Filter definition」タブで「Add an element」をクリックし、フィルター定義のラベルと ID を入力します。

  2. フィルター定義のプロパティを編集し、そのルールを設定します。

  3. ID キーで使用されるフィールドを含むテーブルをワークスペースにドラッグ&ドロップします。

  4. 識別キー(「CRM ID」)で使用される最初のフィールドを選択し、「Switch to parameters」オプションをアクティブ化します。

  5. Filter conditions」セクションで、Equal 演算子を保持し、パラメーターの名前を定義した後、プラス記号をクリックしてパラメーターを作成します。

    note note
    NOTE
    + ボタンをクリックすると、パラメーターの名前が自動的に生成されます。 この情報は、API からフィルターを使用するために必要なので、注意してください。
  6. 識別キー(「カテゴリ」)を構成するすべてのフィールドで上記の手順を繰り返し、変更を保存します。

  7. これで、フィルター定義が設定されました。 リソースを公開すると、フィルターを使用できるようになります。

手順 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>
NOTE
カスタムフィルターを呼び出すには、「by」プレフィックスの後に、 手順 2 でフィルター定義を設定する際に定義したフィルター名を使用します。

この場合、「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 ドキュメントを参照してください。

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff