Show Menu
トピック×

複合 ID キーを使用したリソースの呼び出し

場合によっては、2つのフィールドで構成される識別キーをリソースに対して定義する必要があります。 IDキーを設定したら、Campaign StandardインターフェイスまたはAPIからこのIDキーを使用してリソースを呼び出せるように、フィルター定義を設定する必要があります。
この使用例では、 プロファイル リソースがカスタムの「CRM ID 」フィールドと「 カテゴリ」 ​フィールドを使用して拡張されています。 この2つのフィールドで構成されるプロファイルリソースのIDキーを作成します。 次に、IDキーを使用してプロファイルリソースにアクセスできるように、フィルター定義を設定します。
この使用例の主な手順は次のとおりです。
  1. 2つのフィールドに基づいて、プロファイルリソースのIDキーを設定します。
  2. IDキーを使用してプロファイルリソースを呼び出せるように、フィルター定義を設定します。
  3. プロファイルリソースをインターフェイスまたはAPから呼び出します。
関連トピック :

手順1:IDキーの設定

IDキーを設定する際のグローバルな概念について詳し くは、この節
  1. IDキーを設定する前に、目的のフィールドでリソースが拡張され、発行されていることを確認します。 詳しくは、 この節 を参照してください。
  2. Administration / Developement /」 Custom resources メニューに移動し、 Profile リソースを開きます。
  3. In the Identification keys section, click the Create element button.
  4. 2つ追加のカスタム「CRM ID」と「カテゴリ」フィールドで、をクリックし Confirm ​ます。
    プロファイルのインターフェイスに2つのカスタムフィールドを表示する場合は、 Screen definition タブを設定します。 詳しくは、 この節 を参照してください。
  5. これで、フィルター定義のIDキーを使用してリソースを呼び出せるようにフィルター定義を設定できます。

手順2:フィルター定義の設定

フィルター定義を設定する際のグローバル概念について詳し くは、この節
  1. タブでをクリック Filter definition Add an element ​し、フィルタ定義のラベルとIDを入力します。
  2. フィルター定義のプロパティを編集して、ルールを設定します。
  3. IDキーで使用されるフィールドを含むテーブルをワークスペースにドラッグ&ドロップします。
  4. IDキーで使用される最初のフィールド(「CRM ID」)を選択し、この Switch to parameters オプションをアクティブ化します。
  5. このセクションでは、 Filter conditions Equal 演算子をそのまま使用し、パラメーターの名前を定義し、プラス記号をクリックして作成します。
    +」 ボタンをクリックすると、パラメーター名が自動的に生成されます。 この情報は、APIのフィルタを使用する必要があるので、注意してください。
  6. IDキー(「カテゴリ」)を構成するすべてのフィールドに対して上記の手順を繰り返し、変更を保存します。
  7. これで、フィルター定義が設定されます。 リソースを公開して、フィルターを使用できます。

手順3:識別キーに基づいてリソースを呼び出す

IDキーとそのフィルター定義が設定されたら、それらを使用して、キャンペーン標準インターフェイスまたはREST APIからリソースを呼び出すことができます。
インターフェイスのフィルタ定義を使用するには、ワークフローで Query アクティビティを使用します( この節を参照 )。 その後、左側のペインでフィルターを使用できます。
Campaign StandardREST APIのフィルター定義を使用するには、次の構文を使用します。
GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>

この例では、「123456」CRM IDを持つ「spring」カテゴリからプロファイルを取得する構文は次のようになります。
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456