Criar e editar classes na interface ui-create-and-edit

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 o Perfil Individual XDM e o 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 Experience 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 à função do XDM no ecossistema do Experience Platform e as noções básicas da composição de esquemas para saber como as classes contribuem para os esquemas XDM.

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

Introdução getting-started

Na interface do usuário do Experience Platform, selecione Schemas na navegação à esquerda para abrir o espaço de trabalho Schemas e selecione a guia Classes. Uma lista de classes disponíveis é exibida.

Filtrar classes filter

A lista de classes é automaticamente filtrada com base em como foram criadas. A configuração padrão exibe as classes definidas pelo Adobe. Também é possível filtrar a lista para mostrar os criados por sua organização. Selecione o botão de opção para escolher entre as opções Standard e Custom. A opção Standard mostra entidades criadas pelo Adobe e a opção Custom exibe entidades criadas na organização.

Criar uma nova classe create

Há dois métodos para criar uma classe na interface do Experience Platform, por meio de Create class ou Create schema.

Criar classe

Selecione Create class na guia Classes do espaço de trabalho Schemas.

A caixa de diálogo Create class é exibida. Insira um Display name e Description para sua classe e escolha o comportamento pretendido para sua classe com os botões de opção. As classes podem ser do tipo Record ou Time-series. Selecione Create para confirmar suas escolhas e retornar à guia Classes.

A classe criada está disponível e listada na visualização Classes.

Criar esquema

Como alternativa, você pode criar uma classe criando um esquema manualmente. Selecione Create schema na guia Classes do espaço de trabalho Schemas.

Selecione Manual na caixa de diálogo Create a schema exibida.

O workflow de criação do schema é exibido. Na seção Schema details, selecione Other. Uma lista de classes disponíveis é exibida. Selecione Create class.

A caixa de diálogo Create class é exibida. Insira um Display name e Description para sua classe e escolha o comportamento pretendido para sua classe com os botões de opção. As classes podem ser do tipo Record ou Time-series. Selecione Create para confirmar suas escolhas e retornar à guia Classes.

A lista de classes é atualizada na seção Schema details, e sua classe recém-criada é selecionada automaticamente. Selecione Next para continuar criando seu esquema.

Após selecionar uma classe, a seção Name and review é 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 Schema display name amigável no campo de texto. Em seguida, insira uma descrição adequada para ajudar a identificar seu esquema. Quando tiver revisado sua estrutura de esquema e estiver satisfeito com suas configurações, selecione Finish para criar seu esquema.

Adicionar campos a uma classe add-fields

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

Um espaço reservado Untitled Field aparece no na tela e o painel direito é atualizado para mostrar controles para configurar as propriedades do campo. Em Assign to, selecione Class.

Consulte o manual 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 Save para salvar o esquema e a classe.

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

Editar uma classe edit-a-class

Você pode editar uma classe por meio do workflow do esquema editando um esquema existente que estende a classe ou criando manualmente um esquema. Não é possível editar uma classe diretamente. Dentro da guia Browse no espaço de trabalho Schemas, selecione uma classe existente ou Create a schema.

Se você optar por criar um novo esquema, consulte a seção sobre criação de um esquema para obter detalhes. Quando terminar de criar o esquema (ou após selecionar um esquema existente), o Editor de esquemas será exibido. Para atualizar um campo de classe existente, selecione o campo na estrutura do esquema. As informações do campo aparecerão no painel direito. Assegure o Assign to
a opção Class está selecionada ou suas atualizações não afetarão a classe.

Faça as alterações desejadas no campo, rolando para baixo no painel direito para selecionar Apply para salvar suas alterações.

Para adicionar novos campos, siga o guia adicionar campos a uma classe. Quando terminar, selecione Save para salvar o esquema e a classe.

Alterar a classe de um esquema schema

Você pode alterar a classe do schema em qualquer momento durante o processo de criação inicial, antes que ele seja salvo. No entanto, isso deve ser feito com cuidado, pois os grupos de campo são compatíveis apenas com determinadas classes. Alterar a classe redefine a tela de desenho e quaisquer campos adicionados.
Consulte o manual sobre criação e edição de esquemas para obter mais informações.

Próximas etapas next-steps

Este documento abordou como criar e editar classes usando a interface do usuário do Experience Platform. 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 do Registro de Esquema, consulte o manual de ponto de extremidade de classes.