Configuração do serviço de preenchimento prévio no Forms adaptável usando o Edge Delivery Services

Fase 1: Configuração Do Modelo De Dados De Formulário

Etapa 1: Criar modelo de dados do formulário

1. Faça logon na sua instância do AEM Forms as a Cloud Service

2. Navegue até Adobe Experience Manager > Forms > Integrações de Dados

3. Selecione Criar > Modelo de Dados de Formulário

4. Escolha sua Configuração do Data Source e selecione o Data Source configurado

   

   note tip
   TIP
   Para obter instruções detalhadas sobre como criar Modelos de Dados de Formulário, consulte Criar Modelo de Dados de Formulário.

Etapa 2: Configurar Serviços do FDM

1. Ir para Adobe Experience Manager > Forms > Integrações de Dados

2. Abrir o modelo de dados de formulário no modo de edição

3. Selecione um objeto de modelo de dados e clique em Editar Propriedades

4. Configurar os serviços Leitura e Gravação para os objetos de modelo de dados selecionados

   

5. Configurar argumentos do serviço:

   • Clique no ícone de edição para o argumento do serviço de leitura
   • Associe o argumento a um Atributo de Perfil de Usuário, Atributo de Solicitação ou Valor literal
   • Especifique o valor da associação (por exemplo, petid para um formulário de registro de animal de estimação)

   

6. Clique em Concluído para salvar o argumento e em Salvar para salvar o FDM

   note note
   NOTE
   Saiba mais sobre como configurar serviços do FDM em Trabalhar com o Modelo de Dados de Formulário (FDM).

Fase 2: Criação e configuração do formulário adaptável

Etapa 3: Criar um formulário adaptável

1. Navegue até Adobe Experience Manager > Forms > Forms e Documentos

2. Selecione Criar > Forms Adaptável

3. Na guia Source, selecione um modelo do Edge Delivery Services:

   

4. Clique em Criar para abrir o assistente Criar Formulário

   note note
   NOTE
   Você pode configurar a fonte de dados na guia Dados ou posterior editando as propriedades do formulário.

5. Especifique os detalhes do formulário:

   • Nome: insira um nome descritivo para o formulário
   • Título: forneça um título amigável
   • URL do GitHub: insira sua URL de repositório (por exemplo, https://github.com/wkndforms/edsforms)

6. Clique em Criar

   

O formulário é aberto no Editor universal para criação.

Etapa 4: configurar o Form Data Source

1. Selecione seu formulário e clique em Propriedades

   

2. Abra a guia Modelo de formulário

3. Na lista suspensa Selecionar de, escolha Modelo de Dados de Formulário (FDM)

4. Selecione o modelo de dados de formulário criado (por exemplo, PetFDM) na lista suspensa

   

5. Clique em Salvar e fechar

6. Abrir o formulário para edição no Editor Universal

Os elementos de formulário do FDM aparecem na guia Datasource do Navegador de Conteúdo.

Etapa 5: Adicionar vinculação de dados a campos de formulário

1. Selecionar elementos de dados na guia Fonte de Dados

2. Clique em Adicionar ou arraste e solte elementos para criar seu formulário

   

3. Adicionar vinculação de dados a campos de formulário:

   • Selecionar um campo de formulário

   • No painel Propriedades, localize a propriedade Referência de Ligação

   • Selecione a referência de vinculação de dados apropriada

     

Fase 3: Configuração do serviço de preenchimento prévio

Etapa 6: Ativar extensões necessárias

Verifique se essas extensões estão habilitadas no Universal Editor:

1. Extensão de Propriedades do Formulário do AEM

   • Abrir Extension Manager no Editor Universal
   • Habilitar a extensão Propriedades do Formulário AEM

   

2. Extensão do Data Source

   • Habilite a extensão Fonte de dados se você não visualizar o ícone Fontes de dados

   

   note tip
   TIP
   Para obter instruções detalhadas sobre como gerenciar extensões, consulte Destaques dos recursos do Extension Manager.

Etapa 7: configurar o serviço de preenchimento prévio

1. Abra o formulário adaptável no Editor universal

2. Clique no ícone de extensão Propriedades do AEM Form

   

3. Clique na guia Preenchimento prévio

4. Selecionar Serviço de Preenchimento de Modelo de Dados de Formulário

   

5. Clique em Salvar e fechar

Fase 4: Testar A Configuração De Preenchimento Prévio

Etapa 8: pré-visualização e teste

1. Ir para Forms > Forms e Documentos

2. Selecione o formulário adaptável

3. Escolher Visualizar como HTML

4. Teste o preenchimento prévio anexando parâmetros ao URL:

   https://your-preview-url.com?<bindreferencefield>=<value>

   Exemplo:

   https://your-preview-url.com?petid=12345

   

O formulário deve ser preenchido automaticamente com dados com base no parâmetro fornecido.

Problemas comuns e soluções

table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3
Problema	Causa possível	Solução
Campos de formulário não preenchidos previamente	Valores de bindRef incorretos	Verificar se bindRef corresponde exatamente a nomes de campos FDM
Erros de formato de dados	Estrutura de dados incompatível	Garantir que os dados pré-preenchidos correspondam ao esquema do modelo de formulário
Serviço não encontrado	Problemas de configuração do FDM	Verifique se os serviços do FDM estão configurados e salvos corretamente
Erros de autenticação	Conectividade da fonte de dados	Verificar credenciais e conectividade da fonte de dados
Carregamento de dados parcial	Mapeamentos de campo ausentes	Verificar se todos os campos obrigatórios têm vínculos de dados adequados

Etapas de depuração

1. Verificar Configuração do FDM:

   • Verificar se os serviços estão configurados corretamente
   • Testar os serviços do FDM independentemente
   • Validar conectividade da fonte de dados

2. Verificar Configuração do Formulário:

   • Confirmar se o formulário está associado ao FDM correto
   • Verificar os valores do campo bindRef
   • Formulário de ensaio sem preenchimento prévio

3. Testar Fluxo de Dados:

   • Usar ferramentas de desenvolvedor do navegador para inspecionar solicitações de rede
   • Verifique se há erros de JavaScript no console
   • Validar formato de dados de resposta

4. Mensagens de Erro Comuns:

   • "Serviço de preenchimento prévio não encontrado": verifique a configuração do serviço
   • "Falha na associação de dados": verifique a precisão bindRef
   • "Formato de dados inválido": verifique se os dados correspondem ao esquema

Práticas recomendadas de configuração

• Usar nomenclatura descritiva: nomeie seus FDMs e serviços com clareza
• Validar esquemas de dados: verifique se a estrutura de dados corresponde aos requisitos do formulário
• Testar incrementalmente: configurar e testar um campo por vez
• Mapeamentos de documentos: acompanhar os mapeamentos de campo para dados

Otimização do desempenho

• Minimizar volume de dados: preencher apenas os campos necessários
• Usar armazenamento em cache: configurar o armazenamento em cache apropriado para os dados acessados com frequência
• Otimizar consultas: verifique se as consultas ao banco de dados são eficientes
• Monitorar desempenho: Rastrear tempos de carregamento de formulário com preenchimento prévio habilitado

Considerações sobre segurança

• Validar parâmetros de entrada: sempre validar parâmetros de URL
• Limpar dados: limpe os dados antes de preencher formulários previamente
• Implementar controles de acesso: certifique-se de que os usuários só possam acessar seus próprios dados
• Usar HTTPS: sempre usar conexões seguras para transmissão de dados

Diretrizes de experiência do usuário

• Fornecer feedback: Mostrar indicadores de carregamento durante a busca de dados
• Lidar com erros normalmente: exibir mensagens de erro úteis
• Permitir substituições: permitir que os usuários modifiquem dados preenchidos previamente
• Manter consistência: usar comportamento de preenchimento prévio consistente em formulários

Como testar se o preenchimento prévio está funcionando corretamente?

Visualize o formulário e anexe parâmetros de preenchimento prévio à URL usando este formato: ?<bindreferencefield>=<value>. Verifique se o campo tem um bindRef válido que corresponda à estrutura de dados. Use as ferramentas de desenvolvedor do navegador para inspecionar solicitações de rede e verificar se os dados estão sendo obtidos corretamente.

Quais formatos de dados são compatíveis com o preenchimento prévio do Adaptive Forms?

O Forms adaptável é compatível com vários formatos, dependendo do modelo de formulário:

• Formulários XFA: XML correspondente ao esquema XFA
• Formulários de esquema JSON: dados JSON compatíveis com o esquema
• Formulários FDM: JSON que mapeia para a estrutura do modelo de dados
• Formulários de esquema XML: XML correspondente à estrutura do esquema

Posso preencher previamente campos vinculados e não vinculados?

Sim, você pode preencher previamente ambos os tipos de campos. Os campos associados usam a seção afBoundData e devem corresponder ao esquema do modelo de formulário. Campos desatados usam a seção afUnBoundData e podem conter dados adicionais.

O que devo fazer se apenas alguns campos estiverem sendo preenchidos previamente?

Verifique se todos os campos têm bindRef valores corretos que correspondam exatamente ao seu FDM. Verifique se a fonte de dados contém todos os campos obrigatórios e se a estrutura de dados corresponde ao esquema do modelo de formulário.

Posso usar vários serviços de preenchimento prévio em um formulário?

É possível configurar um serviço de preenchimento prévio principal por formulário. No entanto, é possível combinar diferentes fontes de dados em um único Modelo de dados de formulário para obter funcionalidade semelhante.

Como gerenciar a autenticação de serviços de preenchimento prévio?

A autenticação depende da configuração da fonte de dados. Para preenchimento prévio baseado em FDM, configure a autenticação nas configurações da fonte de dados. Para o preenchimento prévio de rascunho, os usuários normalmente precisam estar conectados para acessar os rascunhos salvos.