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 dialogrutan Konfigurera kan innehållsredigeraren definiera åtgärden som aktiveras när formulär skickas, URL:en som ska hantera överföringen och om ett arbetsflöde ska aktiveras. Mallförfattaren kan använda designdialogrutan för att definiera de tillåtna komponenterna och deras mappningar som liknar designdialogrutan för standardlayoutbehållaren 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.). Det går inte att använda Foundation Components i kärnkomponentens formulärbehållare (och vice versa).

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 Core Components Versions.

Exempel på komponentutdata sample-component-output

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

Teknisk information technical-details

Den senaste tekniska dokumentationen om Form Container-komponenten finns på GitHub.

Mer information om hur du utvecklar kärnkomponenter finns i dokumentationen för kärnkomponentutvecklare.

Konfigurera dialogruta configure-dialog

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

Beroende på vald å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.

Post-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 Post-formulärdata i formulärbehållarkomponentens redigeringsdialogruta

  • Slutpunkt - Den fullständiga HTTPS-tjänsten som bearbetar 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 för GitHub.

E-post mail

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

E-postalternativ i formulärbehållarkomponentens redigeringsdialogruta

  • Ämne - Ämnet i det e-postmeddelande som skickas när formulär skickas

  • Från - Från-e-postadressen för 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

    • Tryck eller klicka på knappen Lägg till för att lägga till ytterligare adresser
    • Tryck eller klicka på knappen Ta bort 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

    • Tryck eller klicka på knappen Lägg till för att lägga till ytterligare adresser
    • Tryck eller klicka på knappen Ta bort 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.

Lagra innehållsalternativ i formulärbehållarens redigeringsdialogruta

  • Innehållssökväg - 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 det lagrade innehållet som nyttolast när formulär 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 åtgärdstypen Post Form Data för att skicka användarinnehåll 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 formulärbehållarkomponenten

  • 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 datalagret.

    • 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ållaren i mallredigeraren.

Fliken Format styles-tab

Komponenten Form Container stöder AEM Style System.

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