tot seguit s'explica el format de descripció XML dels arxius de dades "continguts" GenB.
arxiu XML dades:
<?xml version="1.0" encoding="iso-8859-1"?>
<genb creator_name="Demo" creator_surname="Demo" creator_company="Inte" date="2003-06-27 04:06">
<user uid="12339123c80123ba6112312312312378" url="http://www.test.com" xml:lang="ca">
<source name="generica" id="111" template_name="template A" template_id="1" status="2">
<name>registre basat en model A</name>
<date>2003-06-18</date>
<item template_item_label="Title" template_item_id="1" xml:lang="ca">introducció a GenB</item>
<item template_item_label="Contents" template_item_id="2" xml:lang="ca"><![CDATA[Lorem ipsum ...]]></item>
<item template_item_label="File" template_item_id="3">demo.zip</item>
<item template_item_label="Image_1" template_item_id="4">demo.gif</item>
<item template_item_label="Option_class" template_item_id="5" selected="1" active_option="1">opció A</item>
<item template_item_label="Option_class" template_item_id="5" selected="0" active_option="1">opció B</item>
<item template_item_label="Option_class" template_item_id="5" selected="0" active_option="1">opció C</item>
</source>
<source name="generica" id="111" template_name="template B" template_id="2" status="2">
...
...
</source>
...
...
</user>
</genb>
genb: [requerit] obre i tanca l'espai de continguts. Disposa d'atributs informatius com "creator_name", "creator_surname",...
user: [requerit] identifica l'entitat/site d'on procedeixen el conjunt de continguts que compren.
Ubicació: formant part directament del contingut de 'genb'.
els atributs que pot contenir són:
1.- uid: [opcional] identificador únic de l'entitat. Si no s'inclou aquest atribut, en un procés d'importació, el sistema prendrà per defecte l'entitat de l'usuari en sessió.
2.- url: [informatiu] url de l'espai web de 'uid'.
3.- xml:lang: [informatiu] idioma utilitzat a l'espai de gestió de continguts GenBnet.
source: [requerit] obre i tanca el conjunt de continguts d'un registre associat a un model de dades "template".
Ubicació: formant part directament del contingut de 'user'.
els atributs que pot contenir són:
1.- name: [requerit] identificador de mòdul al que pertany el model de dades.
Valors possibles: 'autenticacion' (mòdul autenticació); 'generica' (planes genèriques); 'productogen' (producte); 'actualidadgen' (actualitat); 'registrogen' (registres).
2.- id: [opcional] identificador únic del registre. Si no s'inclou l'atribut "id", en un procés d'importació, el sistema tractarà el bloc source com si es tractes d'una inserció. Per altre banda si es facilita identificador i aquest existeix, el sistema intentarà actualitzar sempre que sigui possible.
3.- template_id: [opcional] identificador únic del model de dades en el que es basa el contingut de 'source'. Si no s'inclou l'atribut "template_id", en un procés d'importació, el sistema tractarà d'identificar el model de dades basant-se en l'atribut "template_name".
4.- template_name: [opcional] nom del model de dades (nom utilitzat en primer idioma utilitzat per la gestió de continguts). Utilitzat en lloc de l'identificador de model de dades "template_id" quan aquest darrer no és facilitat.
5.- status: [opcional] atribut que designa l'estat de publicació del registre 'bloc source'.
Si no s'inclou l'atribut, en un procés d'importació, el sistema prendrà el valor per defecte 1 -> pendent.
Els valors possibles per aquest atribut són: 1 -> pendent (defecte), 2 -> publicat, 3 -> retirat. name: [opcional] delimita el contingut corresponent al nom/referència intern/a que l'usuari dona al registre.
Ubicació: formant part directament del contingut de 'source'. No importa la seva posició dins dels continguts de source.
No disposa d'atributs.
date: [opcional] delimita el contingut corresponent a la data que l'usuari assigna al registre. El format del contingut es aaaa-mm-dd
Ubicació: formant part directament del contingut de 'source'. No importa la seva posició dins dels continguts de source.
No disposa d'atributs.
item: [opcional] obre i tanca el contingut d'un camp pertanyent al registre o 'source'.
Ubicació: formant part directament del contingut de 'source'. No importa l'ordre.
Els atributs que pot contenir són:
1.- template_item_id: [opcional] identificador únic del camp associat al registre o 'source'. Si no s'inclou l'atribut "template_item_id", en un procés d'importació el sistema tractarà d'identificar el camp basant-se en l'atribut "template_item_label".
2.- template_item_label: [opcional] nom del camp associat al registre o 'source'. Utilitzat com a identificador únic quan l'identificador "template_item_id" no és utilitzat.
3.- xml:lang: [opcional] idioma utilitzat per al contingut del camp. Si no s'inclou l'atribut, el sistema triarà l'idioma designat per 'user' si aquest forma part dels idiomes de continguts o en darrera instància el primer idioma utilitzat en continguts. Podran existir tants 'item' per un mateix camp com idiomes utilitzats per continguts.
4.- selected: [opcional] atribut utilitzat exclusivament en camps de tipus "closed_list" (llista tancada).
Els valors possibles per aquest atribut són: 0 -> opció no seleccionada (defecte), 1 -> opció seleccionada.
5.- active_option: [opcional] atribut informatiu utilitzat exclusivament en camps de tipus "closed_list" (llista tancada).
Els valors possibles per aquest atribut són: 1 -> opció activa, 2 -> opció inactiva (obsoleta).
NOTA: en un procés d'importació, en camps de tipus "closed_list" (llista tancada) el contingut és utilitzat per localitzar l'opció i aplicar el valor de l'atribut "selected". En el procés d'identificació de l'opció el sistema utilitzarà l'idioma designat per 'user' si aquest forma part dels idiomes de continguts o en darrera instància el primer idioma utilitzat en continguts. |