Esquemas de metadados

Nos ativos Adobe Experience Manager (AEM), um esquema de metadados define o layout da página de propriedades e as propriedades de metadados exibidas para ativos que usam o esquema específico. As propriedades dos metadados incluem título, descrição, tipos MIME, tags e assim por diante.

Você pode usar o editor de Forms do esquema de metadados para modificar esquemas existentes ou adicionar esquemas de metadados personalizados.

  1. Para exibir a página de propriedades de um ativo, clique ou toque no ícone Exibir propriedades de Ações rápidas no bloco de ativos na exibição Cartão. Como alternativa, selecione o ativo na interface do usuário e clique ou toque no ícone Propriedades na barra de ferramentas.

  2. Edite várias propriedades de metadados em várias guias. No entanto, não é possível modificar o tipo de ativo na página de propriedades.
    Para modificar o tipo MIME de um ativo, use um formulário de esquema de metadados personalizado ou modifique um formulário existente. Consulte Editar o esquema de metadados Forms para obter mais informações. Se você modificar o esquema de metadados para um determinado tipo MIME, o layout da página de propriedades para ativos com o tipo MIME atual e todos os subtipos de ativos serão modificados. Por exemplo, modificar um esquema jpeg em default/image modifica apenas o layout de metadados (propriedades de ativos) para ativos com o tipo MIME image/jpeg. No entanto, se você editar o esquema padrão, suas alterações modificarão o layout de metadados para todos os tipos de ativos.

  3. Para exibir uma lista de formulários/modelos, clique no logotipo do AEM e navegue até Ferramentas > Ativos > Esquemas de metadados.
    AEM fornece os seguintes modelos prontos para uso:

    • padrão: O formulário de esquema de metadados básico para ativos.

    Os seguintes formulários filho herdam as propriedades do formulário padrão:
    i. image: Formulário de esquema para ativos com o tipo MIME "imagem", por exemplo, image/jpeg, image/png e assim por diante.
    O formulário "image" tem os seguintes modelos de formulário filho:
    a. jpeg: Formulário de esquema para ativos com subtipo jpeg.
    b. tiff: Formulário de esquema dos ativos com subtipo tiff.

    ii. aplicativo: Formulário de esquema para ativos com tipo MIME application, por exemplo application/pdf, application/zipe assim por diante.
    a. pdf: Formulário de esquema para ativos com subtipo pdf.

    iii. Vídeo: Formulário de esquema para ativos com tipo MIME video, como video/avi, video/mp4, e assim por diante.

    • coleção: Formulário de esquema para coleções.
    • contentfragment: formulário de esquema dos Fragmentos de conteúdo.
OBSERVAÇÃO

Para exibir os formulários filho de um formulário de esquema, clique/toque no nome do formulário de esquema.

Adicionar um formulário de esquema de metadados

  1. Para adicionar um modelo personalizado à lista, clique em Create na barra de ferramentas.

    OBSERVAÇÃO

    Os modelos não atualizados têm um ícone de cadeado antes deles. Se você personalizar qualquer um dos modelos, o ícone de bloqueio antes do modelo desaparece.

  2. Na caixa de diálogo , insira o título do formulário Schema e clique em Create para concluir o processo de criação do formulário.

Editar formulários de esquema de metadados

É possível editar um formulário de esquema de metadados recém-adicionado ou existente. O formulário de esquema de metadados inclui o seguinte:

  • Guias
  • Itens de formulário nas guias.

Você pode mapear/configurar esses itens de formulário em um campo dentro de um nó de metadados no repositório CRX.

É possível adicionar novas guias ou itens de formulário ao formulário de esquema de metadados. As guias e os itens de formulário derivados do pai estão no estado bloqueado. Não é possível alterá-los no nível filho.

  1. Na página Formulários de esquema, marque a caixa de seleção ao lado de um formulário e clique no ícone Editar na barra de ferramentas.
  2. Na página Editor de esquema de metadados, personalize a página de propriedades do ativo arrastando um ou mais componentes da lista de tipos de componentes na guia Criar formulário para a guia Básico.
  3. Para configurar um componente, selecione-o e modifique suas propriedades na guia Settings.

Componentes na guia Criar formulário

A guia Criar formulário lista os itens de formulário que você usa no formulário de esquema. A guia Settings fornece os atributos de cada item selecionado na guia Criar formulário. A tabela a seguir lista os itens de formulário disponíveis na guia Criar formulário:

Nome do componente Descrição
Título da seção Adicione um cabeçalho de seção para obter uma lista de componentes comuns.
Texto em linha única Adicione uma propriedade de texto de linha única. Ele é armazenado como uma string.
Texto multivalor Adicione uma propriedade de texto de vários valores. Ele é armazenado como uma matriz de sequência de caracteres.
Número Adicione um componente de número.
Data Adicione um componente de data.
Lista suspensa Adicione uma lista suspensa.
Tags padrão Adicionar uma tag.
Tags inteligentes Adicione para aumentar os recursos de pesquisa adicionando automaticamente as tags de metadados.
Campo oculto Adicione um campo oculto. Ele é enviado como um parâmetro POST quando o ativo é salvo.
Ativo referenciado por Adicione este componente para exibir a lista de ativos referenciados pelo ativo.
Fazer referência ao ativo Adicionar para exibir uma lista de ativos que fazem referência ao ativo.
Referências de produtos Adicionar para mostrar a lista de produtos vinculados ao ativo.
Classificação do ativo Adicionar para exibir opções para classificar o ativo.
Metadados do contexto Adicionar para controlar a exibição de outras guias de metadados na página de propriedades dos ativos.

Editar o componente de metadados

Para editar as propriedades de um componente de metadados no formulário, clique no componente e edite todas ou um subconjunto das seguintes propriedades na guia Settings.

Rótulo do campo: O nome da propriedade de metadados exibida na página de propriedades do ativo.

Mapear para propriedade: Essa propriedade especifica o caminho/nome relativo para o nó do ativo, onde ele é salvo no repositório CRX. Ele começa com ./ porque indica que o caminho está no nó do ativo.

A seguir estão os valores válidos para essa propriedade:

  • . /jcr:content/metadata/dc:title: armazena o valor no nó de metadados do ativo como a propriedade dc:title.

  • . /jcr:created: exibe a propriedade jcr no nó do ativo. Se você configurar essas propriedades nas propriedades de exibição, recomendamos marcá-las como Desativar edição, pois elas estão protegidas. Caso contrário, o erro "Os ativos falharam ao serem modificados" ocorre ao salvar as propriedades do ativo.

Para garantir que o componente seja exibido corretamente no formulário de esquema de metadados, o caminho da propriedade não deve incluir espaços.

Espaço reservado: Use essa propriedade para especificar o texto de espaço reservado relevante em relação à propriedade de metadados.

Obrigatório: Use essa propriedade para marcar uma propriedade de metadados como obrigatória na página de propriedades.

Desativar edição: Use essa propriedade para tornar uma propriedade de metadados não editável na página Propriedades .

Mostrar Campo Vazio Em Somente Leitura: Marque essa propriedade para exibir uma propriedade de metadados na página de propriedades, mesmo que ela não tenha um valor. Por padrão, quando uma propriedade de metadados não tem valor, ela não é listada na página de propriedades.

Mostrar ordem da lista: Use essa propriedade para exibir uma lista ordenada de opções

Opções: Usar esta propriedade para especificar opções em uma lista

Descrição : Use essa propriedade para adicionar uma breve descrição para o componente de metadados.

Classe: Classe de objeto à qual a propriedade está associada.

Excluir: Clique em para excluir um componente do formulário de esquema.

OBSERVAÇÃO

O componente Campo oculto não inclui esses atributos. Em vez disso, inclui propriedades, como atributos Nome, Valor, Rótulo do campo e Descrição. Os valores do componente Campo oculto são enviados como um parâmetro de POST sempre que o ativo é salvo. Ele não é salvo como metadados para o ativo.

Se você selecionar a opção Obrigatório, poderá pesquisar por ativos sem metadados obrigatórios. No painel Filtros, expanda o predicado Validação de metadados e selecione a opção Inválido. Os resultados de pesquisa exibem ativos que não têm metadados obrigatórios configurados por meio do formulário de esquema.

Se você adicionar o componente Metadados contextuais a qualquer guia de qualquer formulário de esquema, o componente aparecerá como uma lista na página de propriedades dos ativos aos quais o schema específico é aplicado. A lista inclui todas as outras guias, exceto a guia à qual você aplicou o componente de Metadados contextuais. No momento, esse recurso fornece funcionalidades básicas para controlar a exibição de metadados com base no contexto.

Para incluir qualquer guia na página de propriedades, além da guia em que o componente de Metadados contextuais é aplicado, selecione a guia na lista. A guia é adicionada à página de propriedades.

Especificar propriedades no arquivo JSON

Em vez de especificar propriedades para as opções na guia Configurações, defina as opções em um arquivo JSON especificando pares de valores chave correspondentes. Especifique o caminho do arquivo JSON no campo Caminho JSON.

Adicione e exclua uma guia no formulário de esquema

O editor de esquema permite adicionar ou excluir uma guia. O formulário de esquema padrão inclui as guias Básico, Avançado, IPTC e Extensão IPTC, por padrão.

Clique em + para adicionar uma nova guia em um formulário de esquema. Por padrão, a nova guia tem o nome Unnamed-1. Você pode modificar o nome da guia Settings. Clique em X para excluir uma guia.

Exclusão de formulários de esquema de metadados

AEM permite excluir somente formulários de esquema personalizados. Ela não permite excluir os formulários/modelos de esquema padrão. No entanto, é possível excluir quaisquer alterações personalizadas nesses formulários.

Para excluir um formulário, selecione-o e clique no ícone excluir.

OBSERVAÇÃO

Após excluir as alterações personalizadas em um formulário padrão, o ícone de bloqueio é exibido novamente antes na interface do Esquema de metadados para indicar que o formulário foi revertido para seu estado padrão.

OBSERVAÇÃO

Não é possível excluir os formulários de esquema de metadados prontos para uso no AEM Assets.

Formulários de esquema para tipos MIME

O AEM Assets fornece formulários padrão para vários tipos MIME prontos para uso. No entanto, é possível adicionar formulários personalizados a ativos de vários tipos MIME.

Adicionar novos formulários para tipos MIME

Crie um novo formulário no tipo de formulário apropriado. Por exemplo, para adicionar um novo modelo para o subtipo image/png, crie o formulário nos formulários "image". O título do formulário de esquema é o nome do subtipo. Nesse caso, o título é "png."

Uso de um modelo de esquema existente para vários tipos MIME

Você pode usar um modelo existente para um tipo MIME diferente. Por exemplo, use o formulário image/jpeg para ativos do tipo MIME image/png.

Nesse caso, crie um novo nó em /etc/dam/metadataeditor/mimetypemappings no repositório CRX. Especifique um nome para o nó e defina as seguintes propriedades:

Nome Descrição Tipo Valor
exposedmimetype Nome do formulário existente a ser mapeado Sequência de caracteres image/jpeg
mimetypes Lista de tipos MIME que usam o formulário definido no atributo exposedmimetype Sequência de caracteres image/png

O AEM Assets mapeia os seguintes tipos MIME e formulários de esquema:

Formulário de esquema Tipos MIME
image/jpeg image/pjpeg
image/tiff image/x-tiff
application/pdf application/postscript
application/x-ImageSet Multipart/Related; type=application/x-ImageSet
application/x-SpinSet Multipart/Related; type=application/x-SpinSet
application/x-MixedMediaSet Multipart/Related; type=application/x-MixedMediaSet
video/quicktime vídeo/x-quicktime
vídeo/mpeg4 video/mp4
vídeo/avi vídeo/avi, vídeo/msvideo, vídeo/x-msvideo
vídeo/wmv video/x-ms-wmv
vídeo/flv video/x-flv

Conceder acesso aos esquemas de metadados

O recurso Esquema de metadados está disponível somente para administradores do . No entanto, os administradores podem fornecer acesso a não administradores modificando algumas permissões. O não administrador deve ter permissões para criar, modificar e excluir na pasta /conf.

Aplicar metadados específicos da pasta

O AEM Assets permite definir uma variante de um esquema de metadados e aplicá-la a uma pasta específica.

Por exemplo, você pode definir uma variante do esquema de metadados padrão e aplicá-la a uma pasta. Ao aplicar o schema modificado, ele substitui o schema de metadados padrão original aplicado aos ativos na pasta.

Somente os ativos carregados na pasta à qual esse esquema é aplicado estarão em conformidade com os metadados modificados definidos no esquema de metadados da variante.

Os ativos em outras pastas onde o esquema original é aplicado continuam em conformidade com os metadados definidos no esquema original.

A herança de metadados por ativos é baseada no esquema aplicado à pasta de primeiro nível na hierarquia. Em outras palavras, se uma pasta não contiver subpastas, os ativos na pasta herdarão os metadados do esquema aplicado à pasta.

Se a pasta tiver uma subpasta, os ativos na subpasta herdarão os metadados do esquema aplicado no nível da subpasta se um esquema diferente for aplicado no nível da subpasta. No entanto, se nenhum esquema ou o mesmo schema for aplicado no nível da subpasta, os ativos da subpasta herdarão os metadados do schema aplicado no nível da pasta pai.

  1. Clique no logotipo do AEM e navegue até Ferramentas > Ativos > Esquemas de metadados. A página Formulários de esquema de metadados é exibida.

  2. Marque a caixa de seleção ao lado de um formulário, por exemplo, o formulário de metadados padrão, clique ou toque no ícone de cópia e salve-o como um formulário personalizado. Especifique um nome personalizado para o formulário, por exemplo my_default. Como alternativa, é possível criar um formulário personalizado.

  3. Na página Forms do esquema de metadados, selecione o formulário my_default e clique no ícone Editar.

  4. Na página Editor de esquema de metadados , adicione um campo de texto ao formulário de esquema. Por exemplo, adicione um campo com o rótulo Category.

  5. Clique em Salvar. O formulário modificado é listado na página Forms do Esquema de Metadados.

  6. Clique/toque em Aplicar às pastas na barra de ferramentas para aplicar os metadados personalizados a uma pasta.

  7. Selecione a pasta na qual aplicar o schema modificado e clique/toque em Aplicar.

  8. Se a pasta tiver o outro esquema de metadados aplicado, será exibida uma mensagem avisando que você está prestes a substituir o esquema de metadados existente. Clique em Substituir.

  9. Clique em OK para fechar a mensagem de sucesso.

  10. Navegue até a pasta na qual você aplicou o esquema de metadados modificado.

Definição de metadados obrigatórios

Você pode definir campos obrigatórios em um nível de pasta, que é empregado em ativos que são carregados na pasta. Se você carregar ativos com metadados ausentes para os campos obrigatórios definidos anteriormente, uma indicação visual para metadados ausentes será exibida nos ativos na exibição de Cartão.

OBSERVAÇÃO

Um campo de metadados pode ser definido como obrigatório com base no valor de outro campo. Na exibição Cartões, AEM não exibe a mensagem de aviso sobre a falta de metadados para esses campos de metadados obrigatórios.

  1. Clique no logotipo do AEM e navegue até Ferramentas > Ativos > Esquemas de metadados. A página Formulários de esquema de metadados é exibida.

  2. Salve o formulário de metadados padrão como um formulário personalizado. Por exemplo, salve-o como my_default.

  3. Edite o formulário personalizado. Adicione um campo obrigatório. Por exemplo, adicione um campo Category e torne o campo obrigatório.

  4. Clique em Salvar. O formulário modificado é listado na página Forms do Esquema de Metadados. Selecione o formulário e clique ou toque em Aplicar à(s) pasta(s) na barra de ferramentas para aplicar os metadados personalizados a uma pasta.

  5. Navegue até a pasta e faça upload de alguns ativos com metadados ausentes para o campo obrigatório adicionado ao formulário personalizado. Uma mensagem para os metadados ausentes do campo obrigatório é exibida na exibição Cartão do ativo.

  6. (Opcional) Acesse https://[server]:[port]/system/console/components/. Configure e habilite o componente com.day.cq.dam.core.impl.MissingMetadataNotificationJob que está desabilitado por padrão. Defina uma frequência na qual o AEM verifica a validade dos metadados nos ativos.

    Essa configuração adiciona uma propriedade hasValidMetadata a jcr:content de ativos. Usando essa propriedade, AEM pode filtrar resultados em uma pesquisa.

    OBSERVAÇÃO

    Se um ativo for adicionado após a verificação agendada, ele não será sinalizado com hasValidMetadata até a próxima verificação agendada. Os ativos não aparecem em resultados de pesquisa intermediária.

    CUIDADO

    As verificações de validação de metadados consomem muitos recursos e podem afetar o desempenho do sistema. Agendar as verificações em conformidade. Se o servidor não conseguir lidar com a carga, tente desabilitar este trabalho

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now