51黑料不打烊

使用复合标识关键码调用资源 calling-a-resource-using-a-composite-identification-key

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

在此使用案例中,配置文件 ?资源已通过自定义? "CRM ID" ?和? "category" ?字段扩展。 我们将为用户档案资源创建一个标识键,该键将由这两个字段组成。 然后,我们将配置过滤器定义,以便可以使用标识键访问用户档案资源。

此用例的主要步骤包括:

  1. 根据这两个字段,配置用户档案资源的标识键。
  2. 配置过滤器定义,以便能够使用用户档案资源的标识键调用该资源。
  3. 从接口或础笔滨调用配置文件资源。

相关主题:

步骤1:配置标识键 step-1-configure-the-identification-key

NOTE
有关配置标识键时的全局概念,请参阅此部分
  1. 在配置标识键之前,请确保已使用所需的字段扩展了资源并且已发布该资源。 如需详细信息,请参阅此小节

  2. 转到? Administration / Development / Custom resources ?菜单,然后打开? Profile ?资源。

  3. 在? Identification keys ?部分中,单击? Create element ?按钮。

  4. 添加两个自定义“CRM ID”和“类别”字段,然后单击? Confirm

    note note
    NOTE
    如果要在用户档案的界面中显示两个自定义字段,请配置? Screen definition ?选项卡。 如需详细信息,请参阅此小节
  5. 您现在可以将过滤器定义配置为能够使用其标识键调用资源。

步骤2:配置过滤器定义 step-2-configure-the-filter-definition

NOTE
有关配置筛选器定义时的全局概念的详情,请参阅本节
  1. 在? Filter definition ?选项卡中,单击? Add an element,然后输入筛选器定义的标签和滨顿。

  2. 编辑过滤器定义的属性以配置其规则。

  3. 将包含标识键中所用字段的表拖放到工作区中。

  4. 选择标识键(“CRM ID”)中使用的第一个字段,然后激活? Switch to parameters ?选项。

  5. 在? Filter conditions ?部分中,保留? Equal ?运算符,然后定义参数的名称,并单击加号创建参数。

    note note
    NOTE
    单击?**+**?按钮后,将自动生成参数的名称。 请注意此信息,因为您将需要此信息以使用API中的过滤器。
  6. 对组成标识键(“肠补迟别驳辞谤测”)的所有字段重复上述步骤,然后保存更改。

  7. 筛选器定义现已配置完成。 您可以发布资源,以便过滤器可用。

步骤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>
NOTE
要调用自定义筛选器,请使用“产测”前缀,后跟在步骤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文档

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff