Serviço de envio de Forms para o Edge Delivery Services

Perfeito para:

• Criadores de conteúdo criando formulários de coleção de dados simples
• Pequenas empresas que precisam de fluxos de trabalho rápidos de formulário para planilha
• Equipes de marketing coletando informações de clientes potenciais
• Organizadores de eventos gerenciando registros

Considere alternativas para:

• Fluxos de trabalho complexos que exigem lógica personalizada
• Integrações corporativas com bancos de dados
• Forms que precisa de validação ou processamento avançado

• Nenhuma infraestrutura de back-end necessária - o Adobe hospeda o ponto de extremidade de envio
• Integração direta com plataformas de planilha populares
• Mapeamento automático de dados de campos de formulário para colunas de planilha

• Captura instantânea de dados - os envios aparecem imediatamente em sua planilha
• Armazenamento estruturado - colunas organizadas para facilitar a análise
• Colaboração ao vivo - vários membros da equipe podem acessar e analisar dados

• Aproveita permissões existentes - use os controles de compartilhamento da sua plataforma de planilha
• segurança gerenciada pela Adobe - ponto de extremidade de envio seguro com proteção de nível empresarial
• Propriedade dos dados - seus dados permanecem na plataforma de planilha escolhida

• Repositório do GitHub configurado para seu projeto do Edge Delivery Services com o Bloco Adaptive Forms mais recente instalado
• incluir na lista de permissões Aprovação de acesso - repositório adicionado ao arquivo de pesquisa

Escolha uma das plataformas compatíveis:

• Google Sheets - Conta da Google com permissões de criação de planilhas
• Microsoft OneDrive - Conta do Microsoft 365 com acesso ao Excel Online
• SharePoint - Acesso ao SharePoint com permissões de lista/biblioteca

• Editar permissões para a planilha de destino
• Compartilhando recursos para conceder acesso a forms@adobe.com
• Permissões de geração de link para a plataforma escolhida

Antes de configurar qualquer método, verifique se a base do projeto do AEM está pronta:

1. Crie ou atualize seu projeto do AEM com o Bloco Adaptive Forms mais recente (Tutorial de Introdução)

2. Atualizefstab.yaml na raiz do seu projeto:

   code language-yaml
   # Replace with the path to your shared folder mountpoints: /: https://drive.google.com/drive/folders/your-shared-folder-id

3. Compartilhar a pasta do projeto com forms@adobe.com (são necessárias permissões de edição)

Crie a estrutura do formulário usando o Google Sheets ou o Microsoft Excel.

Etapas de Criação do Formulário:

1. Abra a plataforma de planilha (Google Sheets ou Microsoft Excel)
2. Criar uma nova planilha para o projeto de formulário
3. Nomeie sua planilha (deve ser helix-default ou shared-aem)
4. Defina sua estrutura de formulário usando o guia de criação de formulário

Exemplo: definição de formulário com tipos de campo, rótulos e regras de validação

Ponto de Verificação de Validação:

• A estrutura do formulário está completa com todos os campos obrigatórios
• A planilha está nomeada corretamente (helix-default ou shared-aem)
• Os tipos de campos e as regras de validação estão configurados corretamente

Configure uma planilha dedicada para receber dados de envio do formulário.

Configuração de Folha de Dados:

1. Adicionar uma nova planilha à planilha existente
2. Nomeie a planilha exatamenteincoming (diferencia maiúsculas de minúsculas)
3. Configurar cabeçalhos de coluna que correspondam aos seus campos de formulário
4. Salve a planilha para garantir que as alterações sejam preservadas

Exemplo: planilha de entrada com cabeçalhos de coluna correspondentes aos campos de formulário

Ponto de Verificação de Validação:

• incoming planilha existe em sua planilha
• Os cabeçalhos de coluna correspondem aos nomes dos campos de formulário
• A planilha é salva e acessível corretamente

Conceda acesso ao Adobe Forms Submission Service para sua planilha.

Processo de Compartilhamento:

1. Clique no botão Compartilhar no canto superior direito da planilha

2. Adicionar a conta de serviço da Adobe:

   • Email: forms@adobe.com
   • Nível de permissão: Editor (necessário para gravação de dados)

3. Enviar o convite de compartilhamento

4. Copie o link da planilha para a próxima etapa

   
   Processo de compartilhamento passo a passo para conceder acesso ao serviço da Adobe

Instruções específicas da plataforma:

Planilhas Google:

• Adicionar forms@adobe.com como editor
• Verifique se "Qualquer pessoa com o link pode visualizar" está ativado
• Copiar o link compartilhável

Microsoft Excel (OneDrive/SharePoint):

• Adicionar forms@adobe.com com permissões de edição

• Defina o compartilhamento de link como "Qualquer pessoa com o link pode editar"

• Copiar o URL de compartilhamento

  
  Exemplo: Copiando o link compartilhável para a configuração de formulário

Ponto de Verificação de Validação:

• forms@adobe.com tem acesso de Editor à sua planilha
• O link da planilha foi copiado e está pronto para uso
• Permissões de compartilhamento permitem acesso externo

Vincule a definição do formulário à planilha de envio.

Conexão de Planilha de Formulário:

1. Abra a planilha de definição de formulário (aquela com a planilha helix-default ou shared-aem)

2. Localize a linha de campo Enviar na definição do formulário

3. Cole o link da planilha copiada na coluna Ação para o campo Enviar

4. Salve as alterações na definição do formulário

   

Exemplo: Conectando a ação de envio à sua planilha de coleta de dados

Publicando Seu Formulário:

1. Abra o AEM Sidekick no navegador
2. Visualize seu formulário para testar a configuração
3. Publicar o formulário para ativá-lo

Validação Final:

• O link da planilha é adicionado corretamente à ação Enviar campo
• A definição de formulário é salva e publicada
• A visualização do formulário mostra todos os campos corretamente
• O botão Enviar está configurado corretamente

Materiais de Referência:

• Planilha de exemplo completa com configuração adequada
• documentação do AEM Sidekick para orientação de publicação

Perfeito para:

• Sistemas automatizados de coleta de dados
• Implementações de formulário personalizado
• Integração com aplicativos existentes
• Fluxos de trabalho de envio de dados em massa

Antes de usar a API, verifique se você tem:

• Configuração da planilha concluída (incluindo a planilha incoming)
• Acesso ao serviço da Adobe concedido a forms@adobe.com
• ID do formulário do seu formulário publicado
• Informações do repositório (organização e nome do site)

URL Base: https://forms.adobe.com/adobe/forms/af/submit/{id}

Cabeçalhos obrigatórios:

• Content-Type: application/json
• x-adobe-routing: tier=live,bucket=main--[repository]--[organization]

Documentação da API: Referência completa da API

O Postman fornece uma interface simples para testar os envios de API.

Instruções de Instalação:

1. Criar uma nova solicitação POST no Postman

2. Configurar o ponto de extremidade: https://forms.adobe.com/adobe/forms/af/submit/{id}

3. Substituir espaços reservados:

   • {id} → Sua ID de formulário real
   • [repository] → Seu nome de repositório no GitHub
   • [organization] → Sua organização/nome de usuário do GitHub

Solicitar configuração:

POST https://forms.adobe.com/adobe/forms/af/submit/your-form-id

Headers:
Content-Type: application/json
x-adobe-routing: tier=live,bucket=main--your-repo--your-org

Body (JSON):
{
        "data": {
            "startDate": "2025-01-10",
            "endDate": "2025-01-25",
            "destination": "Australia",
            "class": "First Class",
            "budget": "2000",
            "amount": "1000000",
            "name": "Mary",
            "age": "35",
            "subscribe": null,
            "email": "mary@gmail.com"
                }
}

Resposta esperada:

• Código de Status: 201 Created
• Os dados aparecem na planilha incoming imediatamente

Exemplo: envio bem-sucedido da API usando a interface do Postman

Para desenvolvedores que preferem prompt de terminal/comando, use curl para enviar dados programaticamente.

Configuração da Linha de Comando:

Substitua os seguintes espaços reservados nos comandos abaixo:

• {id} → Sua ID de formulário real
• [repository] → Seu nome de repositório no GitHub
• [organization] → Sua organização/nome de usuário do GitHub

curl -X POST "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" \
    --header "Content-Type: application/json" \
  --header "x-adobe-routing: tier=live,bucket=main--your-repo--your-org" \
    --data '{
        "data": {
            "startDate": "2025-01-10",
            "endDate": "2025-01-25",
            "destination": "Australia",
            "class": "First Class",
            "budget": "2000",
            "amount": "1000000",
            "name": "Joe",
            "age": "35",
            "subscribe": null,
      "email": "joe@example.com"
                }
            }'

curl -X POST "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" ^
    --header "Content-Type: application/json" ^
  --header "x-adobe-routing: tier=live,bucket=main--your-repo--your-org" ^
  --data "{\"data\": {\"startDate\": \"2025-01-10\", \"endDate\": \"2025-01-25\", \"destination\": \"Australia\", \"class\": \"First Class\", \"budget\": \"2000\", \"amount\": \"1000000\", \"name\": \"Joe\", \"age\": \"35\", \"subscribe\": null, \"email\": \"joe@example.com\"}}"

$body = @{
  data = @{
    startDate = "2025-01-10"
    endDate = "2025-01-25"
    destination = "Australia"
    class = "First Class"
    budget = "2000"
    amount = "1000000"
    name = "Joe"
    age = "35"
    subscribe = $null
    email = "joe@example.com"
  }
} | ConvertTo-Json -Depth 3

Invoke-RestMethod -Uri "https://forms.adobe.com/adobe/forms/af/submit/your-form-id" `
  -Method POST `
  -Headers @{"Content-Type"="application/json"; "x-adobe-routing"="tier=live,bucket=main--your-repo--your-org"} `
  -Body $body

Resposta Bem-sucedida:

HTTP/1.1 201 Created
Connection: keep-alive
Content-Length: 0
X-Request-Id: 02a53839-2340-56a5-b238-67c23ec28f9f
X-Message-Id: 42ecb4dd-b63a-4674-8f1a-05a4a5b0372c
Date: Fri, 10 Jan 2025 13:06:10 GMT
Access-Control-Allow-Origin: *

Verificação de dados:

Após um envio bem-sucedido, verifique se os dados aparecem em sua planilha:

Exemplo: dados gravados com êxito na folha de entrada via API

Validação de Resposta:

• Status HTTP: 201 Created indica envio bem-sucedido
• X-Request-Id: Identificador exclusivo para rastrear o envio
• Os dados aparecem na sua planilha incoming em segundos
• Todos os campos de formulário estão mapeados corretamente para colunas da planilha

Problema: 403 Erro Proibido

Causes: Missing or incorrect access permissions
Solutions:
- Verify forms@adobe.com has Editor access to your spreadsheet
- Check that your repository is added to the allowlist
- Confirm the x-adobe-routing header format

Problema: 404 Erro Não Encontrado

Causes: Incorrect Form ID or endpoint URL
Solutions:
- Verify your Form ID is correct
- Check the API endpoint URL format
- Ensure your form is published and live

Problema: Dados Não Aparecem na Planilha

Causes: Missing 'incoming' sheet or permission issues
Solutions:
- Confirm 'incoming' sheet exists (case-sensitive)
- Verify column headers match form field names exactly
- Check forms@adobe.com has edit permissions
- Ensure spreadsheet is shared properly

Problema: Erro de Formato JSON Inválido

Causes: Malformed request body
Solutions:
- Validate JSON syntax using online JSON validators
- Ensure proper escaping of special characters
- Check quote marks and brackets are balanced

Canais de suporte:

• Problemas de acesso antecipado: Email aem-forms-ea@adobe.com
• Documentação da API: Referência do desenvolvedor
• Suporte da comunidade: Comunidade da Adobe Experience League

• Criar Forms Avançado - Adicionar validação, lógica condicional e estilo personalizado
• Guia de Componentes de Formulário - Explorar tipos de campos de formulário disponíveis

• Envios de Publicação do AEM - Para fluxos de trabalho complexos e integrações corporativas
• Ações de Envio Personalizadas - Manuseio de envio avançado

• Form Analytics - Rastrear o desempenho e o uso do formulário
• Integração de Dados - Conectar formulários a bancos de dados e sistemas CRM