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, você pode 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 guia explica como explorar esquemas, classes, grupos de campos, tipos de dados e relacionamentos existentes na interface do Experience Platform.

Pesquisar um recurso de esquema lookup

Na interface do usuário do Experience Platform, selecione Esquemas no painel esquerdo. O espaço de trabalho Esquemas fornece uma guia Procurar, na qual você pode exibir todos os esquemas em sua organização. Você também pode usar as guias Classes, Grupos de campos, Tipos de dados e Relações para exibir esses recursos.

Filtrar e pesquisar esquemas filter-search

Use as ferramentas de filtragem e pesquisa no espaço de trabalho Esquemas para restringir a lista de esquemas e localizar recursos específicos mais rapidamente. O ícone de filtro ( ) abre o painel de filtro, onde você pode filtrar esquemas usando critérios de metadados, identidade, relacionamento, data e propriedade. Os filtros de recursos estão disponíveis nas guias Procurar e Relações.

Filtros de metadados de esquema

Filtrar esquemas por suas características fundamentais e atributos organizacionais.

Filtros de atributo de esquema

Restrinja os resultados com base na estrutura do esquema e na configuração da identidade.

Filtros temporários e do criador

Filtre esquemas com base nos padrões de criação e na propriedade.

Filtros da guia Relacionamento

Ao visualizar relações de esquema na guia Relações, use filtros adicionais para explorar conexões de esquema:

Combinar vários filtros

Combine filtros para restringir a lista de esquemas e encontrar recursos específicos mais rapidamente. Por exemplo, você pode encontrar esquemas padrão Habilitados para perfil com tags personalizadas que foram criadas no mês passado ou localizar esquemas ad hoc que usam uma identidade principal de email e contêm campos de relacionamento.

Os filtros aplicados aparecem como chips removíveis na linha de cabeçalho do inventário. Para remover um filtro, selecione o × em seu chip. Para remover todos os filtros ativos de uma só vez, selecione Limpar tudo.

Use a barra de pesquisa para restringir ainda mais os resultados.

Os resultados da pesquisa são classificados com base nas correspondências nos títulos e descrições dos recursos. As correspondências de títulos são priorizadas em relação às correspondências de descrição e os recursos com termos mais correspondentes aparecem mais acima na lista de resultados.

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

Procurar, organizar e gerenciar esquemas browse-organize-manage-schemas

Use o espaço de trabalho Esquemas para localizar, organizar e gerenciar esquemas. Você pode filtrar o inventário de esquemas, classificar colunas de metadados e executar ações comuns de esquema diretamente da visualização do inventário.

Procurar e filtrar metadados

O inventário de esquemas exibe os principais metadados do esquema em uma única visualização de tabela. Você pode exibir tags, tipo de esquema, status de ativação de perfil, data de criação, data da última modificação, classe, identidades, relacionamentos, comportamento e outros metadados sem abrir esquemas individuais.

Para classificar o inventário, selecione um cabeçalho de coluna. Selecione o mesmo cabeçalho de coluna novamente para inverter a ordem de classificação.

Se o inventário contiver mais resultados do que cabem em uma única página, use os controles de página na parte inferior da lista para navegar entre as páginas.

Realizar ações em linha em esquemas

Use o menu de reticências de uma linha de esquema para executar ações comuns de esquema diretamente da visualização de inventário.

As ações estão disponíveis nas exibições de inventário e de detalhes do recurso. Algumas ações estão disponíveis somente para recursos personalizados (definidos pelo locatário). Os recursos padrão fornecidos pela Adobe podem ter opções de ação limitadas.

Dependendo do tipo de recurso e das permissões, você pode editar propriedades do esquema, aplicar rótulos de governança de dados, excluir esquemas e gerenciar tags sem abrir o esquema. As ações adicionais incluem mover esquemas para pastas, adicionar esquemas a pacotes de implantação, copiar o esquema JSON e baixar arquivos de amostra para teste.

Para obter instruções detalhadas sobre cada ação, consulte o guia de ações do esquema.

Navegar por esquemas usando tags e pastas

Use tags e pastas para organizar e localizar esquemas no inventário. As tags ajudam a agrupar esquemas por projeto, equipe, domínio de dados ou outras categorias definidas pela organização. As pastas fornecem uma estrutura hierárquica para organizar esquemas relacionados.

Para filtrar esquemas por marca, selecione o ícone de filtro ( ) para abrir o painel de filtro. Em seguida, selecione uma ou mais marcas na lista suspensa Tem qualquer marca.

Para procurar esquemas por pasta, selecione o ícone mostrar pastas ( ). A hierarquia de pastas é exibida no painel esquerdo. Selecione uma pasta para exibir seus esquemas associados.

As tags e pastas funcionam com o sistema de filtragem de inventário, permitindo limitar a lista de esquemas com base nas tags atribuídas e nos locais das pastas.

Para obter informações sobre como criar e gerenciar tags na Experience Platform, consulte o guia de gerenciamento de tags unificadas.

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 padrão e grupos de campos exibem um ícone de cadeado ( ). O ícone identifica recursos gerados pela Adobe que têm restrições de edição. Ele aparece no painel esquerdo ao lado dos nomes de classe e grupo de campos e ao lado dos campos que pertencem aos recursos gerados pela Adobe no diagrama de esquema.

Não é possível editar uma classe padrão. Para estender um grupo de campos padrão, consulte a documentação Adicionar campos personalizados a grupos de campos 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 Experience 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, Valor padrão (metadados de esquema informativos que não são aplicados durante a assimilação), padrões, formatos, se o campo é obrigatório e muito mais. Consulte Propriedades do campo específico do tipo para saber como o Valor padrão difere das configurações de validação de assimilação. Quando você estiver explorando um grupo de campos, os detalhes relacionados ao rótulo do campo selecionado também podem aparecer aqui; consulte Rótulos na exibição de estrutura.

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.

Explorar grupos de campos: uso e metadados explore-field-groups

Navegue até Esquemas > Grupos de campos para explorar grupos de campos. Na guia Grupos de campos, recursos adicionais ajudam você a entender onde um grupo de campos é usado em esquemas e o que ele inclui, como compatibilidade, campos obrigatórios (que impõem requisitos de assimilação) e sinais de governança.

Esses recursos ajudam você a avaliar o impacto antes de fazer alterações e identificar grupos de campos relevantes com mais eficiência durante o design do esquema.

Exibir uso de esquema para grupos de campos view-schema-usage-for-field-groups

Na tabela Grupos de campos, selecione um grupo de campos para abrir sua exibição detalhada. A tela é atualizada para exibir a estrutura do grupo de campos, e o painel de propriedades mostra informações adicionais sobre o recurso selecionado.

Esquemas que usam este grupo de campos

No painel de propriedades à direita, a seção Esquemas usando este grupo de campos lista os esquemas que atualmente incluem o grupo de campos.

Selecione um nome de esquema para abrir sua visualização de detalhes em uma nova guia e inspecione como o grupo de campos é implementado dentro desse esquema.

Exibir mais e lista completa de esquemas

Se houver mais esquemas do que podem ser exibidos em linha, selecione Exibir mais para abrir a caixa de diálogo completa.

A caixa de diálogo Esquemas usando este grupo de campos é exibida, mostrando a lista completa de esquemas que usam o grupo de campos.

Na caixa de diálogo Esquemas usando este grupo de campos, é possível:

Você pode exibir detalhes do esquema, como nome do esquema, classe e outros atributos.

Este fluxo de trabalho destina-se somente a análise e exploração de impacto. Ela não modifica esquemas ou grupos de campos. Para alterar a estrutura do esquema, consulte Criar e editar esquemas na interface.

Metadados e filtragem do grupo de campos field-group-metadata-and-filtering

A guia Grupos de campos fornece ferramentas de filtragem e metadados para ajudar você a localizar e avaliar grupos de campos antes de selecioná-los.

Procurar tabela e filtros

A tabela de inventário do grupo de campos inclui colunas adicionais que expõem metadados diretamente na exibição de lista, como Classes compatíveis, que indica a quais classes um grupo de campos pode ser aplicado. Os grupos de campos só podem ser adicionados a esquemas que usam uma das classes compatíveis listadas, com base no comportamento dos dados que representam (por exemplo, dados com base em registros ou de séries temporais). A tabela pode exibir Todos quando o grupo de campos é compatível com todas as classes. As marcas do setor ajudam a categorizar grupos de campos para descoberta.

Para refinar a lista, selecione o ícone de filtro ( ) para abrir o painel de filtro no painel esquerdo. A imagem a seguir mostra o painel de filtro aberto no painel esquerdo.

No painel de filtros, é possível:

Durante a navegação, selecione uma linha na tabela para acionar o painel de informações. O painel de informações exibe metadados como classes compatíveis e tags do setor, para que você possa revisar os principais detalhes sem abrir o grupo de campos.

Metadados de detalhes do grupo de campos

Ao abrir um grupo de campos, o painel de propriedades exibe metadados adicionais associados ao recurso.

O painel de propriedades pode exibir os seguintes metadados:

Essas informações ajudam a entender as restrições e os requisitos antes de usar ou modificar o grupo de campos.

Rótulos na visualização de estrutura

Quando um grupo de campos é aberto na tela, é possível exibir as informações do rótulo diretamente na estrutura. Selecione o ícone de configurações ( ) na barra de ferramentas da tela de desenho e habilite Mostrar rótulos na árvore para exibir indicadores de rótulo nos campos da tela.

Selecione um campo na tela para exibir os detalhes do rótulo no painel Propriedades do campo, incluindo rótulos aplicados a esse campo.

Os rótulos são agrupados por categoria (por exemplo, rótulos de identidade e confidenciais) e fornecem visibilidade sobre a governança ou as restrições relacionadas ao acesso aplicadas aos dados.

Esses indicadores são somente para visibilidade e não alteram a estrutura do schema. Para obter mais informações, consulte Gerenciar rótulos de uso de dados para um esquema.

Próximas etapas

Use os seguintes recursos para continuar trabalhando com esquemas XDM e recursos relacionados do Experience Platform: