DocumentaçãoAEM as a Cloud ServiceGuia do usuário

Adicionar, remover ou editar metadados de um Formulário adaptável manage-form-metadata

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined

O Adobe recomenda o uso de Componentes principaisde captura de dados moderna e extensível para criar um novo Forms Adaptávelou adicionar o Forms Adaptável às páginas do AEM Sites. Esses componentes representam um avanço significativo na criação do Forms adaptável, garantindo experiências de usuário impressionantes. Este artigo descreve a abordagem mais antiga para criar o Forms adaptável usando componentes de base.

Versão
Link do artigo
AEM 6.5
Clique aqui
AEM as a Cloud Service
Este artigo

Os metadados facilitam a categorização e a organização de ativos e ajudam os usuários que procuram um ativo específico.

AEM Forms, por padrão, fornece um conjunto definido de metadados para cada tipo de ativo. Além dos metadados padrão, é possível 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 forma eficiente para seus formulários.

Metadados no AEM Forms metadata-in-aem-forms

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

Tipos de ativos asset-types

Os seguintes tipos de ativos têm suporte no AEM Forms:

  • Modelos de formulário (formulários XFA)
  • PDF forms
  • Documento (PDF simples)
  • Adaptive Forms
  • Modelo de dados do Forms
  • XFS

Ampla lista de metadados extensive-list-of-metadata

Esta é uma lista extensa de propriedades de metadados com suporte no AEM Forms:

Nome da propriedade
Tipo de ativo
Descrição
Título
Todos, exceto o recurso
Nome para exibição do ativo.
Descrição
Todos, exceto o recurso
Descrição do ativo. O usuário pode especificar este valor.
Tipo
Todos

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 (Signed)
  • Documento, Documento (Assinado)
  • Formulário adaptável
  • Modelo de dados de formulário (FDM)
  • Recurso
Criado
Todos
Um valor somente leitura que especifica o tempo de criação do ativo.
Data da última modificação
Todos
Um valor somente leitura que especifica a hora em que o ativo foi modificado pela última vez.
Autor
Todos, exceto o recurso

Um valor somente leitura que é automaticamente calculado com base no tipo de formulário.

  • PDF/Modelo de formulário/Documento - obtido do arquivo binário carregado.
  • Formulário adaptável - Usuário conectado no momento da criação do formulário.
Status
Todos, exceto o recurso

Um valor somente leitura que define um dos seguintes estados de um formulário:

  • Nenhum valor: se um formulário nunca foi 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 o recurso
Um valor somente leitura que especifica a hora em que o formulário foi publicado pela última vez.
Horário ligado/desligado do Publish
Todos, exceto o recurso

Hora em que o formulário está agendado para ser publicado/despublicado automaticamente. O usuário define esse valor ao editar metadados.

  • Os horários de ativação e desativação do Publish devem estar após a data atual.
  • O Tempo de desativação do Publish deve estar além do tempo de ativação da publicação.
Enviar URL

Modelo de formulário

formulário PDF

Para configurar uma URL especificada pelo usuário para enviar dados de formulário a um servlet.

O URL de envio pode ser configurado usando qualquer um dos métodos a seguir, listados em ordem de precedência:

  • Especifique um URL de envio diretamente em um Modelo de formulário usando o botão Enviar 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 uma URL de envio ao editar as propriedades dos metadados.
Perfil de renderização do HTML
Modelo de formulário
O perfil de renderização de HTML usado ao renderizar um Modelo de Formulário no formato HTML.
Renderizar formato

Modelo de formulário

Formulário adaptável

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.

Tags
Todos, exceto o recurso
Rótulos associados ao formulário para facilitar a pesquisa rápida e fácil.
Referências

Formulário adaptável

Modelo de formulário

Recurso

Lista de ativos (outros formulários ou recursos) aos quais este formulário está relacionado. Esses ativos podem estar nas duas categorias a seguir:

  • Refere-se: Assets ao qual o formulário atual se refere.
  • Referenciado por: Assets que se refere 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ário adaptável

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 dados de formulário (FDM)
  • Esquema: um XML do esquema JSON
  • Nenhum

Um modelo de formulário depois de selecionado pode ser atualizado, mas não removido.

Exibir metadados de formulário view-form-metadata

O Assets tem valores de propriedade existentes, que podem ser exibidos no modo somente leitura. Esses metadados são originados 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:

    • Clique no ícone Propriedades Propriedades de Ações rápidas.

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

    • Selecione o formulário e clique no ícone Propriedades Propriedades que aparece na barra de ferramentas.

    • 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 do olho Propriedades no canto superior direito e clique em Propriedades na lista abaixo.

  3. A página de propriedades que é aberta exibe um esquema que contém apenas as propriedades de metadados que têm algum valor.

    A parte de 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 em várias guias.

Adicionar/atualizar valores de metadados de formulário add-update-form-metadata-values

É 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 a miniatura do formulário update-the-form-thumbnail

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 Carregar Imagem e procurando um arquivo de imagem no diretório local. A imagem selecionada é usada como uma miniatura em vez da padrão.

Para o Adaptive Forms, é fornecida uma funcionalidade adicional, que permite que o usuário gere uma miniatura como um instantâneo da visualização atual do Formulário adaptável. Como o AEM Forms também oferece suporte à criação do Adaptive Forms, a visualização do Formulário adaptável pode mudar sempre que você alterar o Formulário adaptável. Essa funcionalidade de gerar uma miniatura ajuda a obter uma nova miniatura do Formulário adaptável com base no status de visualização atual. Clique em Gerar visualização para realizar esta ação.

NOTE
  • Use uma imagem quadrada para a miniatura. Quando você usa uma imagem não quadrada e visualiza a miniatura na exibição em lista, a miniatura aparece cortada.
  • Depois que 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 add-custom-metadata

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

Uma ferramenta (Editor de Esquema de Metadados) é fornecida para definir o esquema para o layout de 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.

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

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

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

  3. Na lista aberta, clique no tipo de ativo ao qual deseja adicionar metadados personalizados.

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

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

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

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

    Editor de metadados

    1. O painel esquerdo contém seções com abas, onde os campos são posicionados, e o painel direito exibe todos os componentes de 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. Você pode adicionar guias adicionais 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 Configurações depois de clicar no campo.

Adicionar propriedade de metadados personalizada no editor de esquema add-custom-metadata-property-in-schema-editor

  1. Navegue até a guia (existente ou nova) onde 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.

    note note
    NOTE
    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 você 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 para usar como um nome de exibição acima do campo colocado no esquema (Por exemplo: Departamento)

    2. Em Mapear para 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 crx (Por exemplo: './jcr:content/metadata/department')

      note note
      NOTE
      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 Excluir .

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

  5. Clique em Salvar depois de fazer todas as alterações.

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

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

Consulte também see-also

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab