Configurar ações de envio para o AEM Forms
Configure o manuseio de envio de formulário para rotear dados para planilhas, emails ou sistemas de back-end usando o AEM Forms com o Edge Delivery Services.
Guia de decisão rápida
Escolha seu método de envio:
Pré-requisitos
Antes de configurar ações de envio, verifique se você tem:
- Instância do AEM Forms as a Cloud Service
- Projeto do Edge Delivery Services configurado
- Formulário criado usando Criação de Documento ou Editor Universal
- Permissões necessárias para destinos de destino (planilhas, sistemas de email ou AEM)
O Serviço de envio da Forms é um terminal hospedado pela Adobe ideal para cenários simples de captura de dados.
Destinos suportados
- Planilhas: Google Sheets, Microsoft Excel (OneDrive/SharePoint)
- Email: enviar dados de formulário para endereços de email especificados
Etapas de configuração
-
Configurar Acesso ao Destino
- Para planilhas: Conceder permissão de edição a
forms@adobe.com
na planilha de destino - Para email: verifique se os endereços de email dos recipients estão acessíveis
- Para planilhas: Conceder permissão de edição a
-
Configurar Envio de Formulário
- Abrir o formulário no ambiente de criação
- Definir a ação de envio como "Serviço de envio do Forms"
- Especificar URL da planilha de destino ou endereços de email
- Salvar e publicar o formulário
-
Envio de teste
- Enviar dados de teste por meio do formulário
- Verificar se os dados aparecem no destino
- Verificar logs de erros se o envio falhar
Observações importantes
- A conta de serviço
forms@adobe.com
requer acesso de edição para planilhas de destino - As notificações por email são enviadas imediatamente após o envio do formulário
- A validação de dados ocorre no nível de serviço
Envie dados de formulário diretamente para a instância de publicação do AEM as a Cloud Service para processamento complexo.
Quando usar a publicação do AEM
- Fluxos de trabalho personalizados do AEM necessários após envio
- Integração do Form Data Model (FDM) com bancos de dados
- Integrações de serviços de terceiros (Marketo, Power Automate, Workfront Fusion)
- Armazenamento Azure Blob ou bibliotecas de documentos do SharePoint
- Validação ou lógica de processamento complexa do lado do servidor
Ações de envio disponíveis
- Enviar para endpoint REST
- Enviar email por meio dos serviços de email da AEM
- Enviar usando modelo de dados do formulário
- Chamar fluxo de trabalho de AEM
- Enviar para o SharePoint
- Enviar para o OneDrive
- Enviar para o Armazenamento de blob do Azure
- Enviar para o Microsoft Power Automate
- Enviar para o Adobe Workfront Fusion
- Enviar para o Adobe Marketo Engage
Requisitos de configuração
1. Atualizar o URL da instância do AEM no Edge Delivery
Atualize a URL da instância do AEM Cloud Service no arquivo constant.js
no bloco form
em submitBaseUrl
. Você pode configurar o URL com base em seu ambiente:
Para a instância do Cloud Service
code language-js |
---|
|
Para desenvolvimento local
code language-js |
---|
|
2. Filtro referenciador OSGi
Configure o Filtro referenciador para permitir domínios de site específicos do Edge Delivery:
-
Criar ou atualizar o arquivo de configuração OSGi:
org.apache.sling.security.impl.ReferrerFilter.cfg.json
-
Adicione a seguinte configuração com os domínios específicos do site:
code language-json { "allow.empty": false, "allow.hosts": [ "main--abc--adobe.aem.live", "main--abc1--adobe.aem.live" ], "allow.hosts.regexp": [ "https://.*\\.aem\\.live:443", "https://.*\\.aem\\.page:443", "https://.*\\.hlx\\.page:443", "https://.*\\.hlx\\.live:443" ], "filter.methods": [ "POST", "PUT", "DELETE", "COPY", "MOVE" ], "exclude.agents.regexp": [ "" ] }
-
Implantar a configuração por meio do Cloud Manager
Para obter a configuração detalhada do Filtro referenciador OSGi, consulte o Guia do Filtro referenciador.
3. Questões do CORS (Cross-Origin Resource Sharing, Compartilhamento de recursos entre origens)
Defina as configurações do CORS no AEM para permitir solicitações de domínios específicos do site do Edge Delivery:
Localhost do Desenvolvedor
code language-apache |
---|
|
Sites do Edge Delivery - Adicionar cada domínio de site individualmente
code language-apache |
---|
|
Domínios herdados do Franklin (se ainda estiverem em uso)
code language-apache |
---|
|
note note |
---|
NOTE |
Substitua main--abc--adobe.aem.live e main--abc1--adobe.aem.live pelos domínios de site reais. Cada site hospedado no mesmo repositório requer uma entrada de configuração do CORS separada. |
Para obter a configuração detalhada do CORS, consulte o Guia de Configuração do CORS.
Para habilitar o CORS para o seu ambiente de desenvolvimento local, consulte o artigo Entender o CORS (Cross-Origin Resource Sharing, Compartilhamento de recursos entre origens).
4. Configuração do formulário
- Criar formulário no Editor Universal
- Configurar ação de envio para ação do AEM Forms de destino
- Especificar caminho de ponto de extremidade de envio
- Publicar formulário no site do Edge Delivery
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
---|---|
Problema | Solução |
Falha no envio do formulário | Verifique os erros do console, verifique o URL do endpoint e confirme as permissões |
Formulário inserido não aparece | Configure os cabeçalhos CORS na origem do formulário e verifique o URL do formulário |
Erros 403/401 com o AEM | Atualize o filtro do referenciador Sling, verifique as configurações de autenticação |
Dados não atingindo a planilha | Verificar se forms@adobe.com tem acesso de edição, verificar URL da planilha |
Erros do CORS | Adicionar cabeçalhos Access-Control-Allow-Origin adequados à origem do formulário |
Exemplos de configuração
- Criar estrutura de formulário no Google Docs/Sheets
- Configurar ponto de extremidade do Serviço de envio do Forms
- Conceder acesso de edição
forms@adobe.com
à planilha de destino - Publicar documento no site do Edge Delivery
- Testar envio de formulário e fluxo de dados
- Criar formulário no Editor Universal
- Configurar a ação de envio para "Chamar fluxo de trabalho do AEM"
- Configurar o Dispatcher e o filtro de referenciador no AEM Publish
- Configurar regras de roteamento CDN
- Publicar formulário e testar a execução do fluxo de trabalho
Práticas recomendadas
- Use o Serviço de Envio do Forms para cenários simples de captura de dados
- Escolha Publicar no AEM quando um processamento complexo ou integrações forem necessários
- Testar completamente no ambiente de preparo antes da implantação de produção
- Monitorar envios usando logs do AEM e erros de console
- Implementar a manipulação adequada de erros para envios com falha
- Validar dados nos níveis de cliente e servidor
- Usar HTTPS para todos os envios de formulários e transmissão de dados