Anpassa mallar för Forms Portal-komponenter customizing-templates-for-forms-portal-components
Förutsättningar prerequisites
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
-
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 filmall.html i den här mappen så att den kan fungera som en anpassad mall.
-
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-repetable till true.
I exemplet som behandlas 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. Attributet data-repetable 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 egenskapen ${metadata_prop} på platsen.
I exemplet används metadataegenskapen i flera instanser. Den används t.ex. i description,name,formUrl,htmlStyle,pdfUrl,pdfStyle och path 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
-
Formulärets namn:
-
namn: Formulärets namn (vanligtvis ä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 resurs. Giltiga värden är Form, PDF Form, Print Form och Adaptive Form
-
htmlStyle& pdfStyle: Visningsformat för HTML och PDF som används för återgivning. Giltiga värden är __FP_display_none eller tomma.
- 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):
-
Lokaliseringsstöd: Om du vill lokalisera statisk text använder du attributet
${localize-YOUR_TEXT}
och gör det lokaliserade värdet tillgängligt, om det inte redan finns.
I det exempel som behandlas används attributen${localize-Apply}
och${localize-Download}
för att lokalisera texten Använd och Hämta. -
Stöd för sortering: Klicka på elementet HTML om du vill 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. -
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 ToolTip-text som sparats via redigeringsdialogrutan använder du attributet
${config-htmlLinkText}
. På samma sätt använder du attributet${config-pdfLinkText}
för PDF-verktygstipstext.
Länkkomponent link-component
- Formulärets namn:
- formUrl: URL för att återge formuläret som HTML
- target: Länks målattribut. Giltiga värden är "_blank" och "_self".
- linkText: Länkbeskrivning
Komponenten Utkast och inskickat material drafts-amp-submissions-component
- Sökväg: 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ägen för AEM
- firstLetter: Första bokstaven (versaler) i titeln för det adaptiva formuläret, som sparades som utkast eller skickades.
- formName: Titeln på det adaptiva formuläret, som har sparats som utkast eller skickats.
- 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äret som är associerat med utkastet eller sändningen.
- 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/överföringen. Forms Portal innehåller följande klasser med olika färgade bakgrunder.
- ägare: Användaren som skapade utkastet/överföringen.
- I dag: Skapad av utkast eller inskickad i
DD:MM:YYYY
-format. - TimeNow: Tid då utkast eller inskickning skapades i
HH:MM:SS
24-timmarsformat
Obs!
-
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.
-
När du skapar länkar till öppna utkast och inskickade dokument kan du ange ${path}.html som värde för attributet href för ankartaggen.
A. Behållarelement
B. Sökväg-metadata med en fast hierarki för att hämta den miniatyrbild som lagras för varje formulär.
C. Attribut för upprepning av data som används för mallavsnittet för varje formulär
D. Localize "Apply" string
E. Använda konfigurationsegenskapen pdfLinkText
F. Använda pdfUrl-metadata
Tips, tricks och kända fel tips-tricks-and-known-issues
- Använd inte enkla citattecken (') i någon anpassad mall.
- Om du vill ha anpassade metadata sparar du den här egenskapen endast på noden jcr:content/metadata . Om du lagrar det på något annat ställe kan Forms Portal inte visa metadata.
- 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.
- data-repetable har ingen betydelse för en Link-komponent. Adobe rekommenderar att du undviker att använda den här egenskapen i mallen för en länkkomponent.
Relaterade artiklar
- Aktivera Forms Portal-komponenter
- Skapa Forms Portal-sida
- Visa formulär på en webbsida med API:er
- Använda komponenten Utkast och inskickat material
- Anpassa lagring av utkast och inskickade formulär
- Exempel på hur man integrerar utkast och inskickningskomponenter med databas
- Anpassa mallar för Forms Portal-komponenter
- Introduktion till att publicera formulär på en portal