Formulärbehållarkomponent

Senaste uppdatering: 2022-06-27
  • Skapat för:
  • Developer
    Admin
    User

Med komponenten Core Component Form Container Component kan man skapa enkla inskickningsformulär.

Användning

Med formulärbehållarkomponenten kan du skapa enkla formulär och funktioner för inlämning av information genom att stödja enkla WCM-formulär och använda en kapslad struktur för att tillåta ytterligare formulärkomponenter.

Genom att använda konfigurera dialogruta innehållsredigeraren kan definiera den åtgärd som ska utföras när formulär skickas, vilken URl som ska hantera överföringen och om ett arbetsflöde ska aktiveras. Mallförfattaren kan använda designdialogruta för att definiera de tillåtna komponenterna och deras mappningar som liknar designdialogrutan för standardlayoutbehållare i mallredigeraren.

OBSERVERA

Huvudkomponenterna Form Container Component har endast stöd för användning av kärnkomponenter i form av komponenter (knapp, text, dold etc.). Använda grundkomponenter formulärkomponenter i kärnkomponentens formulärbehållare (och vice versa) stöds inte.

Version och kompatibilitet

Den aktuella versionen av Form Container Component är v2, som introducerades i version 2.0.0 av Core Components i januari 2018, och som beskrivs i det här dokumentet.

Följande tabell visar alla versioner av komponenten som stöds, de AEM versionerna som komponenterna är kompatibla med och länkar till dokumentation för tidigare versioner.

Komponentversion AEM 6.4 AEM 6.5 AEM as a Cloud Service
v2 Kompatibel med
version 2.17.4 och tidigare
Kompatibel Kompatibel
v1 Kompatibel Kompatibel Kompatibel

Mer information om versioner och versioner av kärnkomponenter finns i dokumentet Huvudkomponentversioner.

Exempel på komponentutdata

Om du vill visa Form Container-komponenten samt se exempel på dess konfigurationsalternativ samt HTML och JSON-utdata går du till Komponentbibliotek.

Teknisk information

Den senaste tekniska dokumentationen om komponenten Formulärbehållare finns på GitHub.

Mer information om hur du utvecklar kärnkomponenter finns i Dokumentation för grundkomponentutvecklare.

Konfigurera dialogruta

I dialogrutan Konfigurera kan innehållsförfattaren definiera vilka åtgärder som ska vidtas när komponenten skickas.

Beroende på det markerade Åtgärdstyp​ändras de tillgängliga alternativen i behållaren. De tillgängliga åtgärdstyperna är:

Oavsett typ finns det allmänna inställningar som gäller för varje åtgärd.

Bokför formulärdata

När formuläret skickas skickar dataåtgärden post form till en tredje part som JSON för bearbetning.

Alternativ för att skicka formulärdata i formulärbehållarkomponentens redigeringsdialogruta

  • Slutpunkt - Den fullständiga HTTPS-tjänsten som kommer att bearbeta data
  • Felmeddelande - Meddelande som visas om överföringen inte lyckas
TIPS

Det finns ytterligare timeout-alternativ som en systemadministratör kan justera för att hantera bearbetningen av vidarebefordrade formulärdata. Mer information finns i den tekniska dokumentationen om GitHub.

E-post

När formuläret skickas skickar poståtgärdstypen ett e-postmeddelande till angivna mottagare.

E-postalternativ i dialogrutan Redigera i komponenten Formulärbehållare

  • Ämne - Ämnet i det e-postmeddelande som skickas när formulär skickas
  • Från - Från-e-postadressen till det e-postmeddelande som ska skickas när formulär skickas
  • Till - Adresserna till mottagarna som får ett e-postmeddelande när formuläret skickas in
    • Tryck eller klicka på Lägg till knapp för att lägga till ytterligare adresser
    • Tryck eller klicka på Ta bort knapp för att ta bort en e-postadress
  • CC - Adresserna till mottagare som ska få en kopia av e-postmeddelandet som skickas när formuläret skickas in
    • Tryck eller klicka på Lägg till knapp för att lägga till ytterligare adresser
    • Tryck eller klicka på Ta bort knapp för att ta bort en e-postadress

Lagra innehåll

När formuläret skickas kommer innehållet i formuläret att lagras på en angiven plats i databasen.

Alternativ för att lagra innehåll i redigeringsdialogrutan för formulärbehållaren

  • Innehållsbana - Sökväg till innehållsdatabas där skickat innehåll lagras
  • Visa data - Tryck eller klicka för att visa lagrade skickade data som JSON
  • Starta arbetsflöde - Konfigurera för att starta ett arbetsflöde med lagrat innehåll som nyttolast när formuläret skickas
OBSERVERA

För att förenkla hanteringen av användardata och för att framtvinga olika problemområden rekommenderar vi i allmänhet inte att användargenererat innehåll lagras i databasen.

Använd i stället Bokför formulärdata åtgärdstyp för att skicka användarinnehåll vidare till en dedikerad tjänsteleverantör.

Allmänna inställningar

Oavsett vilken åtgärdstyp du väljer kan du alltid definiera en tacksida.

Allmänna alternativ i redigeringsdialogrutan för komponenten Formulärbehållare

  • Tack - Användaren omdirigeras till den angivna sidan när formuläret har skickats.
    • Använd dialogrutan Markering för att välja en resurs i AEM.
    • Om tacksidan inte finns i AEM anger du den absoluta URL:en. Icke-absoluta URL:er tolkas i förhållande till AEM.
    • Lämna tomt om du vill visa formuläret igen när det har skickats.
  • ID - Med det här alternativet kan du styra den unika identifieraren för komponenten i HTML och i Datalager.
    • Om inget anges genereras ett unikt ID automatiskt åt dig och du hittar det genom att granska den resulterande sidan.
    • Om ett ID anges är det författarens ansvar att se till att det är unikt.
    • Om du ändrar ID:t kan det påverka spårningen av CSS, JS och datalager.

Designdialogruta

I designdialogrutan kan mallskaparen definiera de tillåtna komponenterna och deras mappningar för behållaren som liknar designdialogrutan för standardlayoutbehållare i mallredigeraren.

Fliken Format

Komponenten Form Container stöder AEM Formatsystem.

På denna sida