[Applicabile anche a v8]{class="badge positive" title="Applicabile anche a Campaign v8"}
Utilizzare gli schemi di dati in Campaign data-schemas
Di seguito sono riportati alcuni principi generali relativi all’utilizzo degli schemi di dati in Adobe Campaign.
Per ulteriori informazioni sulla creazione e la configurazione di schemi di dati in Adobe Campaign, consulta questa sezione.
Struttura dello schema schema-structure
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>
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.
In uno schema di gestione dei contenuti, l’elemento principale è rappresentato dalla seguente riga:
<element name="book" template="ncm:content" xmlChildren="true">
L'attributo template immesso nell'elemento principale consente di estendere lo schema con proprietà generiche a tutte le definizioni di contenuto, ad esempio nome, data di creazione, autore, stringa associata e così via.
Queste proprietà sono descritte nello schema ncm:content.
Tipi di dati data-types
Di seguito è riportato un esempio di schema di gestione dei contenuti con i tipi compilati:
<srcSchema name="book" namespace="cus">
<element name="book" template="ncm:content" xmlChildren="true">
<attribute name="title" type="string"/>
<attribute name="date" type="date"/>
<attribute name="language" type="string"/>
<element name="chapter">
<attribute name="name" type="string"/>
<element name="page" type="string>
<attribute name="number" type="short"/>
</element>
</element>
</element>
</element>
Properties properties
È possibile utilizzare diverse proprietà per arricchire gli elementi <element> e <attribute> dello schema dati.
Le proprietà principali utilizzate nella gestione dei contenuti sono le seguenti:
- label: breve descrizione,
- desc: descrizione lunga,
- default: l'espressione restituisce un valore predefinito durante la creazione del contenuto,
- userEnum: enumerazione gratuita per archiviare e visualizzare i valori immessi tramite questo campo,
- enum: enumerazione fissa utilizzata quando l'elenco dei valori possibili è noto in anticipo.
Di seguito è riportato uno schema di esempio con le proprietà compilate:
<srcSchema name="book" namespace="cus">
<enumeration name="language" basetype="string" default="eng">
<value name="fra" label="French"/>
<value name="eng" label="English"/>
</enumeration>
<element name="book" label="Book" desc="Example book" template="ncm:content" xmlChildren="true">
<attribute name="title" type="string" label="Title" default="'New book'"/>
<attribute name="date" type="date" default="GetDate()"/>
<attribute name="language" type="string" label="Language" enum="language"/>
<element name="chapter" label="Chapter">
<attribute name="name" type="string" label="Name" desc="Name of chapter"/>
<element name="page" type="string" label="Page" desc="Page content">
<attribute name="number" type="short" label="Number" default="CounterValue('numPage')"/>
</element>
</element>
</element>
</srcSchema>
Elementi della raccolta collection-elements
Una raccolta è un elenco di elementi con lo stesso nome e lo stesso livello gerarchico.
Nel nostro esempio, gli elementi <chapter> e <page> sono elementi di raccolta. L'attributo unbound deve quindi essere aggiunto alla definizione di questi elementi:
<element name="chapter" label="Chapter" unbound="true" ordered="true">
<element name="page" type="string" label="Page" desc="Content of page" unbound="true">
Elemento con riferimento a element-referencing
Il riferimento agli elementi viene utilizzato in larga misura negli schemi di contenuto. Consente di fattorizzare la definizione di un elemento <element> in modo che sia possibile farvi riferimento in altri elementi con la stessa struttura.
L'attributo ref dell'elemento a cui fare riferimento deve essere completato con il percorso (XPath) dell'elemento di riferimento.
Esempio: aggiunta di una sezione Appendix con la stessa struttura dell'elemento <chapter> dello schema di esempio.
<srcSchema name="book" namespace="cus">
<element name="section">
<attribute name="name" type="string" label="Name" desc="Name"/>
<element name="page" type="string" label="Page" desc="Content of page">
<attribute name="number" type="short" label="Number" default="CounterValue('numPage')"/>
</element>
<element name="book" label="Book" desc="Example book" template="ncm:content" xmlChildren="true">
<attribute name="title" type="string" label="Title" default="'New book'"/>
<attribute name="date" type="date" default="GetDate()"/>
<attribute name="language" type="string" label="Language" enum="language"/>
<element name="chapter" label="Chapter" ref="section"/>
<element name="appendix" label="Appendix" ref="section"/>
</element>
</srcSchema>
La struttura del capitolo viene spostata nell’elemento con il nome "section" al di fuori dell’elemento principale. Il capitolo e la sezione fanno riferimento all’elemento "section".
Elemento “compute-string” compute-string
Una stringa di calcolo è un'espressione XPath utilizzata per creare una stringa che rappresenta un'istanza di contenuto.
Ecco il nostro schema di esempio con la sua stringa di calcolo:
<srcSchema name="book" namespace="cus">
<element name="book" label="Book" desc="Example book" template="ncm:content" xmlChildren="true">
<compute-string expr="@name"/>
...
</element>
</srcSchema>
Modifica degli schemi editing-schemas
Il campo di modifica consente di inserire il contenuto XML dello schema di origine:
Quando lo schema di origine viene salvato, la generazione estesa dello schema viene avviata automaticamente.