[Applicabile anche a v8]{class="badge positive" title="Applicabile anche a Campaign v8"}

Moduli di input input-forms

Di seguito sono riportati alcuni principi generali relativi all’utilizzo dei moduli di input in Adobe Campaign.

Forms sono descritti in questa sezione.

Struttura di un modulo form-structure

Il documento XML di un modulo di input deve contenere l'elemento principale <form> con gli attributi name e namespace per compilare rispettivamente il nome del modulo e il relativo spazio dei nomi.

<form name="form_name" namespace="name_space">
…
</form>

Per impostazione predefinita, un modulo è associato allo schema dati con lo stesso nome e lo stesso spazio dei nomi. Per associare un modulo a un nome diverso, immettere la chiave dello schema nell'attributo entity-schema dell'elemento <form>.

Per illustrare la struttura di un modulo di input, descriviamo un’interfaccia basata sullo schema di esempio "cus:book":

Questo è il modulo di input corrispondente:

<form name="book" namespace="cus" type="contentForm">
  <input xpath="@name"/>
  <input xpath="@date"/>
  <input xpath="@language"/>
</form>

La descrizione degli elementi di modifica inizia con l'elemento principale <form>.

È stato immesso un controllo di modifica in un elemento <input> con l'attributo xpath contenente il percorso del campo nel relativo schema.

Promemoria relativo alla sintassi XPath:

Il linguaggio XPath viene utilizzato in Adobe Campaign per fare riferimento a un elemento o attributo appartenente a uno schema di dati.

XPath è una sintassi che consente di individuare un nodo nella struttura di un documento XML.

Gli elementi sono designati dal loro nome e gli attributi sono designati dal nome preceduto dal carattere "@".

Esempi:

  • @date: seleziona l'attributo denominato "date"
  • chapter/@title: seleziona l'attributo "title" nell'elemento <chapter>
  • …/@date: seleziona la data dall'elemento padre dell'elemento corrente

Il controllo di modifica si adatta automaticamente al tipo di dati corrispondente e utilizza l'etichetta definita nello schema.

Per impostazione predefinita, ogni campo viene visualizzato su una riga e occupa tutto lo spazio disponibile, a seconda del tipo di dati.

CAUTION
Il modulo di input deve fare riferimento a un attributo type="contentForm" nell'elemento <form> per aggiungere automaticamente il frame necessario per l'input del contenuto.

Formattazione formatting

La disposizione dei controlli l'uno rispetto all'altro è simile alla disposizione utilizzata nelle tabelle HTML, con la possibilità di dividere un controllo in più colonne, di elementi interlacciati o di specificare l'occupazione dello spazio disponibile. Tenete presente, tuttavia, che la formattazione autorizza solo la distribuzione delle proporzioni; non potete specificare dimensioni fisse per un oggetto.

Per ulteriori informazioni al riguardo, consulta questa sezione.

Controlli del tipo di elenco list-type-controls

Per modificare un elemento della raccolta, è necessario utilizzare un controllo di tipo elenco.

Elenco colonne column-list

Questo controllo visualizza un elenco di colonne modificabile con una barra degli strumenti contenente i pulsanti Aggiungi ed Elimina.

<input xpath="chapter" type="list">
  <input xpath="@name"/>
  <input xpath="@number"/>
</input>

Il controllo elenco deve essere compilato con l'attributo type="list" e il percorso dell'elenco deve fare riferimento all'elemento della raccolta.

Le colonne sono dichiarate dagli elementi secondari <input> dell'elenco.

NOTE
Le frecce di ordinamento verso l'alto e verso il basso vengono aggiunte automaticamente quando l'attributo ordered="true" viene completato per l'elemento di raccolta nello schema dati.

Per impostazione predefinita, i pulsanti della barra degli strumenti sono allineati verticalmente. Possono anche essere allineati orizzontalmente:

<input nolabel="true" toolbarCaption="List of chapters" type="list" xpath="chapter">
  <input xpath="@name"/>
  <input xpath="@number"/>
</input>

L'attributo toolbarCaption forza l'allineamento orizzontale della barra degli strumenti e compila il titolo sopra l'elenco.

NOTE
Affinché l'etichetta dell'elemento di raccolta non venga visualizzata a sinistra del controllo, aggiungere l'attributo nolabel="true".

Ingrandire un elenco zoom-in-a-list

L'inserimento e la modifica dei dati dell'elenco possono essere eseguiti in un modulo di modifica separato.

I moduli di modifica all’interno di elenchi vengono utilizzati nei casi seguenti:

  • Per semplificare l'immissione delle informazioni,
  • presenza di un controllo su più righe,
  • Le colonne dell'elenco contengono solo i campi principali e nel modulo vengono visualizzati tutti i campi dell'elemento di raccolta.

<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>

La definizione del modulo di modifica viene specificata tramite l'elemento <form> sotto l'elemento list. La sua struttura è identica a quella di un modulo di input.

Un pulsante Detail viene aggiunto automaticamente quando l'attributo zoom="true" viene inserito nella definizione dell'elenco. In questo modo è possibile aprire il modulo di modifica sulla riga selezionata.

NOTE
L'aggiunta dell'attributo zoomOnAdd="true" impone la chiamata del modulo di modifica all'inserimento di un elemento dell'elenco.

Elenco schede tab-list

Questo elenco presenta la modifica degli elementi di raccolta sotto forma di schede.

<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>

Il controllo elenco deve essere compilato con l'attributo type="notebooklist" e il percorso dell'elenco deve fare riferimento all'elemento della raccolta.

Il titolo della scheda contiene il valore dei dati immessi tramite l'attributo xpath-label.

I controlli di modifica devono essere dichiarati in un elemento <container> figlio del controllo elenco.

Utilizzare i pulsanti della barra degli strumenti per aggiungere o eliminare elementi dell'elenco.

NOTE
Le frecce di ordinamento a sinistra e a destra vengono aggiunte automaticamente quando l'attributo ordered="true" viene popolato per l'elemento di raccolta nello schema dati.

Contenitori containers

I contenitori consentono di raggruppare un insieme di controlli. Esistono tramite l'elemento <container>. Sono già stati utilizzati per formattare i controlli in diverse colonne e per il controllo dell'elenco di schede.

Per ulteriori informazioni sui contenitori e su come utilizzarli nei moduli di input, consulta questa sezione.

Modifica dei moduli editing-forms

L'area di modifica consente di immettere il contenuto XML del modulo di input:

La scheda Preview consente di visualizzare il modulo di input:

Ulteriori informazioni sulla modifica dei moduli e sulla struttura del modulo.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1