Show Menu
主题×

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

在某些情况下,您可能需要为资源定义由两个字段组成的标识密钥。 配置标识密钥后,您需要配置过滤器定义,以便能够从Campaign standard界面或API中使用该标识密钥调用资源。
在此用例中, Profile resource has been extended with custom " CRM ID " and "category" field . 我们将为配置文件资源创建一个标识密钥,该标识密钥将由这两个字段组成。 然后,我们将配置过滤器定义,以便我们能够使用标识密钥访问配置文件资源。
此用例的主要步骤是:
  1. 根据两个字段配置配置文件资源的标识密钥。
  2. 配置过滤器定义,以便能够使用其标识密钥调用配置文件资源。
  3. 从界面或AP调用配置文件资源。
相关主题:

第1步:配置标识密钥

配置标识密钥时的全局概念在本节中 有详细介绍
  1. 在配置标识密钥之前,请确保资源已扩展到所需的字段并且已发布。 如需详细信息,请参阅 此部分
  2. 转到/ Developement /菜 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步:根据资源的标识密钥调用资源

一旦配置了标识密钥及其过滤器定义,您就可以使用它们从Campaign标准界面或REST API调用资源。
要从界面中使用过滤器定义,请在工 Query 作流中使用活动(请参 阅本节 )。 然后,该过滤器在左侧窗格中可用。
要使用Campaign Standard REST API中的过滤器定义,请使用以下语法:
GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>

要调用客户过滤器,请使用“by”前缀,后跟在步骤2中配置过滤器定义时定义的过 滤器名称
在本例中,用于从“spring”类别中检索配置文件的语法为:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456

有关详细信息,请参 阅Campaign Standard REST API文档