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 usuário 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 de Experience Platform e as noções básicas da composição de esquema 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 da Platform, selecione Esquemas na navegação à esquerda para abrir o espaço de trabalho Esquemas 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 Padrão e Personalizado. A opção Padrão mostra entidades criadas pelo Adobe e a opção Personalizado exibe entidades criadas na sua organização.

Criar uma nova classe create

Há dois métodos para criar uma classe na interface do usuário da Platform, por meio de Criar classe ou Criar esquema.

Criar classe

Selecione Criar classe na guia Classes do espaço de trabalho Esquemas.

A caixa de diálogo Criar classe é exibida. Insira um Nome de exibição e uma Descrição para sua classe e escolha o comportamento pretendido para sua classe com os botões de opção. As classes podem ser do tipo Registro ou Série temporal. Selecione Criar para confirmar suas escolhas e retornar à guia Classes.

A classe criada está disponível e listada no modo de exibição Classes.

Criar esquema

Como alternativa, você pode criar uma classe criando um esquema manualmente. Selecione Criar esquema na guia Classes no espaço de trabalho Esquemas.

Selecione Manual na caixa de diálogo Criar um esquema exibida.

O workflow de criação do schema é exibido. Na seção Detalhes do esquema, selecione Outros. Uma lista de classes disponíveis é exibida. Selecione Criar classe.

A caixa de diálogo Criar classe é exibida. Insira um Nome de exibição e uma Descrição para sua classe e escolha o comportamento pretendido para sua classe com os botões de opção. As classes podem ser do tipo Registro ou Série temporal. Selecione Criar para confirmar suas escolhas e retornar à guia Classes.

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

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.

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 para Campo sem título aparece na tela e o painel direito atualiza para mostrar controles que configuram as propriedades do campo. Em Atribuir a, selecione Classe.

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 Salvar 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 Procurar no espaço de trabalho Esquemas, selecione uma classe existente ou Criar um esquema.

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 a Atribuir a
a opção Classe 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 Aplicar para salvar as alterações.

Para adicionar novos campos, siga o guia adicionar campos a uma classe. Quando terminar, selecione Salvar 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 da plataforma. 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 classes usando a API do Registro de Esquema, consulte o manual de ponto de extremidade de classes.