Konfigurera Skicka-åtgärder för AEM Forms

Konfigurera hantering av blankettinlämning för att dirigera data till kalkylblad, e-post eller backend-system med AEM Forms med Edge Delivery Services.

Snabbbeslutshandbok

Välj överföringsmetod:

Metod
Bäst för
Konfigurera komplexitet
Användningsexempel
Forms Submission Service
Enkel datainhämtning
Låg
Kontaktformulär, enkäter, grundläggande datainsamling
AEM Publish Submission
Komplexa arbetsflöden
Hög
Företagsintegrering, anpassad bearbetning, arbetsflöden

Förutsättningar

Innan du konfigurerar skicka-åtgärder måste du se till att:

  • AEM Forms as a Cloud Service - instans
  • Edge Delivery Services-projektet är konfigurerat
  • Formulär som skapats med Document Author eller Universal Editor
  • Behörighet krävs för måldestinationer (kalkylblad, e-postsystem eller AEM)
Metod 1: Forms Sändningstjänst

Forms Submission Service är en slutpunkt på Adobe som är perfekt för enkla datainhämtningsscenarier.

Destinationer som stöds

  • Kalkylblad: Google-blad, Microsoft Excel (OneDrive/SharePoint)
  • E-post: Skicka formulärdata till angivna e-postadresser

Konfigurationssteg

  1. Konfigurera målåtkomst

    • För kalkylblad: Bevilja redigeringsbehörighet för forms@adobe.com i målkalkylblad
    • För e-post: Verifiera att mottagarnas e-postadresser är tillgängliga
  2. Konfigurera formuläröverföring

    • Öppna formuläret i redigeringsmiljön
    • Ange skicka-åtgärd till"Forms Submission Service"
    • Ange kalkylblads-URL eller e-postadresser
    • Spara och publicera formuläret
  3. Testa överföring

    • Skicka testdata via formuläret
    • Verifiera att data visas i målmålet
    • Kontrollera felloggar om överföringen misslyckas

Viktiga anteckningar

  • Tjänstkontot forms@adobe.com kräver redigeringsåtkomst till målkalkylblad
  • E-postmeddelanden skickas omedelbart när formuläret skickas
  • Dataverifiering sker på tjänstnivå

Forms Submission Service Flow

Metod 2: AEM Publish Submit

Skicka formulärdata direkt till AEM as a Cloud Service Publish-instansen för komplex bearbetning.

Använda AEM Publish

  • Anpassade AEM-arbetsflöden krävs efter inskickning
  • FDM-integration (Form Data Model) med databaser
  • Tjänstintegreringar från tredje part (Marketo, Power Automate, Workfront Fusion)
  • Azure Blob Storage eller SharePoint dokumentbibliotek
  • Komplex validering eller bearbetningslogik på serversidan

Tillgängliga överföringsåtgärder

AEM-publiceringsflöde

Konfigurationskrav

​1. Uppdatera AEM Instance URL i Edge Delivery

Uppdatera AEM Cloud Service-instansens URL i filen constant.js i blocket form under submitBaseUrl. Du kan konfigurera URL-adressen baserat på din miljö:

För Cloud Service-instans

code language-js
export const submitBaseUrl = '<aem-publish-instance-URL>';

För lokal utveckling

code language-js
export const submitBaseUrl = 'http://localhost:<port-number>';

​2. Refererarfilter för OSGi

Konfigurera referensfiltret så att dina specifika Edge Delivery-webbplatsdomäner tillåts:

  1. Skapa eller uppdatera OSGi-konfigurationsfilen: org.apache.sling.security.impl.ReferrerFilter.cfg.json

  2. Lägg till följande konfiguration med dina specifika webbplatsdomäner:

    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": [
        ""
      ]
    }
    
  3. Distribuera konfigurationen via Cloud Manager

Mer information om konfigurationen för OSGi-referensfilter finns i Handboken för referensfilter.

3. CORS (Cross-Origin Resource Sharing) Issues

Konfigurera CORS-inställningar i AEM för att tillåta begäranden från dina specifika Edge Delivery-webbplatsdomäner:

Developer Localhost

code language-apache
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(http://localhost(:\d+)?$)#" CORSTrusted=true

Edge Delivery Sites - Lägg till varje webbplatsdomän individuellt

code language-apache
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://main--abc--adobe\.aem\.live$)#" CORSTrusted=true
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://main--abc1--adobe\.aem\.live$)#" CORSTrusted=true

Äldre Franklin-domäner (om de fortfarande används)

code language-apache
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://.*\.hlx\.page$)#" CORSTrusted=true
SetEnvIfExpr "env('CORSProcessing') == 'true' && req_novary('Origin') =~ m#(https://.*\.hlx\.live$)#" CORSTrusted=true
note note
NOTE
Ersätt main--abc--adobe.aem.live och main--abc1--adobe.aem.live med de faktiska webbplatsdomänerna. Varje plats som lagras från samma databas kräver en separat CORS-konfigurationspost.

Detaljerad CORS-konfiguration finns i CORS-konfigurationsguiden.

Om du vill aktivera CORS för din lokala utvecklingsmiljö läser du artikeln Förstå korsdomänsresursdelning (CORS).

​4. Formulärkonfiguration

  1. Skapa formulär i Universal Editor
  2. Konfigurera åtgärden skicka för att rikta AEM Forms-åtgärden
  3. Ange slutpunktssökväg för överföring
  4. Publicera formulär på Edge Delivery webbplats
Vanliga problem
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2
Problem Lösning
Det går inte att skicka formulär Kontrollera konsolfel, verifiera slutpunkts-URL, bekräfta behörigheter
Inbäddat formulär visas inte Konfigurera CORS-huvuden på formulärkällan, verifiera formulär-URL
403/401 fel med AEM Uppdatera Sling Referer-filter, kontrollera autentiseringsinställningar
Data når inte kalkylblad Verifiera att forms@adobe.com har redigeringsåtkomst, kontrollera kalkylblads-URL
CORS-fel Lägg till korrekta Access-Control-Allow-Origin rubriker i formulärkällan

Konfigurationsexempel

Dokumentbaserat formulär med inskickning av kalkylblad
  1. Skapa formulärstruktur i Google Docs/Sheets
  2. Konfigurera slutpunkt för Forms-överföringstjänst
  3. Bevilja forms@adobe.com redigeringsåtkomst till målkalkylblad
  4. Publicera dokument på Edge Delivery webbplats
  5. Testa inskickning av formulär och dataflöde
Universell redigeringsblankett med AEM Workflow
  1. Skapa formulär i Universal Editor
  2. Konfigurera åtgärden Skicka till"Anropa AEM Workflow"
  3. Konfigurera Dispatcher och referensfilter i AEM Publish
  4. Konfigurera CDN-routningsregler
  5. Publicera formulär och testa arbetsflödeskörning

Bästa praxis

  • Använd Forms överföringstjänst för enkla datainhämtningsscenarier
  • Välj AEM Publish när komplex bearbetning eller integrering krävs
  • Testa grundligt i mellanlagringsmiljön före produktionsdistributionen
  • Övervaka överföringar med AEM loggar och konsolfel
  • Implementera korrekt felhantering för misslyckade överföringar
  • Verifiera data på både klient- och servernivå
  • Använd HTTPS för alla formuläröverföringar och dataöverföringar

Relaterade ämnen

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab