Definir enumerações e valores sugeridos na interface enums-and-suggested-values

No Experience Data Model (XDM), um campo de sequência pode receber um conjunto predefinido de valores aceitos ou sugeridos para controlar melhor quais valores são assimilados nesse campo ou como ele se comportará na segmentação.

Enumerações restringir os valores que podem ser assimilados de um campo de string para um conjunto predefinido. Se você tentar assimilar dados em um campo enum e o valor não corresponder a nenhum dos definidos em sua configuração, a assimilação será negada.

Ao contrário dos enums, a variável Valores sugeridos permite que o indique um conjunto de valores recomendados para um campo de string que não restringem os valores que ele pode assimilar. Em vez disso, os valores sugeridos afetam quais valores predefinidos estão disponíveis no Interface de segmentação ao incluir o campo de string como um atributo.

Quando definição de um novo campo na interface do usuário do Adobe Experience Platform e definir o tipo como String, você terá a opção de definir uma enum ou valores sugeridos para esse campo.

Imagem mostrando a opção Enumeração e valores sugeridos ativada para um campo de string na interface do usuário

Este documento aborda como definir enumerações e valores sugeridos na Esquemas Espaço de trabalho da interface do usuário. Para obter uma visão geral rápida sobre enumerações e valores sugeridos, incluindo como configurá-los na interface do usuário e seus efeitos downstream, assista ao seguinte vídeo:

Definir um enum enum

Selecionar Enumerações e valores sugeridos e selecione Enumerações. Controles adicionais são exibidos, permitindo especificar as restrições de valor para o enum. Para adicionar uma restrição, selecione Adicionar linha.

Imagem mostrando a opção Enumerações selecionada na interface do usuário

No Valor , você deve fornecer o valor exato ao qual deseja restringir o campo. Você pode, opcionalmente, fornecer um Nome de exibição para a restrição também, o que afeta como o valor será representado na segmentação.

Continuar a usar Adicionar linha para adicionar as restrições desejadas e os rótulos opcionais ao enum, ou selecione o ícone excluir ( Imagem do ícone de exclusão ) ao lado de uma linha adicionada anteriormente para removê-la. Quando terminar, selecione Aplicar para aplicar as alterações ao esquema.

Imagem que mostra os valores de enumeração e nomes de exibição preenchidos para o campo de string na interface

A tela é atualizada para refletir as alterações. Ao explorar esse esquema no futuro, você pode visualizar e editar as restrições para o campo de enumeração no painel direito.

Definir valores sugeridos suggested-values

Selecionar Enumerações e valores sugeridos e selecione Valores sugeridos para fazer com que controles adicionais apareçam. Aqui, selecione Adicionar linha para começar a adicionar valores sugeridos.

Imagem mostrando a opção Valores sugeridos selecionada na interface do usuário

No Nome de exibição forneça um nome amigável para o valor como deseja que ele seja exibido na interface do usuário de segmentação. Para adicionar mais valores sugeridos, selecione Adicionar linha novamente e repita o processo conforme necessário. Para remover uma linha adicionada anteriormente, selecione o ícone excluir ao lado da linha em questão.

Quando terminar, selecione Aplicar para aplicar as alterações ao esquema.

Imagem que mostra os valores de enumeração e nomes de exibição preenchidos para o campo de string na interface

NOTE
Há um atraso de aproximadamente cinco minutos para que os valores sugeridos atualizados de um campo sejam refletidos na interface do usuário de segmentação.

Gerenciar valores sugeridos para campos padrão

Alguns campos de componentes XDM padrão contêm seus próprios valores sugeridos, como eventType do XDM ExperienceEvent classe. Embora seja possível criar valores sugeridos adicionais para um campo padrão, não é possível modificar ou remover valores sugeridos que não estejam definidos pela organização. Ao visualizar um campo padrão na interface do usuário do, os valores sugeridos são exibidos, mas são somente leitura.

Imagem que mostra os valores de enumeração e nomes de exibição preenchidos para o campo de string na interface

Para adicionar novos valores sugeridos para um campo padrão, selecione Adicionar linha. Para remover um valor sugerido que foi adicionado anteriormente por sua organização, selecione o ícone excluir ao lado da linha em questão.

Imagem que mostra os valores de enumeração e nomes de exibição preenchidos para o campo de string na interface

Regras de evolução para enumerações e valores sugeridos evolution

Depois que um esquema com um campo de enumeração é usado para assimilar dados na Platform, qualquer alteração adicional feita na definição do esquema deve estar em conformidade com os dados já existentes no sistema. Em geral, as alterações feitas em um campo existente só podem fazer com que esse campo menos restritivo. Um campo não pode se tornar mais restritivo do que já é.

Quando se trata de enumerações e valores sugeridos, as seguintes regras se aplicam após a assimilação:

  • Você PODE adicione os valores sugeridos para campos padrão e personalizados com os valores sugeridos existentes.
  • Você PODE remova os valores sugeridos dos campos personalizados com os valores sugeridos existentes.
  • Você PODE adicione novos valores de enumeração para um campo de enumeração personalizado existente.
  • Você PODE alterne os valores de enumeração de um campo personalizado somente para os valores sugeridos ou converta-os em uma sequência de caracteres sem enumeração ou valores sugeridos. Essa opção não pode ser desfeita depois de aplicada.
  • Você NÃO PODE remova enumerações ou valores sugeridos dos campos padrão.
  • Você NÃO PODE adicione valores de enumeração a um campo sem enumeração existente.
  • Você NÃO PODE remova menos do que todos os valores de enumeração existentes para um campo personalizado.
  • Você NÃO PODE alterne de valores sugeridos para um enum.

Mesclar regras para enumerações e valores sugeridos merging

Se vários esquemas usarem o mesmo campo de enumeração com configurações diferentes e esses esquemas forem incluídos em uma união, determinadas regras se aplicam quando se trata de como as diferenças de enumeração são reconciliadas. As regras exatas dependem se os esquemas que fazem referência ao mesmo campo padrão (como eventType) ou se estiverem fazendo referência ao mesmo caminho de campo personalizado em grupos de campos diferentes.

Se fizer referência ao mesmo campo padrão:

  • Quaisquer valores adicionais sugeridos são ANEXADO na união.
  • As atualizações feitas nos valores sugeridos para a mesma chave enum são ATUALIZADO na união.

Se estiver fazendo referência ao mesmo caminho de campo personalizado em grupos de campos diferentes:

  • Quaisquer valores adicionais sugeridos são ANEXADO na união.
  • Se o mesmo valor adicional sugerido for definido em mais de um schema, esses valores serão MESCLADO na união. Em outras palavras, o mesmo valor sugerido não aparecerá duas vezes após a mesclagem.

Limitações da validação

Devido às limitações atuais do sistema, há dois casos em que um enum não é validado pelo sistema durante a assimilação:

  1. O enum é definido em um campo de matriz.
  2. A enumeração está definida em mais de um nível profundo na hierarquia de esquema.

Próximas etapas

Este guia abordou como definir enumerações e valores sugeridos para campos de sequência na interface do usuário. Para obter informações sobre como gerenciar enumerações e valores sugeridos usando a API do Registro de Esquema, consulte o seguinte tutorial.

Para saber como definir outros tipos de campo XDM na variável Schema Editor, consulte a visão geral em definição de campos na interface.

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