使用複合識別鍵呼叫資源

在某些情況下，您可能需要為資源定義由兩個欄位組成的標識鍵。 一旦配置了標識密鑰，您需要配置過濾器定義，以便能夠通過Campaign Standard介面或API使用該標識密鑰調用資源。

在此使用案例中，Profile​資源已擴展為自定義​"CRM ID"​和​"category"​欄位。 我們將為Profile資源建立一個標識鍵，該標識鍵將由這兩個欄位組成。 然後，我們將設定篩選定義，以便我們能夠使用識別碼存取描述檔資源。

此使用案例的主要步驟為：

  1. 根據這兩個欄位，設定描述檔資源的識別碼。
  2. 設定篩選定義，以便能夠使用其識別金鑰呼叫描述檔資源。
  3. 從介面或從APi調用Profile資源。

相關主題：

步驟1:配置標識鍵

注意

配置標識鍵時的全局概念在本節中有詳細說明。

  1. 在設定識別金鑰之前，請確定資源已擴充至所需欄位，且已發佈。 如需詳細資訊，請參閱本章節。

  2. 前往​Administration / Development / Custom resources​功能表，然後開啟​Profile​資源。

  3. 在​Identification keys​區段中，按一下​Create element​按鈕。

  4. 新增兩個自訂「CRM ID」和「類別」欄位，然後按一下​Confirm。

    注意

    如果要在配置檔案的介面中顯示兩個自定義欄位，請配置​Screen definition​頁籤。 如需詳細資訊，請參閱本章節。

  5. 您現在可以設定篩選定義，以便能夠使用其識別碼呼叫資源。

步驟2:設定篩選定義

注意

設定篩選器定義時的全域概念，請參閱本節。

  1. 在​Filter definition​標籤中，按一下​Add an element，然後輸入篩選定義的標籤和ID。

  2. 編輯篩選定義的屬性以設定其規則。

  3. 將包含標識鍵中使用的欄位的表拖放到工作區中。

  4. 選取識別碼中使用的第一個欄位(「CRM ID」)，然後啟動​Switch to parameters​選項。

  5. 在​Filter conditions​區段中，保留​Equal​運算子，然後定義參數的名稱，然後按一下加號以建立它。

    注意

    按一下​**+**​按鈕後，就會自動產生參數的名稱。 請注意，因為您需要此項資訊才能使用API的篩選。

  6. 使用構成識別碼的所有欄位（「類別」）重複上述步驟，然後儲存變更。

  7. 現在已設定篩選定義。 您可以發佈資源，以便篩選器可用。

步驟3:基於其標識鍵調用資源

一旦設定識別金鑰及其篩選定義後，您就可使用它們來呼叫資源，不論是從Campaign標準介面或REST API。

若要使用介面中的篩選定義，請在工作流程中使用​Query​活動（請參閱本節）。 然後，篩選器便可在左窗格中使用。

若要使用Campaign StandardREST API的篩選定義，請使用下列語法：

GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>
注意

若要呼叫自訂篩選，請在步驟2中設定篩選定義時，使用"by"字首，後面接著定義的篩選器名稱。

在本例中，從"spring"類別擷取具有"123456" CRM ID的描述檔的語法為：

GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456

有關詳細資訊，請參閱Campaign StandardREST API文檔。

本頁內容