Konfigurieren des Vorbefüllungsdienstes in adaptiven Forms mit Edge Delivery Services
Beim Vorbefüllen eines Formulars werden Formularfelder automatisch mit relevanten Daten aus externen Quellen ausgefüllt, sobald eine Benutzerin bzw. ein Benutzer das Formular öffnet. Durch die Nutzung von Daten aus Benutzerprofilen, Datenbanken, gespeicherten Entwürfen oder anderen Backend-Systemen wird das Ausfüllen des Formulars erleichtert, indem manuelle Eingaben reduziert, Fehler minimiert und das Ausfüllen beschleunigt werden. Das erhöht nicht nur die Benutzerzufriedenheit, sondern auch die Wahrscheinlichkeit erfolgreicher Formularübermittlungen.
Vorteile des Vorbefüllens von Formularen
Funktionsweise der Vorbefüllung
Das folgende Diagramm veranschaulicht die automatische Vorbefüllung, die beim Öffnen eines adaptiven Formulars durch eine Benutzerin bzw. einen Benutzer vorgenommen wird:
Der Vorbefüllungsprozess umfasst vier wichtige Schritte:
- Benutzerin bzw. Benutzer öffnet Formular: Benutzerin bzw. Benutzer greift über eine URL oder Navigation auf ein adaptives Formular zu
- Identifizieren von Datenquelle: Der Vorbefüllungsdienst ermittelt die konfigurierte Datenquelle (Formulardatenmodell oder Entwurfsdienst)
- Abrufen von Daten: Das System ruft basierend auf Kontext, Parametern oder Benutzeridentifizierung relevante Benutzerdaten ab
- Zuordnen und Anzeigen: Daten werden Formularfeldern mithilfe von
bindRef-Eigenschaften zugeordnet und das ausgefüllte Formular wird der Benutzerin bzw. dem Benutzer angezeigt
Dieses automatisierte Verfahren sorgt dafür, dass die Benutzenden ein Formular mit ihren relevanten Daten vorausgefüllt sehen, was das Benutzererlebnis und die Formularausfüllraten erheblich verbessert.
Datenstruktur zum Vorbefüllen
Adaptive Formulare unterstützen zwei Arten von Feldern:
- Gebundene Felder: Felder, die mit einer Datenquelle mit einer nicht leeren
bindRef-Eigenschaft verbunden sind - Ungebundene Felder: Eigenständige Felder mit leeren
bindRef-Werten
Die Datenstruktur zum Vorbefüllen umfasst:
- afBoundData: Enthält Daten für gebundene Felder und Bereiche
- afUnBoundData: Enthält Daten für ungebundene Felder
Das Datenformat muss mit Ihrem Formularmodell übereinstimmen:
- XFA-Formulare: XML-konform mit dem XFA-Vorlagenschema
- XML-Schemaformulare: XML, die mit der Schemastruktur übereinstimmt
- JSON-Schemaformulare: JSON-konform mit dem Schema
- Formulardatenmodell (FDM)-Formulare: JSON, das mit der FDM-Struktur übereinstimmt
- Schemalose Formulare: Alle Felder sind ungebunden und nutzen ungebundene XML
Voraussetzungen
Bevor Sie Vorbefüllungsdienste konfigurieren, müssen Sie folgende Voraussetzungen erfüllen:
Erforderliches Setup
Zugriffsanforderungen
- Zugriff auf AEM Forms as a Cloud Service
- Berechtigungen zum Erstellen und Bearbeiten von Formularen
- Zugriff auf den universellen Editor mit aktivierten erforderlichen Erweiterungen
Optionen für den Vorbefüllungsdienst
Der universelle Editor bietet zwei Optionen für den Vorbefüllungsdienst:
Detailvergleich
Konfigurieren eines Vorbefüllungsdienstes für ein Formular
Schritt 1: Erstellen Sie ein Formulardatenmodell
-
Melden Sie sich bei Ihrer AEM Forms as a Cloud Service-Instanz an.
-
Navigieren Sie zu: Adobe Experience Manager > Formulare > Formulare und Dokumente
-
Wählen Sie Erstellen > Formulardatenmodell aus.
-
Wählen Sie Ihre Datenquellenkonfiguration und dann die konfigurierte Datenquelle.
note tip TIP Genaue Anweisungen zum Erstellen von Formulardatenmodellen finden Sie unter Erstellen eines Formulardatenmodells.
Schritt 2: Konfigurieren Sie FDM-Dienste
-
Wechseln Sie zu Adobe Experience Manager > Formulare > Datenintegrationen.
-
Öffnen Sie Ihr Formulardatenmodell im Bearbeitungsmodus.
-
Wählen Sie ein Datenmodellobjekt aus und klicken Sie auf Eigenschaften bearbeiten.
-
Konfigurieren Sie Lese- und Schreib-Dienste für die ausgewählten Datenmodellobjekte.
-
Konfigurieren Sie die Dienstargumente:
- Klicken Sie auf das Bearbeitungssymbol für das Argument des Lesediensts.
- Binden Sie das Argument an ein Benutzerprofilattribut, Anfrageattribut oder einen Literalwert.
- Geben Sie den Bindungswert an (z. B.
petidfür ein Registrierungsformular für Haustiere).
-
Klicken Sie auf Fertig, um das Argument zu speichern, und auf Speichern, um das FDM zu speichern.
note note NOTE Erfahren Sie mehr über das Konfigurieren von FDM-Diensten in Arbeiten mit einem Formulardatenmodell (FDM).
Schritt 3: Erstellen Sie ein adaptives Formular
-
Gehen Sie zu Adobe Experience Manager > Forms > Formulare und Dokumente.
-
Wählen Sie Erstellen > Adaptive Formulare.
-
Wählen Sie auf der Registerkarte Quelle eine Edge Delivery Services-basierte Vorlage aus:
-
Klicken Sie auf Erstellen, um den Assistenten für Formular erstellen zu öffnen.
Sie können die Datenquelle in der Registerkarte Daten oder später bei der Bearbeitung der Formulareigenschaften konfigurieren.
-
Geben Sie die Formulardetails an:
- Name: Geben Sie einen beschreibenden Namen für Ihr Formular ein.
- Titel: Geben Sie einen anwenderfreundlichen Titel an.
- GitHub-URL: Geben Sie die URL Ihres Repositorys ein (z. B.
https://github.com/wkndforms/edsforms).
-
Klicken Sie auf Erstellen.
Das Formular wird im universellen Editor zum Erstellen geöffnet.
Schritt 4: Konfigurieren Sie die Formulardatenquelle
-
Wählen Sie ein Formular aus und klicken Sie auf Eigenschaften.
-
Öffnen Sie die Registerkarte Formularmodell.
-
Wählen Sie in der Dropdown-Liste Auswählen den Eintrag Formulardatenmodell (FDM).
-
Wählen Sie in der Dropdown-Liste das erstellte Formulardatenmodell (z. B. PetFDM) aus.
-
Klicken Sie auf Speichern und schließen.
-
Öffnen Sie das Formular zur Bearbeitung im universellen Editor.
Die Formularelemente aus Ihrem FDM werden auf der Registerkarte Datenquelle des Inhalts-Browsers angezeigt.
Schritt 5: Fügen Sie Datenbindungen zu Formularfeldern hinzu
-
Wählen Sie Datenelemente auf der Registerkarte Datenquelle aus.
-
Klicken Sie auf Hinzufügen oder ziehen Sie Elemente per Drag-and-Drop, um Ihr Formular zu erstellen.
-
Fügen Sie Datenbindungen zu Formularfeldern hinzu:
-
Wählen Sie ein Formularfeld aus.
-
Suchen Sie im Bedienfeld Eigenschaften nach der Eigenschaft Bindungsverweis.
-
Wählen Sie den entsprechenden Datenbindungsverweis aus.
-
Schritt 6: Aktivieren Sie erforderliche Erweiterungen
Stellen Sie sicher, dass folgende Erweiterungen im universellen Editor aktiviert sind:
-
Erweiterung für AEM-Formulareigenschaften
- Öffnen Sie Extension Manager im universellen Editor.
- Aktivieren Sie die Erweiterung AEM-Formulareigenschaften.
-
Erweiterung „Datenquellen“
- Aktivieren Sie die Erweiterung Datenquellen, wenn Sie das Symbol Datenquellen nicht sehen können.
note tip TIP Genaue Anweisungen zum Verwalten von Erweiterungen finden Sie unter Extension Manager – Highlights der Funktionen.
Schritt 7: Konfigurieren Sie den Vorbefüllungsdienst
-
Öffnen Sie Ihr adaptives Formular im universellen Editor.
-
Klicken Sie auf das Erweiterungssymbol AEM-Formulareigenschaften.
-
Klicken Sie auf die Registerkarte Vorbefüllung.
-
Wählen Sie Vorbefüllungsdienst für Formulardatenmodell.
-
Klicken Sie auf Speichern und schließen.
Schritt 8: Führen Sie eine Vorschau und Tests durch
-
Gehen Sie zu Formulare > Formulare und Dokumente.
-
Wählen Sie Ihr adaptives Formular aus.
-
Wählen Sie Vorschau als HTML.
-
Testen Sie das Vorbefüllen durch Anhängen von Parametern an die URL:
https://your-preview-url.com?<bindreferencefield>=<value>Beispiel:
https://your-preview-url.com?petid=12345
Das Formular sollte anhand des angegebenen Parameters automatisch mit Daten ausgefüllt werden.
Beispiele
Beispieldatenstrukturen zum Vorbefüllen
JSON-Beispiel für ein FDM-basiertes Formular:
{
"afBoundData": {
"user": {
"firstName": "John",
"lastName": "Doe",
"email": "john.doe@example.com",
"phone": "+1-555-0123"
}
},
"afUnBoundData": {
"additionalInfo": "User preferences loaded"
}
}
XML-Beispiel für ein XFA-basiertes Formular:
<?xml version="1.0" encoding="UTF-8"?>
<afData>
<afBoundData>
<user>
<firstName>John</firstName>
<lastName>Doe</lastName>
<email>john.doe@example.com</email>
</user>
</afBoundData>
</afData>
Beispiel-URLs zum Vorbefüllen
Die folgenden URLs dienen nur zu Veranschaulichungszwecken und funktionieren nicht im Istzustand. Ersetzen Sie den Host und die Parameter durch diejenigen, die für Ihre Umgebung beim Testen der Vorbefüllungsfunktion relevant sind.
Einfacher Vorbefüllungstest:
https://preview.example.com/form.html?userId=12345
Test mit mehreren Parametern:
https://preview.example.com/form.html?userId=12345&category=premium
Fehlerbehebung
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| Problem | Mögliche Ursache | Lösung |
| Formularfelder werden nicht vorbefüllt | Ungültige bindRef-Werte |
Überprüfen Sie, ob bindRef genau mit FDM-Feldnamen übereinstimmt |
| Datenformatfehler | Nicht übereinstimmende Datenstruktur | Stellen Sie sicher, dass die Vorbefüllungsdaten mit dem Formularmodellschema übereinstimmen |
| Dienst nicht gefunden | Probleme mit der FDM-Konfiguration | Überprüfen Sie, ob FDM-Dienste ordnungsgemäß konfiguriert und gespeichert sind |
| Authentifizierungsfehler | Verbindung zur Datenquelle | Überprüfen Sie die Anmeldedaten und Verbindung der Datenquelle |
| Partielles Laden von Daten | Fehlende Feldzuordnungen | Stellen Sie sicher, dass alle erforderlichen Felder über korrekte Datenbindungen verfügen |
-
Überprüfen der FDM-Konfiguration:
- Prüfen Sie, ob die Dienste korrekt konfiguriert sind
- Testen Sie FDM-Services unabhängig voneinander
- Überprüfen Sie die Verbindung der Datenquelle
-
Überprüfen der Formularkonfiguration:
- Prüfen Sie, ob das Formular mit dem richtigen FDM verknüpft ist
- Überprüfen Sie die
bindRef-Werte von Feldern - Testformular ohne vorheriges Vorbefüllen
-
Testen von Datenfluss:
- Verwenden Sie die Entwickler-Tools des Browsers, um Netzwerkanfragen zu überprüfen
- Überprüfen Sie die Konsole auf JavaScript-Fehler
- Validieren Sie das Antwortdatenformat
-
Häufige Fehlermeldungen:
- „Vorbefüllungsdienst nicht gefunden“: Überprüfen Sie die Dienstkonfiguration
- „Datenbindung fehlgeschlagen“: Überprüfen Sie die Richtigkeit von
bindRef - „Ungültiges Datenformat“: Stellen Sie sicher, dass die Daten mit dem Schema übereinstimmen
Best Practices
- Beschreibende Benennung verwenden: Benennen Sie FDMs und Dienste klar
- Datenschemata validieren: Stellen Sie sicher, dass die Datenstruktur den Formularanforderungen entspricht
- Inkrementell testen: Konfigurieren und testen Sie jeweils ein Feld
- Dokumentzuordnungen: Überwachen Sie Zuordnungen von Feldern zu Daten
- Datenvolumen minimieren: Lassen Sie nur erforderliche Felder vorbefüllen
- Zwischenspeichern verwenden: Konfigurieren Sie ein geeignetes Zwischenspeichern für häufig aufgerufene Daten
- Abfragen optimieren: Stellen Sie sicher, dass Datenbankabfragen effizient sind
- Leistung überwachen: Verfolgen Sie die Ladezeiten von Formularen mit aktivierter Vorbefüllung
- Eingabeparameter überprüfen: Sie sollten URL-Parameter stets überprüfen
- Daten bereinigen: Bereinigen Sie Daten, bevor Formulare vorbefüllt werden
- Zugriffssteuerungen implementieren: Sorgen Sie dafür, dass Benutzende nur auf ihre eigenen Daten zugreifen können
- HTTPS verwenden: Sie sollten stets sichere Verbindungen für die Datenübertragung nutzen
- Feedback geben: Zeigen Sie bei Datenabrufen den Ladestatus an
- Mit Fehlern elegant umgehen: Zeigen Sie hilfreiche Fehlermeldungen an
- Überschreibungen zulassen: Benutzende können vorbefüllte Daten ändern
- Konsistenz gewährleisten: Nutzen Sie in allen Formularen ein konsistentes Vorbefüllungsverhalten
Häufig gestellte Fragen
?<bindreferencefield>=<value>. Stellen Sie sicher, dass das Feld über eine gültige bindRef verfügt, die zu Ihrer Datenstruktur passt. Verwenden Sie die Entwickler-Tools des Browsers, um Netzwerkanfragen zu untersuchen und zu prüfen, ob Daten korrekt abgerufen werden.Adaptive Formulare unterstützen je nach Formularmodell verschiedene Formate:
- XFA-Formulare: XML, die mit dem XFA-Schema übereinstimmt
- JSON-Schemaformulare: JSON-Daten, die mit dem Schema konform sind
- FDM-Formulare: JSON, das der Datenmodellstruktur zugeordnet ist
- XML-Schemaformulare: XML, die mit der Schemastruktur übereinstimmt
afBoundData und müssen mit Ihrem Formularmodellschema übereinstimmen. Ungebundene Felder verwenden den Abschnitt afUnBoundData und können zusätzliche Daten enthalten.bindRef-Werte haben, die genau mit Ihrem FDM übereinstimmen. Sorgen Sie dafür, dass Ihre Datenquelle alle erforderlichen Felder enthält und die Datenstruktur mit Ihrem Formularmodellschema übereinstimmt.