[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 <form> rotelementet med name och namespace attribut 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 schematangenten i dialogrutan enhetstabell attributet för <form> -element.

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 <form> rotelement.

En redigeringskontroll anges i en <input> -elementet med xpath attribut 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:

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.

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 type="list" och listans sökväg måste referera till samlingselementet.

Kolumnerna deklareras av det underordnade objektet <input> -element 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>

The toolbarCaption -attributet framtvingar 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:

<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 <form> -element under listelementet. Dess struktur är identisk med strukturen för ett indataformulär.

A Detail knappen läggs till automatiskt när zoom="true" -attributet 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 type="notebooklist" och listans sökväg måste referera till samlingselementet.

Flikens rubrik innehåller värdet på de data som anges via xpath-label -attribut.

Redigeringskontrollerna måste deklareras under en <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 <container> -element. 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:

The Preview kan du visa indataformuläret:

Läs mer om redigera formulär och formulärstruktur.