Formulärbehållarkomponent form-container-component

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

Användning usage

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.

NOTE
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 version-and-compatibility

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 sample-component-output

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 technical-details

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 configure-dialog

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 post-data

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
TIP
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 mail

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 store-content

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
NOTE
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 general-settings

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 design-dialog

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 styles-tab

Komponenten Form Container stöder AEM Formatsystem.

recommendation-more-help
d2be9096-a81e-404b-9952-d8925af7219c