使用複合識別鍵呼叫資源 calling-a-resource-using-a-composite-identification-key
在某些情況下,您可能需要為資源定義由兩個欄位組成的識別索引鍵。 在設定識別金鑰後,您需要設定篩選器定義,以便能夠從Campaign Standard介面或API使用此識別金鑰呼叫資源。
在此使用案例中,設定檔 資源已使用自訂 "CRM ID" 和 "category" 欄位擴充。 我們將為設定檔資源建立識別金鑰,該金鑰將由這兩個欄位組成。 然後,我們將設定篩選定義,以便可以使用識別鍵存取設定檔資源。
此使用案例的主要步驟為:
- 根據兩個欄位,設定設定檔資源的識別碼。
- 設定篩選定義,以便能夠使用設定檔資源的識別鍵進行呼叫。
- 從介面或API呼叫設定檔資源。
相關主題:
步驟1:設定識別鍵 step-1-configure-the-identification-key
-
在設定識別金鑰之前,請確定資源已使用所需欄位擴展,並且已發佈。 如需詳細資訊,請參閱本章節。
-
前往 Administration / Development / Custom resources 功能表,然後開啟 Profile 資源。
-
在 Identification keys 區段中,按一下 Create element 按鈕。
-
新增兩個自訂「CRM ID」和「類別」欄位,然後按一下 Confirm。
note note NOTE 如果您想要在設定檔介面中顯示兩個自訂欄位,請設定 Screen definition 標籤。 如需詳細資訊,請參閱本章節。 -
您現在可以設定篩選定義,以便能夠使用資源的識別鍵呼叫資源。
步驟2:設定篩選定義 step-2-configure-the-filter-definition
-
在 Filter definition 索引標籤中,按一下 Add an element,然後輸入篩選器定義的標籤和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標準介面或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
如需詳細資訊,請參閱Campaign StandardREST API檔案。