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

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

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

此用例的主要步骤包括：

  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. 对组成标识键(“category”)的所有字段重复上述步骤，然后保存更改。

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

步骤3：根据其标识键调用资源

配置标识键及其过滤器定义后，您可以使用它们从Campaign标准界面或REST API调用资源。

若要使用界面中的过滤器定义，请使用 Query 工作流中的活动(请参阅 本节)。 然后，该过滤器将显示在左窗格中。

要使用Campaign StandardREST 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文档.

在此页面上