tot seguit es descriu el format de descripció XML dels arxius d'estructura GenB.
arxiu XML estructura:
<?xml version="1.0" encoding="iso-8859-1"?>
<?xml-stylesheet href="http://www.inte.es/code/genbExport.xsl" type="text/xsl"?>
<genb creator_name="Demo" creator_surname="Demo" creator_company="Inte" date="2003-06-20 09:06">
<user uid="12339123c80123ba6112312312312378" url="http://www.test.com" xml:lang="ca">
<template name="generica" template_id="1">
<template_name xml:lang="ca">model_A</template_name>
<url_list xml:lang="ca">/demo/index.php</url_list>
<url_detail xml:lang="ca">/demo/detalle.php</url_detail>
<label id="1" label_type="short text" show_in_admin_list="1" email="0">Title</label>
<label id="2" label_type="text" num_rows="10">Contents</label>
<label id="3" label_type="document">File</label>
<label id="4" label_type="image">Image_1</label>
<label id="5" label_type="closed list" list_style="drop down menu">Option_class</label>
<closed_list id="1" label="Tipo_Opcion" xml:lang="ca" status="1">opció A</closed_list>
<closed_list id="2" label="Tipo_Opcion" xml:lang="ca" status="1">opció B</closed_list>
<closed_list id="3" label="Tipo_Opcion" xml:lang="ca" status="2">opció C</closed_list>
</template>
<template name="generica" template_id="2">
...
...
</template>
...
...
</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 del que 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. Si no s'inclou aquest atribut, en un procés d'importació, el sistema prendrà per defecte l'usuari en sessió.
2.- url: [informatiu] url de l'espai web de 'uid'.
3.- xml:lang: [informatiu] idioma utilitzat en l'espai de gestió de continguts.
template: [requerit] obre i tanca el conjunt de continguts que defineixen l'estructura d'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: 'generica' (planes genèriques); 'productogen' (producte); 'actualidadgen' (actualitat); 'registrogen' (registres).
2.- template_id: [opcional]identificador únic del model de dades. Si no s'inclou template_id, en un procés d'importació, el sistema tractarà el model de dades com si es tractes d'una incorporació nova. Altrament si es facilita identificador i aquest existeix, el sistema intentarà actualitzar sempre que sigui possible.
template_name: [opcional] delimita el contingut corresponent al nom que l'usuari dona al "template".
Ubicació: formant part directament del contingut de 'template'. No importa la seva posició dins dels continguts de template.
Els atributs que pot contenir són:
1.- xml:lang: [opcional] idioma utilitzat pel nom del template. Si no s'inclou l'atribut, el sistema escollirà el primer idioma (idioma per defecte) utilitzat per l'usuari. Podran existir tants template_name com idiomes utilitzats per les dades.
url_list: [opcional] delimita el contingut corresponent al camí de base on està ubicat l'arxiu model de visualització a utilitzar en llistats.
Ubicació: formant part directament del contingut de 'template'. No importa la seva posició dins dels continguts de template.
Els atributs que pot contenir són:
1.- xml:lang: [opcional] idioma utilitzat per la url_list del template. Si no s'inclou l'atribut, el sistema escollirà el primer idioma (idioma per defecte) utilitzat per l'usuari. Podran existir tants url_list com idiomes utilitzats per les dades.
url_detail: [opcional] delimita el contingut corresponent al camí de base on està ubicat l'arxiu model de visualització a utilitzar en vistes detall.
Ubicació: formant part directament del contingut de 'template'. No importa la seva posició dins dels continguts de template.
Els atributs que pot contenir són:
1.- xml:lang: [opcional] idioma utilitzat per la url_detail del template. Si no s'inclou l'atribut, el sistema escollirà el primer idioma (idioma per defecte) utilitzat per l'usuari. Podran existir tants url_detail com idiomes utilitzats per les dades.
label: [opcional] defineix un camp del template. les etiquetes label delimiten el contingut corresponent al nom del camp "label". L'etiqueta "label" o nom del camp permet identificar de forma unívoca un camp de contingut dins d'un model de dades "template".
Ubicació: formant part directament del contingut de 'template'. la seva posició respecto a altres "label" determinarà l'ordre d'aparició dins del formulari de continguts del model de dades tractat.
Els atributs que pot contenir són:
1.- id: [opcional] identificador únic del camp.
Si es facilita l'atribut 'id', en un procés d'importació, el sistema procedirà a actualitzar la definició del camp "label". Si no s'inclou l'atribut identificador, el sistema en primer lloc, tractarà de localitzar i identificar el camp utilitzat el nom. Si el camp és identificat, es procedirà a actualitzar. Si el camp no existeix, es procedirà a inserir.
2.- label_type: [requerit] identificador que designa el tipus de dades que contindrà el camp. Els valors possibles per aquest atribut són:
atribut |
descripció |
atributs associats |
short_text |
text de llargària màxima 100 caràcters. |
email, show_in_admin_list |
text |
text de llargària il·limitada |
num_rows |
closed_list |
llista de valors tancat |
list_style, show_in_admin_list |
open_list |
text de llargària màxima 100 caràcters. en formulari del gestor de continguts apareix sempre acompanyat d'un menú desplegable amb tots els valors utilitzats en el conjunt de registres del model de dades tractat. |
email, show_in_admin_list |
image |
camp per la gestió d'arxius imatge. Els tipus admesos són: 'image/gif', 'image/pjpeg', 'image/jpeg' |
|
document |
camp per la gestió d'arxius document. Els tipus admesos són: 'video/quicktime', 'video/x-msvideo', 'application/x-troff-msvideo', 'video/avi', 'video/msvideo', 'video/x-ms-asf', 'application/x-mplayer2', 'video/x-ms-asf', 'video/x-ms-asf-plugin', 'application/x-zip-compressed', 'application/zip', 'application/pdf', 'application/msword', 'application/vnd.ms-excel' |
|
3.- show_in_admin_list: [opcional] atribut destinat a indicar presencia del camp als llistats de gestió de contingut. Aquest atribut té validesa per camps de tipus label_type: "short text" i "open list".
Els valors possibles per aquest atribut són: 1 -> mostrar, 0 -> ocultar (defecte).
4.- email: [opcional] atribut destinat a indicar que el contingut del camp correspon a un correu electrònic. Els models de dades que continguin camps designats com "email" permetran, des dels llistats de gestió, el volcat dels correus electrònics a llistes de distribució.
els valors possibles per aquest atribut són: 1 -> si, 0 -> no (defecte).
4.- num_rows: [opcional] atribut destinat a indicar en camps de tipus label_type: "text" (text), el número de línies visibles de la caixa de text que apareixeran als formularis de gestió de continguts.
els valors possibles per aquest atribut són: valor sencer, p.ex.: 15
5.- list_style: [requerit] atribut destinat a indicar en camps de tipus label_type: "closed list" (llista tancada), el format de la llista tancada a utilitzar als formularis de gestió de continguts.
els valors possibles per aquest atribut són: "checkbox", "multiple select", "drop down menú" i "radio button". closed_list: [opcional] delimita el contingut corresponent les opcions d'un camp 'closed_list' (llista tancada). Els camps de tipus 'closed_list' (llista tancada) estan composats per diferents opcions. Les etiquetes closed_list permetran definir el conjunt d'opcions associades a un camp llista tancada.
Ubicació: formant part directament del contingut de 'template', sempre després de la definició del camp 'label' de tipus label_type: "closed_list" al que farà referència mitjançant l'atribut 'label'.
la seva posició respecto a altres 'closed_list' determinarà l'ordre d'aparició.
els atributs que pot contenir són:
1.- id: [opcional] identificador únic. Si es facilita l'atribut 'id', en un procés d'importació, el sistema procedirà a actualitzar l'opció de la llista tancada. Si no s'inclou l'atribut identificador, el sistema procedirà a inserir.
2.- label: [requerit] identificador únic del camp 'label' de tipus label_type: "closed_list" al que va associada l'opció.
3.- xml:lang: [opcional] idioma utilitzat pel contingut de 'closed_list'. Si no s'inclou l'atribut, en un procés d'importació, el sistema escollirà el primer idioma (idioma per defecte) utilitzat per l'usuari.
4.- status: [opcional] atribut que designa l'estat de l'opció.
Si no s'inclou l'atribut, en un procés d'importació, el sistema prendrà el valor per defecte 1 -> actiu. L'estat inactivo indica opció en desuso, és a dir opció visible des de l'espai de gestió de continguts, pero ocultada a l'ésser utilitzada en models de visualització (espai web).
Els valors possibles per aquest atribut són: 1 -> actiu (defecte), 2 -> inactivo. |