[Gäller även för v8]{class="badge positive" title="Gäller även Campaign v8"}
Inmatningsformulär input-forms
Nedan följer några allmänna principer för användning av indataformulär i Adobe Campaign.
Forms beskrivs i det här avsnittet.
Formulärstruktur form-structure
XML-dokumentet i ett indataformulär måste innehålla rotelementet <form> med attributen name och namespace för att fylla i formulärnamnet och dess namnutrymme.
<form name="form_name" namespace="name_space">
…
</form>
Som standard är ett formulär associerat med dataschemat som har samma namn och namnutrymme. Om du vill associera ett formulär med ett annat namn anger du schemanyckeln i attributet entity-schema för elementet <form>.
För att illustrera strukturen för ett inmatningsformulär beskriver vi ett gränssnitt baserat på vårt exempelschema "cus:book":
Det här är motsvarande indataformulär:
<form name="book" namespace="cus" type="contentForm">
<input xpath="@name"/>
<input xpath="@date"/>
<input xpath="@language"/>
</form>
Beskrivningen av redigeringselementen börjar med rotelementet <form>.
En redigeringskontroll har angetts i ett <input>-element med attributet Path som innehåller sökvägen för fältet i dess schema.
Påminnelse gällande XPath-syntax:
XPath-språket används i Adobe Campaign för att referera till ett element eller attribut som tillhör ett dataschema.
XPath är en syntax som gör att du kan hitta en nod i trädet i ett XML-dokument.
Elementen anges med sitt namn och attributen anges med namnet före tecknet"@".
Exempel:
- @date: markerar attributet med namnet "date"
- kapitel/@title: markerar attributet "title" under elementet
<chapter> - …/@date: väljer datumet från det överordnade elementet för det aktuella elementet
Redigeringskontrollen anpassas automatiskt till motsvarande datatyp och använder den etikett som definierats i schemat.
Som standard visas varje fält på en rad och tar upp allt tillgängligt utrymme, beroende på datatypen.
<form> -elementet för att automatiskt lägga till den ram som krävs för att innehållet ska kunna anges.Formatering formatting
Ordningen på kontrollerna i förhållande till varandra ser ut som den ordning som används i HTML-tabeller, med möjlighet att dela upp en kontroll i flera kolumner, sammanflätningselement eller att ange hur tillgängligt utrymme ska användas. Tänk dock på att formatering endast tillåter fördelning av proportioner. Du kan inte ange fasta dimensioner för ett objekt.
Mer information om detta finns i det här avsnittet.
Kontroller för listtyp list-type-controls
Om du vill redigera ett samlingselement måste du använda en listtypskontroll.
Kolumnlista column-list
Den här kontrollen visar en redigerbar kolumnlista med ett verktygsfält som innehåller knapparna Lägg till och Ta bort.
<input xpath="chapter" type="list">
<input xpath="@name"/>
<input xpath="@number"/>
</input>
Listkontrollen måste fyllas i med attributet type="list" och sökvägen för listan måste referera till samlingselementet.
Kolumnerna deklareras av de underordnade <input> elementen i listan.
Som standard justeras verktygsfältsknapparna lodrätt. De kan också justeras vågrätt:
<input nolabel="true" toolbarCaption="List of chapters" type="list" xpath="chapter">
<input xpath="@name"/>
<input xpath="@number"/>
</input>
Attributet toolbarCaption tvingar fram vågrät justering av verktygsfältet och fyller i titeln ovanför listan.
Zooma in en lista zoom-in-a-list
Du kan infoga och redigera listdata i ett separat redigeringsformulär.
Redigera formulär i listor används i följande fall:
- För att underlätta inmatningen av information
- Förekomst av flerradskontroll,
- Kolumnerna i listan innehåller bara huvudfälten och formuläret visar alla fält i samlingselementet.
<input nolabel="true" toolbarCaption="List of chapters" type="list" xpath="chapter" zoom="true" zoomOnAdd="true">
<input xpath="@name"/>
<input xpath="@number"/>
<form colcount="2" label="Editing a chapter">
<input xpath="@name"/>
<input xpath="@number"/>
<input colspan="2" xpath="page"/>
</form>
</input>
Definitionen för redigeringsformuläret anges via elementet <form> under listelementet. Dess struktur är identisk med strukturen för ett indataformulär.
En Detail-knapp läggs till automatiskt när attributet zoom="true" anges i listdefinitionen. Då kan du öppna redigeringsformuläret på den markerade raden.
Fliklista tab-list
I den här listan visas redigeringen av samlingselement i form av flikar.
<container toolbarCaption="List of chapters" type="notebooklist" xpath="chapter" xpath-label="@name">
<container colcount="2">
<input xpath="@name"/>
<input xpath="@number"/>
<input colspan="2" xpath="page"/>
</container>
</container>
Listkontrollen måste fyllas i med attributet type="notebooklist" och listans sökväg måste referera till samlingselementet.
Flikens rubrik innehåller värdet på data som anges via attributet xpath-label .
Redigeringskontrollerna måste deklareras under ett <container>-element som är underordnat listkontrollen.
Använd verktygsfältsknapparna för att lägga till eller ta bort listelement.
Behållare containers
Med behållare kan du gruppera en uppsättning kontroller. De finns via elementet <container>. De har redan använts för att formatera kontroller i flera kolumner och för att styra tabblistan.
Mer information om behållare och hur du använder dem i indataformulär finns i det här avsnittet.
Redigera formulär editing-forms
I redigeringszonen kan du ange XML-innehållet i indataformuläret:
På fliken Preview kan du visa indataformuläret:
Läs mer om att redigera formulär och formulärstruktur.