v7 v8

Moduli di input

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

Il documento XML di un modulo di input deve contenere <form> elemento principale con nome e namespace attributi 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 nel entity-schema attributo del <form> elemento.

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 <form> elemento principale.

Un controllo di modifica viene immesso in un <input> elemento con xpath attributo 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"
  • capitolo/@title: seleziona l’attributo "title" sotto il <chapter> elemento
  • …/@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.

ATTENZIONE

Il modulo di input deve fare riferimento a type="contentForm" attributo su <form> per aggiungere automaticamente il frame richiesto per l'immissione del contenuto.

Formattazione

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

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

Elenco colonne

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 type="list" e il percorso dell'elenco deve fare riferimento all'elemento collection.

Le colonne sono dichiarate dall'elemento figlio <input> elementi dell'elenco.

NOTA

Le frecce di ordinamento verso l'alto e verso il basso vengono aggiunte automaticamente quando ordered="true" l'attributo 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>

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

NOTA

Per non visualizzare l'etichetta dell'elemento di raccolta a sinistra del controllo, aggiungere nolabel="true" attributo.

Ingrandire un elenco

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 <form> sotto l'elemento elenco. La sua struttura è identica a quella di un modulo di input.

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

NOTA

Aggiunta di zoomOnAdd="true" attribute forza la chiamata del modulo di modifica all’inserimento di un elemento dell’elenco.

Elenco schede

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 type="notebooklist" e il percorso dell'elenco deve fare riferimento all'elemento collection.

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

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

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

NOTA

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

Contenitori

I contenitori consentono di raggruppare un insieme di controlli. Esistono tramite <container> elemento. 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

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

Il Preview Questa scheda consente di visualizzare il modulo di input:

Ulteriori informazioni su modifica di moduli e struttura del modulo.

In questa pagina