[Também se aplica ao v8]{class="badge positive" title="Também se aplica ao Campaign v8"}
Uso de esquemas de dados no Campaign data-schemas
Abaixo estão alguns princípios gerais sobre o uso de schemas de dados no Adobe Campaign.
Para saber mais sobre como criar e configurar schemas de dados no Adobe Campaign, consulte esta seção.
Estrutura de esquema schema-structure
O documento XML de um schema de dados deve conter o <srcschema> elemento raiz com os atributos name e namespace para preencher o nome e o namespace do schema.
<srcSchema name="schema_name" namespace="namespace">
...
</srcSchema>
O ponto de entrada do schema é seu elemento principal. É fácil identificar porque ele tem o mesmo nome do schema e deve se originar do elemento raiz. A descrição do conteúdo começa com esse elemento.
Em um schema de gestão de conteúdo, o elemento principal é representado pela seguinte linha:
<element name="book" template="ncm:content" xmlChildren="true">
O atributo template digitado no elemento principal permite estender o schema com propriedades genéricas para todas as definições de conteúdo, como o nome, a data de criação, o autor, a string associada, etc.
Essas propriedades são descritas no schema ncm:content.
Tipos de dados data-types
Este é um exemplo de um esquema de gerenciamento de conteúdo com os tipos preenchidos:
<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>
Propriedades properties
Várias propriedades podem ser utilizadas para enriquecer os elementos <element> e <attribute> do schema de dados.
As principais propriedades utilizadas na gestão de conteúdo são as seguintes:
- label: descrição curta,
- desc: descrição longa,
- default: expressão que retorna um valor padrão na criação de conteúdo,
- userEnum: enumeração livre para armazenar e exibir os valores inseridos por meio desse campo,
- enum: enumeração fixa usada quando a lista de valores possíveis é conhecida antecipadamente.
Este é o nosso exemplo de schema com as propriedades preenchidas:
<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>
Elementos de coleção collection-elements
Uma coleção é uma lista de elementos com o mesmo nome e o mesmo nível hierárquico.
No nosso exemplo, os itens <chapter> e <page> são elementos de coleção. Portanto, o atributo unbound deve ser adicionado à definição desses elementos:
<element name="chapter" label="Chapter" unbound="true" ordered="true">
<element name="page" type="string" label="Page" desc="Content of page" unbound="true">
Referência de elemento element-referencing
A referência de elemento é usado em muitos schemas de conteúdo. Ela permite fatorar a definição de um elemento <element> para que ele possa ser referenciado em outros elementos com a mesma estrutura.
O atributo ref no elemento a ser referenciado deve ser preenchido com o caminho (XPath) do elemento de referência.
Exemplo: adição de uma seção do Appendix com a mesma estrutura do elemento <chapter> do nosso schema de exemplo.
<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>
A estrutura do capítulo é movida para o elemento com o nome "seção" fora do elemento principal. O capítulo e a seção fazem referência ao elemento "seção".
Cálculo de string compute-string
Um Cálculo de string é uma expressão XPath usada para criar uma string representando uma instância de conteúdo.
Aqui está nosso schema de exemplo com seu Cálculo de string:
<srcSchema name="book" namespace="cus">
<element name="book" label="Book" desc="Example book" template="ncm:content" xmlChildren="true">
<compute-string expr="@name"/>
...
</element>
</srcSchema>
Edição de esquemas editing-schemas
O campo de edição permite a inserção do conteúdo XML do schema de origem:
Quando o schema de origem é salvo, a geração do schema estendido é iniciada automaticamente.