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

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

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

此用例的主要步骤包括:

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

相关主题:

步骤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,然后输入过滤器定义的标签和ID。

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

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

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

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

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

  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
要调用自定义筛选条件,请使用“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文档.

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