Formulário definido no AEM Forms form-set-in-aem-forms

Visão geral overview

Os clientes geralmente precisam enviar vários formulários para solicitar um serviço ou benefício. Isso envolve encontrar todos os formulários relevantes e preenchê-los, enviá-los e rastreá-los separadamente. Além disso, eles são necessários para preencher detalhes comuns várias vezes em formulários. Todo o processo se torna complicado e sujeito a erros se envolve um grande número de formulários. O recurso de conjunto de formulários do AEM Forms pode ajudar a simplificar a experiência do usuário em tais cenários.

Um conjunto de formulários é uma coleção de formulários HTML5 agrupados e apresentados como um único conjunto de formulários para os usuários finais. Quando os usuários finais começam a preencher um conjunto de formulários, eles são perfeitamente transferidos de um formulário para outro. No final, eles podem enviar todos os formulários em apenas um clique.

O AEM Forms fornece aos autores de formulários uma interface de usuário intuitiva para criar, configurar e gerenciar conjuntos de formulários. Como autor, você pode solicitar formulários em uma sequência específica que os usuários finais devem seguir. Além disso, você pode aplicar condições ou expressões de qualificação em formulários individuais para controlar sua visibilidade com base nas entradas do usuário. Por exemplo, você pode configurar o formulário de detalhes do cônjuge para que apareça somente quando o estado civil especificar como Casado.

Além disso, você pode configurar campos comuns em diferentes formulários para compartilhar associações de dados comuns. Com vinculações de dados adequadas em vigor, os usuários finais precisam preencher informações comuns apenas uma vez que forem preenchidas automaticamente em formulários subsequentes.

Os conjuntos de formulários também são compatíveis com o aplicativo AEM Forms, permitindo que a força de trabalho de campo coloque um conjunto de formulários offline, visite clientes, insira dados e sincronize posteriormente com o servidor do AEM Forms para enviar dados de formulários para processos de negócios.

Criação e gerenciamento de conjunto de formulários creating-and-managing-form-set

Você pode associar vários XDPs ou Modelos de formulário, criados usando o Designer, em um conjunto de formulários. Os conjuntos de formulários podem ser usados para renderizar seletivamente os XDPs com base nos valores inseridos pelos usuários nos formulários iniciais e em seus perfis.

Uso Interface do usuário do AEM Forms para gerenciar todos os formulários, conjuntos de formulários e ativos relacionados.

Criar um conjunto de formulários create-a-form-set

Para criar um conjunto de formulários, faça o seguinte:

Gerenciamento de um conjunto de formulários managing-a-form-set

Depois que um conjunto de formulários é criado, você pode executar as seguintes ações nesse conjunto de formulários:

Editar um conjunto de formulários edit-a-form-set

Para editar um conjunto de formulários, faça o seguinte:

Conjunto de formulários no Gerenciamento de processos form-set-in-process-management

Depois de criar um conjunto de formulários usando a interface do usuário do AEM Forms Management, você pode usar o conjunto de formulários em um Ponto Inicial ou na atividade Atribuir Tarefa usando a Bancada.

Usando o conjunto de formulários na Tarefa ou no ponto inicial using-form-set-in-task-or-start-point

Expressões de qualificação eligibility-expressions

As expressões de qualificação em um conjunto de formulários são usadas para definir e controlar dinamicamente os formulários exibidos para um usuário. Por exemplo, para exibir um formulário específico somente se o usuário pertencer a uma faixa etária específica. Especifique e edite uma expressão de qualificação usando o gerenciador de formulários.

Uma expressão de elegibilidade pode ser qualquer instrução JavaScript válida que retorne um valor booleano. A última instrução no trecho de código JavaScript é tratada como um valor booleano que determina a qualificação do formulário com base no processamento no restante (linhas anteriores) do trecho de código JavaScript. Se o valor da expressão for true, o formulário estará qualificado para ser exibido ao usuário. Tais formulários são conhecidos como formulários elegíveis.

Além das funções JavaScript padrão, o conjunto de formulários também expõe a API fs.valueOf que fornece acesso ao valor de um campo de um formulário em um conjunto de formulários. Use esta API para acessar o valor de um campo de formulário em um conjunto de formulários. A sintaxe da API é fs.valueOf (formUid, fieldSOM), onde:

Exemplos examples

Uso válido da API:

fs.valueOf("form1", "xfa.form.form1.subform1.field1")

Uso inválido da API:

var formUid = "form1";
 var fieldSOM = "xfa.form.form1.subform1.field1"; fs.valueOf(formUid, fieldSOM);

Preencher previamente XML para o conjunto de formulários prefill-xml-for-form-set

O conjunto de formulários é uma coleção de vários formulários HTML5 que têm esquemas comuns ou diferentes. O conjunto de formulários suporta o pré-preenchimento de campos de formulário usando um arquivo XML. Você pode associar um arquivo XML a um conjunto de formulários, de modo que, ao abrir um formulário no conjunto de formulários, alguns dos campos no formulário sejam pré-preenchidos.

O arquivo XML de preenchimento prévio é especificado usando o parâmetro dataRef da URL do conjunto de formulários. O parâmetro dataRef especifica o caminho absoluto do arquivo XML de dados mesclado com o conjunto de formulários.

Por exemplo, você tem três formulários (formulário1, formulário2 e formulário3), no conjunto de formulários com a seguinte estrutura:

formulário1

campo formulário1campo

formulário2

campo formulário2campo

formulário3

campo formulário3campo

Cada formulário tem um campo nomeado comum, chamado "campo", e um campo nomeado exclusivamente chamado "formfield".

É possível preencher previamente esse conjunto de formulários usando um XML com a seguinte estrutura:

<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
 <field>common field value</field>
 <form1field>value1</form1field>
 <form2field>value2</form2field>
 <form3field>value3</form3field>
</formSetRootTag>

O trecho XML acima mostra que o XML de preenchimento prévio do conjunto de formulários é uma união dos trechos XML de preenchimento prévio dos formulários individuais. Se determinados campos nos diferentes formulários tiverem hierarquia/esquema de dados semelhantes entre si, os campos serão pré-preenchidos com os mesmos valores. Neste exemplo, todos os três formulários são preenchidos previamente com o mesmo valor para o campo comum, "campo". Essa é uma maneira simples de transportar dados de um formulário para o próximo. Isso também pode ser feito vinculando os campos ao mesmo schema ou referência de dados. Se quiser segregar os dados do conjunto de formulários com base no schema dos formulários. Isso pode ser feito especificando o atributo "raiz de dados" do formulário, durante a criação do conjunto de formulários (o valor padrão é "/", que mapeia para a tag raiz do conjunto de formulários).

No exemplo anterior, se você especificar as raízes de dados: "/form1", "/form2" e "/form3" respectivamente para os três formulários, será necessário usar um XML de preenchimento prévio da seguinte estrutura:

<?xml version="1.0" encoding="UTF-8" ?>
<formSetRootTag>
 <form1>
  <field>field value1</field>
  <form1field>value1</form1field>
 </form1>
 <form2>
  <field>field value2</field>
  <form2field>value2</form2field>
 </form2>
 <form3>
  <field>field value3</field>
  <form3field>value3</form3field>
 </form3>
</formSetRootTag>

Em um conjunto de formulários, o XML definiu um esquema XML com a seguinte sintaxe:

<formset>
 <fs_data>
  <xdp:xdp xmlns:xdp="https://ns.adobe.com/xdp/">
  <xfa:datasets xmlns:xfa="https://www.xfa.org/schema/xfa-data/1.0/">
   <xfa:data>
   <rootElement>
    ... data ....
   </rootElement>
   </xfa:data>
  </xfa:datasets>
  </xdp:xdp>
 </fs_data>
 <fs_draft>
  ... private data...
 </fs_draft>
</formset>

Preencher previamente a descrição dos elementos XML prefill-xml-elements-description

Regras de sintaxe para criar um arquivo XML de preenchimento prévio:

FORMSET formset

parent elements:

null

cardinality: [0,1]

submitXML: P

prefillXML: O

children: fs_data

O elemento raiz do conjunto de formulários XML. É recomendável não usar essa palavra como o nome do rootSubform de qualquer formulário no conjunto de formulários.

FS_DATA fs-data

parent elements:

formset

cardinalidade: [1]

submitXML: P

prefillXML: O

children: xdp:xdp/rootElement

A subárvore indica os dados dos formulários no conjunto de formulários. O elemento é opcional no XML de preenchimento prévio somente se o elemento de conjunto de formulários não estiver presente

XDP:XDP xdp-xdp

parent elements: fs_data/null

cardinality: [0,1]

submitXML: O

prefillXML: O

children: xfa:datasets

Essa tag indica o início do formulário XML HTML5. Isso é adicionado no XML de envio se estiver presente no XML de preenchimento prévio ou se não houver XML de preenchimento prévio. Essa tag pode ser removida do XML de preenchimento prévio.

XFA:CONJUNTOS DE DADOS xfa-datasets

parent elements: xdp:xdp

cardinality: [1]

submitXML: O

prefillXML: O

children: xfa:data

XFA:DADOS xfa-data

parent elements: xfa:datasets

cardinality: [1]

submitXML: O

prefillXML: O

children: rootElement

ROOTELEMENT rootelement

parent elements: xfa:datasets/fs_data/null

cardinality: [0,1]

submitXML: P

prefillXML: O

children: controlled by the Forms in Form set

O nome rootElement é apenas um espaço reservado. O nome real é separado dos formulários usados no conjunto de formulários. A subárvore que começa com rootElement contém os dados dos campos e subformulários dentro do Forms no conjunto de formulários. Há vários fatores que determinam a estrutura do rootElement e seus filhos.

No XML pré-preenchido, essa tag é opcional, mas se estiver ausente, o XML inteiro será ignorado.

NOME DA TAG DO ELEMENTO RAIZ

Caso haja um elemento raiz no XML de preenchimento prévio, o nome desse elemento também será usado no XML de envio. Nos casos em que não há xml de preenchimento prévio, o nome do rootElement é o nome do Subformulário raiz do primeiro formulário no conjunto de formulários que tem uma propriedade dataRoot definida como "/". Se não houver tal formulário, o nome do rootElement será fs_dummy_root, que é uma palavra-chave reservada.

Formulário definido no aplicativo AEM Forms formset-in-workspace-app

O aplicativo AEM Forms permite que os funcionários de campo sincronizem seus dispositivos móveis com um servidor AEM Forms e trabalhem em suas tarefas. O aplicativo funciona mesmo quando o dispositivo está offline, salvando os dados localmente no dispositivo. Usando recursos de anotação, como fotografias, os trabalhadores de campo podem fornecer informações precisas para integrar aos processos de negócios.

Limitações conhecidas: padrões não totalmente compatíveis no conjunto de formulários known-limitations-patterns-not-fully-supported-in-form-set

Os seguintes padrões de dados não são totalmente compatíveis com o conjunto de formulários: