Anpassa mallar för Forms Portal-komponenter customizing-templates-for-forms-portal-components

Förutsättningar prerequisites

Hantera formulärmetadata

Arbetskunskaper i HTML och CSS

Ökning overview

Med AEM Forms användargränssnitt kan du lägga till metadata i alla formulär. Anpassade metadata kan förbättra användarupplevelsen samtidigt som du listar och söker efter formulär i organisationen.

Med Forms Portal kan du använda anpassade metadata i formulärlistor. När du skapar anpassade mallar för resurser kan du ändra deras layout och använda anpassade metadata med din CSS-formatuppsättning.

Gör följande så att du kan skapa en anpassad mall för olika Forms Portal-komponenter.

Skapa en anpassad mall creating-a-nbsp-custom-template

  1. Skapa en slinga:Mappnod under /apps

    Lägg till egenskapen fpContentType. Ange lämpliga värden för egenskapen beroende på vilken komponent du definierar den anpassade mallen för.

    • Search & Lister component: "/libs/fd/fp/formTemplate"

    • Komponenten Utkast och inskickat material:

      • Avsnittet Utkast: /libs/fd/fp/draftTemplate
      • Inlämningsavsnitt: /libs/fd/fp/sendingTemplate
    • Länkkomponent: /libs/fd/fp/linkTemplate

    Lägg till en titel som du vill ska visas när du väljer layoutmallar.

    note note
    NOTE
    Titeln kan skilja sig från nodnamnet för sling:Mapp som du skapade.

    I följande bild visas konfigurationen för komponenten Sök och Lister.
    Skapa en slinga:Mapp

  2. Skapa en filmall.html i den här mappen så att den kan fungera som en anpassad mall.

  3. Skriv den anpassade mallen och använd anpassade metadata enligt beskrivningen nedan.

Exempel working-example

Nedan följer ett exempel på implementering av en anpassad mall där Forms Portal förvärvar en anpassad Geometrixx-Gov-kortlayout för komponenten Sök och visa.

<div class="__FP_boxes-container __FP_single-color">
    <div class="boxes __FP_boxes __FP_single-color" data-repeatable="true">
 <div class="__FP_boxes-thumbnail">
     <img src ="${path}/jcr:content/renditions/cq5dam.thumbnail.319.319.png"/>
        </div>
        <h3 class="__FP_single-color" title="${name}" tabindex="0">${name}</h3>
        <p>${description}</p>
        <div class="boxes-icon-cont __FP_boxes-icon-cont">
            <div class="op-dow">
                <a href="${formUrl}" target="_blank" class="__FP_button ${htmlStyle}" title="${config-htmlLinkText}">${localize-Apply}</a>
                <a href="${pdfUrl}" class="__FP_button ${pdfStyle}" title="${config-pdfLinkText}">${localize-Download}</a>
            </div>
        </div>
    </div>
</div>

Tekniska specifikationer för anpassade mallar technical-specifications-for-custom-templates

En anpassad mall för valfri Forms Portal-komponent innehåller repeterbara och icke-repeterbara poster. Repeterbara poster är grundläggande enheter som ska tas upp i förteckningen. Exempel på upprepningsbara poster är komponenterna Sök och Lister, Utkast och överföringar samt Länka.

Forms Portal innehåller en syntax för platshållare som kan visa anpassade/färdiga metadata. Platshållarna fylls i när resultatet av formulär, utkast eller inskickade formulär visas.

Om du vill ta med en repeterbar post konfigurerar du värdet för attributet data-repeterbar till true.

I det exempel som beskrivs finns två Div-element högst upp i den anpassade mallen. Den första, med CSS-klassen"__FP_boxes-container", fungerar som ett behållarelement för de formulär som visas. Den andra, med CSS-klassen"__FP_boxes", är en mall för de grundläggande entiteterna, i det här fallet ett formulär. The data-repeterbar ​attributet i Div-elementet har värdet true.

Varje platshållare har en exklusiv metadatauppsättning som är färdig att användas. Om du vill visa anpassade metadata på en viss plats i formuläret lägger du till ${metadata_prop} property på stället.

I exemplet används metadataegenskapen i flera instanser. Den används till exempel i description,name,formUrl,htmlStyle,pdfUrl,pdfStyle ​och bana ​på föreskrivet sätt.

Metadata utanför kartongen out-of-the-box-metadata

Olika Forms Portal-komponenter har exklusiva uppsättningar färdiga metadata som du kan använda för att visa upp en lista.

Komponenten Search & Lister search-amp-lister-component

  • Titel: Formulärets namn

  • name: Formulärets namn (oftast är det samma som titeln)

  • description: Beskrivning av formuläret

  • formUrl: URL för att återge formuläret som HTML

  • pdfUrl: URL för att återge formuläret som PDF

  • assetType: Typ av tillgång. Giltiga värden är Formulär, PDF Form, Skriv ut formulär och Adaptiv form

  • htmlStyle& pdfStyle: Visningsformat för HTML och PDF som används för återgivning. Giltiga värden är __FP_display_none" eller tomt.

NOTE
Kom ihåg att använda klassen __FP_display_none i din anpassade formatmall.
  • downloadUrl: URL för att hämta en resurs.

Stöd för lokalisering, sortering och användning av konfigurationsegenskaper i användargränssnittet (endast sökning och lister):

  1. Lokaliseringsstöd: Om du vill lokalisera statisk text använder du attributet ${localize-YOUR_TEXT} och göra det lokaliserade värdet tillgängligt, om det inte redan finns.
    I exemplet som behandlas är attributen ${localize-Apply} och ${localize-Download} används för att lokalisera texten Tillämpa och Hämta.

  2. Stöd för sortering: Klicka på elementet HTML för att sortera sökresultaten. Om du vill implementera sortering i en tabelllayout lägger du till attributet data-sortKey i den aktuella tabellrubriken. Lägg dessutom till dess värde som de metadata som du vill sortera efter.
    För rubrikrubriken i stödrastervyn är värdet för rubriken"data-sortKey" till exempel"title". Klicka på rubriken så att du kan sortera värdena i en viss kolumn.

  3. Använda konfigurationsegenskaper: Komponenten Search & Lister har flera konfigurationer som du kan använda i användargränssnittet. Om du till exempel vill visa HTML-verktygstipstext som har sparats i redigeringsdialogrutan använder du ${config-htmlLinkText} -attribut. På samma sätt kan du använda kommandot ${config-pdfLinkText} -attribut.

  • Titel: Formulärets namn
  • formUrl: URL för att återge formuläret som HTML
  • target: Länkens målattribut. Giltiga värden är "_blank" och "_self".
  • linkText: Länkbeskrivning

Komponenten Utkast och inskickat material drafts-amp-submissions-component

  • Bana: Sökväg till metadatanoden för utkast/överföringar. Använd det med tillägget .HTML som en URL-adress så att du kan öppna ett utkast eller en sändning.
  • contextPath: Kontextsökväg för AEM
  • firstLetter: Första bokstaven (versaler) i titeln på det adaptiva formuläret, som sparades som utkast eller skickades.
  • formName: Titeln på det adaptiva formuläret, som sparats som utkast eller skickat.
  • draftID: ID för det utkast som visas (Använd bara i mallen för avsnittet Utkast).
  • submitID: ID för överföringen som visas (Använd bara i mallen för avsnittet Skicka).
  • status: Status för det skickade formuläret. (Använd endast i mallen för avsnittet Skicka).
  • description: Beskrivning av det adaptiva formulär som är kopplat till utkastet eller inlämningen.
  • diffTime: Skillnad mellan aktuell tid och den senaste sparåtgärden för utkastet. Alternativt kan du ange skillnaden mellan den aktuella tiden och den senast skickade åtgärden för överföringen.
  • iconClass: CSS-klass som används för att visa den första bokstaven i utkastet/sändningen. Forms Portal innehåller följande klasser med olika färgade bakgrunder.
  • ägare: Användare som skapade utkastet/sändningen.
  • Idag: Datum då utkastet eller inlämningen skapades DD:MM:YYYY format.
  • TimeNow: Tid då utkast eller inlämning skapades i HH:MM:SS 24-timmarsformat

Obs!

  1. Om du vill ta bort alternativet i avsnittet Utkast under komponenten Utkast och överföringar ska du ge CSS-klassen namnet"__FP_deleteDraft". Inkludera dessutom attributet "draftID" med värdet ${draftID}, som är utkast-ID för motsvarande utkast.

  2. När du skapar länkar till öppna utkast och inskickade dokument kan du ange ${path}.html som värdet för href -attribut för ankartaggen.

Utkast och inskickningsnod

A. Behållarelement

B. "path"-metadata med en fast hierarki för att få miniatyrbilder lagrade för varje formulär.

C. Attribut som kan upprepas för varje formulär i mallavsnittet

D. Localize "Apply" string

E. Använda konfigurationsegenskapen pdfLinkText

F. Använda metadata för pdfUrl

Tips, tricks och kända fel tips-tricks-and-known-issues

  1. Använd inte enkla citattecken (') i någon anpassad mall.
  2. För anpassade metadata sparar du den här egenskapen på jcr:innehåll/metadata endast nod. Om du lagrar det på något annat ställe kan Forms Portal inte visa metadata.
  3. Kontrollera att namnet på anpassade metadata eller befintliga metadata inte innehåller ett kolon ( : ). Om det gör det kan du inte visa det i användargränssnittet.
  4. data-repeterbar har ingen betydelse för Länk -komponenten. Adobe rekommenderar att du undviker att använda den här egenskapen i mallen för en länkkomponent.

Relaterade artiklar

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