Dokumentfragment document-fragments
Dokumentfragment document-fragments-1
Dokumentfragment är återanvändbara delar/komponenter av en korrespondens som du kan använda för att skapa brev/korrespondens. Dokumentfragmenten är av följande typer:
- Text: En textresurs är en del av innehållet som består av ett eller flera textstycken. Ett stycke kan vara statiskt eller dynamiskt.
- Lista: Listan är en grupp dokumentfragment, inklusive text, listor, villkor och bilder. Ordningen på listelementen kan vara fast eller redigerbar. När du skapar en bokstav kan du använda några eller alla listelement för att återanvända ett mönster med element.
- Villkor: Med villkor kan du definiera vilket innehåll som ska tas med när korrespondensen skapas, baserat på angivna data. Villkoret beskrivs i termer av kontrollvariabler. En kontrollvariabel kan antingen vara ett dataordlisteelement eller en platshållare.
- Layoutfragment: Ett layoutfragment är en layout som kan användas i en eller flera bokstäver. Ett layoutfragment används för att skapa repeterbara mönster, särskilt dynamiska tabeller. Layouten kan innehålla typiska formulärfält som "Adress" och "Referensnummer". Den innehåller också tomma delformulär som anger målområden. Layouterna (XDP) skapas i Designer och överförs sedan till AEM Forms.
Text text
En textresurs är en del av innehållet som består av ett eller flera textstycken. Ett stycke kan vara statiskt eller dynamiskt. Ett dynamiskt stycke innehåller referenser till dataelement, vars värden anges vid körning. Kundnamnet i en hälsningsfras kan till exempel vara ett dynamiskt dataelement med dess värde tillgängligt vid körning. Genom att ändra dessa värden kan samma brevmall användas för att generera brev för olika kunder.
Correspondence Management Solution har stöd för två typer av dynamiska dataobjekt (variabeldata):
- Dataordlisteelement: Dessa element är bundna till dataordlistan och hämtar deras värden från den angivna datakällan. En dataordlistevariabel kan vara skyddad eller oskyddad. När korrespondens skapas kan användaren ändra standardvärdet för oskyddade dataordlistevariabler, men inte ändra skyddade.
- Platshållare: Det här är variabler som inte är bundna till någon backend-datakälla. De kräver att användaren fyller i ett värde när korrespondens skapas. Platshållarna är som standard oskyddade.
Skapa text create-text
-
Välj Forms > Dokumentfragment.
-
Välj Skapa > Text eller markera en textresurs och välj Redigera.
-
Ange följande information för texten:
- Titel: (Valfritt) Ange titeln för textresursen. Titlar behöver inte vara unika och kan innehålla specialtecken och tecken som inte är engelska. Texterna refereras till av sina titlar (när de är tillgängliga) som miniatyrbilder och resursegenskaper.
- Namn: Textresursens unika namn. Det finns inga två resurser (text, villkor eller lista) i något läge med samma namn. I fältet Namn kan du bara ange engelska tecken, siffror och bindestreck. Fältet Namn fylls i automatiskt baserat på fältet Titel. De specialtecken, blanksteg, siffror och icke-engelska tecken som anges i fältet Titel ersätts med bindestreck i fältet Namn. Även om värdet i fältet Titel automatiskt kopieras till namnet kan du redigera värdet.
- Beskrivning: Ange en beskrivning av resursen.
- Dataordlista: Om du vill kan du välja vilken dataordlista som ska mappas. Med det här attributet kan du lägga till referenser till dataordlisteelement i textresursen.
- Taggar: Om du vill skapa en egen tagg anger du ett värde i textfältet och trycker på Retur. Taggen visas under textfältet med taggar. När du sparar den här texten skapas även de nya taggarna.
-
Välj Nästa. Korrespondenshanteringen visar redigeringssidan där du kan lägga till textstycken och dataelement i texten.
Standardstavningskontrollen i webbläsaren kontrollerar stavningen i textredigeraren. Om du vill hantera stavnings- och grammatikkontrollen kan du redigera stavningskontrollinställningarna i webbläsaren eller installera plugin-program/tillägg för webbläsaren för att kontrollera stavning och grammatik.
Du kan också använda de olika kortkommandona i textredigeraren för att hantera, redigera och formatera text. Mer information om kortkommandon för textredigeraren finns i Kortkommandon för korrespondenshantering.
-
En textredigerare öppnas. Skriv texten. Använd verktygsfältet längst upp på sidan för att formatera texten, infoga villkor, länkar och sidbrytningar.
- Länk: Infoga hypertextlänk i texten.
- Upprepa: Upprepa skriver ut samlingselement i Data Dictionary med hjälp av en avgränsare.
- Villkor: Välj att infoga ett villkor. Infoga text baserad på villkor. Om villkoret är true visas texten med bokstaven, i annat fall inte.
- Lägg till beskrivning: Lägg till anteckning i ett textstycke. Detta är metadata som är synliga för författaren men inte en del av det brev som skapas.
- Sidbrytning: Om du anger värdet false för sidbrytningsattributet för en textmodul bryts inte textmodulen över flera sidor.
En textredigerare öppnas. Ange texten. Verktygsfältet ändras beroende på vilken typ av redigeringar du väljer att göra: Stycke, Justering eller Lista:
Välj typ av verktygsfält: Stycke, Justering eller Lista
Verktygsfältet Stycke
Verktygsfältet JusteringVerktygsfältet Lista (klicka för att öppna en bild i full storlek)
-
Om du vill återanvända ett av flera textstycken som finns i ett annat program, till exempel MS Word- eller HTML-sidor, kopierar och klistrar du in texten i textredigeraren. Formateringen av den kopierade texten behålls i textredigeraren.
Du kan kopiera och klistra in ett eller flera textstycken i en redigerbar textmodul. Du kan t.ex. ha ett MS Word-dokument med en punktlista över godkända bevis för uppehälle, som följande:
Du kan kopiera och klistra in texten direkt från MS Word-dokumentet i en redigerbar textmodul. Formateringen som punktlistor, teckensnitt och textfärger behålls i textmodulen.
note note NOTE Formateringen av inklistrad text har dock vissa begränsningar. -
Infoga vid behov specialtecken i dokumentfragmentet. Du kan till exempel använda paletten Specialtecken för att infoga:
- Valutasymboler som €,¥ och £
- Matematiska symboler som t.ex.¥, Ð och ^
- Interpunktionssymboler som ‟ och "
Correspondence Management har inbyggt stöd för 210 specialtecken. Administratören kan lägga till stöd för fler/anpassade specialtecken genom anpassning.
-
Markera texten och välj Markera färg om du vill framhäva delar av texten i en redigerbar textbunden modul.
Du kan antingen direkt välja en grundfärg
**[A]**
som finns på paletten Grundfärger eller välja Markera efter att du har använt reglaget**[B]**
för att välja rätt färgton.Du kan också gå till fliken Avancerat och välja lämplig nyans, ljushet och mättnad
**[C]**
för att skapa den exakta färgen och sedan välja Välj**[D]**
för att använda färgen för att markera texten. -
Dra och släpp dataordlisteelement och platshållarelement från datapanelen till texten.
Till:
- Lägg till ett dataordlisteelement i texten, markera ett dataelement i listan och välj Infoga ( ). Om du väljer Skyddat är dataordlisteelementet skrivskyddat och visas i brevsredigeraren, men inte i användargränssnittet Skapa korrespondens eller Correspondence Creator.
- Lägg till ett platshållarelement i texten, välj Skapa nytt på panelen Dataelement, ange information för det nya dataelementet och välj Skapa för att lägga till det nya elementet i listan. Den nya platshållaren kan infogas i texten på samma sätt som dataordlisteelementet. Om du vill redigera en platshållare markerar du en platshållare och väljer Redigera.
Platshållarelement som anges i exempeldatafilen för en Data Dictionary
Värden för platshållarelement i CCR-vyn ifyllda från variablerna i datamappen enligt exempeldatafilen
Du kan också använda symbolen @ för att söka efter och lägga till dataordlista och platshållarelement i textredigeraren. Placera markören där du vill infoga elementet. Skriv @ följt av söksträngen. Textredigeraren utför sökåtgärden på alla dataordlisteelement och platshållarelement som finns i textdokumentfragmentet. Sökåtgärden hämtar och visar elementen som innehåller söksträngen som en nedrullningsbar lista. Navigera genom sökresultaten och klicka på elementet som du vill infoga vid markörens plats. Tryck på Esc för att dölja sökresultaten.
-
Du kan använda textbundna villkor och upprepa för att göra brevet mycket sammanhangsberoende och välstrukturerat. Mer information om textbundna villkor och upprepning finns i Textbundna villkor och upprepa med bokstäver.
-
Välj Spara.
Infoga hyperlänk i en text insert-hyperlink
Så här skapar du en hyperlänk i en textresurs:
-
Markera texten eller datamodellobjektet i textredigeraren.
-
Välj Link. Markera fältet Alt Text om du vill ta bort det befintliga datamodellens objektnamn eller text.
-
Ange URL-adressen och välj .
Söka och ersätta text searching-and-replacing-text
När du arbetar med textelement som innehåller en stor textmängd måste du söka efter en viss textsträng. Du kan också behöva ersätta en viss textsträng med en alternativ sträng.
Med funktionen Sök och ersätt kan du söka efter (och ersätta) alla textsträngar i ett textelement. Funktionen innehåller även en kraftfull sökning efter reguljära uttryck.
Söka efter text i en textmodul to-search-text-in-a-text-module
-
Öppna textmodulen i textredigeraren.
-
Välj Sök och ersätt.
-
Skriv den text du vill söka efter i textrutan Sök och tryck på Sök. Söktexten markeras i textmodulen.
-
Om du vill söka efter nästa förekomst av texten trycker du på Sök igen.
Om du fortsätter att trycka på knappen Sök fortsätter sökningen nedåt på sidan. När den sista instansen av texten har hittats visar meddelandet Slutet av modulen att inga fler sökresultat hittades.
Om ingen instans av söktexten hittas i textmodulen visas meddelandet: Matcha inte hittades.
-
Om du trycker på Sök igen fortsätter sökningen högst upp på sidan.
Sökalternativ search-options
Matcha gemener/VERSALER: Sökningen returnerar endast resultat med samma skiftläge.
Hela ord: Sökningen returnerar bara hela ord.
Reg ex: Sök med reguljära uttryck. Följande reguljära uttryck söker till exempel efter e-postadresser i en textmodul:
[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,4}
Söka och ersätta text i en textmodul to-search-and-replace-text-in-a-text-module
-
Öppna textmodulen i textredigeraren.
-
Välj Sök och ersätt.
-
Ange den text som du vill söka efter i textrutan Sök och den text som du vill ersätta söktexten med. Tryck sedan på Ersätt.
-
Om söktexten hittas ersätts texten med ersättningstexten.
- Om en annan förekomst av söktexten hittas markeras den förekomsten i textmodulen. Om du trycker på Ersätt igen ersätts den markerade instansen och markören flyttas framåt, om en tredje instans hittas.
- Om ingen annan instans hittas stannar markören vid den senast ersatta instansen.
-
Om du trycker på Sök igen fortsätter sökningen högst upp på sidan.
Använd alternativet Ersätt alla om du vill ersätta alla förekomster av en text i textmodulen. När du gör oss" visas antalet ersättningar som ett meddelande i dialogrutan Sök och ersätt.
God praxis/tips och tricks för textmoduler best-practices-tips-and-tricks-for-text-modules
-
Använd en konsekvent namnkonvention för att undvika duplicering.
-
Använd lämplig databindning i textmoduler.
-
Följande regler gäller när du använder textredigeraren när du ändrar en textresurs:
- Tillägg av variabel: tillåtet
- Borttagning av variabel: Tillåten
- Uppdatering av egenskaper: Tillåtet
- Ändring av dataordlista: Tillåts tills dataordlisteelementet inte används. Du kan inte ändra dataordlistan vid uppdatering.
Lista list
En lista är en grupp dokumentfragment, inklusive text eller (andra) listor, villkor och bilder. Ordningen på listelementen kan vara fast eller redigerbar. När du skapar en bokstav kan du använda några eller alla listelement för att återanvända ett mönster med element. Listor fungerar i princip som mål som kan kapslas i andra mål.
Implementeringslistor implementing-lists
Implementeringslistorna består av två steg:
- Definiera kärnegenskaper som namn, beskrivning och dataordlista.
- Avsnitt med innehåll som är en del av listan och sedan ange egenskaper som låsordning och biblioteksåtkomst för listan.
Skapa en lista create-a-list
En lista är en grupp med relaterat innehåll som kan användas i en brevmall som en enda enhet. Alla typer av innehåll kan läggas till i en lista. Listor kan också kapslas. Listmoduler kan anges som:
- ORDERED: Det går inte att ändra ordningen i körningsmiljön Create Correspondence.
- Biblioteksåtkomst: Användare kan lägga till moduler i listan. Den här flaggan anger om biblioteksåtkomst är aktiverad. Om den är aktiverad (öppen) kan användaren lägga till moduler i listan när bokstaven förhandsgranskas.
- När du skapar en lista kan du ange en typ, till exempel:
- Normal: Ingen ytterligare formatering används i listan.
- Punktlista: En lista formaterad med en enkel punkt.
- Numrerad: En numerisk lista med alternativen Standard (1,2,…), Romerska (I, II, …) och Romska gemener (i, ii,…).
- Bokfört: En alfabetisk lista med gemener (a,b,…) och versaler (A,B,…).
- Egen: Du kan skapa valfria värden för Numbered/Lätta typ och prefix och suffix.
-
Välj Forms > Dokumentfragment.
-
Välj Skapa > Lista.
-
Ange följande information för listan:
- Titel (valfritt): Ange titeln för listan. Titeln behöver inte vara unik och kan innehålla specialtecken och tecken som inte är engelska. Listor refereras till av deras titlar (om de är tillgängliga) som miniatyrbilder och resursegenskaper.
- Namn: Listans unika namn. Det finns inga två resurser (text, villkor eller lista) i något läge med samma namn. I fältet Namn kan du bara ange engelska tecken, siffror och bindestreck. Fältet Namn fylls automatiskt i med värdet i fältet Titel. De specialtecken, blanksteg, siffror och icke-engelska tecken som anges i fältet Titel ersätts med bindestreck i fältet Namn. Även om värdet i fältet Titel automatiskt kopieras till namnet kan du redigera värdet.
- Beskrivning (valfritt): Ange en beskrivning av resursen.
- Dataordlista (valfritt): Du kan också välja vilken dataordlista som du vill ansluta till. Endast resurser som använder samma dataordlista som listan, eller resurser som inte har någon dataordlista tilldelad, kan läggas till i listan. Om du tilldelar ett datalexikon till en lista blir det enklare för personen som skapar en brevmall att hitta rätt lista.
- Taggar (valfritt): Markera de taggar som ska användas. Du kan också skriva namnet på en ny tagg och skapa den. (Den nya taggen skapas när du väljer Spara.)
-
Välj Nästa.
-
Välj Lägg till resurs.
-
Om du vill lägga till resurser i listan markerar du dem på sidan Välj Assets och väljer Klar.
-
Resurserna läggs till på sidan Listobjekt.
Om du vill ändra ordningen på resurserna i listan markerar och håller du ned pilikonen ( ) och drar och släpper. När användaren öppnar en brevmall i användargränssnittet Skapa korrespondens, monteras innehållet i den ordning som du definierade här. -
Du kan välja följande alternativ för att ange hur listan fungerar i CCR-användargränssnittet:
-
Biblioteksåtkomst: Om du vill aktivera biblioteksåtkomst för att lägga till resurser väljer du Biblioteksåtkomst. När Library Access är aktiverat kan anspråksjusteraren lägga till mer innehåll i listan. I annat fall begränsas Anspråksjusteraren till det innehåll som du har definierat för listan.
-
Lås ordning: Välj Lås ordning om du vill låsa ordningen för resurserna i listan så att anspråksjusteraren inte kan ändra ordningen. Om du inte markerar det här alternativet kan du ändra ordningen på listobjekten med Anspråksjustering.
-
Lägg till punkter: Använd det här alternativet om du vill använda en punkt- eller numreringsstil i modulen. Du kan antingen använda ett fördesignat listformat eller ett anpassat. Du kan också ange den text som ska visas före och efter varje listobjekt.
-
Sidbrytning: Välj det här alternativet ( ) om du vill lägga till en sidbrytning mellan listinnehållet. Om det här alternativet inte är markerat ( ), och innehållet i listan flödar över till nästa sida, flyttas hela listan till nästa sida i stället för att brytas i sidan mellan listan.
-
Tilldelningskonfiguration: Använd det här alternativet om du vill ange minsta och högsta antal resurser som kan läggas till i listan.
-
-
Du kan välja följande alternativ för att ange hur varje resurs i listan fungerar vid körning:
- Redigerbar: När det här alternativet är markerat kan innehållet redigeras i användargränssnittet Skapa korrespondens. (Det här alternativet är inte tillgängligt för list- och bildmodulerna.)
- Obligatoriskt: När det här alternativet är markerat krävs innehållet i användargränssnittet Skapa korrespondens.
- Markerat: När det här alternativet är markerat är innehållet förmarkerat i användargränssnittet Skapa korrespondens.
- Hoppa över format: När det här alternativet är markerat hoppar innehållet över punkter och numrering i användargränssnittet Skapa korrespondens. (Det här alternativet är inte tillgängligt för Image-moduler. Mellan Hoppa över format, Stansat och Ignorera listformat kan bara ett av alternativen användas i en modul. Ett av dessa alternativ kan användas för en modul när du väljer Lägg till punkter för en modul.)
- Indrag: Du kan ändra indragsnivån för varje modul/innehåll som är markerat som en del av listan. Indrag anges i Nivåer (med början från noll), så att varje indragsnivå motsvarar en utfyllnad på 36 punkter.
- Sammansatt: När du väljer det här alternativet används den sammansatta numreringen som en kombination av den yttre (överordnade) listans format och dess egna format. Den sammansatta numreringen för den här kapslade listan baseras på den ordning i vilken den kapslade listan visas i den yttre listan.
- Ignorera listformat: Om alternativet Sammansatt numrering är avmarkerat aktiveras alternativet att ignorera listformat. Den här markeringen ignorerar den kapslade listans eget format och numreringen fortsätter från den yttre listan. Därför behandlas modulerna i den kapslade listan som en del av den yttre listan, oavsett vilka format som har angetts i den kapslade listan. Om alternativet Ignorera listformat inte är markerat för en kapslad lista har de moduler som är en del av den kapslade listan ett eget numreringsformat.
- Håll ihop med nästa: Anger sidbrytningen för resurserna i en lista. Om du anger egenskapen Behåll med nästa för en resurs i en lista till På stannar resursen och nästa resurs på samma sida. Det innebär att innehållet i den valda resursen och nästa resurs inte bryts över flera sidor.
-
Välj Spara.
God praxis/tips och tricks best-practices-tips-and-tricks
-
Använd en konsekvent namnkonvention för att undvika duplicering.
-
Använd lämplig databordsbindning
-
Följande regler gäller när du använder listredigeraren för att ändra en lista:
- Egenskapsuppdatering: Tillåten
- Ändring av dataordlista: Tillåts tills inget objekt som använder dataordlistan är associerat med det. Du kan inte ändra dataordlistan vid uppdatering.
Villkor conditions
Villkoren gör att du kan definiera vilket innehåll som ska tas med när korrespondens/brev skapas, baserat på angivna data. Villkoret beskrivs i termer av kontrollvariabler. När du lägger till ett villkor kan du välja att ta med en resurs baserat på det värde som kontrollvariabeln har.
Baserat på de alternativ du väljer utvärderas antingen bara det första uttrycket som är sant, baserat på den aktuella villkorsvariabeln, eller hela villkoret. När du fyller i brevet i Skapa korrespondens (CCR) fungerar villkoren som"vita rutor". Om ett villkor resulterar i en lista kommer alla obligatoriska och förmarkerade objekt i listan att returneras. Om något av dessa objekt är villkor eller själva listas, returneras även det resulterande innehållet, i den nedifrån och upp-och-ned-ordning som en platt lista med text- och bildinnehåll. Villkorsresultaten kan vara av valfri typ (text, lista, villkor eller bild).
Genomförandevillkor implementing-conditions
Villkorsredigeraren har ett Expression Builder -användargränssnitt som stöder skapande av uttryck med hjälp av både flera platshållare och Data Dictionary-element. Du kan använda vanliga operander och lokala/globala funktioner i sådana uttryck. Varje uttryck kan associeras med visst innehåll och det kan också finnas ett standardavsnitt om inget av uttrycken utvärderas som true. Alla uttryck utvärderas i den sekvens i vilken de definieras och de första uttrycken som returnerar true markeras och det tillhörande innehållet returneras av den villkorliga modulen.
Om villkoren i en bokstav till exempel skiljer sig åt beroende på vilket läge kunden befinner sig i och dataordlistan innehåller ett element med namnet"state", kan du lägga till villkoret enligt följande:
- läge = NY, markera textstycket T&C_NY
- läge = NC, markera textstycket T&C_NC
Med Villkorsredigeraren kan du ange ett standardvillkor. Om värdet för kontrollvariablerna inte matchar något av villkoren används innehållet som är associerat med standardvillkoret. I föregående exempel kan du lägga till den här villkorsraden:
- Standard, välj T&C_Rest
Skapa ett villkor create-a-condition
-
Välj Forms > Dokumentfragment.
-
Välj Skapa > Villkor.
-
Ange följande information för listan:
- Titel (valfritt): Ange villkorets titel. Titeln behöver inte vara unik och kan innehålla specialtecken och tecken som inte är engelska. Villkoren refereras till av deras titlar (om de är tillgängliga) som miniatyrbilder och resursegenskaper.
- Namn: Villkorets unika namn. Det finns inga två resurser (text, villkor eller lista) i något läge med samma namn. I fältet Namn kan du bara ange engelska tecken, siffror och bindestreck. Fältet Namn fylls i automatiskt baserat på fältet Titel. De specialtecken, blanksteg, siffror och icke-engelska tecken som anges i fältet Titel ersätts med bindestreck i fältet Namn. Även om värdet i fältet Titel automatiskt kopieras till namnet kan du redigera värdet.
- Beskrivning (valfritt) Ange en beskrivning av villkoret.
- Dataordlista (valfritt): Du kan också välja vilken dataordlista som du vill ansluta till. Endast resurser som använder samma dataordlista som villkoret, eller resurser som inte har någon dataordlista tilldelad, kan läggas till i listan. Om du tilldelar ett datalexikon till en lista blir det enklare för den som skapar en brevmall att hitta rätt villkor.
- Taggar (valfritt): Om du vill kan du välja vilka taggar som ska användas. Du kan också skriva namnet på en ny tagg och skapa den. (Den nya taggen skapas när du väljer Spara.)
-
Välj Nästa.
-
Välj Lägg till resurs.
-
Om du vill lägga till en resurs i villkoret markerar du den på sidan Välj Assets och väljer Klar. Resurserna läggs till i rutan Uttryck.
-
Du kan välja följande alternativ för att ange hur villkoret fungerar under körning:
- Inaktivera utvärdering av flera resultat\Aktivera utvärdering av flera resultat: När det här alternativet är aktiverat (visas som "Aktivera flera…") utvärderas alla villkor och resultatet är summan av alla verkliga villkor. Om det här alternativet är inaktiverat (visas som"Inaktivera flera…") utvärderas endast det första villkoret som är sant och blir villkorets utdata.
- Sidbrytning: Välj det här alternativet ( ) om du vill lägga till en sidbrytning mellan villkorens moduler. Om det här alternativet inte är markerat ( ) och ett villkor flödar över till nästa sida, flyttas hela villkoret till nästa sida i stället för att brytas i sidan mellan villkoret.
-
Om du vill ändra ordningen på resurserna i villkoret markerar och håller du ned pilikonen ( ) och drar och släpper. När användaren öppnar en brevmall i användargränssnittet Skapa korrespondens, monteras innehållet i den ordning som du definierade här.
-
Välj Ta bort om du vill ta bort raden. Om du väljer Ta bort som standardrad rensas bara resursinformationen.
-
Välj Kopiera om du vill duplicera en rad.
-
Välj Redigera om du vill ändra resursen eller redigera uttrycket.
Ytterligare:
- Om du vill uppdatera resursen väljer du mappikonen under Resurskolumnen.
- Om du vill öppna uttrycksverktyget och infoga ett uttryck väljer du mappikonen under kolumnen Uttryck. Mer information om Expression Builder finns i Expression Builder.
God praxis/tips och tricks best-practices-tips-and-tricks-1
-
Använd en konsekvent namngivningskonvention för enkel sökning och för att undvika dubbelarbete.
-
Villkoren fungerar som fallsatser, så villkorens ordning är viktig. Den första matchningen returneras.
-
Använd lämplig databordsbindning
-
Följande regler gäller när du använder villkorsredigeraren för att redigera ett villkor:
- Tillägg av variabel: tillåtet
- Borttagning av variabel: Tillåten
- Uppdatering av egenskaper: Tillåtet
- Ändring av dataordlista: Tillåts tills dataordlisteelementet inte används.
Layoutfragment layoutfragments
Ett layoutfragment baseras på XDP:er som skapats i Designer. Om du vill skapa layoutfragment måste du skapa XDP-filerna och överföra dem till AEM Forms.
Ett eller flera layoutfragment kan utgöra delar av en bokstav och definiera den grafiska layouten för dessa delar. Ett layoutfragment kan innehålla typiska formulärfält, t.ex. adress och referensnummer, och tomma delformulär som anger målområden. Dessutom kan du med layoutfragment skapa tabeller och infoga dem med bokstäver.
Ett vanligt användningssätt är att hitta återanvändbara layoutmönster i Bokstäver och skapa layoutfragment för dem. Till exempel hälsningsfras, adress och ämne i brevet, som visas i samma ordning med flera bokstäver. Ett annat exempel kan vara en tabell med ett liknande antal rader och kolumner som används i flera bokstäver.
Du kan skapa ett layoutfragment baserat på en befintlig XDP. Ett layoutfragment kan antingen bestå av fält och målområden eller av en eller flera tabeller. Tabellerna i en layout kan vara statiska eller dynamiska. En XDP skapas i Designer och överförs till AEM Forms. En XDP kan utgöra strukturen antingen för ett layoutfragment eller för en bokstav. Mer information om Layoutdesign.
Om du använder fragment som är bundna till målområden kan bokstaven ändras vid redigeringen. Layoutfragment med olika dimensioner kan skapas och rätt fragment kan bindas till målområdet. Med layoutfragment kan du också anpassa några av tabellegenskaperna:
- Du kan öka antalet rader och kolumner.
- Du kan ange sidhuvud och sidfot för fler rader och kolumner.
- Du kan definiera förhållandet mellan tabellkolumnbredden. Vid körning ändras tabellkolumnernas storlek enligt den definierade kvoten och det tillgängliga utrymmet. Summan av breddförhållandet måste vara 100. I annat fall är det inte tillämpligt.
- Om en tabell är en platshållare (innehåller endast en tom cell) kan du definiera typen (målområde/fält) för nya kolumner.
- Du kan dölja huvud- och fotrader.
Skapa ett XFA-fragment med Designer innan du utför den här proceduren. Fragmentet kan innehålla tabeller för att ordna fält och målområden. Med Designer kan du skapa två typer av tabeller: statiska och dynamiska. Statiska tabeller innehåller ett fast antal rader. Statiska tabeller kan innehålla målområden och fält. Målområdet och fälten kan inte bindas till upprepade DDE:er. En dynamisk tabell kan också ha en rad. De data som är bundna till tabellceller avgör antalet rader för dynamiska tabeller. En dynamisk tabell kan bara innehålla fält. DDE:er kan vara upprepande eller icke-upprepande.
Tänk på följande när du utformar tabeller:
- Tabeller kan anpassas när layoutfragment skapas. Alternativet för anpassning är bara aktiverat när tabellens överordnade delformulär flödas.
- För dynamiska tabeller använder alla fält, repeterbara rader och tabeller "use name"-bindning för att data ska sammanfogas korrekt.
- För dynamiska tabeller är alla upprepade DDE:er som är bundna till tabellfälten en del av samma hierarki. För icke upprepande DDE:er finns ingen sådan begränsning.
- När du sammanfogar layoutfragment i överordnade målområdestabeller ändras storleken enligt tillgängligt utrymme, men storleksändringen sker bara när layoutfragmentet inte innehåller något målområde eller fält direkt i det översta delformuläret. Målområde och fält i tabellen tillåts.
- Du kan skapa platshållartabeller. Platshållartabeller har bara en tom cell.
-
För platshållartabeller kan du anpassa följande egenskaper när du skapar fragment.
- radantal
- antal kolumner
- sidhuvud och sidfot för varje kolumn
- typ (målområde/målfält) för varje kolumn
- breddförhållande för varje kolumn
-
För tabeller som inte är platshållare kan du anpassa följande egenskaper:
- radantal
- antal kolumner
- sidhuvud och sidfot för ytterligare kolumner
- breddförhållande för varje kolumn
Du kan kapsla fragment i en bokstav. Det innebär att du kan lägga till ett fragment i ett fragment. Korrespondenshanteringslösningen stöder upp till fyra kapslingsnivåer i en bokstav: **Letter *>*Fragment *>*Fragment *>*Fragment >Fragment.
Ett detaljerat exempel på hur du använder statiska och dynamiska tabeller i layoutfragment finns i Exempel på exempelfiler: använda statiska och dynamiska tabeller i en bokstav.
Skapa ett layoutfragment creating-a-layout-fragment
-
Välj Skapa > Layoutfragment.
-
Correspondence Management visar tillgängliga XDP:er. Välj den XDP som du vill basera ditt layoutfragment på och välj Nästa.
-
Ange följande information för layouten:
- Titel (valfritt): Ange layoutfragmentets titel. Titeln behöver inte vara unik och kan innehålla specialtecken och tecken som inte är engelska. Layoutfragment refereras till av sina titlar (när de är tillgängliga) som miniatyrbilder och resursegenskaper.
- Namn: Layoutfragmentets unika namn. Det finns inga två resurser (text, villkor eller lista) i något läge med samma namn. I fältet Namn kan du bara ange engelska tecken, siffror och bindestreck. Fältet Namn fylls i automatiskt baserat på fältet Titel. De specialtecken, blanksteg, siffror och icke-engelska tecken som anges i fältet Titel ersätts med bindestreck i fältet Namn. Även om värdet i fältet Titel automatiskt kopieras till namnet kan du redigera värdet. Det här namnet visas i listan i användargränssnittet för Hantera Assets.
- Beskrivning (valfritt): Beskrivning som visas i listan i användargränssnittet Hantera Assets.
- Taggar (valfritt): Om du vill kan du markera taggarna som ska användas i villkoret. Du kan också skriva namnet på en ny tagg och skapa den.
-
Markera fliken Tabell och ange följande information för layouten:
-
Konfiguration för: Välj den tabell som konfigureras.Som ett suffix till tabellnamnet i listrutan är (statiskt) om tabellen är statisk eller (dynamiskt) om tabellen är en dynamisk tabell. Statiska tabeller innehåller ett fast antal rader. Statiska tabeller kan innehålla målområden och fält. Målområdet och fälten kan inte bindas till upprepade DDE:er. De data som är bundna till tabellceller avgör antalet rader för dynamiska tabeller.
-
Rader: Markera antalet rader för layouten. Det konfigurerade radantalet måste vara större än eller lika med det ursprungliga radantalet.
-
Kolumner: välj antal kolumner för layouten. Det konfigurerade kolumnantalet måste vara större än eller lika med det ursprungliga kolumnantalet.
För varje kolumn krävs följande uppgifter:
- Sidhuvud: text som ska visas för sidhuvudet
- Sidfot: text som ska visas för sidfoten
- Typ: typ av extra kolumn. Fält eller målområde. Typ är aktiverat för statiska platshållartabeller. Text kan definieras på kolumnnivå och inte på cellnivå. Alla celler i en utökad kolumn är av samma typ. För en dynamisk tabell är alla kolumner av fälttyp. För tabeller som inte är platshållare kan du inte definiera typen av ytterligare kolumner. I det här fallet är typen av ytterligare celler i den utökade kolumnen densamma som typen för den sista kolumnen i den raden, och typen av cell i den andra raden är densamma som typen för den sista cellen i den kolumnen.
- Breddförhållande: för tabellkolumnbredderna.
Ett detaljerat exempel på hur du använder statiska och dynamiska tabeller i layoutfragment finns i Exempel på exempelfiler: använda statiska och dynamiska tabeller i en bokstav.
-
-
Välj Spara.
Överför en XDP till Correspondence Management upload-an-xdp-to-correspondence-management
Instruktioner om hur du överför/importerar en XDP till Correspondence Management finns i Importera och exportera resurser till AEM Forms.
God praxis/tips och tricks best-practices-tips-and-tricks-2
Ange standardbindning för delformulär set-the-default-subform-binding
När du skapar målområden i Designer är det bra att ange standardbindningen för alla nya delformulär till "none".
Så här anger du standardbindning:
-
I Designer väljer du Verktyg > Alternativ > Databindningar > Bindning för delformulär.
-
Välj Ingen databindning i listan Standardbindning för nya delformulär.
Detta garanterar att delformulär som infogats med kommandot Infoga > Delformulär eller genom att dra och släppa från objektpaletten har bindningen "none" som standard. Det innebär som standard att alla nya delformulär är ett målområde såvida du inte lägger till innehåll i det, ändrar bindningsinställningen eller namnger delformuläret med suffixet"_int".
Section 508-compliance section-compliance
Om det färdiga brev som skapas i användargränssnittet Skapa korrespondens används för att fylla i ett senare arbetsflöde. Följ de här rekommendationerna för Section 508 när du skapar layouten. I annat fall visas brevet PDF och du kan bortse från följande rekommendationer:
- Alla målområdesdelformulär och alla fält i en layout har en tabbordning.
- Fält med bildtexter är som standard 508-kompatibla. Fältets speak@priority är som standard inställt på"anpassad", vilket innebär att skärmläsaren läser upp fältets bildtext, såvida inte anpassad uppläsningstext anges.
- Fält utan bildtexter anger en funktionsbeskrivning och visar att skärmläsare läser funktionsbeskrivningen genom att ange
/field/assist/speak@priority="toolTip"
och anger verktygstipstext i /field/assist/toolTip
.
Datumformat i Designer och Resurskonfigurationshanteraren date-formats-in-designer-and-asset-configuration-manager
När du utformar en layout i Designer måste du se till att formaten för datumfält matchar datumformaten som anges i datavisningsformat i Konfiguration av korrespondenshantering. Mer information finns i Formatera fältvärden och använda mönster i hjälpen för Designer.
Samla in datumintervall capturing-date-ranges
När du hanterar en kombination av datum, till exempel startDate - endDate, ska du använda ett enda delformulär för att säkerställa korrekt justering i den färdiga bokstaven och för att minimera antalet fält.
Ange bindning på formulärnivå setting-form-level-binding
När en layout innehåller många fält och målområden som är mappade till enskilda XML-element använder du bindning på formulärnivå och skapar en separat nod för varje element. Fält som är bundna på formulärnivå ignoreras när data mappas i Correspondence Management.
Använd inte målområden för delformulär på en mallsida do-not-use-subform-target-areas-in-a-master-page
Delformulärets målområden på en mallsida är inte synliga i användargränssnittet Hantera Assets och det går inte att mappa data till dem.
Välja lämpliga positioner och typer för målområden choosing-appropriate-positions-and-types-for-target-areas
Var försiktig när du utformar layouten när du väljer delformulär. Om layouten innehåller ett enskilt delformulär kan det vara en flödestyp. När du har placerat fält i delformuläret kan du kapsla in det i ett annat delformulär så att även det inkapslade delformuläret flödas och layouten inte störs.
Placera fält på mallsidor placing-fields-on-master-pages
Observera följande när du placerar ett fält på en mallsida:
- Ange bindning för mallsidans fält till Använd globala data
- Placera inte fältet direkt under mallsidans rotsidområde.
- Lägg in fältet i ett namngivet delformulär och se till att bindningen för det namngivna delformuläret är inställd på Använd namn.
Skapa tabeller med layoutfragment creating-tables-using-layout-fragments
Många bokstavsmallar innehåller tabeller. Tabeller kan vara statiska, t.ex. en tabell med termer och villkor, där varje rad representerar ett villkor och varje del visas i en separat kolumn. Tabeller kan också vara dynamiska, till exempel kontoinformation, som innehåller information som kundnamn, konto-id, transaktionsnummer och transaktionsbelopp.
- Statiska tabeller: Tabeller skapas ibland med rader som har ett annat antal kolumner, till exempel för en tabell med termer och villkor. Där varje rad representerar ett villkor och varje villkor kan ha olika underdelar. Varje del visas i en separat kolumn.
- Dynamiska tabeller: Med layoutfragment kan du binda en dynamisk tabells fält till DDE-samlingar. Vid tidpunkten för teckengenereringstabellen genereras rader enligt storleken på DDE:er för samlingar.
Dvd:n har ett samlingselement Nominee_details som har ett sammansatt element med tre primitiva element: Nominee_name, Nominee_address och Nominee_kön.
Den dynamiska XDP-filen har också samma rubriker. Du kan mappa de dynamiska XDP-fälten med de ovannämnda fälten i DD.
Exempel med exempelfiler: Använda statiska och dynamiska tabeller i en bokstav examplewithsamplefiles
I det här exemplet visas hur du kan skapa en dynamisk och statisk tabell, binda den dynamiska tabellen till DDE:er och sedan skapa en bokstav som innehåller de två tabellerna. När du arbetar med det här exemplet kan du antingen skapa filer från grunden eller använda indatafilerna som anges i stegen.
-
Skapa en dataordlista (DD) som du vill använda i exemplet, så som den visas i bilden.
Välj sedan DD och exportera exempeldata. XML-filen som du hämtar innehåller medarbetardata och tre instanser för Nominee_details (som standard hämtas 3 instanser. Du kan lägga till eller ta bort efter behov). Uppdatera värdena och importera sedan testdata i DD. CMP-filen är paketet och innehåller DD. Importera DD till Correspondence Management.
Mer information om hur du arbetar med dataordlista och testdata finns i Dataordlista.
-
I Designer skapar du två XDP-filer (layoutfragment): en dynamisk tabell och en statisk tabell. För båda layouterna:
- Lägg till delformulär i tabellkolumnen. Se till att du ändrar layouten för tabellens överordnade delformulär till flödande och tar bort bindningarna för delformuläret i tabellen.
- Lägg till ett delformulär i tabellcellen. Se till att du ändrar layouten för tabellens överordnade delformulär till flödande och tar bort bindningarna för delformuläret i tabellen.
Eller använd de statiska och dynamiska XDP:er som är bifogade med det här steget.
Mer information om hur du arbetar med layoutfragment finns i Layoutfragment.
Mer information om att utforma layouter finns i hjälpen för Designer.
-
Överför XDP:er till AEM Forms.
-
Skapa ett layoutfragment baserat på den dynamiska XDP-filen. Egenskapernas flik Tabell visar att tabellen är dynamisk (fältet Konfiguration för). Antalet rader (1) och kolumner (3) härleds från XDP-/layoutfragmentet.
Den här layoutens fält är senare bundna till den importerade DD-filen och i bokstaven skapas antalet rader dynamiskt baserat på antalet poster i testdatafilen (XML-datafilen som bifogas med DD-filen).
Klicka för att öppna fullstor bild
-
Skapa ett layoutfragment baserat på den statiska XDP-filen. Egenskapernas flik Tabell visar att tabellen är statisk (fältet Konfiguration för). Antalet rader (1) och kolumner (3) härleds från XDP-/layoutfragmentet.
Du kan ändra antalet kolumner och rader här. Beroende på vad du väljer på den här skärmen förblir antalet rader och kolumner i en statisk tabell fast i den bokstav som skapas med den här layouten.
-
Skapa ett brev med hjälp av båda layoutfragmenten i det. När du infogar den dynamiska XDP-filen i brevet anger du bindningen av fälten till datamappningslexikonets samlingselement.
Mer information om hur du skapar bokstavs- och brevmallar finns i Skapa brev.
-
Spara brevet och förhandsgranska det. När du förhandsgranskar bokstaven visas värdena från datamordlistan i bokstaven. För den dynamiska tabellen finns det tre rader. Detta beror på att testdata har tre poster för de här raderna.
För den statiska tabellen finns det så många rader och kolumner som du angav när du skapade layoutfragmentet.
För den dynamiska tabellen visas de tre raderna enligt antalet poster i testdatafilen. Detta inträffade eftersom du när du lade till layouten till brevet skapade en bindning mellan den dynamiska tabellens fält och dataglexikonets samlingselement. Värdena Namn, Adress och Kön fylls i från den testdatafil som du använde.
Skapa en kopia av ett dokumentfragment create-a-copy-of-a-document-fragment
Om du snabbt vill skapa ett dokumentfragment med egenskaper och innehåll som liknar ett befintligt dokumentfragment kan du kopiera och klistra in det.
- Välj ett eller flera dokumentfragment i listan med dokumentfragment. Gränssnittet visar ikonen Kopiera.
- Välj Kopiera. Gränssnittet visar ikonen Klistra in. Du kan också välja att gå in i en mapp innan du klistrar in. Olika mappar kan innehålla resurser med samma namn. Mer information om mappar finns i Mappar och ordna resurser.
- Välj Klistra in. Dialogrutan Klistra in visas. Om du kopierar och klistrar in dokumentfragmenten på samma plats, tilldelas namn och titlar automatiskt till de nya kopiorna av bokstäverna, men du kan redigera bokstävernas namn.
- Om det behövs redigerar du titeln och namnet som du vill spara kopian av dokumentfragmentet med.
- Välj Klistra in. Kopian av dokumentfragmentet skapas.