在某些情况下,您可能需要为资源定义由两个字段组成的标识密钥。 配置标识密钥后,您需要配置过滤器定义,以便能够从Campaign Standard接口或API中使用此标识密钥调用资源。
在此用例中,用户档案资源已扩展为自定义"CRM ID"和"类别"字段。 我们将为用户档案资源创建一个标识密钥,由这两个字段组成。 然后,我们将配置过滤器定义,以便我们能够使用标识密钥访问用户档案资源。
此用例的主要步骤是:
相关主题:
配置标识键时的全局概念在本节中有详细介绍。
在配置标识密钥之前,请确保资源已扩展到所需的字段并且已发布。 如需详细信息,请参阅此部分。
转到Administration / Development / Custom resources菜单,然后打开Profile资源。
在Identification keys部分,单击Create element按钮。
添加两个自定义“CRM ID”和“类别”字段,然后单击Confirm。
如果要在用户档案的接口中显示两个自定义字段,请配置Screen definition选项卡。 如需详细信息,请参阅此部分。
您现在可以配置筛选器定义,以便能够使用其标识键调用资源。
配置筛选器定义时的全局概念在本节中有详细介绍。
在Filter definition选项卡中,单击Add an element,然后输入筛选器定义的标签和ID。
编辑筛选器定义的属性以配置其规则。
将包含在标识键中使用的字段的表拖放到工作区中。
选择标识键(“CRM ID”)中使用的第一个字段,然后激活Switch to parameters选项。
在Filter conditions部分,保留Equal运算符,然后定义参数的名称并单击加号创建它。
单击**+**按钮后,将自动生成参数的名称。 请注意此信息,因为您需要它才能使用API中的筛选器。
对构成标识键的所有字段重复上述步骤(“类别”),然后保存更改。
现在已配置筛选器定义。 您可以发布资源,以使过滤器可用。
配置标识密钥及其筛选器定义后,您可以使用它们从活动标准接口或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文档。