Moduli di input

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

Forms è descritto in questa sezione.

Struttura di un modulo

Il documento XML di un modulo di input deve contenere gli attributi <form> root con gli attributi name e namespace rispettivamente per compilare 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 nomi. Per associare un modulo con 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 <form> principale.

Un controllo di modifica viene immesso in un elemento <input> con l'attributo xpath contenente il percorso del campo nello schema.

Promemoria relativa 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 indicati dal nome e gli attributi sono designati dal nome preceduto dal carattere "@".

Esempi:

  • @date: seleziona l'attributo con il nome "date"
  • capitolo/@title: seleziona l'attributo "title" sotto l' <chapter> elemento
  • …/@date: seleziona la data dall'elemento padre dell'elemento corrente

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

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

ATTENZIONE

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

Formattazione

La disposizione dei controlli è simile a quella utilizzata nelle tabelle HTML, con la possibilità di dividere un controllo in più colonne, di elementi di interlacciamento o di specificare l'occupazione dello spazio disponibile. Tenere presente, tuttavia, che la formattazione autorizza solo la distribuzione delle proporzioni; non è possibile specificare dimensioni fisse per un oggetto.

Per ulteriori informazioni al riguardo, consulta questa sezione.

Controlli del tipo di elenco

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

Elenco colonne

Questo controllo visualizza un elenco di colonne modificabili 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.

NOTA

Le frecce di ordinamento verso l'alto e il basso vengono aggiunte automaticamente quando l'attributo ordered="true" viene completato per l'elemento di raccolta nello schema di 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.

NOTA

Per evitare che l'etichetta dell'elemento di raccolta venga visualizzata a sinistra del controllo, aggiungere l'attributo nolabel="true".

Zoom in un elenco

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

I moduli di modifica negli elenchi vengono utilizzati nei casi seguenti:

  • Per semplificare l'immissione delle informazioni,
  • Presenza di un controllo a più linee,
  • Le colonne nell'elenco contengono solo i campi principali e il modulo visualizza tutti i campi dell'elemento 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 elenco. La sua struttura è identica alla struttura di un modulo di input.

Un pulsante Detail viene aggiunto automaticamente quando l'attributo zoom="true" viene immesso nella definizione dell'elenco. Questo consente di aprire il modulo di modifica sulla riga selezionata.

NOTA

Se si aggiunge l'attributo zoomOnAdd="true", il modulo di modifica viene chiamato all'inserimento di un elemento dell'elenco.

Elenco tabulazioni

Questo elenco presenta la modifica degli elementi della 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="blocco appunti" 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 sotto un elemento <container> secondario 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 l'attributo ordered="true" viene popolato per l'elemento di raccolta nello schema dati.

Contenitori

I contenitori consentono di raggruppare un set di controlli. Esistono tramite l'elemento <container>. Sono già stati utilizzati per formattare i controlli in più colonne e per controllare l'elenco delle schede.

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

Modifica dei moduli

La zona di modifica consente di inserire il contenuto XML del modulo di input:

La scheda Preview consente di visualizzare il modulo di input:

In questa pagina

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now