使用复合标识关键码调用资源 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中的过滤器。 -
对组成标识键(“category”)的所有字段重复上述步骤,然后保存更改。
-
筛选器定义现已配置完成。 您可以发布资源,以便过滤器可用。
步骤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>
在本例中,用于从“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文档。