[Also applies to v8]{class="badge positive" title="Also applies to 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 (documentazione di Campaign v8).

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, viene descritta 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:

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.

Formattazione formatting

La disposizione dei controlli l’uno rispetto all’altro è simile alla disposizione utilizzata nelle tabelle di 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, consulta questa sezione (documentazione di Campaign v8).

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.

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.

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:

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

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.

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 (documentazione di Campaign v8).

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 (documentazione di Campaign v8).