Explorar recursos de esquema na interface do

No Adobe Experience Platform, todos os recursos de esquema do Experience Data Model (XDM) são armazenados no Schema Library, incluindo os recursos padrão fornecidos pelo Adobe e os recursos personalizados definidos pela sua organização. Na interface do usuário do Experience Platform, é possível exibir a estrutura e os campos de qualquer esquema, classe, grupo de campos ou tipo de dados existente no Schema Library. Isso é especialmente útil ao planejar e se preparar para a assimilação de dados, pois a interface do usuário fornece informações sobre os tipos de dados e casos de uso esperados de cada campo fornecido por esses recursos XDM.

Este tutorial aborda as etapas para explorar esquemas, classes, grupos de campos e tipos de dados existentes na interface do usuário do Experience Platform.

Pesquisar um recurso de esquema lookup

Na interface da Platform, selecione Esquemas na navegação à esquerda. O espaço de trabalho Esquemas fornece uma guia Procurar para explorar todos os esquemas em sua organização, juntamente com guias dedicadas adicionais para explorar Classes, Grupos de campos, Tipos de dados e Relações, respectivamente.

O ícone de filtro ( ) revela controles no painel esquerdo para restringir os resultados listados. Os filtros de recursos estão disponíveis para esquemas e relações nas guias Procurar e Relações, respectivamente.

Na guia Procurar do espaço de trabalho Esquemas, você pode filtrar o inventário de esquemas. Use a opção Incluído no Perfil para mostrar apenas esquemas que foram habilitados para uso no Perfil de Cliente em Tempo Real. Use a opção Mostrar esquemas adhoc para filtrar a lista de esquemas criados com campos com namespace para uso apenas por um único conjunto de dados.

Na guia Relação do espaço de trabalho Esquemas, você pode filtrar a lista de relações com base em quatro critérios. Os filtros incluem esquema Source, esquema Destino, classe Source e a classe Destino. A tabela abaixo fornece uma descrição dos filtros.

Você também pode usar a barra de pesquisa para restringir ainda mais os resultados.

Os recursos exibidos nos resultados da pesquisa são ordenados primeiro por correspondências de título e, em seguida, por correspondências de descrição. Por sua vez, quanto mais palavras corresponderem em uma dessas categorias, maior será o recurso exibido na lista.

Depois de encontrar o recurso que deseja explorar, selecione o nome dele na lista para exibir sua estrutura na tela.

Explorar um recurso XDM na tela explore

Depois de selecionar um recurso, sua estrutura é aberta na tela.

Todos os campos do tipo de objeto que contêm subpropriedades são recolhidos por padrão quando aparecem pela primeira vez na tela. Para mostrar as subpropriedades de qualquer campo, selecione o ícone ao lado do nome.

Indicador padrão de classe e grupo de campos standard-class-and-field-group-indicator

No Editor de esquemas, classes e grupos de campos padrão (gerados por Adobe) são indicados com o ícone de cadeado ( . O cadeado é exibido no painel à esquerda, ao lado do nome da classe ou do grupo de campos, e também ao lado de qualquer campo no diagrama de esquema que faça parte de um recurso gerado pelo sistema.

Consulte a documentação Adicionar campos personalizados a grupos de campos padrão para obter orientação. Não é possível editar uma classe padrão.

Campos gerados pelo sistema system-fields

Alguns nomes de campos recebem um sublinhado como prefixo, por exemplo, _repo e _id. Eles representam espaços reservados para campos que o sistema gerará e atribuirá automaticamente à medida que os dados forem assimilados.

Dessa forma, a maioria desses campos deve ser excluída da estrutura dos dados ao assimilar na Platform. A principal exceção para essa regra é o campo _{TENANT_ID}, no qual todos os campos XDM criados em sua organização devem ter o namespace.

Tipos de dados data-types

Para cada campo mostrado na tela, seu tipo de dados correspondente é mostrado ao lado do nome, indicando rapidamente o tipo de dados que o campo espera para assimilação.

Qualquer tipo de dados com colchetes ([]) anexados representa uma matriz desse tipo de dados específico. Por exemplo, um tipo de dados de Cadeia de caracteres[] indica que o campo espera uma matriz de valores de cadeia de caracteres. Um tipo de dados de Item de Pagamento[] indica uma matriz de objetos que estão em conformidade com o tipo de dados Item de Pagamento.

Se um campo de matriz é baseado em um tipo de objeto, você pode selecionar seu ícone na tela para mostrar os atributos esperados para cada item de matriz.

Propriedades do campo field-properties

Ao selecionar o nome de qualquer campo na tela, o painel direito é atualizado para mostrar detalhes sobre esse campo em Propriedades do campo. Isso pode incluir uma descrição do caso de uso pretendido do campo, valores padrão, padrões, formatos, se o campo é obrigatório ou não e muito mais.

Se o campo que você está inspecionando for um campo de enumeração, o painel direito também exibirá os valores aceitáveis que o campo espera receber.

Campos de identidade identity

Ao inspecionar esquemas que contêm campos de identidade, esses campos são listados no painel à esquerda na classe ou no grupo de campos que os fornece ao esquema. Selecione o nome do campo de identidade no painel à esquerda para revelar o campo na tela, independentemente da profundidade em que ele está aninhado.

Os campos de identidade são realçados na tela com um ícone de impressão digital ( ). Se você selecionar o nome do campo de identidade, poderá exibir informações adicionais, como o namespace de identidade e se o campo é ou não a identidade principal do esquema.

Campos de relacionamento relationship

Se você estiver inspecionando um esquema que contém um campo de relação, o campo será listado no painel esquerdo em Relações. Selecione o nome do campo de relacionamento no painel à esquerda para revelar o campo na tela, independentemente da profundidade em que ele está aninhado. Os campos de relacionamento também são destacados exclusivamente na tela, mostrando o nome do esquema de referência ao qual o campo é vinculado. Para organizações com recursos B2B, os nomes de relacionamentos personalizados podem ser escritos e serão exibidos na tela nesses casos.

Para exibir o namespace de identidade da identidade primária do esquema de referência, selecione o campo de relação e Editar relação na barra lateral Propriedades de campo. Os parâmetros da relação são exibidos na caixa de diálogo Editar relação exibida.

Consulte o tutorial sobre criação de uma relação na interface para obter mais informações sobre o uso de relações em esquemas XDM.

Próximas etapas

Este documento abordou como explorar os recursos XDM existentes na interface do usuário do Experience Platform. Para obter mais informações sobre os diferentes recursos do espaço de trabalho Esquemas e Schema Editor, consulte a visão geral dos esquemas do espaço de trabalho.