Definir um relacionamento de “um para um” entre dois esquemas usando o Schema Editor

Última atualização em 2024-01-25
  • Tópicos
  • Schemas
    Exibir mais informações sobre este tópico
  • Criado para:
  • Developer
    User
    Admin
    Leader

A capacidade de entender os relacionamentos entre seus clientes e as interações deles com sua marca em vários canais é uma parte importante do Adobe Experience Platform. Definir esses relacionamentos na estrutura do Experience Data Model Os esquemas de (XDM) permitem obter insights complexos sobre os dados do cliente.

Embora os relacionamentos entre esquemas possam ser inferidos por meio do uso do esquema 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 esquemas pertencentes a classes diferentes, um campo de relação dedicado deve ser adicionado a um esquema de origem, que faz referência à identidade do outro esquema relacionado.

OBSERVAÇÃO

Se os esquemas de origem e destino pertencerem à mesma classe, um campo de relacionamento dedicado deverá não ser utilizado. Nesse caso, use a interface do esquema de união para ver o relacionamento. As instruções sobre como fazer isso podem ser encontradas no exibir relacionamentos seção do guia da interface do esquema de união.

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

OBSERVAÇÃO

Para obter etapas sobre como criar uma relação muitos para um no Adobe Real-time Customer Data Platform B2B Edition, consulte o guia sobre criação de relacionamentos B2B.

Introdução

Este tutorial requer um entendimento prático de XDM System e o Editor de esquemas no Experience Platform IU. Antes de iniciar este tutorial, reveja a seguinte documentação:

Definir um esquema de origem e de referência

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 membros de um programa de fidelidade de uma organização (definido em uma "Loyalty Members" schema) e seu hotel favorito (definido em uma "Hotels").

IMPORTANTE

Para estabelecer uma relação, ambos os esquemas devem ter identidades primárias definidas e estar habilitados para Real-Time Customer Profile. Consulte a seção sobre ativar um esquema para uso no perfil no tutorial de criação de schema se você precisar de orientação sobre como configurar seus schemas adequadamente.

Relacionamentos de esquema são representados por um campo dedicado em um esquema de origem que aponte para outro campo dentro de um esquema de referência. Nas etapas a seguir, "Loyalty Members" será o esquema de origem, enquanto "Hotels" atuará como o esquema de referência.

As seções a seguir descrevem a estrutura de cada esquema usado neste tutorial antes que uma relação seja definida.

Loyalty Members schema

O schema de origem "Loyalty Members" baseia-se no XDM Individual Profile classe, que contém o campo que descreve os membros de um programa de fidelidade. Um desses campos, personalEmail.addess, serve como a identidade principal do esquema sob o E-mail namespace. Como visto em Propriedades do esquema, este esquema foi ativado para uso no Real-Time Customer Profile.

Hotels schema

O schema de referência "Hotels" é baseado em um " personalizado"Hotels" e contém campos que descrevem um hotel. Para participar de um relacionamento, o schema de referência também deve ter uma identidade primária definida e estar habilitado para Perfil. Nesse caso, _tenantId.hotelIdatua como a identidade principal do esquema, usando uma "Hotel ID" namespace de identidade.

Ativar para perfil

OBSERVAÇÃO

Para saber como criar namespaces de identidade personalizados, consulte a Documentação do Serviço de identidade.

Criar um grupo de campos de relacionamento

OBSERVAÇÃO

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

Para definir uma relação entre dois esquemas, o esquema de origem deve ter um campo dedicado que indicará a identidade principal do esquema de referência. Você pode adicionar este campo ao esquema de origem criando um novo grupo de campos de esquema ou estendendo um existente.

No caso do Loyalty Members schema, um novo preferredHotel O campo será adicionado para indicar o hotel preferido do membro de fidelidade para visitas da empresa. Comece selecionando o ícone de adição (+) ao lado do nome do esquema de origem.

Um novo espaço reservado de campo é exibido na tela. Em Propriedades do campo, forneça um nome de campo e um nome de exibição para o campo e defina seu tipo como "String". Em Atribuir a, selecione um grupo de campos existente para estender ou digite um nome exclusivo para criar um novo grupo de campos. Nesse caso, um novo "Preferred HotelO grupo de campos "é criado.

Quando terminar, selecione Aplicar.

A atualização preferredHotel aparece na tela, localizada abaixo de um _tenantId objeto, pois é um campo personalizado. Selecionar Salvar para finalizar as alterações no esquema.

Definir um campo de relacionamento para o esquema de origem

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

OBSERVAÇÃO

As etapas abaixo abordam como definir um campo de relacionamento usando os controles do painel direito na tela. Se você tiver acesso ao Real-Time CDP B2B Edition, também poderá definir uma relação um para um usando o mesma caixa de diálogo como ao criar relações muitos para um.

Selecione o preferredHotel na tela e role para baixo sob Propriedades do campo até que o Relacionamento é 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 Esquema de referência e selecione o schema de referência para o relacionamento ("Hotels" neste exemplo). Em Namespace de identidade de referência, selecione o namespace do campo de identidade do schema de referência (neste caso, "Hotel ID"). Selecionar Aplicar quando terminar.

A variável preferredHotel agora o campo é realçado como uma relação na tela, exibindo o nome do esquema de referência. Selecionar Salvar para salvar suas alterações e concluir o fluxo de trabalho.

Próximas etapas

Ao seguir este tutorial, você criou uma relação um para um entre dois esquemas usando o Schema Editor. Para obter etapas sobre como definir relacionamentos usando a API, consulte o tutorial sobre definição de uma relação usando a API do registro de esquema.

Nesta página