Introduzione ai moduli di input gs-ac-forms

Quando si crea o si estende uno schema, è necessario creare o modificare i moduli di input associati per rendere tali modifiche visibili agli utenti finali.

Un modulo di input consente di modificare un’istanza associata a uno schema di dati dalla console client di Adobe Campaign. Il modulo è identificato dal nome e dallo spazio dei nomi.

La chiave di identificazione di un modulo è una stringa costituita dallo spazio dei nomi e dal nome separato da due punti, ad esempio: "cus:contact".

Modifica moduli di input

Creare e configurare moduli di input da Administration> Configuration >Input forms cartella della console client:

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

L’anteprima genera una visualizzazione del modulo di input:

Struttura di un modulo

La descrizione di un modulo è un documento XML strutturato che osserva la grammatica dello schema del modulo xtk:form.

Il documento XML del modulo di input deve contenere <form> elemento principale con nome e namespace attributi per compilare il nome del modulo e lo 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, impostare entity-schema attributo del <form> al nome della chiave dello schema. Per illustrare la struttura di un modulo di input, descriviamo un’interfaccia utilizzando lo schema di esempio "cus:recipient":

<srcSchema name="recipient" namespace="cus">
  <enumeration name="gender" basetype="byte">
    <value name="unknown" label="Not specified" value="0"/>
    <value name="male" label="Male" value="1"/>
    <value name="female" label="Female" value="2"/>
  </enumeration>

  <element name="recipient">
    <attribute name="email" type="string" length="80" label="Email" desc="E-mail address of recipient"/>
    <attribute name="birthDate" type="datetime" label="Date"/>
    <attribute name="gender" type="byte" label="Gender" enum="gender"/>
  </element>
</srcSchema>

Il modulo di input basato sullo schema di esempio:

<form name="recipient" namespace="cus">
  <input xpath="@gender"/>
  <input xpath="@birthDate"/>
  <input xpath="@email"/>
</form>

La descrizione dei controlli di modifica inizia da <form> elemento principale. Un controllo di modifica viene immesso in un <input> elemento con xpath attributo contenente il percorso del campo nel relativo schema.

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 sola riga e occupa tutto lo spazio disponibile a seconda del tipo di dati.

Tutti gli attributi del modulo sono elencati in Documentazione di Campaign Classic v7.

Formattazione formatting

Il layout dei controlli è simile al layout utilizzato nelle tabelle HTML, con la possibilità di dividere un controllo in più colonne, di interlacciare elementi o di specificare l'occupazione dello spazio disponibile. Tenete presente, tuttavia, che la formattazione consente di dividere l'area solo per le proporzioni; non è possibile specificare dimensioni fisse per un oggetto.

Per visualizzare i controlli dell'esempio precedente in due colonne:

<form name="recipient" namespace="cus">
  <container colcount="2">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email"/>
  </container>
</form>

Il <container> elemento con colcount attributo consente di forzare la visualizzazione dei controlli figlio in due colonne.

Il colspan in un controllo estende il controllo in base al numero di colonne immesse nel relativo valore:

<form name="recipient" namespace="cus">
  <container colcount="2">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
</form>

Compilando il type="frame" , il contenitore aggiunge una cornice intorno ai controlli figlio con l'etichetta contenuta nel etichetta attributo:

<form name="recipient" namespace="cus">
  <container colcount="2" type="frame" label="General">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
</form>

A <static> può essere utilizzato per formattare il modulo di input:

<form name="recipient" namespace="cus">
  <static type="separator" colspan="2" label="General"/>
  <input xpath="@gender"/>
  <input xpath="@birthDate"/>
  <input xpath="@email" colspan="2"/>
  <static type="help" label="General information about recipient with date of birth, gender, and e-mail address." colspan="2"/>
</form>

Il <static> tag con separatore tipo consente di aggiungere una barra di separazione con un'etichetta contenuta nel etichetta attributo.

È stato aggiunto un testo della guida utilizzando <static> tag con tipo di guida. Il contenuto del testo viene immesso nel etichetta attributo.

Utilizzare i contenitori containers

Utilizzare container per raggruppare un insieme di controlli. Essi sono rappresentati dal <container> elemento. Sono stati utilizzati in precedenza per formattare i controlli su più colonne.

Il xpath attributo su una <container> consente di semplificare il riferimento ai controlli figlio. Il riferimento dei controlli viene quindi relativo al padre <container> principale.

Esempio di contenitore senza "xpath":

<container colcount="2">
  <input xpath="location/@zipCode"/>
  <input xpath="location/@city"/>
</container>

Esempio con l’aggiunta di "xpath" all’elemento denominato "location":

<container colcount="2" xpath="location">
  <input xpath="@zipCode"/>
  <input xpath="@city"/>
</container>

I contenitori vengono utilizzati per creare controlli complessi utilizzando un set di campi formattati nelle pagine.

Aggiungi schede (blocco appunti) tab-container

Utilizza un notebook contenitore per formattare i dati nelle pagine accessibili dalle schede.

<container type="notebook">
  <container colcount="2" label="General">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
  <container colcount="2" label="Location">
    ...
  </container>
</container>

Il contenitore principale è definito da type="notebook" attributo. Le schede vengono dichiarate nei contenitori figlio e l’etichetta delle schede viene compilata dalla sezione etichetta attributo.

Aggiungi il style="down" per forzare il posizionamento verticale delle etichette di tabulazione sotto il controllo. Questo attributo è facoltativo. Il valore predefinito è "su".

<container style="down" type="notebook"> ... </container>

Aggiungi icone (iconbox) icon-list

Utilizza questo contenitore per visualizzare una barra di icone verticale che consente di selezionare le pagine da visualizzare.

<container type="iconbox">
  <container colcount="2" label="General" img="xtk:properties.png">
    <input xpath="@gender"/>
    <input xpath="@birthDate"/>
    <input xpath="@email" colspan="2"/>
  </container>
  <container colcount="2" label="Location" img="nms:msgfolder.png">
    ...
  </container>
</container>

Il contenitore principale è definito da type="iconbox" attributo. Le pagine associate alle icone vengono dichiarate nei contenitori figlio. L’etichetta delle icone viene compilata dal file etichetta attributo.

L’icona di una pagina viene compilata dalla sezione img="<image>" attributo, dove <image> è il nome dell’immagine corrispondente alla sua chiave composta dal nome e dallo spazio dei nomi (ad esempio, "xtk:properties.png").

Le immagini sono disponibili nella sezione Administration > Configuration > Images nodo.

Nascondi contenitori (visibleGroup) visibility-container

È possibile nascondere un insieme di controlli tramite una condizione dinamica.

Questo esempio illustra la visibilità dei controlli sul valore del campo "Gender":

<container type="visibleGroup" visibleIf="@gender=1">
  ...
</container>
<container type="visibleGroup" visibleIf="@gender=2">
  ...
</container>

Un contenitore di visibilità è definito dall'attributo type="visibleGroup". Il visibleIf contiene la condizione di visibilità.

Esempi di sintassi delle condizioni:

Visualizzazione condizionale (enabledGroup) enabling-container

Questo contenitore ti consente di abilitare o disabilitare un set di dati da una condizione dinamica. La disattivazione di un controllo ne impedisce la modifica. L’esempio seguente illustra l’abilitazione dei controlli dal valore del campo "Genere":

<container type="enabledGroup" enabledIf="@gender=1">
  ...
</container>
<container type="enabledGroup" enabledIf="@gender=2">
  ...
</container>

Un contenitore di abilitazione è definito da type="enabledGroup" attributo. Il enabledIf contiene la condizione di attivazione.

Modificare un collegamento editing-a-link

Ricorda che un collegamento viene dichiarato nello schema di dati come segue:

<element label="Company" name="company" target="cus:company" type="link"/>

Il controllo di modifica del collegamento nel relativo modulo di input è il seguente:

<input xpath="company"/>

La selezione del target è accessibile tramite il campo di modifica. L'immissione è assistita dal completamento automatico in modo che un elemento di destinazione possa essere facilmente trovato dai primi caratteri immessi. La ricerca si basa quindi sul Stringa di calcolo definito nello schema di destinazione. Se lo schema non esiste dopo la convalida nel controllo, viene visualizzato un messaggio di conferma della creazione immediata del target. La conferma crea un nuovo record nella tabella di destinazione e lo associa al collegamento.

Viene utilizzato un elenco a discesa per selezionare un elemento di destinazione dall’elenco di record già creato.

Il Modify the link (cartella) avvia un modulo di selezione con l’elenco degli elementi target e un’area filtro.

Il Edit link (lente di ingrandimento) avvia il modulo di modifica dell’elemento collegato. Il modulo utilizzato viene dedotto per impostazione predefinita sulla chiave dello schema di destinazione. Il modulo attribute consente di forzare il nome del modulo di modifica (ad esempio, "cus:company2").

Puoi limitare la scelta degli elementi target aggiungendo il <sysfilter> dalla definizione del collegamento nel modulo di input:

<input xpath="company">
  <sysFilter>
    <condition expr="[location/@city] =  'Newton"/>
  </sysFilter>
</input>

Puoi anche ordinare l’elenco con <orderby> elemento:

<input xpath="company">
  <orderBy>
    <node expr="[location/@zipCode]"/>
  </orderBy>
</input>

Proprietà controllo control-properties

Aggiungi un elenco di collegamenti (non associati) list-of-links

Un collegamento immesso nello schema dati come elemento di raccolta (unbound="true") deve scorrere un elenco per visualizzare tutti gli elementi associati.

Il principio consiste nella visualizzazione dell’elenco degli elementi collegati con caricamento dei dati ottimizzato (download per batch di dati, esecuzione dell’elenco solo se è visibile).

Esempio di un collegamento di raccolta in uno schema:

<element label="Events" name="rcpEvent" target="cus:event" type="link" unbound="true">
...
</element>

L’elenco nella sua forma di input:

 <input xpath="rcpEvent" type="linklist">
  <input xpath="@label"/>
  <input xpath="@date"/>
</input>

Il controllo elenco è definito da type="linklist" attributo. Il percorso dell’elenco deve fare riferimento al collegamento della raccolta.

Le colonne vengono dichiarate tramite <input> elementi dell'elenco. Il xpath l'attributo fa riferimento al percorso del campo nello schema di destinazione.

Una barra degli strumenti con un’etichetta (definita sul collegamento nello schema) viene automaticamente posizionata sopra l’elenco.

L’elenco può essere filtrato tramite Filters e configurate per aggiungere e ordinare le colonne.

Il Add e Delete I pulsanti consentono di aggiungere ed eliminare elementi della raccolta sul collegamento. Per impostazione predefinita, l’aggiunta di un elemento avvia il modulo di modifica dello schema di destinazione.

Il Detail viene aggiunto automaticamente quando zoom="true" l'attributo è completato il <input> tag dell’elenco: ti consente di avviare il modulo di modifica della riga selezionata.

È possibile applicare filtri e ordinamenti durante il caricamento dell’elenco:

 <input xpath="rcpEvent" type="linklist">
  <input xpath="@label"/>
  <input xpath="@date"/>
  <sysFilter>
    <condition expr="@type = 1"/>
  </sysFilter>
  <orderBy>
    <node expr="@date" sortDesc="true"/>
  </orderBy>
</input>

Definire una tabella di relazioni relationship-table

Una tabella di relazione consente di collegare due tabelle con cardinalità N-N. La tabella delle relazioni contiene solo i collegamenti alle due tabelle.

L’aggiunta di un elemento all’elenco dovrebbe pertanto consentirti di completare un elenco da uno dei due collegamenti nella tabella delle relazioni.

Esempio di tabella di relazioni in uno schema:

<srcSchema name="subscription" namespace="cus">
  <element name="recipient" type="link" target="cus:recipient" label="Recipient"/>
  <element name="service" type="link" target="cus:service" label="Subscription service"/>
</srcSchema>

Nel nostro esempio, iniziamo con il modulo di input dello schema "cus:recipient". L’elenco deve visualizzare le associazioni con gli abbonamenti ai servizi e deve consentirti di aggiungere un abbonamento selezionando un servizio esistente.

<input type="linklist" xpath="subscription" xpathChoiceTarget="service" xpathEditTarget="service" zoom="true">
  <input xpath="recipient"/>
  <input xpath="service"/>
</input>

Il xpathChoiceTarget attributo consente di avviare un modulo di selezione dal collegamento inserito. La creazione del record della tabella delle relazioni aggiornerà automaticamente il collegamento al destinatario corrente e al servizio selezionato.

Proprietà elenco list-properties

Aggiungere un elenco di controlli memoria memory-list-controls

Gli elenchi di memoria consentono di modificare gli elementi della raccolta utilizzando il precaricamento dei dati dell’elenco. Questo elenco non può essere filtrato o configurato.

Questi elenchi vengono utilizzati su elementi di raccolta XML mappati o su collegamenti di volumi ridotti.

Aggiungere un elenco di colonne column-list

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

<input xpath="rcpEvent" type="list">
  <input xpath="@label"/>
  <input xpath="@date"/>
</input>

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

Le colonne vengono dichiarate nell'elemento figlio <input> dell’elenco. L’etichetta e la dimensione della colonna possono essere forzate con etichetta e colSize attributi.

I pulsanti della barra degli strumenti possono essere allineati orizzontalmente:

<input nolabel="true" toolbarCaption="List of events" type="list" xpath="rcpEvent" zoom="true">
  <input xpath="@label"/>
  <input xpath="@date"/>
</input>

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

Abilitare lo zoom avanti in un elenco zoom-in-a-list

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

<input nolabel="true" toolbarCaption="List of events" type="list" xpath="rcpEvent" zoom="true" zoomOnAdd="true">
  <input xpath="@label"/>
  <input xpath="@date"/>

  <form colcount="2" label="Event">
    <input xpath="@label"/>
    <input xpath="@date"/>
  </form>
</input>

Il modulo di modifica viene completato da <form> elemento nella definizione dell’elenco. La sua struttura è identica a quella di un modulo di input. Il Detail viene aggiunto automaticamente quando zoom="true" l'attributo è completato il <input> dell’elenco. Questo attributo consente di avviare il modulo di modifica della riga selezionata.

Proprietà elenco list-properties-1

Aggiungi campi non modificabili non-editable-fields

Per visualizzare un campo e impedirne la modifica, utilizzare <value> o completa il readOnly="true" attributo su <input> tag.

Esempio sul campo "Genere":

<value value="@gender"/>
<input xpath="@gender" readOnly="true"/>

Aggiungi pulsanti di scelta radio-button

Un pulsante di scelta consente di scegliere tra diverse opzioni. Il <input> i tag vengono utilizzati per elencare le opzioni possibili e le selectedValue attribute specifica il valore associato alla scelta.

Esempio sul campo "Genere":

<input type="RadioButton" xpath="@gender" checkedValue="0" label="Choice 1"/>
<input type="RadioButton" xpath="@gender" checkedValue="1" label="Choice 2"/>
<input type="RadioButton" xpath="@gender" checkedValue="2" label="Choice 3"/>

Aggiungi una casella di controllo checkbox

Una casella di controllo riflette uno stato booleano (selezionato o meno). Per impostazione predefinita, questo controllo viene utilizzato dai campi "booleani" (true/false). A questo pulsante può essere associata una variabile che assume un valore predefinito pari a 0 o 1. Questo valore può essere sovraccaricato tramite checkValue attributi.

<input xpath="@boolean1"/>
<input xpath="@field1" type="checkbox" checkedValue="Y"/>

Modifica gerarchia di navigazione navigation-hierarchy-edit

Questo controllo crea una struttura ad albero su un insieme di campi da modificare.

I controlli da modificare sono raggruppati in un <container> immessi in <input> tag del controllo struttura:

<input nolabel="true" type="treeEdit">
  <container label="Text fields">
    <input xpath="@text1"/>
    <input xpath="@text2"/>
  </container>
  <container label="Boolean fields">
    <input xpath="@boolean1"/>
    <input xpath="@boolean2"/>
  </container>
</input>

Aggiungere un campo espressione expression-field

Un campo espressione aggiorna dinamicamente un campo da un’espressione; il campo <input> viene utilizzato con un tag xpath per immettere il percorso del campo da aggiornare e un attributo espr attributo contenente l'espressione di aggiornamento.

<!-- Example: updating the boolean1 field from the value contained in the field with path /tmp/@flag -->
<input expr="Iif([/tmp/@flag]=='On', true, false)" type="expr" xpath="@boolean1"/>
<input expr="[/ignored/@action] == 'FCP'" type="expr" xpath="@launchFCP"/>

Contesto dei moduli context-of-forms

L'esecuzione di un modulo di input inizializza un documento XML contenente i dati dell'entità da modificare. Questo documento rappresenta il contesto del modulo e può essere utilizzato come area di lavoro.

Aggiornare il contesto updating-the-context

Per modificare il contesto del modulo, utilizzare <set expr="<value>" xpath="<field>"/> tag, dove <field> è il campo di destinazione, e <value> è l’espressione o il valore di aggiornamento.

Esempi di utilizzo del <set> tag:

È possibile aggiornare il contesto del modulo durante l'inizializzazione e la chiusura del modulo tramite <enter> e <leave> tag.

<form name="recipient" namespace="cus">
  <enter>
    <set...
  </enter>
  ...
  <leave>
    <set...
  </leave>
</form>

Linguaggio di espressione expression-language-

Nella definizione del modulo è possibile utilizzare un linguaggio macro per eseguire test condizionali.

Il <if expr="<expression>" /> Il tag esegue le istruzioni specificate nel tag se l’espressione viene verificata:

<if expr="([/tmp/@test] == 'Test' or @lastName != 'Doe') and @boolean2 == true">
  <set xpath="@boolean1" expr="true"/>
</if>

Il <check expr="<condition>" /> combinato con <error> impedisce la convalida del modulo e visualizza un messaggio di errore se la condizione non viene soddisfatta:

<leave>
  <check expr="/tmp/@test != ''">
    <error>You must populate the 'Test' field!</error>
  </check>
</leave>

Assistente (procedura guidata) wizards

Un assistente ti guida attraverso un set di passaggi di immissione dati sotto forma di pagine. I dati immessi vengono salvati al momento della convalida del modulo.

Per aggiungere un assistente, utilizza il seguente tipo di struttura:

<form type="wizard" name="example" namespace="cus" img="nms:rcpgroup32.png" label="Wizard example" entity-schema="nms:recipient">
  <container title="Title of page 1" desc="Long description of page 1">
    <input xpath="@lastName"/>
    <input xpath="comment"/>
  </container>
  <container title="Title of page 2" desc="Long description of page 2">
    ...
  </container>
  ...
</form>

La presenza del type="wizard" attributo su <form> consente di definire la modalità procedura guidata nella costruzione del modulo. Le pagine vengono completate da <container> elementi, che sono figli di <form> elemento. Il <container> L'elemento di una pagina viene compilato con gli attributi title per il titolo e desc per visualizzare la descrizione sotto il titolo della pagina. Il Previous e Next I pulsanti vengono aggiunti automaticamente per consentire la navigazione tra le pagine.

Il Finish consente di salvare i dati immessi e di chiudere il modulo.

Metodi SOAP soap-methods

L'esecuzione del metodo SOAP può essere avviata da un <leave> alla fine di una pagina.

Il <soapcall> Il tag contiene la chiamata per il metodo con i seguenti parametri di input:

<soapCall name="<name>" service="<schema>">
  <param type="<type>" exprIn="<xpath>"/>
  ...
</soapCall>

Il nome del servizio e il relativo schema di implementazione vengono immessi tramite nome e servizio attributi di <soapcall> tag.

I parametri di input sono descritti nella <param> elementi sotto <soapcall> tag.

Il tipo di parametro deve essere specificato tramite tipo attributo. I tipi possibili sono i seguenti:

Il exprIn contiene la posizione dei dati da passare come parametro.

Esempio:

<leave>
  <soapCall name="RegisterGroup" service="nms:recipient">
    <param type="DOMElement" exprIn="/tmp/entityList"/>
    <param type="DOMElement" exprIn="/tmp/choiceList"/>
    <param type="boolean"    exprIn="true"/>
  </soapCall>
</leave>