Criar e editar tipos de dados usando a interface ui-create-and-edit

No Experience Data Model (XDM), os tipos de dados são campos reutilizáveis que contêm vários subcampos. Embora semelhantes aos grupos de campos de esquema, no sentido de que permitem o uso consistente de uma estrutura de vários campos, os tipos de dados são mais flexíveis, pois podem ser incluídos em qualquer lugar na estrutura do esquema, enquanto os grupos de campos só podem ser adicionados no nível raiz.

O Adobe Experience Platform fornece vários tipos de dados padrão que podem ser usados para abranger uma grande variedade de casos de uso comuns do gerenciamento de experiência. No entanto, você também pode definir seus próprios tipos de dados personalizados para atender às suas necessidades comerciais exclusivas.

NOTE
Se um campo for definido como um tipo de dados específico, você não poderá criar o mesmo campo com um tipo de dados diferente em outro esquema. Essa restrição se aplica ao locatário da organização.

Este tutorial aborda as etapas para a criação e edição de tipos de dados personalizados na interface do usuário da Platform.

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 ao papel do XDM no ecossistema de Experience Platform, e a noções básicas da composição do esquema para saber como os tipos de dados contribuem para esquemas XDM.

Embora não seja necessário para este guia, é recomendável seguir o tutorial em composição de um esquema na interface para se familiarizar com os vários recursos do Schema Editor.

Abra o Schema Editor para um tipo de dados data-type

Na interface do usuário da Platform, selecione Esquemas na navegação à esquerda, para abrir a Esquemas e selecione o Tipos de dados guia. Uma lista de tipos de dados disponíveis é exibida. A lista de tipos de dados é automaticamente filtrada com base em como foram criados. A configuração padrão exibe os tipos de dados definidos pelo Adobe. Também é possível filtrar a lista para mostrar os criados por sua organização.

A variável Esquemas espaço de trabalho com Esquemas no painel de navegação esquerdo e Tipos de dados destacado.

Aqui, você tem as seguintes opções:

Criar um novo tipo de dados create

No Tipos de dados selecione Criar tipo de dados.

A variável Esquemas espaço de trabalho Tipos de dados guia com Criar tipo de dados destacado.

A variável Schema Editor é exibida, mostrando a estrutura atual do novo tipo de dados na tela. No lado direito do editor, é possível fornecer um nome de exibição e uma descrição opcional para o tipo de dados. Certifique-se de fornecer um nome exclusivo e conciso para o tipo de dados, pois é assim que ele será identificado ao adicioná-lo a um esquema.

Este tutorial cria um tipo de dados que descreve uma propriedade de restaurante, portanto, o tipo de dados recebe o nome de exibição "Restaurante".

A partir daqui, você pode pular para a próxima seção para começar a adicionar campos ao novo tipo de dados.

Filtrar tipos de dados filter

A lista de tipos de dados disponíveis é pré-filtrada com base em como foram criados. Selecione o botão de opção para escolher entre as opções Padrão e Personalizado opções. A variável Padrão mostra entidades criadas por Adobe e a variável Personalizado exibe entidades criadas na organização.

A variável Tipos de dados guia do Esquemas espaço de trabalho com Padrão e Personalizado destacado.

Editar um tipo de dados existente edit

NOTE
Depois que um tipo de dados existente for usado em um esquema que foi ativado para uso no Perfil do cliente em tempo real, somente alterações não destrutivas poderão ser feitas nesse tipo de dados. Consulte a regras de evolução do schema para obter mais informações.

Somente tipos de dados personalizados definidos por sua organização podem ser editados. Selecionar Personalizado para mostrar somente os tipos de dados personalizados de propriedade de sua organização.

Selecione o tipo de dados que deseja editar na lista para abrir o painel direito, mostrando os detalhes do tipo de dados. No painel de detalhes, também é possível baixar um arquivo de amostra, copiar a estrutura JSON ou adicionar o tipo de dados a um pacote.

Selecione o nome do tipo de dados no painel direito para abrir sua estrutura no Schema Editor.

A variável Tipos de dados guia do Esquemas espaço de trabalho, com um tipo de dados, Personalizado e o tipo de dados Nome destacado.

Adicionar campos ao tipo de dados add-fields

Para começar a adicionar campos ao tipo de dados, selecione o mais (+) ícone ao lado do campo de nível raiz na tela. Um novo campo é exibido abaixo, e o painel direito é atualizado para exibir controles do novo campo.

Use os controles no painel direito para configurar os detalhes do novo campo. Consulte o guia sobre definição de campos na interface para obter etapas específicas sobre como configurar e adicionar o campo ao tipo de dados.

O tipo de dados Restaurant requer um campo de sequência para representar o nome do restaurante. Como tal, a Comissão Nome do campo é definido como "name" e a variável Tipo está definido como "String". Selecionar Aplicar para aplicar as alterações ao campo.

Continue adicionando mais campos ao tipo de dados, conforme necessário. O tipo de dados Exemplo de restaurante agora tem campos adicionais para marca, capacidade de assento e espaço.

Além dos campos básicos, você também pode aninhar tipos de dados adicionais com seu tipo de dados personalizado. Por exemplo, o tipo de dados Restaurant requer um campo que representa o endereço físico da propriedade. Nesse cenário, é possível adicionar um novo campo "address", que recebe o tipo de dados padrão "Endereço postal".

Isso demonstra como tipos de dados podem ser flexíveis em termos de descrição de seus dados: os tipos de dados podem empregar campos que também são tipos de dados, que podem conter outros tipos de dados e assim por diante. Isso permite abstrair e reutilizar padrões de dados comuns em todos os esquemas XDM, facilitando a representação de estruturas de dados complexas.

Quando terminar de adicionar campos ao tipo de dados, selecione Salvar para salvar suas alterações e adicionar o tipo de dados à Schema Library.

Adicionar o tipo de dados a um esquema add-data-type

Depois de criar um tipo de dados, você pode começar a usá-lo em seus schemas. Como os esquemas XDM são compostos de uma classe e zero ou mais grupos de campos, os campos fornecidos por um tipo de dados não podem ser adicionados diretamente a um esquema. Em vez disso, eles devem ser incluídos em uma classe ou em um grupo de campos.

Comece seguindo as etapas envolvidas com adicionar um campo a uma classe ou adicionar um campo a um grupo de campos. Como alternativa, você pode iniciar adição de um campo diretamente a um esquema e escolha a classe pai ou o grupo de campos a partir daí. Ao escolher a variável Tipo para o novo campo, selecione o nome do seu tipo de dados no menu suspenso.

Converter um objeto de vários campos em um tipo de dados convert

Ao criar um campo do tipo objeto com vários subcampos no Schema Editor, é possível converter esse campo em um tipo de dados para usar a mesma estrutura de campo em uma classe ou grupo de campos diferente.

Para converter um campo do tipo objeto em um tipo de dados, selecione o campo na tela. Antes de converter o campo, verifique se Nome de exibição é descritiva dos dados que o objeto conterá, pois esse se tornará o nome do tipo de dados. Quando estiver pronto para converter o campo, selecione Converter em novo tipo de dados no painel direito.

A tela atualiza o tipo de dados do campo de "Objeto" para o novo tipo de dados. Essa estrutura agora pode ser reutilizada em outras classes e grupos de campos selecionando esse tipo de dados na Tipo ao definir um novo campo.

Próximas etapas next-steps

Este guia abordou como criar e editar tipos de dados usando a interface do usuário da plataforma. Para obter mais informações sobre os recursos do Esquemas espaço de trabalho, consulte a Esquemas visão geral do espaço de trabalho.

Para saber como gerenciar tipos de dados usando o Schema Registry , consulte a guia de endpoint de tipos de dados.

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07