Criar e editar esquemas na interface create-edit-schemas-in-ui

Use a interface do usuário do Adobe Experience Platform para criar, editar e gerenciar esquemas do Experience Data Model (XDM) para sua organização. Este guia mostra como criar esquemas padrão e relacional, personalizar estruturas de esquema, gerenciar esquemas do espaço de trabalho Procurar e preparar esquemas para uso de produção.

IMPORTANT
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 abrange apenas as interações básicas que você pode fazer com esquemas na interface e exclui etapas relacionadas, como personalizar classes, grupos de campos de esquema, tipos de dados e campos.
Para um tour completo do processo de criação de esquema, siga juntamente com o tutorial de criação de esquema para criar um esquema de exemplo completo e familiarizar-se com os vários recursos do Schema Editor.

Pré-requisitos prerequisites

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 de esquemas para obter uma visão geral de como os esquemas são construídos.

Criar um novo esquema create

No espaço de trabalho Esquemas, selecione Criar esquema no canto superior direito. O menu suspenso ‘Selecionar tipo de esquema’ é exibido com opções para esquemas Padrão ou Relacional.

O espaço de trabalho Esquemas com Criar esquema realçado e a lista suspensa Selecionar tipo de esquema exibida.

Criar um esquema relacional create-relational-schema

AVAILABILITY
O Data Mirror e esquemas relacionais estão disponíveis para os titulares de licença de campanhas orquestradas da Adobe Journey Optimizer. Eles também estão disponíveis como uma versão limitada para usuários do Customer Journey Analytics, dependendo da sua licença e da ativação de recursos. Entre em contato com o representante da Adobe para obter acesso.

Selecione Relacional para definir esquemas estruturados de estilo relacional com controle refinado sobre registros. Os esquemas relacionais oferecem suporte à aplicação da chave primária, ao controle de versão em nível de registro e aos relacionamentos em nível de esquema por meio de chaves primárias e estrangeiras. Eles também são otimizados para assimilação incremental usando captura de dados de alteração e oferecem suporte a vários modelos de dados usados em implementações do Campaign Orchestration, Data Distiller e B2B.

Para saber mais, consulte a visão geral do Data Mirror ou do Esquema relacional.

Criar manualmente create-manually

AVAILABILITY
O upload do arquivo DDL está disponível somente para titulares de licenças do Adobe Journey Optimizer Orchestrated campaign. Sua interface do usuário pode aparecer de forma diferente.

A caixa de diálogo Criar um esquema relacional é exibida. Você pode escolher Criar manualmente ou Carregar arquivo DDL para definir a estrutura do esquema.

Na caixa de diálogo Criar um esquema relacional, selecione Criar manualmente e Avançar.

A caixa de diálogo Criar um esquema relacional com Criar manualmente foi selecionada e Avançar foi realçado.

A página Detalhes do esquema relacional é exibida. Insira um nome para exibição de esquema e uma descrição opcional e selecione Concluir para criar o esquema.

A página Detalhes do esquema relacional com Nome para exibição do esquema, Descrição e Término foi realçada.

O Editor de esquemas é aberto com uma tela vazia para definir a estrutura do esquema. Você pode adicionar campos como de costume.

Adicionar um campo de identificador de versão add-version-identifier

Para ativar o rastreamento de versão e suportar a captura de dados de alteração, você deve designar um campo de identificador de versão no esquema. No Editor de Esquemas, selecione o sinal de mais ( A ícone de mais. ) ícone ao lado do nome do esquema para adicionar um novo campo.

Insira um nome de campo como updateSequence e escolha um tipo de dados de DateTime ou Number.

No painel direito, habilite a caixa de seleção Identificador de Versão e selecione Aplicar para confirmar o campo.

O Editor de Esquemas com um campo DateTime chamado updateSequence foi adicionado e a caixa de seleção Identificador de Versão foi selecionada.

IMPORTANT
Um esquema relacional deve incluir um campo de identificador de versão para oferecer suporte a atualizações no nível do registro e alterar a assimilação da captura de dados.

Para definir relações, selecione Adicionar Relação no Editor de Esquemas para criar relações de chave primária/estrangeira em nível de esquema. Consulte o tutorial em adicionando relações de nível de esquema para obter mais informações.

Em seguida, prossiga para definir chaves primárias e adicionar outros campos, conforme necessário. Para obter orientação sobre como habilitar a captura de dados de alteração nas Fontes do Experience Platform, consulte o guia de assimilação da captura de dados de alteração.

NOTE
Depois de salvo, o campo Tipo na barra lateral Propriedades do esquema indica que este é um esquema Relacional. Isso também é indicado na barra lateral de detalhes na exibição de inventário de esquema.
A tela Editor de Esquemas mostrando uma estrutura de esquema relacional vazia com o tipo Relational indicado na barra lateral Propriedades de esquema.

Fazer upload de um arquivo DDL upload-ddl-file

AVAILABILITY
O upload do arquivo DDL está disponível somente para titulares de licenças do Adobe Journey Optimizer Orchestrated campaign.

Use esse fluxo de trabalho para definir o esquema fazendo upload de um arquivo DDL. Na caixa de diálogo Criar um esquema relacional, selecione Carregar arquivo DDL e arraste um arquivo DDL local do sistema ou selecione Escolher arquivos. O Experience Platform valida o esquema e exibe uma marca de seleção verde se o upload do arquivo for bem-sucedido. Selecione Avançar para confirmar o carregamento.

A caixa de diálogo Criar um esquema relacional com Carregar arquivo DDL selecionada e a área de carregamento de arquivo exibida, incluindo o botão Escolher arquivos e a região de arrastar e soltar.

A caixa de diálogo Selecionar entidades e campos para importar é exibida, permitindo que você visualize o esquema. Revise a estrutura do esquema e use os botões de opção e as caixas de seleção para garantir que cada entidade tenha uma chave primária e um identificador de versão especificados.

IMPORTANT
A estrutura da tabela deve conter uma chave primária e um identificador de versão, como um campo updateSequence do tipo datetime ou number.
Para assimilação de captura de dados de alteração, uma coluna especial chamada _change_request_type do tipo Cadeia de caracteres também é necessária para habilitar o processamento incremental. Este campo indica o tipo de alteração de dados (por exemplo, u (substituição) ou d (exclusão)).

Embora seja necessário durante a assimilação, colunas de controle como _change_request_type não são armazenadas no esquema e não aparecem na estrutura final do esquema. Se tudo estiver correto, selecione Concluído para criar o esquema.

NOTE
O tamanho máximo de arquivo suportado para um upload de DDL é 10 MB.

A caixa de diálogo Selecionar entidades e campos para importar com campos importados mostrados e Concluído destacados.

O esquema é aberto no Editor de esquemas, onde você pode ajustar a estrutura antes de salvar.

Em seguida, prossiga para adicionar mais campos e adicionar mais relações de nível de esquema, conforme necessário.

Para obter orientação sobre como habilitar a captura de dados de alteração nas Fontes do Experience Platform, consulte o guia de assimilação da captura de dados de alteração.

Criar um esquema padrão create-standard-schema

Selecione Padrão no menu de tipo de esquema. A caixa de diálogo Criar um esquema é exibida. Nesta caixa de diálogo, escolha um fluxo de trabalho de criação de esquema. Você pode criar um esquema manualmente adicionando campos e grupos de campos ou fazer upload de um arquivo CSV para gerar um esquema automaticamente.

A caixa de diálogo Criar um esquema com as opções de fluxo de trabalho de criação de esquema realçadas.

[Criação manual ou com ML]{class="badge informative"} do esquema manual-or-assisted

Para saber como usar um algoritmo de ML para recomendar uma estrutura de esquema com base em um arquivo csv, consulte o guia de criação de esquema assistido por aprendizado de máquina. Este guia da interface do usuário se concentra no fluxo de trabalho de criação manual.

Criação manual de esquema manual-creation

O fluxo de trabalho Criar esquema é exibido. Você pode escolher uma classe base para o esquema selecionando Perfil Individual, Evento de Experiência ou Outros, seguido de Próximo para confirmar sua escolha. Consulte a documentação do Perfil individual XDM e do XDM ExperienceEvent para obter mais informações sobre essas classes.

O fluxo de trabalho Criar esquema mostrando as três opções de classe base com Próximo realçado.

Ao escolher Outros, uma lista de classes disponíveis é exibida. Aqui você pode navegar e filtrar classes pré-existentes.

O fluxo de trabalho Criar esquema com Outros foi selecionado e a lista de classes disponíveis foi exibida.

Selecione um botão de opção para filtrar as classes com base no fato de serem classes personalizadas ou padrão. Você também pode filtrar os resultados disponíveis com base em seu setor ou pesquisar por uma classe específica usando o campo de pesquisa.

O fluxo de trabalho Criar esquema com a barra de pesquisa Personalizado e Setores foi realçado.

Para ajudá-lo a decidir a classe apropriada, há ícones de informações e visualização para cada classe. O ícone de informações ( Um ícone de informações. ) abre uma caixa de diálogo que fornece uma descrição da classe e do setor ao qual ela está associada.

O fluxo de trabalho Criar esquema com uma dica de ferramenta de informações de classe aberta mostrando a descrição da classe e o setor associado.

O ícone de visualização ( Um ícone de visualização. ) abre uma caixa de diálogo de visualização para a classe que contém um diagrama de esquema e suas propriedades.

A caixa de diálogo de visualização da classe mostrando o diagrama do esquema e as propriedades da classe selecionada.

Selecione qualquer linha para escolher uma classe, em seguida, selecione Próximo para confirmar sua escolha.

O fluxo de trabalho Criar esquema com uma classe selecionada da tabela de classes disponíveis e Próximo realçado.

Após selecionar uma classe, a seção Nome e revisão é exibida. Nesta seção, você fornece um nome e uma descrição para identificar o esquema. ​A estrutura base do esquema (fornecida pela classe) é mostrada na tela para que você revise e verifique a classe selecionada e a estrutura do esquema.

Insira um Nome para exibição do esquema amigável no campo de texto. Em seguida, insira uma descrição adequada para ajudar a identificar seu esquema. Quando tiver revisado a estrutura do esquema e estiver satisfeito com as configurações, selecione Concluir para criar o esquema.

A seção Nome e revisão do fluxo de trabalho Criar esquema com o Nome para exibição do esquema, Descrição e Término realçados.

O Editor de esquemas é exibido com a estrutura do esquema mostrada na tela. Se desejar, agora você pode começar a adicionar campos à classe.

O Editor de Esquemas mostrando na tela a estrutura base de um esquema recém-criado.

Editar um esquema existente edit

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

Para editar um esquema existente, selecione a guia Procurar e selecione o nome do esquema que deseja editar. Você também pode usar a barra de pesquisa para restringir a lista de opções disponíveis.

A guia Procurar do espaço de trabalho Esquemas com um nome de esquema realçado para seleção e edição.

TIP
Você pode usar os recursos de pesquisa e filtragem do espaço de trabalho para facilitar a localização do esquema. Consulte o guia em explorando recursos XDM para obter mais informações.

Depois de selecionar um esquema, o Schema Editor aparece com a estrutura do esquema mostrada na tela. Agora você pode personalizar o esquema usando as ferramentas e opções descritas na seção a seguir.

Personalizar um esquema customize-schema

Depois que um esquema é aberto no Editor de esquemas, você pode personalizar sua estrutura, campos e exibir propriedades. Esta seção aborda as principais opções de personalização disponíveis para adaptar schemas aos seus requisitos específicos.

Use os links a seguir para navegar diretamente para as principais tarefas de personalização nesta seção:

Alternância do nome de exibição display-name-toggle

Para sua conveniência, o Editor de esquemas fornece uma alternância entre os nomes de campo originais e os nomes de exibição mais legíveis. Essa flexibilidade permite uma melhor descoberta de campo e edição de seus esquemas. O botão de alternância é encontrado na parte superior direita da visualização Editor de esquemas.

NOTE
A alteração de nomes de campo para nomes de exibição é meramente cosmética e não altera nenhum recurso downstream.

O Editor de Esquemas com Mostrar nomes para exibição para campos foi realçado.

Os nomes de exibição para grupos de campos padrão são gerados pelo sistema, mas podem ser personalizados, conforme descrito na seção nomes de exibição. Os nomes de exibição são refletidos em várias exibições de interface do usuário, incluindo mapeamento e visualizações de conjunto de dados. A configuração padrão está desativada e mostra os nomes dos campos de acordo com os valores originais.

Adicionar grupos de campos a um esquema add-field-groups

NOTE
Esta seção aborda como adicionar grupos de campos existentes a um esquema. Se quiser criar um novo grupo de campos personalizado, consulte o manual sobre criação e edição de grupos de campos.

Depois de abrir um esquema no Schema Editor, você pode adicionar campos ao esquema usando grupos de campos. Para começar, selecione Adicionar ao lado de Grupos de campos no painel esquerdo.

O Editor de Esquemas com o botão Adicionar na seção Grupos de campos do painel esquerdo realçado.

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 na popularidade do uso em sua organização.

A caixa de diálogo Adicionar grupos de campos mostrando grupos de campos disponíveis classificados pela coluna Popularidade.

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 campos.

A caixa de diálogo Adicionar grupos de campos com filtros do Setor selecionados no painel esquerdo e a coluna Setor destacada.

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

Você também pode usar a barra de pesquisa para ajudar a localizar o grupo de campos desejado. Os grupos de campos cujo nome corresponde à consulta são exibidos na parte superior da lista. Em Campos Padrão, os grupos de campos que contêm campos que descrevem os atributos de dados desejados são exibidos.

A caixa de diálogo Adicionar grupos de campos com a barra de pesquisa ativa e os resultados de Campos Padrão exibidos.

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

A caixa de diálogo Adicionar grupos de campos com grupos de campos selecionados usando caixas de seleção e os grupos selecionados mostrados no painel direito.

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

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

A caixa de diálogo Adicionar grupos de campos com grupos de campos selecionados e Adicionar grupos de campos destacados.

O Schema Editor reaparece com os campos fornecidos por grupos de campos representados na tela.

O Editor de esquemas mostrando os campos do grupo de campos recém-adicionado representados na tela.

NOTE
No Editor de Esquemas, classes e grupos de campos padrão (gerados por Adobe) são indicados com o ícone de cadeado Um ícone de cadeado. . O cadeado é exibido no painel à esquerda, ao lado do nome da classe ou do grupo de campos, e também ao lado de qualquer campo no diagrama de esquema que faça parte de um recurso gerado pelo sistema.
O Editor de Esquemas com o ícone de cadeado realçado ao lado de um nome de grupo de campos padrão no painel esquerdo.

Depois de adicionar um grupo de campos a um esquema, você pode, opcionalmente, remover campos existentes ou adicionar novos campos personalizados a esses grupos, dependendo das suas necessidades.

Remover campos adicionados de grupos de campos remove-fields

Depois de adicionar um grupo de campos a um esquema, você pode remover campos globalmente do grupo de campos ou ocultá-los localmente do esquema atual. Entender a diferença entre essas ações é essencial para evitar alterações não intencionais no esquema.

IMPORTANT
Selecionar Remover exclui o campo do próprio grupo de campos, afetando todos esquemas que usam esse grupo de campos.
Não use esta opção, a menos que deseje remover o campo de cada esquema que inclua o grupo de campos.

Para excluir um campo do grupo de campos, selecione-o na tela e selecione Remover no painel direito. Este exemplo mostra o campo taxId do grupo Detalhes Demográficos.

O Editor de Esquemas com um campo selecionado na tela e Remover realçado no painel direito.

Para ocultar vários campos de um esquema sem removê-los do próprio grupo de campos, use a opção Gerenciar campos relacionados. Selecione qualquer campo do grupo na tela e selecione Gerenciar campos relacionados no painel direito.

O Editor de Esquemas com um campo de grupo de campos selecionado na tela e Gerenciar campos relacionados realçados no painel direito.

Uma caixa de diálogo é exibida mostrando a estrutura do grupo de campos. Use as caixas de seleção para marcar ou desmarcar os campos que deseja incluir.

A caixa de diálogo Gerenciar campos relacionados com campos selecionados e Confirmar realçada.

Selecione Confirmar para atualizar a tela e refletir os campos selecionados.

A tela Editor de Esquemas mostrando a estrutura de esquema atualizada após confirmar as alterações de visibilidade de campo na caixa de diálogo Gerenciar campos relacionados.

Comportamento do campo ao remover ou descontinuar campos field-removal-deprecation-behavior

Use a tabela abaixo para entender o escopo de cada ação.

Ação
Aplica-se somente ao esquema atual
Modifica o grupo de campos
Afeta outros esquemas
Descrição
Remover campo
Não
Sim
Sim
Exclui o campo do grupo de campos. Isso o remove de todos os esquemas que usam esse grupo.
Gerenciar campos relacionados
Sim
Não
Não
Oculta campos somente do esquema atual. O grupo de campos permanece inalterado.
Desativar campo
Não
Sim
Sim
Marca o campo como obsoleto no grupo de campos. Não está mais disponível para uso em nenhum schema.
NOTE
Esse comportamento é consistente em esquemas baseados em registros e em eventos.

Adicionar campos personalizados a grupos de campos add-fields

Depois de ter adicionado um grupo de campos a um esquema, você pode definir campos adicionais para esse grupo. No entanto, todos os campos adicionados a um grupo de campos em um esquema também aparecerão em todos os outros esquemas que empregam esse mesmo grupo de campos.

Além disso, se um campo personalizado for adicionado a um grupo de campos padrão, esse grupo de campos será convertido em um grupo de campos personalizado e o grupo de campos padrão original não estará mais disponível.

Para adicionar um campo personalizado a um grupo de campos padrão, consulte a seção abaixo para obter instruções específicas. Se você estiver adicionando campos a um grupo de campos personalizado, consulte a seção sobre edição de grupos de campos personalizados no guia de interface do usuário de grupos de campos.

Se não quiser alterar nenhum grupo de campos existente, você pode criar um novo grupo de campos personalizado para definir campos adicionais.

Adicionar campos a um esquema add-fields-to-schema

O Editor de esquemas fornece várias maneiras de adicionar campos à estrutura do esquema. Escolha a abordagem que melhor atenda às suas necessidades específicas.

Use os links a seguir para ler sobre métodos específicos para adicionar campos a um esquema:

Adicionar campos individuais a um esquema add-individual-fields

O Editor de esquemas permite adicionar campos individuais diretamente a um esquema se você não quiser adicionar um grupo de campos inteiro para um caso de uso específico. Você pode adicionar campos individuais de grupos de campos padrão ou adicionar seus próprios campos personalizados.

IMPORTANT
Embora o Editor de esquemas funcionalmente permita adicionar campos individuais diretamente a um esquema, isso não altera o fato de que todos os campos em um esquema XDM devem ser fornecidos por sua classe ou por um grupo de campos compatível com essa classe. Conforme explicado nas seções abaixo, todos os campos individuais ainda estão associados a uma classe ou grupo de campos como uma etapa principal quando são adicionados a um esquema.

Adicionar campos padrão a um esquema add-standard-fields

Você pode adicionar campos de grupos de campos padrão diretamente a um esquema sem precisar saber seu grupo de campos correspondente antecipadamente. Para adicionar um campo padrão a um esquema, selecione o ícone de adição (+) ao lado do nome do esquema na tela. Um espaço reservado para Campo sem título aparece na estrutura do esquema e o painel direito atualiza para revelar controles para configurar o campo.

A tela Editor de Esquemas com um espaço reservado para Campo sem título adicionado e controles de configuração de campo mostrados no painel direito.

Em Nome do campo, comece digitando o nome do campo que deseja adicionar. O sistema procura automaticamente por campos padrão que correspondam à consulta e os lista em Campos Padrão Recomendados, incluindo os grupos de campos aos quais pertencem.

O painel direito do Editor de Esquemas mostrando Campos Padrão Recomendados correspondentes à consulta de nome de campo inserida.

Embora alguns campos padrão compartilhem o mesmo nome, sua estrutura pode variar dependendo do grupo de campos de onde vêm. Se um campo padrão estiver aninhado em um objeto principal na estrutura do grupo de campos, o campo principal também será incluído no esquema se o campo secundário for adicionado.

Selecione o ícone de visualização ( Ícone de visualização ) ao lado de um campo padrão para exibir a estrutura do grupo de campos e entender melhor como ele pode estar aninhado. Para adicionar o campo padrão ao esquema, selecione o ícone de adição ( ícone de adição ).

O painel de configuração do campo Editor de Esquemas com uma visualização de campo padrão aberta e o ícone de adição realçado.

A tela é atualizada para mostrar o campo padrão adicionado ao esquema, incluindo todos os campos principais sob os quais ele está aninhado dentro da estrutura do grupo de campos. O nome do grupo de campos também está listado em Grupos de campos no painel esquerdo. Se quiser adicionar mais campos do mesmo grupo de campos, selecione Gerenciar campos relacionados no painel direito.

A tela Editor de Esquemas mostrando um campo padrão adicionado à estrutura do esquema, com seus campos pai visíveis e o grupo de campos listado no painel esquerdo.

Adicionar campos personalizados a um esquema add-custom-fields

Semelhante ao fluxo de trabalho para campos padrão, também é possível adicionar seus próprios campos personalizados diretamente a um esquema.

Para adicionar campos ao nível raiz de um esquema, selecione o ícone de adição (+) ao lado do nome do esquema na tela. Um espaço reservado para Campo sem título aparece na estrutura do esquema e o painel direito atualiza para revelar controles para configurar o campo.

A tela Editor de Esquemas com um espaço reservado para Campo Sem Título adicionado no nível raiz e controles de configuração de campo no painel direito.

Comece a digitar o nome do campo que deseja adicionar e o sistema inicia automaticamente a pesquisa por campos padrão correspondentes. Para criar um novo campo personalizado, selecione a opção superior anexada com (Novo campo).

Painel direito do Editor de Esquemas com um nome de campo personalizado inserido e a opção Novo Campo realçada nas sugestões de nome de campo.

Depois de fornecer um nome de exibição e um tipo de dados para o campo, a próxima etapa é atribuir o campo a um recurso XDM principal. Se o esquema usar uma classe personalizada, você poderá optar por adicionar o campo à classe atribuída ou a um grupo de campos. No entanto, se o esquema usar uma classe padrão, você só poderá atribuir o campo personalizado a um grupo de campos.

Atribuir o campo a um grupo de campos personalizado add-to-field-group

NOTE
Esta seção aborda apenas como atribuir o campo a um grupo de campos personalizados. Se, em vez disso, você quiser estender um grupo de campos padrão com o novo campo personalizado, consulte a seção sobre adição de campos personalizados a grupos de campos padrão.

Em Atribuir a, selecione Grupo de Campos. Se o esquema usar uma classe padrão, essa será a única opção disponível e será selecionada por padrão.

Em seguida, é necessário selecionar um grupo de campos ao qual o novo campo será associado. Comece a digitar o nome do grupo de campos na entrada de texto fornecida. Se você tiver grupos de campos personalizados que correspondam à entrada, eles serão exibidos na lista suspensa. Como alternativa, você pode digitar um nome exclusivo para criar um novo grupo de campos.

O painel direito do Editor de Esquemas com a opção de grupo de campos Atribuir a selecionada e o campo de entrada de nome do grupo de campos destacado.

WARNING
Se você selecionar um grupo de campos personalizado existente, todos os outros esquemas que empregam esse grupo de campos também herdarão o campo recém-adicionado depois que você salvar as alterações. Por esse motivo, somente selecione um grupo de campos existente se desejar esse tipo de propagação. Caso contrário, você deve optar por criar um novo grupo de campos personalizados.

Depois de selecionar o grupo de campos na lista, selecione Aplicar.

O painel direito do Editor de Esquemas mostrando a nova configuração de campo personalizado com Aplicar realçado.

O novo campo é adicionado à tela e tem namespace sob sua ID de locatário para evitar conflitos com campos XDM padrão. O grupo de campos ao qual você associou o novo campo também aparece em Grupos de campos no painel esquerdo.

A tela Editor de Esquemas mostrando o novo campo personalizado adicionado sob o namespace de ID de locatário, com o grupo de campos associado listado no painel esquerdo.

NOTE
O restante dos campos fornecidos pelo grupo de campos personalizados selecionado são removidos do esquema por padrão. Se quiser adicionar alguns desses campos ao esquema, selecione um campo pertencente ao grupo e selecione Gerenciar campos relacionados no painel direito.

Atribuir o campo a uma classe personalizada add-to-class

Em Atribuir a, selecione Classe. O campo de entrada abaixo é substituído pelo nome da classe personalizada do esquema atual, indicando que o novo campo será atribuído a essa classe.

A opção Classe está sendo selecionada para a nova atribuição de campo.

Continue a configurar o campo como desejado e selecione Aplicar quando terminar.

O painel direito do Editor de Esquemas mostrando o novo campo atribuído a uma classe personalizada com Aplicar realçado.

O novo campo é adicionado à tela e tem namespace sob sua ID de locatário para evitar conflitos com campos XDM padrão. Selecionar o nome da classe no painel à esquerda revela o novo campo como parte da estrutura da classe.

O novo campo aplicado à estrutura da classe personalizada, representado na tela.

Adicionar campos personalizados a grupos de campos padrão custom-fields-for-standard-groups

Se o esquema em que você está trabalhando tiver um campo do tipo objeto fornecido por um grupo de campos padrão, será possível adicionar seus próprios campos personalizados a esse objeto padrão.

WARNING
Quaisquer campos adicionados a um grupo de campos em um esquema também aparecerão em todos os outros esquemas que empregam esse mesmo grupo de campos. Além disso, se um campo personalizado for adicionado a um grupo de campos padrão, esse grupo de campos será convertido em um grupo de campos personalizado e o grupo de campos padrão original não estará mais disponível.
Se você participou da versão beta desse recurso, você receberá uma caixa de diálogo informando sobre os grupos de campos padrão que você personalizou anteriormente. Após selecionar Confirmar, os recursos listados serão convertidos em grupos de campos personalizados.
A caixa de diálogo de confirmação da conversão beta listou anteriormente os grupos de campos padrão personalizados com Confirmar realçados.

Para iniciar, selecione o ícone de adição (+) ao lado da raiz do objeto fornecido pelo grupo de campos padrão.

A tela Editor de Esquemas com o ícone de adição destacado ao lado de um objeto de grupo de campos padrão para adicionar um campo personalizado.

Uma mensagem de aviso é exibida, solicitando que você confirme se deseja converter o grupo de campos padrão. Selecione Continuar criando grupo de campos para continuar.

A caixa de diálogo de aviso do Editor de Esquemas solicitando confirmação para converter um grupo de campos padrão, com Continue criando o grupo de campos realçado.

A tela de desenho reaparece com um espaço reservado sem título para o novo campo. Observe que o nome do grupo de campos padrão foi anexado com “(Extended)” para indicar que ele foi modificado em relação à versão original. Aqui, use os controles no painel direito para definir as propriedades do campo.

A tela Editor de Esquemas mostrando o grupo de campos padrão renomeado com o sufixo Extended e um campo de espaço reservado sem título adicionado.

Depois de aplicar as alterações, o novo campo aparece sob o namespace da ID do locatário dentro do objeto padrão. Esse namespace aninhado impede conflitos de nome de campo dentro do próprio grupo de campos para evitar alterações em outros esquemas que usam o mesmo grupo de campos.

A tela Editor de Esquemas mostrando o novo campo personalizado adicionado sob o namespace de ID de locatário dentro do grupo de campos padrão convertido.

Editar nomes de exibição para campos de esquema display-names

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 de esses campos terem sido fornecidos por recursos XDM padrão ou personalizados.

NOTE
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 esquema específico. Em outras palavras, alterar o nome de exibição de um campo padrão em um esquema 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.

Altere os nomes de campos para os nomes para exibição alterando em Mostrar nomes para exibição para campos. 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 Nome de exibição.

O Editor de Esquemas com um campo selecionado na tela e o campo Nome de exibição realçado no painel direito.

Selecione Aplicar no painel direito e as atualizações da tela para mostrar o novo nome para exibição do campo. Selecione Salvar para aplicar as alterações ao esquema.

A tela Editor de Esquemas mostrando o nome de exibição do campo atualizado, com Salvar realçado.

Gerenciar esquemas manage-schemas

As tarefas de gerenciamento de esquema estão disponíveis em dois locais principais na interface do usuário do Experience Platform. Escolha o fluxo de trabalho apropriado com base em onde você está trabalhando com seus esquemas.

Gerenciar esquemas na exibição Procurar manage-from-browse

Esta seção documenta as ações de esquema disponíveis na guia Procurar. Para obter informações sobre descoberta, filtragem e organização de esquemas, consulte explorando recursos XDM.

A guia Procurar do espaço de trabalho Esquemas com o menu de reticências aberto para uma linha de esquema, mostrando ações embutidas incluindo Editar, Excluir, Aplicar rótulos e Gerenciar marcas.

As seções a seguir descrevem as ações de gerenciamento de esquema disponíveis na guia Procurar. Essas ações podem ser acessadas por meio do menu de reticências (…) ao lado de cada linha do esquema.

Ação
Descrição
Editar propriedades do esquema
Modifica informações básicas do esquema, incluindo nome de exibição, descrição e tags sem abrir o Editor de esquemas. Para obter instruções detalhadas, consulte Editar propriedades do esquema.
Excluir esquema
Remove o esquema da organização. Disponível somente para esquemas não ativados para o Perfil do cliente em tempo real e sem conjuntos de dados associados. Para obter instruções detalhadas, consulte Excluir esquema.
Aplicar rótulos (governança de dados)
Atribui rótulos de uso de dados para categorizar esquemas de acordo com políticas de privacidade e requisitos de conformidade. Os rótulos aplicados no nível do esquema se propagam para todos os conjuntos de dados criados a partir desse esquema. Para obter instruções detalhadas, consulte Aplicar rótulos de governança de dados.
Criar conjunto de dados
Cria um novo conjunto de dados do esquema selecionado. Para obter instruções detalhadas, consulte Criar conjunto de dados.
Gerenciar marcas
Adiciona ou remove tags definidas pelo usuário para a organização do esquema. Para obter instruções detalhadas, consulte Gerenciar marcas.
Mover para a pasta
Move esquemas para hierarquias de pastas. Para obter instruções detalhadas, consulte Mover para a pasta.
Adicionar ao pacote
Inclui o esquema em um pacote de ferramentas de sandbox para implantação em ambientes. Para obter instruções detalhadas, consulte Adicionar ao pacote.
Copiar estrutura JSON
Copia a representação JSON completa do esquema para a área de transferência. Para obter instruções detalhadas, consulte Copiar estrutura JSON.
Baixar arquivo de amostra
Gera e baixa um arquivo de dados de amostra que esteja em conformidade com a estrutura do esquema. Para obter instruções detalhadas, consulte Baixar arquivo de amostra.
NOTE
Os arquivos de amostra são para testar a estrutura do esquema e não devem conter dados de produção.

Editar propriedades do esquema edit-schema-properties

Direciona para o Editor de esquemas com o esquema pré-preenchido.

Excluir esquema delete-schema

Remove o esquema da organização. A exclusão está disponível somente para esquemas que não foram ativados para o Perfil do cliente em tempo real e não têm conjuntos de dados associados. Depois de excluído, o esquema não pode ser recuperado.

Aplicar rótulos de governança de dados apply-data-governance-labels

Direciona para a guia Rótulo do espaço de trabalho de Esquemas. Para obter instruções completas, consulte a documentação Gerenciar rótulos de uso de dados para um esquema.

Criar conjunto de dados create-dataset

AVAILABILITY
Essa ação está disponível somente para esquemas padrão (não relacionais).

Abre a caixa de diálogo Criar conjunto de dados a partir do esquema com o nome do esquema de origem pré-preenchido. Insira um conjunto de dados Nome e, opcionalmente, uma Descrição e selecione Criar conjunto de dados para criar o conjunto de dados.

A caixa de diálogo Criar conjunto de dados a partir do esquema com os campos Nome e Descrição realçados e o botão Criar conjunto de dados.

Após criar o conjunto de dados, ele é aberto no espaço de trabalho Conjuntos de dados.

Gerenciar tags manage-tags

Abre a caixa de diálogo Adicionar ou remover marcas, na qual você pode atribuir ou remover marcas definidas pelo usuário do esquema. As tags atribuídas a um esquema aparecem no inventário de esquemas e podem ser usadas para filtragem. Para obter mais informações sobre a organização baseada em marcas, consulte explorando recursos XDM.

Mover para a pasta move-to-folder

Abre a caixa de diálogo Mover, na qual você pode selecionar uma pasta de destino ou criar uma nova pasta. Os esquemas organizados em pastas aparecem na hierarquia de pastas no painel à esquerda. Para obter mais informações sobre a organização baseada em pastas, consulte explorando recursos XDM.

Adicionar ao pacote add-to-package

Inclui o esquema em um pacote de ferramentas de sandbox para implantação em ambientes. O schema deve atender aos requisitos de qualificação de pacote. Os pacotes que contêm schemas podem ser exportados e importados entre sandboxes.

Copiar estrutura JSON copy-json-structure

Copia a representação JSON completa do esquema para a área de transferência. A saída corresponde à estrutura do esquema conforme armazenado no Registro de esquema e pode ser usada para operações de API ou compartilhamento de esquema.

Baixar arquivo de amostra download-sample-file

Gera e baixa um arquivo de dados de amostra que esteja em conformidade com a estrutura do esquema. O arquivo contém valores de exemplo para cada campo definido no esquema. Os arquivos de amostra são destinados apenas ao teste da estrutura do esquema e não devem conter dados de produção.

Gerenciar esquemas no Editor de esquemas manage-from-editor

No Editor de esquemas, você pode executar ações rápidas para copiar a estrutura JSON do esquema ou excluí-lo se ele não tiver sido ativado para o Perfil de cliente em tempo real e não tiver conjuntos de dados associados. Selecione Mais na parte superior da exibição para exibir uma lista suspensa com ações rápidas.

O Editor de Esquemas com o botão Mais realçado e a lista suspensa de ações rápidas exibida.

A funcionalidade Copiar estrutura JSON permite ver como seria uma carga de amostra enquanto você ainda está criando o esquema e seus pipelines de dados. É especialmente útil para situações em que há estruturas complexas de mapa de objetos no esquema, como um mapa de identidade.

Finalizar um esquema finalize-schema

Quando terminar de personalizar a estrutura do esquema e os campos, talvez seja necessário executar etapas adicionais para prepará-lo para o uso da produção. Essas etapas finais de configuração garantem que seu esquema esteja integrado corretamente aos serviços da Experience Platform.

Habilitar um esquema para o perfil do cliente em tempo real profile

O Perfil de Cliente em Tempo Real mescla dados de diferentes fontes para criar uma exibição completa de cada cliente individual. Se quiser que os dados capturados por um esquema participem desse processo, habilite o esquema para uso em Profile.

IMPORTANT
Para habilitar um esquema para Profile, ele deve ter um campo de identidade primário definido. Consulte o manual sobre definição de campos de identidade para obter mais informações.

Para habilitar o esquema, comece selecionando o nome do esquema no painel esquerdo e selecione a opção de alternância Perfil no painel direito.

O Editor de Esquemas com o nome do esquema selecionado no painel esquerdo e a opção de alternância Perfil realçada no painel direito.

Um popover é exibido, avisando que, uma vez que um esquema tenha sido ativado e salvo, ele não poderá ser desativado. Selecione Habilitar para continuar.

Popover de confirmação Habilitar para Perfil com o botão Habilitar realçado.

A tela será exibida novamente com a opção de alternância Perfil habilitada.

IMPORTANT
Como o esquema ainda não foi salvo, esse é o ponto sem volta se você mudar de ideia sobre como permitir que o esquema participe do Perfil do cliente em tempo real: depois de salvar um esquema ativado, ele não poderá mais ser desativado. Selecione a opção de alternância Perfil novamente para desabilitar o esquema.

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

O painel direito do Editor de Esquemas mostrando a alternância Perfil no estado habilitado.

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

Alterar a classe de um esquema change-class

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

WARNING
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 Atribuir no lado esquerdo da tela.

A tela Editor de Esquemas com o botão Atribuir realçado à esquerda.

Uma caixa de diálogo é exibida, mostrando uma lista de todas as classes disponíveis, incluindo as definidas pela sua organização (sendo o proprietário “Cliente”), bem como as classes padrão definidas pela 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.

A caixa de diálogo Atribuir classe mostrando as classes disponíveis com a descrição de classe selecionada exibida e a opção Atribuir classe realçada.

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

Caixa de diálogo de confirmação de reatribuição de classe com o botão Atribuir realçado.

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

Próximas etapas next-steps

Este documento aborda as noções básicas para a criação e edição de esquemas na interface do usuário do Experience Platform. É altamente recomendável que você consulte o tutorial de criação de esquemas para obter um fluxo de trabalho abrangente e criar um esquema 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 Esquemas, consulte a visão geral do espaço de trabalho de ​.

Para saber como gerenciar esquemas na API Schema Registry, consulte o manual de endpoint de esquemas.

recommendation-more-help
experience-platform-help-xdm