Suporte XFA em formulários adaptáveis baseados em XDP

Última atualização em 2023-11-08
  • Criado para:
  • User

Introdução

O Adobe recomenda o uso da captura de dados moderna e extensível Componentes principais para criação de um novo Forms adaptável ou adição de 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.

Os formulários adaptáveis são compatíveis com vários eventos XFA, propriedades, scripts e validações definidos em um arquivo XDP, incluindo:

  • Execução de scripts definidos em eventos no arquivo XDP.
  • Captura de valores padrão e propriedades comportamentais para campos no arquivo XDP.
  • Execução de scripts de validação definidos no arquivo XDP.

Quando um formulário adaptável é criado com base em um arquivo XDP, as propriedades, os eventos e as validações são preenchidos automaticamente na interface de criação do formulário. No entanto, os autores de formulário podem substituir alguns desses elementos para criar uma experiência alternativa.

Este artigo lista eventos, propriedades e validações XFA compatíveis honrados em formulários adaptáveis e explica como substituí-los em formulários adaptáveis.

Elementos XFA compatíveis e seu mapeamento em formulários adaptáveis

Campos

Quando um formulário adaptável é criado usando um arquivo XDP, você pode arrastar e soltar um campo XFA no formulário adaptável. A tabela a seguir lista como os campos XFA são mapeados para campos de formulário adaptáveis.

Campo ou contêiner XFA

Componente de formulário adaptável correspondente

Botão

Botão

Caixa de seleção

Caixa de seleção

Caixa de listagem

Lista suspensa

Campo de data/hora

Seletor de data

Rabisco de assinatura

Rabiscar a assinatura

Campo numérico

Caixa numérica

Campo decimal

Caixa numérica

Campo de texto

Caixa de texto

Campo de senha

Caixa Senha

Imagem

Imagem

Texto

Texto

Subformulário

Painel

Área (Grupo)

Painel

Conjunto de subformulários

Painel

Propriedades

A tabela a seguir captura como vários scripts XFA definidos nos arquivos XDP se comportam em formulários adaptáveis.

Propriedades do componente XFA

Comportamento correspondente em formulários adaptáveis

somExpression

Mapeado para a propriedade Referência de vínculo (bindRef) no formulário adaptável.

presença

Mapeado para a propriedade visível no formulário adaptável. É possível substituí-lo usando a expressão Visibility.

acesso

Mapeado para a propriedade ativada no formato adaptável. Você pode substituí-lo usando a expressão Access.

Acessibilidade: função

Mapeado para a propriedade de função no formulário adaptável.

Acessibilidade: speakPriority

Mapeado para a propriedade speakPriority no formato adaptável.

Acessibilidade: speakText

Mapeado para o texto personalizado de Acessibilidade no formulário adaptável.

Acessibilidade: toolTip

Mapeado para a propriedade de descrição curta em formato adaptável.

legenda (todos os tipos de campos)

Mapeado para a propriedade Título no formulário adaptável.

displayFormat (todos os tipos de campos)

Mapeado para o padrão de exibição no formulário adaptável.

rawValue (todos os tipos de campos)

Mapeado para a propriedade de valor no formulário adaptável.

itens (Caixa de listagem, Caixa de seleção)

Mapeado para a propriedade de opções no formulário adaptável. Você pode substituí-lo usando a expressão Options.

maxChar (Campo de texto)

Mapeado para a propriedade Máximo de caracteres permitidos no formulário adaptável.

multilinha (Campo de texto)

Mapeado para a propriedade Permitir várias linhas no formulário adaptável.

fracDigit (Campo Numérico, Campo Decimal)

Mapeado para a propriedade de dígitos Frac no formulário adaptável.

leadDigit (Campo Numérico, Campo Decimal)

Mapeado para a propriedade de dígitos de cliente potencial no formulário adaptável.

multiSelect (Caixa de listagem)

Mapeado para a propriedade Permite seleção múltipla em formato adaptável.

Scripts

A tabela a seguir captura como vários scripts XFA definidos no arquivo XDP se comportam em formulários adaptáveis.

Eventos de script XFA

Comportamento correspondente em formulários adaptáveis

inicializar

Esse script é executado no tempo de execução e não pode ser substituído no formulário adaptável.

calcular

Mapeado para a expressão Calculate no formato adaptável.

validar

Mapeado para a expressão Validation no formulário adaptável.

validationState

Esse script é executado no tempo de execução e não pode ser substituído no formulário adaptável.

sair

Esse script é executado no tempo de execução e não pode ser substituído no formulário adaptável.

clique em (campos de botão)

Mapeado para a expressão Click do botão.

Suporte para script de servidor

Esse script é executado no tempo de execução e não pode ser substituído no formulário adaptável.

Suporte para serviços da Web

Esse script é executado no tempo de execução e não pode ser substituído no formulário adaptável.

Alterar (campo de rabisco, botão de opção, caixa de seleção)

Esse script é executado no tempo de execução e não pode ser substituído no formulário adaptável.

Validações

A tabela a seguir captura como as validações XFA são mapeadas para validações em formulários adaptáveis.

Validação de XFA

Validação correspondente no formulário adaptável

Padrão de validação (formatTest)

validatePictureClause

Mensagem do padrão de validação (formatTestMessage)

validatePictureMessage

Obrigatório (nullTest )

obrigatório

Mensagem vazia (nullTestMessage)

mandatoryMessage

Validar script (scriptTest)

validateExp

Mensagem do script de validação (scriptTestMessage)

validateMessage

OBSERVAÇÃO

Não é possível substituir a propriedade obrigatória pelo botão de opção do formulário adaptável e pelo grupo de caixas de seleção vinculados aos botões de seleção XFA.

Nesta página