Struttura dello schema schema-structure

La struttura di base di <srcschema> è la seguente:

<srcSchema>
    <enumeration>
        ...          //definition of enumerations
    </enumeration>

    <element>         //definition of the root <element>    (mandatory)

        <compute-string/>  //definition of a compute-string
        <key>
            ...        //definition of keys
        </key>
        <sysFilter>
            ...           //definition of filters
        </sysFilter>
        <attribute>
            ...             //definition of fields
        </attribute>

            <element>           //definition of sub-<element>
                  <attribute>           //(collection, links or XML)
                  ...                         //and additional fields
                  </attribute>
                ...
            </element>

    </element>

        <methods>                 //definition of SOAP methods
            <method>
                ...
            </method>
            ...
    </methods>

</srcSchema>

Il documento XML di uno schema dati deve contenere l'elemento principale <srcschema> con gli attributi name e namespace per popolare il nome dello schema e il relativo spazio dei nomi.

<srcSchema name="schema_name" namespace="namespace">
...
</srcSchema>

Per illustrare la struttura di uno schema di dati, utilizziamo i seguenti contenuti XML:

<recipient email="John.doe@aol.com" created="AAAA/DD/MM" gender="1">
  <location city="London"/>
</recipient>

Con lo schema di dati corrispondente:

<srcSchema name="recipient" namespace="cus">
  <element name="recipient">
    <attribute name="email"/>
    <attribute name="created"/>
    <attribute name="gender"/>
    <element name="location">
      <attribute name="city"/>
   </element>
  </element>
</srcSchema>

Descrizione description

Il punto di ingresso dello schema è il suo elemento principale. È facile da identificare perché ha lo stesso nome dello schema e dovrebbe essere l’elemento secondario dell’elemento principale. La descrizione del contenuto inizia con questo elemento.

Nel nostro esempio, l’elemento principale è rappresentato dalla seguente riga:

<element name="recipient">

Gli elementi <attribute> e <element> che seguono l'elemento principale consentono di definire le posizioni e i nomi degli elementi dati nella struttura XML.

Nello schema di esempio, questi sono:

<attribute name="email"/>
<attribute name="created"/>
<attribute name="gender"/>
<element name="location">
  <attribute name="city"/>
</element>

Devono essere rispettate le seguenti regole:

Tipi di dati data-types

Il tipo di dati viene immesso tramite l'attributo type negli elementi <attribute> e <element>.

Un elenco dettagliato è disponibile nella documentazione di Campaign Classic v7.

Quando questo attributo non viene popolato, stringa è il tipo di dati predefinito a meno che l'elemento non contenga elementi figlio. In caso affermativo, viene utilizzato solo per strutturare gli elementi in modo gerarchico (<location> elemento nel nostro esempio).

Negli schemi sono supportati i seguenti tipi di dati:

Di seguito è riportato uno schema di esempio con i tipi immessi:

<srcSchema name="recipient" namespace="cus">
  <element name="recipient">
    <attribute name="email" type="string" length="80"/>
    <attribute name="created" type="datetime"/>
    <attribute name="gender" type="byte"/>
    <element name="location">
      <attribute name="city" type="string" length="50"/>
   </element>
  </element>
</srcSchema>

Properties properties

Gli elementi <elements> e <attributes> dello schema dati possono essere arricchiti con varie proprietà. Puoi popolare un’etichetta per descrivere l’elemento corrente.

Etichette e descrizioni labels-and-descriptions

Valori predefiniti default-values

La proprietà default consente di definire un'espressione che restituisce un valore predefinito durante la creazione del contenuto.

Il valore deve essere un'espressione compatibile con il linguaggio XPath. Per ulteriori informazioni al riguardo, consulta questa sezione.

Esempio:

Per collegare un valore predefinito a un campo, è possibile utilizzare <default> or <sqldefault> field. </sqldefault> </default>

<default> : consente di precompilare il campo con un valore predefinito durante la creazione di entità. Il valore non sarà un valore SQL predefinito.

<sqldefault> : ti consente di avere un valore aggiunto durante la creazione di un campo. Questo valore viene visualizzato come risultato SQL. Durante un aggiornamento dello schema, questo valore influisce solo sui nuovi record.

Enumerazioni enumerations

Enumerazione gratuita free-enumeration

La proprietà userEnum consente di definire un'enumerazione gratuita per memorizzare e visualizzare i valori immessi tramite questo campo. La sintassi è la seguente:

userEnum="nome dell'enumerazione"

Il nome assegnato all’enumerazione può essere scelto liberamente e condiviso con altri campi.

Questi valori vengono visualizzati in un elenco a discesa dal modulo di input:

Imposta enumerazione set-enumeration

La proprietà enum consente di definire un'enumerazione fissa utilizzata quando l'elenco dei valori possibili è noto in anticipo.

L'attributo enum fa riferimento alla definizione di una classe di enumerazione popolata nello schema al di fuori dell'elemento principale.

Le enumerazioni consentono di selezionare un valore da un elenco a discesa anziché immetterlo in un campo di input regolare:

Esempio di dichiarazione di enumerazione nello schema dati:

<enumeration name="gender" basetype="byte" default="0">
  <value name="unknown" label="Not specified" value="0"/>
  <value name="male" label="male" value="1"/>
  <value name="female" label="female" value="2"/>
</enumeration>

Enumerazione dichiarata all'esterno dell'elemento principale tramite l'elemento <enumeration>.

Le proprietà di enumerazione sono le seguenti:

I valori di enumerazione sono dichiarati nell'elemento <value> con i seguenti attributi:

enumerazione del dbenum dbenum-enumeration

Esempio example

Di seguito è riportato uno schema di esempio con le proprietà compilate:

<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="Email of recipient"/>
    <attribute name="created" type="datetime" label="Date of creation" default="GetDate()"/>
    <attribute name="gender" type="byte" label="gender" enum="gender"/>
    <element name="location" label="Location">
      <attribute name="city" type="string" length="50" label="City" userEnum="city"/>
   </element>
  </element>
</srcSchema>

Raccolte collections

Una raccolta è un elenco di elementi con lo stesso nome e lo stesso livello gerarchico.

L'attributo unbound con valore "true" consente di popolare un elemento della raccolta.

Esempio: definizione dell'elemento di raccolta <group> nello schema.

<element name="group" unbound="true" label="List of groups">
  <attribute name="label" type="string" label="Label"/>
</element>

Con la proiezione del contenuto XML:

<group label="Group1"/>
<group label="Group2"/>

Riferimento con XPath reference-with-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 "@".

Esempio:

È inoltre possibile definire espressioni complesse, ad esempio le seguenti operazioni aritmetiche:

Sono state aggiunte funzioni di alto livello alle espressioni per arricchire il potenziale di questo linguaggio.

Puoi accedere all’elenco delle funzioni disponibili tramite qualsiasi editor di espressioni nella console client di Adobe Campaign:

Esempio:

Creazione di una stringa tramite la stringa di calcolo building-a-string-via-the-compute-string

Una stringa di calcolo è un'espressione XPath utilizzata per creare una stringa che rappresenta un record in una tabella associata allo schema. La stringa di calcolo viene utilizzata principalmente nell'interfaccia grafica per visualizzare l'etichetta di un record selezionato.

La stringa di calcolo è definita tramite l'elemento <compute-string> nell'elemento principale dello schema dati. Un attributo expr contiene un'espressione XPath per calcolare la visualizzazione.

Esempio: stringa di calcolo della tabella dei destinatari.

<srcSchema name="recipient" namespace="nms">
  <element name="recipient">
    <compute-string expr="@lastName + ' ' + @firstName +' (' + @email + ')' "/>
    ...
  </element>
</srcSchema>

Risultato della stringa calcolata per un destinatario: Fai John (john.doe@aol.com)