使用复合标识关键码调用资源

在某些情况下,您可能需要为资源定义由两个字段组成的标识密钥。 配置标识密钥后,您需要配置过滤器定义,以便能够从Campaign Standard接口或API中使用此标识密钥调用资源。

在此用例中,用户档案​资源已扩展为自定义​"CRM ID"​和​"类别"​字段。 我们将为用户档案资源创建一个标识密钥,由这两个字段组成。 然后,我们将配置过滤器定义,以便我们能够使用标识密钥访问用户档案资源。

此用例的主要步骤是:

  1. 根据这两个字段配置用户档案资源的标识密钥。
  2. 配置用户档案定义,以便能够使用其标识密钥调用筛选器资源。
  3. 从接口或APi调用用户档案资源。

相关主题:

第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步:根据资源的标识密钥调用资源

配置标识密钥及其筛选器定义后,您可以使用它们从活动标准接口或REST API调用资源。

要使用接口中的筛选器定义,请在工作流中使用​Query​活动(请参阅本节)。 然后,左窗格中会显示该过滤器。

要使用Campaign Standard REST API中的过滤器定义,请使用以下语法:

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

要调用自定义筛选器,请使用“by”前缀,后跟在步骤2中配置筛选器定义时定义的筛选器名称。

在本例中,用于从“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文档

On this page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now