DokumentationAEM 6.5Användarhandbok

Skapa en anpassad profil för HTML5-formulär creating-a-custom-profile-for-html-forms

Last update: Sat Jul 13 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Administratör
  • Användare
  • Utvecklare

En profil är en resursnod i Apache Sling. Den representerar en anpassad version av formuläråtergivningstjänsten HTML5. Du kan använda HTML5-formuläråtergivningstjänsten för att anpassa utseende, beteende och interaktioner för HTML5-formulären. Det finns en profilnod i mappen /content i JCR-databasen. Du kan placera noden direkt under mappen /content eller en undermapp till mappen /content.

Profilnoden har egenskapen sling:resourceSuperType och standardvärdet är xfaforms/profile. Återgivningsskriptet för noden finns på /libs/xfaforms/profile.

Sling-skripten är JSP-skript. Dessa JSP-skript fungerar som behållare för att sätta ihop HTML för det begärda formuläret och nödvändiga JS-/CSS-artefakter. Dessa Sling-skript kallas även profilåtergivningsskript. Profilåtergivaren anropar tjänsten Forms OSGi för att återge det begärda formuläret.

Profilskriptet finns i html.jsp och html.POST.jsp för begäranden om GET och POST. Du kan kopiera och ändra en eller flera filer för att åsidosätta och lägga till anpassningar. Gör inga ändringar på plats, så skriver uppdateringen över sådana ändringar.

En profil innehåller olika moduler. Modulerna är formRuntime.jsp, config.jsp, toolbar.jsp, formBody.jsp, nav_footer.jsp och footer.jsp.

formRuntime.jsp formruntime-jsp-br

Modulerna formRuntime.jsp innehåller referenser till klientbiblioteken. Det visar också metoder för att extrahera språkinformation från begäran och inkludera lokaliserade meddelanden i begäran. Du kan inkludera egna anpassade JavaScript-bibliotek eller -format i formRuntime.jsp.

config.jsp config-jsp

Modulen config.jsp innehåller olika konfigurationer som loggning, proxytjänster och beteendeversion. Du kan lägga till din egen konfiguration och widgetanpassning i modulen config.jsp. Du kan också lägga till konfigurationer som anpassad widgetregistrering i modulen config.jsp.

toolbar.jsp toolbar-jsp

toolbar.jsp innehåller kod för att skapa färgade verktygsfält. Om du vill ta bort verktygsfältet tar du bort toolbar.jsp från HTML.jsp

formBody.jsp formbody-jsp

Modulen formBody.jsp är till för HTML-representationen av XFA-formuläret.

Först återges bara den första sidan i formuläret HTML5. När en användare rullar formuläret läses resten av formulären in. Det gör inläsningen snabbare. Komponenten nav_footer.jsp innehåller alla format och nödvändiga element för att underlätta inläsningen av sidorna vid rullning.

Modulen footer.jsp är tom. Här kan du lägga till skript som bara används för användarinteraktion.

Skapa anpassade profiler creating-custom-profiles

Så här skapar du en anpassad profil:

Skapa profilnod create-profile-node

  1. Navigera till CRX DE-gränssnittet på URL https://'[server]:[port]'/crx/de och logga in i gränssnittet med administratörsautentiseringsuppgifter.

  2. Navigera till platsen /content/xfaforms/profiles i den vänstra rutan.

  3. Kopiera nodens standardvärde och klistra in noden i en annan mapp (/content/profiles) med namnet hrform.

  4. Markera den nya noden, hrform, och lägg till en strängegenskap: sling:resourceType med värdet: hrform/demo.

  5. Klicka på Spara alla på verktygsfältmenyn för att spara ändringarna.

Skapa profilåtergivningsskriptet create-the-profile-renderer-script

När du har skapat en anpassad profil lägger du till återgivningsinformation i den här profilen. När CRX tar emot en begäran om den nya profilen verifierar det att mappen /apps finns för den JSP-sida som ska återges. Skapa JSP-sidan i mappen /apps.

  1. Navigera till mappen /apps i den vänstra rutan.

  2. Högerklicka på mappen /apps och välj att skapa en mapp med namnet hrform.

  3. I mappen hrform skapar du en mapp med namnet demo.

  4. Klicka på knappen Spara alla .

  5. Navigera till /libs/xfaforms/profile/html.jsp och kopiera noden html.jsp.

  6. Klistra in noden html.jsp i mappen /apps/hrform/demo som skapas ovan med samma namn .html.jsp och klicka på Spara.

  7. Om du har andra komponenter i profilskriptet följer du steg 1-6 för att kopiera komponenterna i /apps/hrform/demo-mappen.

  8. Öppna URL:en https://'[server]:[port]'/content/xfaforms/profiles/hrform.html för att verifiera att profilen har skapats

Importera formulär från ditt lokala filsystem till AEM Forms och förhandsgranska formuläret AEM serverförfattarinstansen för att verifiera dina formulär.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2