Defina uma relação entre dois schemas usando o Schema Editor

A capacidade de entender os relacionamentos entre seus clientes e suas interações com a marca em vários canais é uma parte importante do Adobe Experience Platform. Definir esses relacionamentos dentro da estrutura de seus esquemas Experience Data Model (XDM) permite que você obtenha insights complexos sobre os dados do cliente.

Embora os relacionamentos de esquema possam ser inferidos por meio do uso do schema de união e Real-time Customer Profile, isso se aplica somente a esquemas que compartilham a mesma classe. Para estabelecer uma relação entre dois schemas pertencentes a classes diferentes, um campo de relacionamento dedicado deve ser adicionado a um schema de origem, que faz referência à identidade de um schema de destino.

Este documento fornece um tutorial para definir uma relação entre dois esquemas usando o Editor de esquemas na interface do usuário Experience Platform. Para obter etapas sobre como definir relações de esquema usando a API, consulte o tutorial em definindo uma relação usando a API do Registro de Esquema.

Introdução

Este tutorial requer uma compreensão funcional de XDM System e do Editor de esquemas na interface do usuário Experience Platform. Antes de iniciar este tutorial, reveja a seguinte documentação:

Definir um esquema de origem e de destino

Espera-se que você já tenha criado os dois schemas que serão definidos na relação. Para fins de demonstração, este tutorial cria uma relação entre membros do programa de fidelidade de uma organização (definido em um schema "Loyalty Members") e seu hotel favorito (definido em um schema "Hotels").

IMPORTANTE

Para estabelecer uma relação, ambos os esquemas devem ter identidades primárias definidas e devem ser habilitados para Real-time Customer Profile. Consulte a seção ativando um schema para uso em Profile no tutorial de criação de schema se precisar de orientação sobre como configurar seus schemas de acordo.

As relações de esquema são representadas por um campo dedicado dentro de um schema de origem que se refere a outro campo dentro de um schema de destino. Nas etapas a seguir, "Loyalty Members" será o schema de origem, enquanto "Hotels" atuará como o schema de destino.

Para fins de referência, as seções a seguir descrevem a estrutura de cada schema usado neste tutorial antes que um relacionamento seja definido.

Loyalty Members schema

O schema de origem "Loyalty Members" é baseado na classe XDM Individual Profile e é o schema que foi construído no tutorial para criar um schema na interface do usuário. Ele inclui um objeto loyalty em seu namespace _tenantId, que inclui vários campos específicos de fidelidade. Um desses campos, loyaltyId, serve como a identidade primária para o schema no namespace Email. Conforme visto em Schema Properties, este esquema foi ativado para uso em Real-time Customer Profile.

Hotels schema

O esquema de destino "Hotels" é baseado em uma classe personalizada "Hotels" e contém campos que descrevem um hotel. O campo hotelId serve como a identidade primária para o esquema em um namespace hotelId personalizado. Como o schema Loyalty Members, esse schema também foi ativado para Real-time Customer Profile.

Criar um grupo de campos do schema de relacionamento

OBSERVAÇÃO

Essa etapa só será necessária se o schema de origem não tiver um campo do tipo string dedicado a ser usado como referência para o schema de destino. Se esse campo já estiver definido no esquema de origem, pule para a próxima etapa de definição de um campo de relação.

Para definir uma relação entre dois schemas, o schema de origem deve ter um campo dedicado para ser usado como referência para o schema de destino. É possível adicionar esse campo ao schema de origem criando um novo grupo de campos de esquema.

Comece selecionando Add na seção Field groups.

A caixa de diálogo Add field group é exibida. Aqui, selecione Create new field group. Nos campos de texto exibidos, insira um nome de exibição e uma descrição para o novo grupo de campos. Selecione Add field groups quando terminar.

A tela reaparece com "Favorite Hotel" aparecendo na seção Field groups. Selecione o nome do grupo de campos e selecione Add field ao lado do campo de nível raiz Loyalty Members.

Um novo campo aparece na tela sob o namespace _tenantId. Em Field properties, forneça um nome de campo e nome de exibição para o campo e defina seu tipo como "String".

Quando terminar, selecione Apply.

O campo atualizado favoriteHotel aparece na tela. Selecione Save para finalizar as alterações no schema.

Definir um campo de relação para o schema de origem

Depois que o schema de origem tiver um campo de referência dedicado definido, você poderá designá-lo como um campo de relacionamento.

Selecione o campo favoriteHotel na tela e role para baixo em Field properties até que a caixa de seleção Relationship seja exibida. Marque a caixa de seleção para revelar os parâmetros necessários para configurar um campo de relacionamento.

Selecione a lista suspensa para Reference schema e selecione o schema de destino para a relação ("Hotels" neste exemplo). Se o schema de destino estiver ativado para Profile, o campo Reference identity namespace será automaticamente definido para o namespace da identidade primária do schema de destino. Se o schema não tiver uma identidade primária definida, você deverá selecionar manualmente o namespace que planeja usar no menu suspenso. Selecione Apply quando terminar.

O campo favoriteHotel agora é destacado como uma relação na tela, exibindo o nome e o namespace de identidade de referência do schema de destino. Selecione Save para salvar suas alterações e concluir o fluxo de trabalho.

Próximas etapas

Ao seguir este tutorial, você criou com êxito uma relação um para um entre dois schemas usando o Schema Editor. Para obter etapas sobre como definir relações usando a API, consulte o tutorial em definindo uma relação usando a API do Registro de Schema.

Nesta página