Na Adobe Experience Platform, a classe de um esquema define os aspectos comportamentais dos dados que o esquema conterá (registro ou série temporal). Além disso, as classes descrevem o menor número de propriedades comuns que todos os esquemas baseados nessa classe precisariam incluir e fornecem uma maneira de vários conjuntos de dados compatíveis serem mesclados.
O Adobe fornece várias classes padrão ("núcleo") do Experience Data Model (XDM), 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 para sua organização.
Este documento fornece uma visão geral de como criar, editar e gerenciar classes personalizadas na interface do usuário do Experience Platform.
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 as classes 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.
No Esquemas espaço de trabalho, selecione Criar esquema e selecione Procurar na lista suspensa.
É exibida uma caixa de diálogo que permite selecionar em uma lista de classes disponíveis. Na parte superior da caixa de diálogo, selecione Criar nova classe. Em seguida, você pode dar à sua nova classe um nome de exibição (um nome curto, descritivo, exclusivo e amigável para a classe), uma descrição e um comportamento para os dados que o esquema definirá (Gravar ou Séries cronológicas).
Quando terminar, selecione Atribuir classe.
A variável Schema Editor é exibida, mostrando um novo esquema na tela com base na classe personalizada que você acabou de criar. Como nenhum campo foi adicionado à classe ainda, o esquema contém apenas um _id
que representa o identificador exclusivo gerado pelo sistema aplicado automaticamente a todos os recursos na Schema Registry.
Ao criar um esquema que implementa uma classe definida por sua 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 Adicionar grupo de campos diálogo. Em vez disso, será necessário criar novos grupos de campos para uso 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 começar adicionar campos à classe, que serão compartilhados por todos os esquemas que empregam a classe.
Somente as classes personalizadas definidas por 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 esquemas 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 nela a partir de então. Consulte a regras de evolução do schema para obter mais informações.
Para editar uma classe existente, selecione o Procurar e selecione o nome de um schema que emprega a classe que deseja editar.
Você pode usar os recursos de pesquisa e filtragem do espaço de trabalho para facilitar a localização do esquema. Consulte o guia sobre exploração de recursos XDM para obter mais informações.
A variável Schema Editor é exibida, com a estrutura do schema mostrada na tela. Agora você pode começar adicionar campos à classe.
Depois que você tiver um esquema que emprega uma classe personalizada aberta na Editor de esquema, você pode começar a adicionar campos à classe. Para adicionar um novo campo, selecione a variável mais (+) ícone ao lado do nome do esquema.
Lembre-se de que todos os 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 só pode ver uso em alguns esquemas nesta classe, você pode considerar adicioná-lo a esses esquemas por criação de um grupo de campos em vez disso.
Um Campo sem título o espaço reservado é exibido no na tela, e o painel direito é atualizado para mostrar controles para configurar as propriedades do campo. Em Atribuir a, selecione Classe.
Consulte o guia sobre definição de campos na interface 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 Salvar para salvar o schema e a classe.
Se você tiver criado esquemas que empregam essa classe, os campos recém-adicionados aparecerão automaticamente nesses esquemas.
Você pode alterar a classe do schema em qualquer momento durante o processo de criação inicial, antes que ele seja salvo. Consulte o guia sobre criação e edição de schemas para obter mais informações.
Este documento abordou como criar e editar classes 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 aulas usando o Schema Registry , consulte a manual de endpoint de classes.