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

在某些情况下，您可能需要为资源定义由两个字段组成的标识密钥。 配置标识密钥后，您需要配置过滤器定义，以便能够从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文档。

在此页面上