Prefill-service configureren in Adaptive Forms met Edge Delivery Services
Het vooraf invullen van formulieren is het automatisch invullen van formuliervelden met relevante gegevens uit externe bronnen zodra een gebruiker het formulier opent. Door gebruik te maken van gegevens uit gebruikersprofielen, databases, opgeslagen concepten of andere back-endsystemen, stroomlijnt de prefilling de functionaliteit voor het invullen van formulieren: handmatige invoer wordt verminderd, fouten worden geminimaliseerd en voltooiing wordt versneld. Dit verhoogt niet alleen de tevredenheid van de gebruiker, maar verhoogt ook de kans op het succesvol verzenden van formulieren.
Voordelen van het vooraf invullen van formulieren
Hoe Prefilling werkt
In het volgende diagram ziet u het automatische vooraf ingevulde proces dat plaatsvindt wanneer een gebruiker een adaptief formulier opent:
Het vooraf ingevulde proces omvat vier belangrijke stappen:
- Gebruiker opent Vorm: De gebruiker heeft toegang tot een AanpassingsVorm door URL of navigatie
- identificeer Gegevens Source: De vooraf ingevulde dienst bepaalt de gevormde gegevensbron (het Model van Gegevens van de Vorm of de dienst van het Ontwerp)
- wint Gegevens terug: Het systeem haalt relevante gebruikersgegevens die op context, parameters, of gebruikersidentificatie worden gebaseerd
- Kaart en Vertoning: De gegevens worden in kaart gebracht aan vormgebieden gebruikend
bindRefeigenschappen en de bevolkte vorm wordt getoond aan de gebruiker
Dit geautomatiseerde proces zorgt ervoor dat gebruikers een formulier zien dat vooraf is ingevuld met hun relevante informatie, wat de gebruikerservaring aanzienlijk verbetert en het voltooiingspercentage van het formulier aanzienlijk verbetert.
Gegevensstructuur voor vooraf invullen
Adaptieve Forms ondersteunt twee typen velden:
- Gebonden gebieden: Gebieden die met een gegevensbron met een niet leeg
bindRefbezit worden verbonden - Niet verbindende gebieden: Standalone gebieden met lege
bindRefwaarden
De vooraf ingevulde gegevensstructuur omvat:
- afBoundData: Bevat gegevens voor verbindende gebieden en panelen
- afUnBoundData: Bevat gegevens voor ongebonden gebieden
De gegevensindeling moet overeenkomen met uw formuliermodel:
- XFA vormen: Volgzaam XML met het malplaatjeschema XFA
- het schemavormen van XML: XML die de schemastructuur aanpassen
- JSON schemavormen: JSON volgzaam met het schema
- het Model van Gegevens van de Vorm (FDM) vormen: JSON die de structuur FDM aanpassen
- schema-less vormen: Alle gebieden zijn niet verbindend en gebruiken ongebonden XML
Vereisten
Voordat u de vooraf ingevulde services configureert, moet u ervoor zorgen dat:
Vereiste instelling
Toegangsvereisten
- Toegang tot AEM Forms as a Cloud Service
- Machtigingen om formulieren te maken en te bewerken
- Universal Editor-toegang met de vereiste extensies ingeschakeld
Opties voor vooraf ingevulde service
De Universal Editor biedt twee vooraf ingevulde serviceopties:
Gedetailleerde vergelijking
Prefill-service voor een formulier configureren
Stap 1: Formuliergegevensmodel maken
-
Aanmelden bij uw AEM Forms as a Cloud Service-exemplaar
-
Ga aan Adobe Experience Manager > Forms > Integraties van Gegevens
-
Selecteer creëren > Model van de Gegevens van de Vorm
-
Kies uw Configuratie van Source van Gegevens en selecteer gevormde Source van Gegevens
note tip TIP Voor gedetailleerde instructies bij het creëren van de Modellen van Gegevens van de Vorm, zie het Model van de Gegevens van de Vormcreëren.
Stap 2: FDM-services configureren
-
Ga naar Adobe Experience Manager > Forms > Integraties van Gegevens
-
Het formuliergegevensmodel openen in de bewerkingsmodus
-
Selecteer een gegevensmodelvoorwerp en klik uitgeven Eigenschappen
-
Vorm Gelezen en schrijven diensten voor de geselecteerde voorwerpen van het gegevensmodel
-
Serviceargumenten configureren:
- Klik op het bewerkingspictogram voor het argument van de leesservice
- Bind het argument aan a Attribuut van het Profiel van de Gebruiker, Attribuut van het Verzoek, of Letterlijke waarde
- Geef de bindingswaarde op (bijvoorbeeld
petidvoor een registratieformulier voor gezelschapsdieren)
-
Klik Gedaan om het argument en sparen te bewaren om FDM te bewaren
note note NOTE Leer meer over het vormen van de diensten FDM in Werk met het Model van de Gegevens van de Vorm (FDM).
Stap 3: Een adaptief formulier maken
-
Navigeer aan Adobe Experience Manager > Forms > Forms & Documenten
-
Selecteer creeer > Aangepaste Forms
-
In het Source lusje, selecteer een malplaatje van Edge Delivery Services:
-
Klik creëren om te openen creeer de 3 tovenaar van de Vorm {
-
Geef de formulierdetails op:
- Naam: Ga een beschrijvende naam voor uw vorm in
- Titel: Verstrek een gebruikersvriendelijke titel
- GitHub URL: Ga uw bewaarplaats URL (b.v.,
https://github.com/wkndforms/edsforms) in
-
Klik creëren
Het formulier wordt geopend in de Universal Editor voor ontwerpen.
Stap 4: Formuliergegevens configureren, Source
-
Selecteer uw vorm en klik Eigenschappen
-
Open het Model van de Vorm lusje
-
Van Uitgezocht van dropdown, kies Model van de Gegevens van de Vorm (FDM)
-
Selecteer het gemaakte formuliergegevensmodel (bijvoorbeeld PetFDM) in de vervolgkeuzelijst
-
Klik sparen & Sluiten
-
Het formulier openen voor bewerking in de Universal Editor
De vormelementen van uw FDM verschijnen in het Datasource lusje van Browser van de Inhoud.
Stap 5: Gegevensbinding toevoegen aan formuliervelden
-
Selecteer gegevenselementen van het lusje van 0} Gegevensbron {
-
Klik toevoegen of belemmering-en-dalingselementen om uw vorm te bouwen
-
Gegevensbinding toevoegen aan formuliervelden:
-
Een formulierveld selecteren
-
In het paneel van Eigenschappen, vind het Bind bezit van de Verwijzing
-
Selecteer de juiste gegevensbindingsverwijzing
-
Stap 6: Vereiste extensies inschakelen
Zorg ervoor dat deze extensies zijn ingeschakeld in de Universal Editor:
-
de Uitbreiding van de Eigenschappen van de Vorm van AEM
- Open Extension Manager in Universele Redacteur
- Laat de uitbreiding van de Eigenschappen van de Vorm van 0} AEM toe
-
de Uitbreiding van Source van Gegevens
- Laat de bron van Gegevens uitbreiding toe als u niet het pictogram van Gegevensbronnen ziet
note tip TIP Voor gedetailleerde instructies bij het beheren van uitbreidingen, zie {de Hoogtepunten van de Eigenschap van 0} Extension Manager .
Stap 7: Prefill-service configureren
-
Het adaptieve formulier openen in de Universal Editor
-
Klik het de uitbreidingspictogram van de Eigenschappen van de Vorm van AEM
-
Klik vooraf ingevulde tabel
-
Selecteer Model van de Gegevens van de Vorm vooraf ingevulde Dienst
-
Klik sparen & Sluiten
Stap 8: Voorvertonen en testen
-
Ga naar Forms > Forms en Documenten
-
Selecteer uw adaptieve formulier
-
Kies Voorproef als HTML
-
Test prefilling door parameters aan URL toe te voegen:
https://your-preview-url.com?
<bindreferencefield>=<value>Voorbeeld:
https://your-preview-url.com?petid=12345
Het formulier moet automatisch gegevens vullen op basis van de opgegeven parameter.
Voorbeelden
Voorbeeld van vooraf ingevulde gegevensstructuren
JSON Voorbeeld voor FDM-Gebaseerde Vorm:
{
"afBoundData": {
"user": {
"firstName": "John",
"lastName": "Doe",
"email": "john.doe@example.com",
"phone": "+1-555-0123"
}
},
"afUnBoundData": {
"additionalInfo": "User preferences loaded"
}
}
Voorbeeld van XML voor op XFA-Gebaseerde Vorm:
<?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>
Vooraf ingevulde URL's
De URL's hieronder dienen alleen ter illustratie en werken niet zoals ze zijn. Vervang de host en parameters door de parameters die relevant zijn voor uw eigen omgeving tijdens het testen van de vooraf ingevulde functionaliteit.
Basis vooraf ingevulde test:
https://preview.example.com/form.html?userId=12345
Veelvoudige parametertest:
https://preview.example.com/form.html?userId=12345&category=premium
Problemen oplossen
| table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 | ||
|---|---|---|
| Probleem | Mogelijke oorzaak | Oplossing |
| de gebieden van de Vorm niet prefilling | Onjuiste waarden bindRef |
Controleren of bindRef precies overeenkomt met FDM-veldnamen |
| de formaatfouten van Gegevens | Gegevensstructuur komt niet overeen | Preflight-gegevens afstemmen op formuliermodelschema |
| niet gevonden de Dienst | FDM-configuratieproblemen | Controleer of FDM-services correct zijn geconfigureerd en opgeslagen |
| de fouten van de Authentificatie | Gegevensbronconnectiviteit | Verifieer gegevensbrongeloofsbrieven en connectiviteit |
| Gedeeltelijke gegevens die laden | Ontbrekende veldtoewijzingen | Ervoor zorgen dat alle vereiste velden de juiste gegevensbindingen hebben |
-
verifieer configuratie FDM:
- Controleren of services correct zijn geconfigureerd
- FDM-services onafhankelijk testen
- Gegevensbronconnectiviteit valideren
-
de Configuratie van de Vorm van de Controle:
- Bevestigen dat formulier is gekoppeld aan juiste FDM
bindRefwaarden van veld verifiëren- Formulier testen zonder voorvoegsel eerst
-
Stroom van Gegevens van de Test:
- Gebruik de browsergereedschappen voor ontwikkelaars om netwerkaanvragen te inspecteren
- Console controleren op JavaScript-fouten
- Gegevensindeling van reactie valideren
-
Gemeenschappelijke Berichten van de Fout:
- "Prefill service not found": serviceconfiguratie controleren
- "Gegevensbinding mislukt": controleer
bindRefnauwkeurigheid - "Ongeldige gegevensindeling": zorg ervoor dat de gegevens overeenkomen met het schema
Aanbevolen procedures
- beschrijvende noemende van het Gebruik: Noem uw FDMs en de diensten duidelijk
- bevestigt gegevensschema's: Verzeker gegevensstructuur vormvereisten aanpast
- Test incrementeel: Vorm en test één gebied tegelijkertijd
- Toewijzingen van het Document: Houd spoor van gebied-aan-gegevens afbeeldingen
- minimaliseer gegevensvolume: Slechts vooraf ingevulde noodzakelijke gebieden
- Gebruik caching: Vorm aangewezen caching voor vaak betreden gegevens
- optimaliseer vragen: Verzeker gegevensbestandvragen efficiënt zijn
- prestaties van de Monitor: De tijden van de vormlading van het spoor met toegelaten prefill
- bevestigt inputparameters: Bevestig altijd parameters URL
- Sanitize gegevens: Reinig gegevens alvorens vormen vooraf in te vullen
- voert toegangscontroles uit: Verzeker gebruikers tot hun eigen gegevens slechts kunnen toegang hebben
- HTTPS van het Gebruik: Gebruik altijd veilige verbindingen voor gegevenstransmissie
- verstrekken terugkoppelt: Toon ladingsindicatoren tijdens gegevenshaal
- elegant de fouten van het 0} Handvat {: De nuttige foutenmeldingen van de vertoning
- staat met voeten treedt toe: Laat gebruikers vooraf ingevulde gegevens wijzigen
- handhaaf consistentie: Gebruik verenigbaar prefill gedrag over vormen
Veelgestelde vragen
?<bindreferencefield>=<value> . Zorg ervoor dat het veld een geldige bindRef heeft die overeenkomt met de gegevensstructuur. Gebruik de browserontwikkelaarsgereedschappen om netwerkaanvragen te inspecteren en te controleren of gegevens correct worden opgehaald.Adaptieve Forms ondersteunt meerdere indelingen, afhankelijk van uw formuliermodel:
- XFA vormen: XML die het schema XFA aanpassen
- JSON schemavormen: Gegevens JSON volgzaam met het schema
- FDM vormen: JSON die aan de structuur van het gegevensmodel in kaart brengt
- het schemavormen van XML: XML die de schemastructuur aanpassen
afBoundData en moeten overeenkomen met het formuliermodelschema. Niet-gebonden velden gebruiken de sectie afUnBoundData en kunnen aanvullende gegevens bevatten.bindRef waarden hebben die exact overeenkomen met uw FDM. Controleer of de gegevensbron alle vereiste velden bevat en of de gegevensstructuur overeenkomt met het formuliermodelschema.