Forms Submission Service für Edge Delivery Services

Perfekt für:

• Inhaltsersteller Erstellen einfacher Datenerfassungsformulare
• Kleine Unternehmen die schnelle Workflows für die Erstellung von Formularen benötigen
• Marketing-Teams Sammeln von Lead-Informationen
• Eventorganisatoren Registrierung verwalten

Alternativen in Betracht ziehen für:

• Komplexe Workflows, die benutzerdefinierte Logik erfordern
• Unternehmensintegrationen mit Datenbanken
• Forms benötigt erweiterte Validierung oder Verarbeitung

• Keine Backend- erforderlich - Adobe hostet den Übermittlungsendpunkt
• Direkte Integration mit gängigen Tabellenkalkulationsplattformen
• Automatische Datenzuordnung von Formularfeldern zu Tabellenspalten

• Sofortige Datenerfassung - Einreichungen werden sofort in Ihrer Tabelle angezeigt
• Strukturierter Speicher - Organisierte Spalten für eine einfache Analyse
• Live-Zusammenarbeit - Mehrere Team-Mitglieder können auf Daten zugreifen und diese analysieren

• Nutzt bestehende Berechtigungen - Verwenden Sie die Freigabesteuerelemente Ihrer Tabellenkalkulationsplattform.
• Adobe-Managed Security - sicherer Übermittlungsendpunkt mit Schutz auf Unternehmensniveau
• Dateneigentum - Ihre Daten verbleiben in der ausgewählten Tabellenkalkulationsplattform

• GitHub-Repository Richten Sie für Ihr Edge Delivery Services-Projekt ein, wobei der neueste adaptive Forms-Block installiert ist
• auf die Zulassungsliste setzen Zugriffsgenehmigung - Repository zur hinzugefügt

Wählen Sie eine der unterstützten Plattformen:

• Google Sheets - Google-Konto mit Berechtigungen zur Erstellung von Tabellen
• Microsoft OneDrive - Microsoft 365-Konto mit Excel Online-Zugriff
• SharePoint - Zugriff auf SharePoint mit Listen-/Bibliotheksberechtigungen

• Berechtigungen bearbeiten für das Zielarbeitsblatt
• Freigabefunktionen um Zugriff auf forms@adobe.com zu gewähren
• Link-Generierung Berechtigungen für die ausgewählte Plattform

Bevor Sie eine dieser Methoden konfigurieren, stellen Sie sicher, dass Ihre AEM Project Foundation bereit ist:

1. Erstellen oder aktualisieren Sie Ihr AEM-Projekt mit dem neuesten adaptiven Forms-Block (Erste Schritte-Tutorial)

2. Aktualisieren vonfstab.yaml im Projektstamm:

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

3. Freigeben des Projektordners für forms@adobe.com (Bearbeitungsberechtigungen erforderlich)

Erstellen Sie Ihre Formularstruktur mit Google Sheets oder Microsoft Excel.

Schritte zur Formularerstellung:

1. Öffnen der Tabellenkalkulationsplattform (Google Sheets oder Microsoft Excel)
2. Neue Tabelle erstellen für Ihr Formularprojekt
3. Benennen Sie Ihr Blatt (muss entweder helix-default oder shared-aem sein)
4. Definieren Sie Ihre Formularstruktur mithilfe des Handbuchs zur Formularerstellung

Beispiel: Formulardefinition mit Feldtypen, Beschriftungen und Validierungsregeln

Validierungs-Checkpoint:

• Formularstruktur ist vollständig mit allen erforderlichen Feldern
• Blatt wurde korrekt benannt (helix-default oder shared-aem)
• Feldtypen und Validierungsregeln sind ordnungsgemäß konfiguriert

Richten Sie ein spezielles Blatt ein, um Formulardaten zur Übermittlung zu empfangen.

Datenblatt-Setup:

1. Ein neues Blatt hinzufügen zu Ihrem vorhandenen Arbeitsblatt hinzufügen
2. Benennen Sie die Tabelle genauincoming (Groß-/Kleinschreibung beachten)
3. Einrichten von Spaltenüberschriften die Ihren Formularfeldern entsprechen
4. Speichern Sie die Tabelle um sicherzustellen, dass die Änderungen erhalten bleiben

Beispiel: Eingehendes Blatt mit Spaltenüberschriften, die mit Formularfeldern übereinstimmen

Validierungs-Checkpoint:

• incoming Tabelle ist in der Tabelle vorhanden
• Spaltenüberschriften entsprechen den Formularfeldnamen
• Blatt ist ordnungsgemäß gespeichert und zugänglich

Gewähren Sie dem Adobe Forms Submission Service Zugriff auf Ihre Tabelle.

Freigabeprozess:

1. Klicken Sie auf die Freigeben oben rechts im Arbeitsblatt

2. Fügen Sie das Adobe-Dienstkonto hinzu:

   • E-Mail: forms@adobe.com
   • Berechtigungsstufe: Editor (erforderlich für das Schreiben von Daten)

3. Senden der Freigabeeinladung

4. Tabellenlink kopieren für den nächsten Schritt

   
   Schritt-für-Schritt-Freigabeprozess für das Gewähren des Zugriffs auf Adobe-Services

Plattformspezifische Anweisungen:

Google-Arbeitsblätter:

• forms@adobe.com als Editor hinzufügen
• Stellen Sie sicher, dass „Jeder mit dem Link kann anzeigen“ aktiviert ist
• Kopieren des freigabefähigen Links

Microsoft Excel (OneDrive/SharePoint):

• forms@adobe.com mit Bearbeitungsberechtigungen hinzufügen

• Setzen Sie die Linkfreigabe auf „Jeder mit dem Link kann bearbeiten“.

• Kopieren der Freigabe-URL

  
  Beispiel: Kopieren des Freigabe-Links für die Formularkonfiguration

Validierungs-Checkpoint:

• forms@adobe.com hat Editor-Zugriff auf Ihre Tabelle
• Tabellenlink wird kopiert und kann verwendet werden
• Freigabeberechtigungen erlauben externen Zugriff

Verknüpfen Sie Ihre Formulardefinition mit dem Übermittlungs-Arbeitsblatt.

Form-Spreadsheet-Verbindung:

1. Öffnen Sie eine Formulardefinitionstabelle (die mit helix-default oder shared-aem Blatt)

2. Suchen Sie die Zeile „Feld senden in Ihrer Formulardefinition

3. Fügen Sie den kopierten Tabellenlink das Feld Senden in die Spalte Aktion ein

4. Speichern Sie die in Ihrer Formulardefinition

   

Beispiel: Verbinden der Übermittlungsaktion mit Ihrer Datenerfassungs-Tabelle

Formular veröffentlichen:

1. Öffnen von AEM Sidekick in Ihrem Browser
2. Vorschau des Formulars, um die Konfiguration zu testen
3. Formular veröffentlichen um es live zu schalten

Endgültige Validierung:

• Tabellenlink wird korrekt zur Übermittlungsfeldaktion hinzugefügt
• Formulardefinition wird gespeichert und veröffentlicht
• Formularvorschau zeigt alle Felder korrekt an
• Senden-Schaltfläche ist ordnungsgemäß konfiguriert

Referenzmaterialien:

• Beispiel-Tabelle ausfüllen mit korrekter Konfiguration
• Dokumentation zu AEM Sidekick für Anleitungen zur Veröffentlichung

Perfekt für:

• Automatisierte Datenerfassungssysteme
• Implementierungen benutzerdefinierter Formulare
• Integration in bestehende Anwendungen
• Workflows für die Massenübermittlung von Daten

Bevor Sie die API verwenden, stellen Sie Folgendes sicher:

• Tabelleneinrichtung abgeschlossen (einschließlich incoming)
• Zugriff auf Adobe Serviceforms@adobe.com gewährt
• Formular-ID aus dem veröffentlichten Formular
• Repository-Informationen (Organisations- und Standortname)

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

Erforderliche Kopfzeilen:

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

API-Dokumentation: vollständige API-Referenz

Postman bietet eine benutzerfreundliche Oberfläche zum Testen von API-Übermittlungen.

Setup-Anweisungen:

1. Erstellen einer neuen POST-Anfrage in Postman

2. Konfigurieren des Endpunkts: https://forms.adobe.com/adobe/forms/af/submit/{id}

3. Platzhalter ersetzen:

   • {id} → tatsächlichen Formular-ID
   • [repository] → Ihres GitHub-Repository-Namens
   • [organization] → GitHub-Organisation/-Benutzername

Anfragekonfiguration:

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

Erwartete Antwort:

• Status-Code: 201 Created
• Daten werden sofort in Ihrem incoming Arbeitsblatt angezeigt

Beispiel: Erfolgreiche API-Übermittlung mit der Postman-Schnittstelle

Für Entwickler, die Terminal/Eingabeaufforderung bevorzugen, verwenden Sie curl , um Daten programmgesteuert zu übermitteln.

Befehlszeilen-Setup:

Ersetzen Sie die folgenden Platzhalter in den folgenden Befehlen:

• {id} → tatsächlichen Formular-ID
• [repository] → Ihres GitHub-Repository-Namens
• [organization] → GitHub-Organisation/-Benutzername

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

Erfolgreiche Antwort:

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

Datenüberprüfung:

Überprüfen Sie nach erfolgreicher Übermittlung, ob die Daten in Ihrer Tabelle angezeigt werden:

Beispiel: Daten wurden erfolgreich über die API in das eingehende Blatt geschrieben

Validierung der Antwort:

• HTTP-Status: 201 Created zeigt an, dass die Übermittlung erfolgreich war
• X-Request-Id: Eindeutige Kennung für das Tracking der Übermittlung
• Daten werden Sekunden in Ihrem incoming angezeigt
• Alle Formularfelder werden ordnungsgemäß Tabellenspalten zugeordnet

Problem: 403 Forbidden Error

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: Fehler „404 Nicht gefunden“

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: Daten werden nicht in der Tabelle angezeigt

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: Fehler wegen ungültigem JSON-Format

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

Support-Kanäle:

• Early Access Issues: E-Mail aem-forms-ea@adobe.com
• API-Dokumentation Entwicklerreferenz
• Community-Support: Adobe Experience League-Community

• Erweiterte Forms erstellen - Hinzufügen von Validierung, bedingter Logik und benutzerdefiniertem Stil
• Handbuch zu Formularkomponenten - Verfügbare Formularfeldtypen erkunden

• AEM-Veröffentlichungseinreichungen - Für komplexe Workflows und Unternehmensintegrationen
• Benutzerdefinierte Übermittlungsaktionen - Erweiterte Übermittlungsverarbeitung

• Formularanalyse - Verfolgen der Formularleistung und -nutzung
• Datenintegration - Verbinden von Formularen mit Datenbanken und CRM-Systemen