Gerenciar metadados do formulário

Visão geral 

Os metadados permitem a categorização e a organização mais fáceis de ativos e ajudam os usuários que estão procurando por um ativo específico.

O AEM Forms, por padrão, fornece um conjunto definido de metadados para cada tipo de ativo. Além dos metadados padrão, você pode adicionar metadados personalizados a cada um dos tipos de ativos. O AEM Forms também fornece o meio certo de criar, gerenciar e trocar todos esses metadados de maneira eficiente para seus formulários.

Se você for um desenvolvedor ou um proprietário de site, poderá personalizar o Forms Portal, a interface de usuário final do AEM Forms para refletir os metadados que você está usando em sua organização. Para obter mais informações sobre o Forms Portal, consulte Introdução à publicação de formulários em um portal.

Metadados no AEM Forms 

No AEM Forms, a lista de propriedades de metadados associadas a um ativo depende de seu tipo. Além disso, se você adicionar uma propriedade de metadados personalizada, ela será adicionada em todos os ativos do tipo em que os metadados personalizados foram adicionados.

Tipos de ativos 

Os seguintes tipos de ativos são compatíveis com o AEM Forms:

• Modelos de formulário (formulários XFA)
• PDF forms
• Documento (PDFs simples)
• Formulários adaptáveis
• Recursos
• XFS

Lista extensa de metadados

Veja a seguir uma extensa lista de propriedades de metadados compatíveis com o AEM Forms:

Exibir metadados do formulário

Os ativos têm valores de propriedade existentes, que podem ser exibidos no modo somente leitura. Esses metadados são originários no momento do upload ou da criação do formulário.

1. Navegue até o local do ativo para o qual deseja exibir metadados.

2. Abra a página de propriedades usando uma das seguintes maneiras:

   1. Clique no ícone Propriedades da exibição das Ações rápidas.

      OBSERVAÇÃO

      As Ações rápidas são os itens de ação exibidos em uma miniatura ao passar o mouse.

   2. Selecione o formulário e clique no ícone Propriedades da exibição que aparece na barra de ferramentas.

   3. Navegue até a página de detalhes do formulário clicando na miniatura do formulário quando não estiver no modo de seleção. Agora, clique no ícone de olho no canto superior direito e, em seguida, clique em Propriedades na lista abaixo dela.

3. A página de propriedade que é aberta exibe um esquema contendo apenas as propriedades de metadados que possuem algum valor.

   A página de propriedades tem uma barra de ferramentas contendo dois ícones de ação:

   • Editar: Editar os valores da propriedade de metadados
   • Exibir: Navegue até a página de detalhes do formulário, que abre o formulário no modo de visualização.

   A parte do conteúdo é dividida em duas partes:

   • O painel esquerdo contém a miniatura do formulário
   • O painel direito contém propriedades de metadados no modo somente leitura, distribuído por várias guias.

Adicionar/atualizar valores de metadados de formulário

É possível editar o valor das propriedades de metadados existentes ou adicionar novos valores a um campo de propriedade de metadados existente (por exemplo, quando um campo de metadados está em branco).

Atualizar valores de propriedade de metadados

1. Siga as etapas mencionadas na seção anterior para abrir a página de propriedades, onde os metadados existentes do formulário selecionado podem ser visualizados.

2. Na barra de ferramentas, clique no ícone de edição para alterar o modo da página de somente leitura para leitura/gravação.

3. A página de propriedades que é aberta contém um esquema que contém uma combinação de campos de entrada editáveis e texto estático.

4. As propriedades exibidas no texto estático são as que não podem ser editadas.

5. É possível navegar para outras guias para encontrar campos de entrada para propriedades de metadados colocadas sob elas.

   Esta página tem uma barra de ferramentas contendo dois ícones de ação diferentes daqueles no modo de exibição:

   • Cancelar: Cancelar quaisquer alterações feitas nos valores de propriedade de metadados até agora
   • Feito em: Salve todas as alterações feitas nos valores de propriedade de metadados até agora

   Ambas as ações direcionam o usuário para o modo somente leitura da página de propriedades que contém os valores atualizados.

Atualizar a miniatura do formulário 

O painel esquerdo na página de propriedades exibe a miniatura do formulário. Por padrão, a miniatura exibida é a gerada no momento da criação do formulário (formulário adaptável) ou no momento do upload do formulário.

Para todos os tipos de formulário, você tem a opção de carregar uma imagem clicando em Upload Image e procurando um arquivo de imagem do diretório local. A imagem selecionada é usada como uma miniatura em vez da padrão.

Para formulários adaptáveis, é fornecida uma funcionalidade adicional, que permite ao usuário gerar uma miniatura como um instantâneo da visualização de formulário adaptável atual. Como o AEM Forms também suporta a criação de formulários adaptáveis, a visualização do formulário adaptável pode mudar sempre que você alterar o formulário adaptável. Essa funcionalidade para gerar uma miniatura ajuda a obter uma nova miniatura do formulário adaptável com base no status de visualização atual. Clique em Generate Preview para executar esta ação.

Adicionar metadados personalizados 

Além dos metadados fornecidos prontos para uso, o AEM Forms suporta novos metadados personalizados.

Uma ferramenta (Editor de esquema de metadados) é fornecida para definir o esquema para o layout dos metadados; ou seja, o layout do que aparece na página Propriedades de um formulário. O Editor de esquema de metadados permite adicionar ou modificar um esquema personalizado para seus ativos.

O AEM Forms expõe os esquemas de metadados dos tipos de formulários suportados nesta ferramenta. Dessa forma, você pode acessar esses esquemas e usar a funcionalidade fornecida no editor de esquema de metadados para adicionar propriedades personalizadas.

Navegar no editor de esquema de metadados 

1. Navegue até Ferramentas > Ativos > Esquemas de metadados.

2. Clique em forms nos formulários de esquema listados.

3. Na lista que é aberta, clique no tipo de ativo para o qual deseja adicionar metadados personalizados.

   OBSERVAÇÃO

   Esses esquemas contêm propriedades de metadados que são fornecidas prontas e não devem ser alteradas/editadas (marcando a caixa de seleção e clicando em Editar na barra de ferramentas) para evitar problemas funcionais.

4. Qualquer tipo de ativo clicado abre uma lista contendo a opção extendedmetadata. Edite este esquema.

5. Marque a caixa de seleção ao lado de extendedmetadata e clique no ícone editar que aparece na barra de ferramentas.

6. O AEM Forms abre o editor de esquema de metadados/construtor de formulários do tipo de ativo selecionado (neste caso, formulário adaptável).

   

   Clique para ampliar

   1. O painel esquerdo contém seções com guias onde os campos são colocados e o painel direito exibe todos os componentes da interface do usuário disponíveis e as propriedades do campo selecionado no painel esquerdo.

   2. A seção bloqueada não é editável e contém campos para todas as propriedades de metadados fornecidas imediatamente.

   3. É possível adicionar outras guias, clicando no símbolo +.

   4. Você pode adicionar um campo personalizado do tipo desejado arrastando o componente de campo da seção Criar formulário para a página de esquema.

   5. As especificações desse campo podem ser fornecidas na seção Settings depois de clicar no campo.

Adicionar propriedade de metadados personalizada no editor de esquema 

1. Navegue até a guia (existente ou nova) na qual deseja adicionar a propriedade personalizada.

2. Arraste um componente do tipo desejado da seção Criar formulário para o painel esquerdo e coloque-o em um local conveniente.

   OBSERVAÇÃO

   Não é possível mover as seções bloqueadas, mas você pode colocar o componente em qualquer um dos espaços vazios.

3. Clique em um componente que acabou de arrastar. Na guia Configurações que é aberta no painel direito, preencha as informações dos seguintes campos:

   1. Especifique um Rótulo de campo que será usado como um nome de exibição acima do campo colocado no esquema (Por exemplo: Departamento)

   2. No campo Mapear para propriedade , você pode ver um valor pré-preenchido './jcr:content/metadata/default'. Altere o ‘default’ para um nome de propriedade desejado, que é usado para armazenar a propriedade no repositório crx (Por exemplo: "./jcr:content/metadata/Department')

      OBSERVAÇÃO

      Não altere o prefixo ‘./jcr:content/metadata/', pois define o caminho onde a propriedade é armazenada.

      Além disso, o nome da propriedade deve ser exclusivo para evitar a gravação de valores para duas ou mais propriedades no mesmo local no repositório. Portanto, é recomendável alterar o valor "padrão".

   3. Preencha outras configurações com base no requisito. Por exemplo: selecione a opção Obrigatório se desejar tornar o campo obrigatório.

   4. Para excluir um campo adicionado, selecione o campo e clique no ícone Delete .

4. Se necessário, siga as etapas de 1 a 3 para adicionar outra propriedade.

5. Clique em Concluído depois de fazer todas as alterações.

   Você adicionou com êxito uma propriedade de metadados personalizada.

Todos os formulários adaptáveis no AEM Forms agora contêm essa propriedade de metadados adicional. Você pode editá-lo na página de propriedades.