Forms Submission Service for Edge Delivery Services

Perfekt för:

• Innehållsskapare skapar enkla datainsamlingsformulär
• Små företag som behöver snabba arbetsflöden mellan formulär och kalkylblad
• Marknadsföringsteam samlar in leadinformation
• Händelseorganisatörer hanterar registreringar

Överväg alternativ för:

• Komplexa arbetsflöden som kräver anpassad logik
• Företagsintegrering med databaser
• Forms behöver avancerad validering eller bearbetning

• Ingen backend-infrastruktur krävs - Adobe är värd för överföringsslutpunkten
• Direktintegrering med populära kalkylbladsplattformar
• Automatisk datamappning från formulärfält till kalkylbladskolumner

• Datainhämtning direkt - inskickade data visas omedelbart i kalkylbladet
• Strukturerad lagring - strukturerade kolumner för enkel analys
• Live-samarbete - flera teammedlemmar kan komma åt och analysera data

• Utnyttjar befintliga behörigheter - använd kalkylbladsplattformens delningskontroller
• Adobe-hanterad säkerhet - säker slutpunkt för överföring med företagsskydd
• Dataägarskap - dina data ligger kvar på den kalkylbladsplattform du valt

• GitHub-databasen har konfigurerats för ditt Edge Delivery Services-projekt med det senaste adaptiva Forms-blocket installerat
• Åtkomstgodkännande - databasen har lagts till i tillåtelselista

Välj en av de plattformar som stöds:

• Google-blad - Google-konto med behörighet att skapa blad
• Microsoft OneDrive - Microsoft 365-konto med åtkomst via Excel Online
• SharePoint - SharePoint-åtkomst med list-/biblioteksbehörigheter

• Redigera behörigheter för målkalkylbladet
• Delningsfunktioner som ger åtkomst till forms@adobe.com
• Länkgenerering behörigheter för den valda plattformen

Innan du konfigurerar någon av metoderna måste du se till att din grund för AEM-projektet är klar:

1. Skapa eller uppdatera ditt AEM-projekt med det senaste adaptiva Forms-blocket (Komma igång-självstudiekurs)

2. Uppdaterafstab.yaml i projektets rot:

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

3. Dela projektmappen med forms@adobe.com (redigeringsbehörighet krävs)

Skapa en formulärstruktur med Google Sheets eller Microsoft Excel.

Steg för att skapa formulär:

1. Öppna kalkylbladsplattformen (Google-blad eller Microsoft Excel)
2. Skapa ett nytt kalkylblad för ditt formulärprojekt
3. Namnge bladet (måste vara antingen helix-default eller shared-aem)
4. Definiera formulärstrukturen med hjälp av guiden Skapa formulär

Exempel: Formulärdefinition med fälttyper, etiketter och valideringsregler

Kontrollpunkt för validering:

• Formulärstrukturen har fyllts i med alla obligatoriska fält
• Blad har rätt namn (helix-default eller shared-aem)
• Fälttyper och verifieringsregler är korrekt konfigurerade

Skapa ett dedikerat blad för att ta emot formuläröverföringsdata.

Inställningar för datablad:

1. Lägg till ett nytt blad i ditt befintliga kalkylblad
2. Namnge bladet exaktincoming (skiftlägeskänsligt)
3. Konfigurera kolumnrubriker som matchar formulärfälten
4. Spara kalkylbladet för att säkerställa att ändringarna bevaras

Exempel: Inkommande blad med kolumnrubriker som matchar formulärfält

Kontrollpunkt för validering:

• incoming blad finns i kalkylbladet
• Kolumnrubrikerna matchar formulärfältsnamnen
• Blad är rätt sparad och tillgänglig

Ge Adobe Forms inskickningstjänst åtkomst till ditt kalkylblad.

Delningsprocess:

1. Klicka på knappen Dela i det övre högra hörnet av kalkylbladet

2. Lägg till Adobe-tjänstkontot:

   • E-post: forms@adobe.com
   • Behörighetsnivå: Redigeraren (krävs för att skriva data)

3. Skicka delningsinbjudan

4. Kopiera kalkylbladslänken för nästa steg

   
   Stegvis delning för att bevilja åtkomst till Adobe-tjänster

Plattformsspecifika instruktioner:

Google-blad:

• Lägg till forms@adobe.com som redigerare
• Kontrollera att "Alla med länken kan visa" är aktiverat
• Kopiera delningslänken

Microsoft Excel (OneDrive/SharePoint):

• Lägg till forms@adobe.com med redigeringsbehörigheter

• Ange länkdelning till"Alla med länken kan redigera"

• Kopiera delnings-URL

  
  Exempel: Kopierar den delningsbara länken för formulärkonfigurationen

Kontrollpunkt för validering:

• forms@adobe.com har redigeraren åtkomst till ditt kalkylblad
• Kalkylbladslänken kopieras och kan användas
• Delningsbehörigheter ger extern åtkomst

Länka formulärdefinitionen till det inskickade kalkylbladet.

Anslutning av formulär-kalkylblad:

1. Öppna formulärdefinitionskalkylbladet (det med helix-default eller shared-aem ark)

2. Leta reda på fältet Skicka i formulärdefinitionen

3. Klistra in den kopierade kalkylbladslänken i kolumnen Åtgärd för fältet Skicka

4. Spara ändringarna i formulärdefinitionen

   

Exempel: Ansluta sändningsåtgärden till ditt datainsamlingsblad

Publicerar ditt formulär:

1. Öppna AEM Sidekick i webbläsaren
2. Förhandsgranska formuläret för att testa konfigurationen
3. Publicera formuläret för att göra det tillgängligt

Slutlig validering:

• Kalkylbladslänk läggs till korrekt i åtgärden Skicka fält
• Formulärdefinitionen sparas och publiceras
• Förhandsgranska formulär visar alla fält korrekt
• Knappen Skicka är korrekt konfigurerad

Referensmaterial:

• Fullständigt exempelkalkylblad med rätt konfiguration
• AEM Sidekick-dokumentation för publiceringsvägledning

Perfekt för:

• Automatiserade datainsamlingssystem
• Anpassade formulärimplementeringar
• Integration med befintliga tillämpningar
• Arbetsflöden för att skicka data satsvis

Innan du använder API måste du se till att du har:

• Kalkylbladskonfiguration har slutförts (inklusive incoming ark)
• Åtkomst till Adobes tjänst beviljad till forms@adobe.com
• Formulär-ID från ditt publicerade formulär
• Databasinformation (organisations- och platsnamn)

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

Obligatoriska rubriker:

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

API-dokumentation: Fullständig API-referens

Postman har ett användarvänligt gränssnitt för att testa API-inskickade data.

Installationsanvisningar:

1. Skapa en ny POST-begäran i Postman

2. Konfigurera slutpunkten: https://forms.adobe.com/adobe/forms/af/submit/{id}

3. Ersätt platshållare:

   • {id} → Ditt faktiska formulär-ID
   • [repository] → Ditt GitHub-databasnamn
   • [organization] → Din GitHub-organisation/ditt användarnamn

Begär konfiguration:

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"
                }
}

Förväntat svar:

• Statuskod: 201 Created
• Data visas i ditt incoming-kalkylblad omedelbart

Exempel: API-överföringen har slutförts med Postman-gränssnittet

För utvecklare som föredrar terminal-/kommandotolk använder du curl för att skicka data programmatiskt.

Inställningar för kommandorad:

Ersätt följande platshållare i kommandona nedan:

• {id} → Ditt faktiska formulär-ID
• [repository] → Ditt GitHub-databasnamn
• [organization] → Din GitHub-organisation/ditt användarnamn

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

Slutfört svar:

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: *

Dataverifiering:

När överföringen är klar kontrollerar du att data finns i kalkylbladet:

Exempel: Data har skrivits till det inkommande bladet via API

Svarsvalidering:

• HTTP-status: 201 Created indikerar att överföringen lyckades
• X-Request-Id: Unik identifierare för att spåra överföringen
• Data visas i incoming-bladet på några sekunder
• Alla formulärfält är korrekt mappade till kalkylbladskolumner

Problem: 403 Otillåtet fel

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

Problem: 404 Det gick inte att hitta felet

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

Problem: Data visas inte i kalkylblad

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

Problem: Ogiltigt JSON-formatfel

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

Supportkanaler:

• Problem med tidig åtkomst: E-post aem-forms-ea@adobe.com
• API-dokumentation: Utvecklarreferens
• Community Support: Adobe Experience League Community

• Skapa avancerad Forms - Lägg till validering, villkorslogik och anpassad formatering
• Handbok för formulärkomponenter - Utforska tillgängliga formulärfältstyper

• AEM Publish Submissions - For complex workflows and enterprise integrations
• Anpassade överföringsåtgärder - Avancerad överföringshantering

• Formuläranalys - Spåra formulärens prestanda och användning
• Dataintegrering - Koppla formulär till databaser och CRM-system