Em alguns casos, pode ser necessário definir para um recurso uma chave de identificação que seja composta de dois campos. Depois que a chave de identificação estiver configurada, é necessário configurar uma definição de filtro para poder chamar o recurso com essa chave de identificação, da interface do Campaign Standard ou das APIs.
Nesse caso de uso, a variável Perfil recurso foi estendido com personalizado "CRM ID" e "category" campos. Criaremos uma chave de identificação para o recurso Perfil, que será composto desses dois campos. Em seguida, configuraremos uma definição de filtro, para que possamos acessar o recurso de Perfil usando a chave de identificação.
As principais etapas para este caso de uso são:
Tópicos relacionados:
Os conceitos globais ao configurar as chaves de identificação são detalhados em esta seção.
Antes de configurar a chave de identificação, verifique se o recurso foi estendido com os campos desejados e se foi publicado. Para obter mais informações, consulte esta seção.
Vá para o Administration / Development / Custom resources , em seguida, abra o Profile recurso.
No Identification keys clique no botão Create element botão.
Adicione os dois campos personalizados "ID do CRM" e "Categoria" e, em seguida, clique em Confirm.
Se quiser exibir os dois campos personalizados na interface do perfil, configure a variável Screen definition guia . Para obter mais informações, consulte esta seção.
Agora você pode configurar a definição de filtro para poder chamar o recurso usando sua chave de identificação.
Os conceitos globais ao configurar definições de filtro são detalhados em esta seção.
No Filter definition clique em Add an element, em seguida, insira o rótulo e a ID da definição de filtro.
Edite as propriedades da definição de filtro para configurar suas regras.
Arraste e solte no espaço de trabalho a tabela que contém os campos usados na chave de identificação.
Selecione o primeiro campo usado na chave de identificação ("ID do CRM") e ative o Switch to parameters opção.
No Filter conditions mantenha Equal , defina o nome do parâmetro e clique no sinal de mais para criá-lo.
Depois de clicar no botão + , o nome do parâmetro é gerado automaticamente. Observe essas informações, pois será necessário usar o filtro das APIs.
Repita as etapas acima com todos os campos que compõem a chave de identificação ("categoria") e salve as alterações.
A definição do filtro está configurada. Você pode publicar o recurso para que o filtro esteja disponível.
Depois que a chave de identificação e sua definição de filtro forem configuradas, você poderá usá-las para chamar o recurso, na interface padrão do Campaign ou em APIs REST.
Para usar a definição de filtro da interface, use um Query em um fluxo de trabalho (consulte esta seção). O filtro estará disponível no painel esquerdo.
Para usar a definição de filtro das APIs REST do Campaign Standard, use a sintaxe abaixo:
GET /profileAndServicesExt/<resourceName>/by<filterName>?<param1_parameter>=<value>&<param2_parameter>=<value>
Para chamar um filtro personalizado, use o prefixo "by" seguido do nome do filtro definido ao configurar a definição do filtro em etapa 2.
No nosso caso, a sintaxe para recuperar um perfil da categoria "Spring" com a ID do CRM "123456" seria:
GET https://mc.adobe.io/<ORGANIZATION>/campaign/profileAndServicesExt/profile/byidentification_key?category_parameter=spring&crm_id_parameter=123456
Para obter mais detalhes, consulte Documentação das APIs REST do Campaign Standard.