Show Menu
TÓPICOS×

Gerenciar metadados do formulário

Visão geral 

Os metadados permitem a classificação e 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 os meios certos de criar, gerenciar e trocar todos esses metadados de forma eficiente para seus formulários.
Se você for um desenvolvedor ou proprietário de um site, poderá personalizar o Portal do Forms , a interface do 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 Portal de formulários, 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 qualquer propriedade de metadados personalizados, ela será adicionada em todos os ativos do tipo em que os metadados personalizados foram adicionados.

Asset types

Os seguintes tipos de ativos são suportados no AEM Forms:
  • Modelos de formulário (formulários XFA)
  • Formulários PDF
  • Documento (PDFs simples)
  • Formulários adaptáveis
  • Recursos
  • XFS

Lista extensa de metadados

A seguir está uma extensa lista de propriedades de metadados compatíveis com o AEM Forms:
Nome da propriedade Tipo de ativo Descrição
Título Todos exceto recursos Nome de exibição do formulário.
Descrição Todos exceto recursos Descrição do formulário. O usuário pode especificar esse valor.
Tipo Todos os pacotes
Um valor somente leitura que especifica o tipo de ativo. Ele pode ter um dos seguintes valores:
  • Modelo de formulário
  • Formulário PDF, formulário PDF (Acroform) ou formulário PDF (Assinado)
  • Documento, Documento (Assinado)
  • Formulários adaptáveis
  • Recurso
Criado Todos os pacotes Um valor somente leitura que especifica o tempo de criação do ativo.
Data da última modificação Todos os pacotes Um valor somente leitura que especifica a hora em que o ativo foi modificado pela última vez.
Autor Todos exceto recursos
Um valor somente leitura que é automaticamente calculado com base no tipo de formulário.
  • PDF/Form template/Document - extraído do arquivo binário carregado.
  • Formulário adaptável - usuário conectado no momento da criação do formulário.
Status Todos exceto recursos
Um valor somente leitura que define um dos seguintes estados de um formulário:
  • Nenhum valor: Se um formulário nunca tiver sido publicado.
  • Publicado: Quando um formulário é publicado.
  • Modificado: Quando um formulário foi modificado depois de ter sido publicado uma vez.
Data da última publicação Todos exceto recursos Um valor somente leitura que especifica a hora em que o formulário foi publicado pela última vez.
Tempo de ativação/desativação da publicação Todos exceto recursos
Hora em que o formulário está programado para ser publicado/não publicado automaticamente. O usuário define esse valor na edição de metadados.
  • Tanto a hora de Ativar quanto a de Desativar devem estar além da data atual.
  • O tempo de Publicar desligado deve estar além do tempo de publicação ligado.
Enviar URL
Modelo de formulário
formulário PDF
Para configurar um URL especificado pelo usuário para enviar dados de formulário para um servlet.
O URL de envio pode ser configurado usando qualquer um dos seguintes métodos, listados em ordem de precedência:
  • Especifique um URL de envio diretamente em um Modelo de formulário usando o botão Enviar por HTTP ao criar um formulário XFA no AEM Forms Designer.
  • Na interface do usuário do AEM Forms, selecione um formulário e especifique um URL de envio para editar as propriedades de metadados.
  • No Portal de Formulários, edite o componente Pesquisar e Lister e especifique um URL de envio na guia Link de Formulário.
Perfil de renderização HTML Modelo de formulário O perfil de renderização HTML usado ao renderizar um Modelo de formulário no formato HTML.
Formato de renderização
Modelo de formulário
Formulários adaptáveis
Essa opção permite que o usuário especifique o formato de renderização do formulário quando os formulários forem publicados:
  • HTML
  • PDF
  • Ambos
Essa opção é usada para restringir o formato de renderização dos formulários somente no portal de formulários, onde eles estão visíveis para o usuário final.
Tags Todos exceto recursos Rótulos associados ao formulário para facilitar a pesquisa rápida e fácil.
Referências
Formulários adaptáveis
Modelo de formulário
Recurso
Lista de ativos (outros formulários ou recursos) aos quais este formulário está relacionado. Esses ativos podem ser incluídos nas duas categorias a seguir:
  • Refere-se: Ativos aos quais o formulário atual se refere.
  • Referenciado por: Ativos que se referem ao ativo atual.
Esses ativos são exibidos como links e seus metadados podem ser acessados diretamente clicando neles.
Seleção do modelo de formulário (XDP/XSD) Formulários adaptáveis
Especifica qual modelo de formulário é usado durante a criação do formulário adaptável. Essa propriedade pode ter os seguintes valores:
  • Modelo de formulário: Um modelo de formulário é selecionado entre os existentes no repositório. Este valor pode ser atualizado.
  • Esquema XML: Um arquivo XSD é carregado. Este valor pode ser atualizado.
  • Nenhum
Um modelo de formulário selecionado uma vez pode ser atualizado, mas não removido.

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 de exibição em Ações rápidas.
      As Ações rápidas são os itens de ação que são exibidos em uma miniatura ao passar o mouse.
    2. Selecione o formulário e clique no ícone Exibir propriedades 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 clique em Propriedades na lista abaixo dele.
  3. A página de propriedade que é aberta exibe um esquema que contém apenas as propriedades de metadados que possuem algum valor.
    A página de propriedades tem uma barra de ferramentas que contém dois ícones de ação:
    • Editar: Editar os valores de 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ídas por várias guias.

Adicionar/atualizar valores de metadados do formulário

Você pode 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 na qual os metadados existentes do formulário selecionado podem ser exibidos.
  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 aquelas que não podem ser editadas.
  5. É possível navegar para outras guias para localizar campos de entrada para propriedades de metadados colocadas sob elas.
    Esta página tem uma barra de ferramentas que contém 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é o momento
    • Feito: Salvar todas as alterações feitas nos valores de propriedade de metadados até o momento
    Ambas as ações direcionam o usuário de volta 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 adaptativo) 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 Carregar imagem 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 do 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 ser alterada sempre que você alterar o formulário adaptável. Essa funcionalidade para gerar uma miniatura ajuda a obter uma miniatura nova para o formulário adaptável com base no status de visualização atual. Clique em Gerar visualização para executar esta ação.
  • Use uma imagem quadrada para a miniatura. Quando você usa uma imagem não quadrada e exibe a miniatura na exibição de lista, a miniatura aparece cortada.
  • Quando uma nova imagem é carregada ou gerada, a miniatura é substituída por essa imagem e não pode ser redefinida para a imagem anterior.

Adicionar metadados personalizados

Além dos metadados fornecidos prontamente, o AEM Forms oferece suporte a 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 que você adicione ou modifique 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.

Adicionar propriedade de metadados personalizados 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 posicione-o em um local conveniente.
    Não é possível mover as seções bloqueadas, mas é possível colocar seu 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. Em Mapear para o campo de propriedade, você pode ver um valor pré-preenchido './jcr:content/metadata/default' . Altere o " padrão " para um nome de propriedade desejado, que é usado para armazenar a propriedade no repositório do crx (por exemplo: "./jcr:content/metadata/Department')
      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 e clique no ícone Excluir .
  4. Se necessário, siga as etapas de 1 a 3 para adicionar outra propriedade.
  5. Clique em Concluído após 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.