Criar e editar esquemas na interface do usuário

Este guia fornece uma visão geral de como criar, editar e gerenciar esquemas do Experience Data Model (XDM) para sua organização na interface do usuário do Adobe Experience Platform.

IMPORTANTE

Os esquemas XDM são extremamente personalizáveis e, portanto, as etapas envolvidas na criação de um esquema podem variar dependendo do tipo de dados que você deseja que o esquema capture. Como resultado, este documento cobre apenas as interações básicas que você pode fazer com esquemas na interface do usuário e exclui etapas relacionadas, como personalização de classes, grupos de campos de esquema, tipos de dados e campos.

Para um tour completo do processo de criação do schema, siga o tutorial de criação de schema para criar um schema de exemplo completo e se familiarizar com os muitos recursos do Schema Editor.

Pré-requisitos

Este guia requer uma compreensão funcional do Sistema XDM. Consulte a Visão geral do XDM para obter uma introdução à função do XDM no ecossistema do Experience Platform e as noções básicas da composição do schema para obter uma visão geral de como os schemas são construídos.

Criar um novo schema

No espaço de trabalho Schemas, selecione Criar esquema no canto superior direito. Na lista suspensa que aparece, você pode escolher entre Perfil individual XDM e XDM ExperienceEvent como a classe base do esquema. Como alternativa, você pode selecionar Procurar para selecionar na lista completa de classes disponíveis, ou criar uma nova classe personalizada em vez disso.

Depois de selecionar uma classe, o Schema Editor aparece e a estrutura base do esquema (fornecida pela classe) é mostrada na tela. Aqui, você pode usar o painel direito para adicionar um Display name e Description ao schema.

Agora é possível começar a criar a estrutura do schema adicionando grupos de campos de esquema.

Editar um esquema existente

OBSERVAÇÃO

Depois que um schema é salvo e usado na assimilação de dados, somente alterações aditivas podem ser feitas nele. Consulte as regras de evolução do schema para obter mais informações.

Para editar um schema existente, selecione a guia Browse e selecione o nome do schema que deseja editar.

DICA

Você pode usar os recursos de pesquisa e filtragem do espaço de trabalho para ajudar a encontrar o esquema mais fácil. Consulte o guia sobre exploração de recursos XDM para obter mais informações.

Depois de selecionar um schema, o Schema Editor aparece com a estrutura do schema mostrada na tela. Agora é possível adicionar grupos de campos ao esquema, editar nomes de exibição de campos ou editar grupos de campos personalizados existentes se o esquema empregar algum.

Adicionar grupos de campos a um schema

OBSERVAÇÃO

Esta seção aborda como adicionar grupos de campos existentes a um schema. Se quiser criar um novo grupo de campos personalizado, consulte o guia em criar e editar grupos de campos.

Após abrir um schema dentro do Schema Editor, é possível adicionar campos ao schema por meio do uso de grupos de campos. Para iniciar, selecione Adicionar ao lado de Grupos de campos no painel esquerdo.

Uma caixa de diálogo é exibida mostrando uma lista de grupos de campos que você pode selecionar para o esquema. Como os grupos de campos são compatíveis apenas com uma classe, somente os grupos de campos associados à classe selecionada do esquema serão listados. Por padrão, os grupos de campos listados são classificados com base em sua popularidade de uso em sua organização.

Se você souber a atividade geral ou a área comercial dos campos que deseja adicionar, selecione uma ou mais categorias verticais do setor no painel à esquerda para filtrar a lista exibida de grupos de campo.

OBSERVAÇÃO

Para obter mais informações sobre as práticas recomendadas para modelagem de dados específica do setor no XDM, consulte a documentação sobre modelos de dados do setor.

Também é possível usar a barra de pesquisa para ajudar a localizar o grupo de campos desejado. Os grupos de campos cujo nome corresponde ao query são exibidos na parte superior da lista. Em Campos padrão, grupos de campos contendo campos que descrevem os atributos de dados desejados são exibidos.

Marque a caixa de seleção ao lado do nome do grupo de campos que deseja adicionar ao schema. É possível selecionar vários grupos de campos na lista, com cada grupo de campos selecionado aparecendo no painel direito.

DICA

Para qualquer grupo de campos listado, você pode passar o mouse ou focar no ícone de informações () para exibir uma breve descrição do tipo de dados que o grupo de campos captura. Você também pode selecionar o ícone de visualização () para exibir a estrutura dos campos que o grupo de campos fornece antes de decidir adicioná-lo ao schema.

Depois de escolher os grupos de campos, selecione Add field groups para adicioná-los ao esquema.

O Schema Editor é exibido novamente com os campos fornecidos pelo grupo de campos representados na tela.

Ativar um esquema para o Perfil do cliente em tempo real

Os Perfis do cliente em tempo real emergem dados de fontes diferentes para construir uma visualização completa de cada cliente individual. Se desejar que os dados capturados por um schema participem neste processo, é necessário habilitar o schema para uso em Profile.

IMPORTANTE

Para habilitar um schema para Profile, ele deve ter um campo de identidade primário definido. Consulte o guia em definindo campos de identidade para obter mais informações.

Para ativar o schema, comece selecionando o nome do schema no painel à esquerda e selecione o botão Profile no painel à direita.

Um provedor é exibido, avisando que, uma vez que um esquema foi ativado e salvo, ele não poderá ser desativado. Selecione Ativar para continuar.

A tela é exibida novamente com a opção Profile ativada.

IMPORTANTE

Como o esquema ainda não foi salvo, esse é o ponto de não retorno se você mudar de ideia sobre permitir que o esquema participe do Perfil do cliente em tempo real: depois de salvar um schema ativado, ele não poderá mais ser desativado. Selecione a opção Profile novamente para desativar o esquema.

Para concluir o processo, selecione Save para salvar o esquema.

O esquema agora está ativado para uso no Perfil do cliente em tempo real. Quando a Platform assimila dados em conjuntos de dados com base nesse esquema, esses dados serão incorporados aos dados do Perfil amalgamado.

Editar nomes de exibição para campos de esquema

Depois de atribuir uma classe e adicionar grupos de campos a um esquema, você pode editar os nomes de exibição de qualquer um dos campos do esquema, independentemente desses campos terem sido fornecidos por recursos XDM padrão ou personalizados.

OBSERVAÇÃO

Lembre-se de que os nomes de exibição dos campos que pertencem a classes ou grupos de campos padrão só podem ser editados no contexto de um schema específico. Em outras palavras, alterar o nome de exibição de um campo padrão em um schema não afeta outros esquemas que empregam a mesma classe ou grupo de campos associado.

Depois de fazer alterações nos nomes de exibição dos campos de um esquema, essas alterações são refletidas imediatamente em qualquer conjunto de dados existente com base nesse esquema.

Para editar o nome de exibição de um campo de esquema, selecione o campo na tela. No painel direito, forneça o novo nome em Display name.

Selecione Aplicar no painel à direita e a tela será atualizada para mostrar o novo nome de exibição do campo. Selecione Save para aplicar as alterações ao esquema.

Alterar a classe de um esquema

Você pode alterar a classe de um schema em qualquer ponto durante o processo de composição inicial antes que o schema tenha sido salvo.

AVISO

A reatribuição da classe para um schema deve ser feita com extremo cuidado. Os grupos de campos são compatíveis apenas com determinadas classes e, portanto, alterar a classe redefinirá a tela e quaisquer campos adicionados.

Para reatribuir uma classe, selecione Assign no lado esquerdo da tela.

Uma caixa de diálogo é exibida mostrando uma lista de todas as classes disponíveis, incluindo qualquer classe definida por sua organização (o proprietário sendo "Customer"), bem como classes padrão definidas pelo Adobe.

Selecione uma classe na lista para exibir sua descrição no lado direito da caixa de diálogo. Você também pode selecionar Visualizar estrutura de classe para ver os campos e metadados associados à classe. Selecione Atribuir classe para continuar.

Uma nova caixa de diálogo é aberta, solicitando que você confirme que deseja atribuir uma nova classe. Selecione Atribuir para confirmar.

Após confirmar a alteração de classe, a tela será redefinida e todo o progresso da composição será perdido.

Próximas etapas

Este documento abordou as noções básicas para a criação e edição de schemas na interface do usuário da plataforma. É altamente recomendável revisar o tutorial de criação de esquema para obter um fluxo de trabalho abrangente para criar um schema completo na interface do usuário, incluindo a criação de grupos de campos personalizados e tipos de dados para casos de uso exclusivos.

Para obter mais informações sobre os recursos do espaço de trabalho Schemas, consulte a Visão geral do espaço de trabalho Schemas.

Para saber como gerenciar schemas na API Schema Registry, consulte o guia de ponto de extremidade de schemas.

Nesta página