Esquemas de metadados

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

Você pode usar o editor do Forms Schema Metadados para modificar schemas existentes ou adicionar schemas de metadados personalizados.

  1. Para visualização da página de propriedades de um ativo, clique ou toque no ícone Propriedades da Visualização em Ações rápidas no bloco de ativo em visualização de 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 nas 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 schema de metadados personalizado ou modifique um formulário existente. Consulte Edição do Schema de Metadados Forms para obter mais informações. Se você modificar o schema de metadados de 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 schema jpeg em default/image modifica apenas o layout de metadados (propriedades do ativo) para ativos com o tipo MIME image/jpeg. No entanto, se você editar o schema padrão, suas alterações modificarão o layout de metadados de 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 schema de metadados base para ativos.

    Os seguintes formulários filho herdam as propriedades do formulário padrão:
    i. image: Formulário de schema para ativos com o tipo MIME "image", 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 schema para ativos com subtipo jpeg.
    b. tiff: Formulário de schema para os ativos com subtipo tiff.

    ii. aplicação: Formulário de schema para ativos com tipo MIME application, por exemplo application/pdf, application/zipetc.
    a. pdf: Formulário de schema para ativos com subtipo pdf.

    iii. vídeo: Formulário de schema para ativos com tipo MIME video, como video/avi, video/mp4etc.

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

Para visualização dos formulários filho de um formulário de schema, clique/toque no nome do formulário do schema.

Adicionar um formulário de schema de metadados

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

    OBSERVAÇÃO

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

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

Editar formulários de schema de metadados

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

  • Guias
  • Itens de formulário em 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 schema 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 da criança.

  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 Configurações.

Componentes na guia Criar formulário

A guia Criar formulário lista itens de formulário que você usa no formulário de schema. A guia Configurações 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 uma lista de componentes comuns.
Texto em linha única Adicione uma única propriedade de texto de linha. É armazenado como uma string.
Texto multivalor Adicione uma propriedade de texto de vários valores. Ele é armazenado como uma matriz de string.
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 tags de metadados.
Campo oculto Adicionar um campo oculto. Ele é enviado como um parâmetro POST quando o ativo é salvo.
Ativo referenciado por Adicione esse componente à lista de visualização 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 Adicione para exibir opções para classificar o ativo.
Metadados do contexto Adicione 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 Configurações.

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

Mapear para propriedade: Essa propriedade especifica o caminho/nome relativo para o nó do ativo no qual ele é salvo no repositório CRX. Ele start com ./ porque indica que o caminho está sob o nó do ativo.

Estes são os valores válidos para esta 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 schema de metadados, o caminho da propriedade não deve incluir espaços.

Espaço reservado: Use essa propriedade para especificar o texto relevante do espaço reservado para a propriedade metadata.

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

Desabilitar 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 valor. Por padrão, quando uma propriedade de metadados não tem valor, ela não é listada na página de propriedades.

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

Opções: Use essa 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 para excluir um componente do formulário de schema.

OBSERVAÇÃO

O componente Campo oculto não inclui esses atributos. Em vez disso, inclui propriedades, como Nome dos atributos, Valor, Rótulo do campo e Descrição. Os valores do componente Campo oculto são enviados como um parâmetro 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 schema, 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 Metadados contextuais. Atualmente, esse recurso fornece funcionalidade básica para controlar a exibição de metadados com base no contexto.

Para incluir qualquer guia na página de propriedades, além da guia na qual o componente 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.

Adicionar e excluir uma guia no formulário de schema

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 schema. Por padrão, a nova guia tem o nome Unnamed-1. É possível modificar o nome na guia Settings. Clique em X para excluir uma guia.

Excluindo formulários de schema de metadados

AEM permite que você exclua apenas formulários de schema personalizados. Isso não permite que você exclua os formulários/modelos de schema 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

Depois de excluir alterações personalizadas em um formulário padrão, o ícone de cadeado reaparece antes dele na interface do Schema de Metadados para indicar que o formulário reverteu para seu estado padrão.

OBSERVAÇÃO

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

Formulários de schema para tipos MIME

A AEM Assets fornece formulários padrão para vários tipos MIME prontos para uso. No entanto, você pode adicionar formulários personalizados para 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 schema 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

A AEM Assets mapeia os seguintes tipos MIME e formulários de schema:

Formulário de schema 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 video/x-quicktime
video/mpeg4 video/mp4
vídeo/avi video/avi, video/msvideo, video/x-msvideo
video/wmv video/x-ms-wmv
video/flv video/x-flv

Concedendo acesso a schemas de metadados

O recurso Schema de metadados está disponível somente para administradores. 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.

Aplicando metadados específicos da pasta

A AEM Assets permite que você defina uma variante de um schema de metadados e aplique-o a uma pasta específica.

Por exemplo, você pode definir uma variante do schema de metadados padrão e aplicá-la a uma pasta. Quando você aplica o schema modificado, ele substitui o schema de metadados padrão original aplicado aos ativos dentro da pasta.

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

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

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

Se a pasta tiver uma subpasta, os ativos dentro da subpasta herdarão os metadados do schema aplicado no nível da subpasta se um schema diferente for aplicado no nível da subpasta. No entanto, se nenhum schema ou 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 antes 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 Schema de metadados, selecione o formulário my_default e clique no ícone Editar.

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

  5. Clique em Salvar. O formulário modificado está listado na página Schema de metadados Forms.

  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 schema de metadados aplicado, será exibida uma mensagem avisando que você está prestes a substituir o schema 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 schema de metadados modificado.

Definindo metadados obrigatórios

Você pode definir campos obrigatórios em nível de pasta, que é imposto aos 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 visualização de cartão.

OBSERVAÇÃO

Um campo de metadados pode ser definido como obrigatório com base no valor de outro campo. Na visualização Cartões, AEM não exibe a mensagem de aviso sobre metadados ausentes 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 Categoria e torne o campo obrigatório.

  4. Clique em Salvar. O formulário modificado está listado na página Schema de metadados Forms. Selecione o formulário e clique ou toque em Aplicar às pastas na barra de ferramentas para aplicar os metadados personalizados a uma pasta.

  5. Navegue até a pasta e carregue 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 visualização Cartão do ativo.

  6. (Opcional) Acesse https://[server]:[port]/system/console/components/. Configure e ative o componente com.day.cq.dam.core.impl.MissingMetadataNotificationJob que está desativado 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 os resultados em uma pesquisa.

    OBSERVAÇÃO

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

    CUIDADO

    As verificações de validação de metadados exigem muitos recursos e podem afetar o desempenho do seu sistema. Agendar as verificações em conformidade. Se o servidor não conseguir lidar com a carga, tente desativar esta tarefa

Nesta página