Skapa och publicera adaptiva Forms med Edge Delivery Services
Det här dokumentet innehåller stegvisa instruktioner för hur du skapar, konfigurerar och publicerar Adaptive Forms med Edge Delivery Services-mallar i AEM. Det täcker hela arbetsflödet från att skapa formulär till att distribuera produktionen.
I slutet av guiden får du lära dig att:
- Skapa formulär med Edge Delivery Services-mallar
- Skapa formulär med Universal Editor
- Konfigurera och publicera formulär till Edge Delivery Services
- Få åtkomst till publicerade formulär och verifiera distributionen
Förutsättningar
Kontrollera att följande krav är uppfyllda innan du fortsätter:
-
AEM Forms as a Cloud Service: En aktiv författarinstans med en Forms-licens.
-
GitHub-konto: Personligt eller organisatoriskt konto för databashantering.
-
Databasinställningar: Välj något av följande:
- Nytt projekt: Skapa ett nytt AEM-projekt med Adaptivt Forms-block. Databasen är förkonfigurerad för Edge Delivery Services.
- Befintligt projekt: Lägg till anpassat Forms-block i en befintlig databas och uppdatera konfigurationen.
-
AEM-GitHub-anslutning: Upprätta en anslutning mellan din AEM-instans och GitHub-databasen.
-
Edge Delivery Services: Kontrollera att databasen har konfigurerats för automatisk distribution.
-
Behörigheter: Kontrollera att du har de nödvändiga åtkomstbehörigheterna för att skapa och publicera formulär.
-
Bekräfta att GitHub-databasen innehåller det adaptiva Forms-blocket.
Arbetsflöde för att skapa och publicera formulär
Processen består av tre huvudfaser:
- Fas 1: Skapa formulär
- Fas 2: Skapa och utforma formulär
- Fas 3: Konfiguration och publicering
I varje fas finns valideringssteg som bekräftar korrekt konfiguration.
Steg 1: Skapa formulär
-
Skapa formulär för åtkomst
- Logga in på din AEM Forms as a Cloud Service-författarinstans.
- Navigera till Adobe Experience Manager > Forms > Forms & Documents.
- Klicka på Skapa > Adaptiv Forms.
-
Välj mall
-
På fliken Source väljer du en Edge Delivery Services-baserad mall.
-
Knappen Skapa aktiveras.
-
-
Konfigurera alternativ (valfritt)
- Source-fliken Data: Välj dataintegrering om det behövs.
- fliken Skicka: Välj en skicka-åtgärd (kan konfigureras senare).
- Leveransflik: Ange publicerings-/avpubliceringsschema.
-
Slutför formulärinställning
-
Klicka på Skapa för att öppna guiden Skapa formulär.
-
Ange följande:
- Namn: Intern identifierare (inga blanksteg, använd bindestreck).
- Titel: Formulärets visningsnamn.
- GitHub-URL: Databas-URL (t.ex.
https://github.com/your-org/your-repo
).
-
-
Validering
-
När du har klickat på Skapa, verifiera:
- Formuläret öppnas i Universal Editor.
- GitHub-URL:en är korrekt länkad.
- Komponentpaletten är tillgänglig.
- Formulärets arbetsyta är synlig.
-
Resultat: Formuläret är klart för redigering i den universella redigeraren.
Steg 2: Skapa och utforma formulär
-
Access Component Library
- Öppna innehållsläsaren i Universal Editor.
- Navigera till komponenten Adaptiv form i innehållsträdet.
-
Lägg till formulärfält
- Klicka på ikonen Lägg till för att öppna komponentbiblioteket.
- Välj komponenter i listan Adaptiva formulärkomponenter.
- Dra och släpp komponenter på arbetsytan.
-
Designa formuläret
- Konfigurera fältegenskaper i egenskapspanelen.
- Ange verifieringsregler och -beteenden.
- Justera format och layout efter behov.
Validering
- Alla obligatoriska fält finns.
- Fältegenskaperna är korrekt konfigurerade.
- Layouten är responsiv och tillgänglig.
- Valideringsregler fungerar som förväntat.
Nästa steg
- Konfigurera överföringsåtgärder för datahantering.
- Guide för universell redigering för avancerade funktioner.
Steg 3: Konfiguration och publicering
Konfigurera Edge Delivery Services och publicera formuläret.
Konfiguration: Automatisk (ingen manuell konfiguration krävs).
- GitHub-databasanslutningen och Edge Delivery Services-konfigurationen skapas när formulär skapas.
- Publiceringsslutpunkter konfigureras automatiskt.
Verifiering:
- Bekräfta att konfigurationen visas i formulärets inställningar.
- Kontrollera att GitHub-URL:en är korrekt länkad.
Publicera formuläret
-
Klicka på knappen Publicera (övre högra hörnet) i Universellt redigeringsprogram.
-
Bekräfta publiceringen i dialogrutan.
-
Observera de URL:er som genereras för testversionerna och liveversionerna.
Formulär-URL
Publicerade formulär är tillgängliga via Edge Delivery Services URL:er.
URL-struktur
-
Mellanlagrad (förhandsgranskning/testning):
code language-none https://<branch>--<repo>--<owner>.aem.page/content/forms/af/<form_name>
-
Live (produktion):
code language-none https://<branch>--<repo>--<owner>.aem.live/content/forms/af/<form_name>
URL-parametrar
<branch>
: GitHub-förgreningsnamn (t.ex.main
,develop
)<repo>
: GitHub-databasnamn (t.ex.my-forms-project
)<owner>
: GitHub-organisation eller användarnamn (t.ex.company-name
)<form_name>
: Formuläridentifierare enligt definition i AEM (t.ex.contact-us
)
Exempel
Exempel för formuläret contact-us
i databasen forms-project
under organisationen acme-corp
:
- Mellanlagrad:
https://main--forms-project--acme-corp.aem.page/content/forms/af/contact-us
- Live:
https://main--forms-project--acme-corp.aem.live/content/forms/af/contact-us
Miljöskillnader
- Mellanlagrad (.page): De senaste ändringarna för testning.
- Live (.live): Publicerat innehåll för produktion.
Uppdelning av Edge Delivery Services formulär-URL:er
Visuella exempel
Edge Delivery Services-mall:
- Mellanlagrad:
- Live:
Felsökning
Nedan beskrivs vanliga problem och lösningar för AEM Forms med Edge Delivery Services.
Problem: Formulär-URL returnerar 404 eller en tom sida.
Upplösning:
- Ta bort tillägget
.html
från URL:er. - Kontrollera att formuläret är publicerat.
- Kontrollera GitHub-databasen för det adaptiva Forms-blocket.
- Kontrollera att formulärnamnet matchar URL:en (skiftlägeskänslig).
Problem: Edge Delivery Services-konfigurationen fungerar inte.
Upplösning:
- Kontrollera att GitHub-URL:en har formatet
https://github.com/owner/repository
. - Använd rätt förgreningsnamn i konfigurationen.
- Verifiera databasåtkomst (offentlig eller autentiserad).
- Kontrollera
fstab.yaml
för korrekt GitHub-information.
Problem: Ändringar visas inte på den publicerade webbplatsen.
Upplösning:
- Vänta 2-3 minuter tills CDN-cachen har uppdaterats.
- Bekräfta att publiceringsarbetsflödet har slutförts.
- Testa först i den mellanlagrade miljön (.page).
- Kontrollera att GitHub-databasen har uppdaterats.
Problem: Det går inte att redigera formulär eller komponenter som inte läses in.
Upplösning:
- Använd en webbläsare som stöds (Chrome, Firefox, Safari).
- Rensa webbläsarcachen och cookies.
- Verifiera nätverksanslutningen.
- Bekräfta författarbehörighet.
Problem: Formuläröverföringar fungerar inte.
Upplösning:
- Konfigurera skicka-åtgärden i formuläregenskaperna.
- Testa slutpunkterna för överföring manuellt.
- Kontrollera CORS-inställningarna om du bäddar in formulär.
- Kontrollera att obligatoriska fält har konfigurerats.
Problem: Långsam formulärinläsning eller dålig prestanda.
Upplösning:
- Optimera bilder.
- Ta bort onödiga komponenter.
- Utnyttja Edge Delivery Services CDN.
- Minimera anpassade JavaScript/CSS.
Om problemen kvarstår:
- Kontrollera status för Adobe Experience Cloud-tjänst.
- Granska Edge Delivery Services-dokumentationen.
- Besök Adobe Experience League Community.
- Kontakta Adobe kundtjänst.
Nästa steg
När du är klar med formulärframtagningen och publiceringen bör du tänka på följande:
- Konfigurera överföringsåtgärder: Konfigurera datahantering och integreringar.
- Formulärdatamodeller: Koppla formulär till backend-datakällor.
- Edge Delivery Services bästa praxis: Maximera prestanda.
- Formuläranalys: Spåra formulärprestanda och användarbeteende.