Criar e editar classes na interface do usuário

No Experience Data Model (XDM), as classes definem os aspectos comportamentais dos dados que um schema conterá (registro ou série de tempo). Além disso, as classes descrevem o menor número de propriedades comuns que todos os esquemas baseados nessa classe precisariam incluir e fornecer uma maneira de vários conjuntos de dados compatíveis serem mesclados.

O Adobe fornece várias classes XDM padrão ("core"), incluindo XDM Individual Profile e XDM ExperienceEvent. Além dessas classes principais, você também pode criar suas próprias classes personalizadas para descrever casos de uso mais específicos da sua organização.

Este documento fornece uma visão geral de como criar, editar e gerenciar classes personalizadas na interface do usuário do Adobe Experience Platform.

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 saber como as classes contribuem para os esquemas XDM.

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

Criar uma nova classe

No espaço de trabalho Schemas, selecione Create schema e selecione Browse no menu suspenso.

Uma caixa de diálogo é exibida e permite selecionar a partir de uma lista de classes disponíveis. Na parte superior da caixa de diálogo, selecione Create new class. Em seguida, você pode fornecer um nome de exibição para sua nova classe (um nome curto, descritivo, exclusivo e amigável para a classe), uma descrição e um comportamento para os dados que o schema definirá ("Record" ou "Time-series").

Quando terminar, selecione Assign class.

O Schema Editor é exibido, mostrando um novo schema na tela que é baseado na classe personalizada que você acabou de criar. Como nenhum campo foi adicionado à classe ainda, o schema contém apenas um campo _id, que representa o identificador exclusivo gerado pelo sistema que é aplicado automaticamente a todos os recursos no Schema Registry.

IMPORTANTE

Ao criar um schema que implementa uma classe definida pela organização, lembre-se de que os grupos de campos de esquema estão disponíveis para uso somente com classes compatíveis. Como a classe definida é nova, não há grupos de campos compatíveis listados na caixa de diálogo Add field group. Em vez disso, será necessário criar novos grupos de campos para usar com essa classe. Na próxima vez que você compor um schema que implementa a nova classe, os grupos de campos definidos serão listados e estarão disponíveis para uso.

Agora você pode iniciar adicionando campos à classe, que será compartilhada por todos os schemas que empregam a classe.

Editar uma classe existente

OBSERVAÇÃO

Somente as classes personalizadas definidas pela sua organização podem ser totalmente editadas e personalizadas. Para classes principais definidas por Adobe, somente os nomes de exibição de seus campos podem ser editados no contexto de schemas individuais. Consulte a seção sobre edição de nomes de exibição para campos de esquema para obter detalhes.

Depois que uma classe personalizada é salva e usada na assimilação de dados, somente alterações aditivas podem ser feitas a ela depois. Consulte as regras de evolução do schema para obter mais informações.

Para editar uma classe existente, selecione a guia Browse e selecione o nome de um schema que emprega a classe 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.

O Schema Editor é exibido, com a estrutura do schema mostrada na tela. Agora você pode iniciar adicionando campos à classe.

Adicionar campos a uma classe

Depois de ter um schema que emprega uma classe personalizada aberta no Schema Editor, você pode começar a adicionar campos à classe. Para adicionar um novo campo, selecione o ícone de adição (+)ao lado do nome do schema.

IMPORTANTE

Lembre-se de que quaisquer campos adicionados a uma classe serão usados em todos os esquemas que empregam essa classe. Portanto, você deve considerar cuidadosamente quais campos serão úteis em todos os casos de uso do schema. Se estiver pensando em adicionar um campo que pode ver o uso somente em alguns schemas sob essa classe, talvez você queira considerar adicioná-lo a esses esquemas ao criar um grupo de campos.

Um New field aparece na tela e o painel direito é atualizado para mostrar controles para configurar as propriedades do campo. Consulte o guia em definindo campos na interface do usuário para obter etapas específicas sobre como configurar e adicionar o campo à classe.

Continue a adicionar quantos campos forem necessários à classe. Quando terminar, selecione Save para salvar o schema e a classe.

Se você tiver criado esquemas que empregam essa classe anteriormente, os campos recém-adicionados aparecerão automaticamente nesses esquemas.

Alterar a classe de um schema

Você pode alterar a classe do schema em qualquer ponto durante o processo de criação inicial antes que ele seja salvo. Consulte o guia em criar e editar schemas para obter mais informações.

Próximas etapas

Este documento cobriu como criar e editar classes usando a interface do usuário da plataforma. Para obter mais informações sobre os recursos do espaço de trabalho Schemas, consulte a Schemas visão geral do espaço de trabalho.

Para saber como gerenciar classes usando a API Schema Registry, consulte o guia de ponto de extremidade de classes.

Nesta página