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

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

Embora as relações de schema possam ser inferidas com o uso do schema de união e Real-time Customer Profile, isso se aplica somente aos schemas 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 schemas usando o Editor de Schemas na interface do usuário Experience Platform. Para obter etapas sobre como definir relações de schema usando a API, consulte o tutorial em definindo uma relação usando a API do Registro do Schema.

Introdução

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

Definir um schema de origem e de destino

Espera-se que você já tenha criado os dois schemas que serão definidos no relacionamento. Para fins de demonstração, este tutorial cria uma relação entre os 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 schemas devem ter identidades primárias definidas e estar habilitados para Real-time Customer Profile. Consulte a seção sobre ativar um schema para uso no Perfil no tutorial de criação do schema se precisar de orientação sobre como configurar seus schemas de acordo.

As relações de schema 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 uma relação seja definida.

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. Inclui um objeto loyalty na namespace _tenantId, que inclui vários campos específicos de fidelidade. Um desses campos, loyaltyId, serve como a principal identidade do schema na namespace Email. Conforme visto em Propriedades do Schema, este schema foi habilitado para uso em Real-time Customer Profile.

Hotels schema

O schema de destino "Hotels" tem por base uma classe "Hotels" personalizada e contém campos que descrevem um hotel. O campo hotelId serve como a identidade principal do schema em uma namespace personalizada hotelId. Como o schema Loyalty Members, esse schema também foi ativado para Real-time Customer Profile.

Criar uma mistura de relacionamento

OBSERVAÇÃO

Essa etapa só é necessária se o schema de origem não tiver um campo de tipo de string dedicado para ser usado como referência ao schema de destino. Se esse campo já estiver definido no schema de origem, pule para a próxima etapa de definindo 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 ao schema de destino. É possível adicionar esse campo ao schema de origem criando uma nova combinação.

Start selecionando Adicionar na seção Mixins.

A caixa de diálogo Adicionar mistura é exibida. Aqui, selecione Criar nova mistura. Nos campos de texto exibidos, insira um nome de exibição e uma descrição para a nova combinação. Selecione Adicionar mistura quando terminar.


A tela reaparece com "Favorite Hotel" aparecendo na seção Mixins. Selecione o nome da mistura e, em seguida, selecione Adicionar campo ao lado do campo de nível raiz Loyalty Members.

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

Quando terminar, selecione Aplicar.

O campo atualizado favoriteHotel é exibido na tela. Selecione Salvar para finalizar suas 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 Propriedades do campo 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 relação.

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

O campo favoriteHotel agora é destacado como um relacionamento na tela, exibindo o nome e a namespace de identidade de referência do schema de destino. Selecione Salvar 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 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 do Schema.

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now