a continuación se describe el formato de descripción XML de los archivos de estructura GenB.
archivo 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="es">
<template name="generica" template_id="1">
<template_name xml:lang="es">template A</template_name>
<url_list xml:lang="es">/demo/index.php</url_list>
<url_detail xml:lang="es">/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="es" status="1">opción A</closed_list>
<closed_list id="2" label="Tipo_Opcion" xml:lang="es" status="1">opción B</closed_list>
<closed_list id="3" label="Tipo_Opcion" xml:lang="es" status="2">opción C</closed_list>
</template>
<template name="generica" template_id="2">
...
...
</template>
...
...
</user>
</genb>
genb: [requerido] abre y cierra el espacio de contenidos. Dispone de atributos informativos como "creator_name", "creator_surname",...
user: [requerido] identifica la entidad/site del que proceden el conjunto de contenidos que encierra.
Ubicación: formando parte directamente del contenido de 'genb'.
los atributos que puede contener son:
1.- uid: [opcional] identificador único. Si se omite este atributo, en un proceso de importación, el sistema tomará por defecto el usuario en sesión.
2.- url: [informativo] url del espacio web de 'uid'.
3.- xml:lang: [informativo] idioma utilizado en el espacio de gestión de contenidos.
template: [requerido] abre y cierra el conjunto de contenidos que definen la estructura de un modelo de datos "template".
Ubicación: formando parte directamente del contenido de 'user'.
Los atributos que puede contener son:
1.- name: [requerido] identificador de módulo al que pertenece el modelo de datos.
Valores posibles: 'generica' (páginas genericas); 'productogen' (poducto); 'actualidadgen' (actualidad); 'registrogen' (registros).
2.- template_id: [opcional]identificador único del modelo de datos. Si se omite template_id, en un proceso de importación, el sistema tratará el modelo de datos como si se tratara de una incorporación nueva. De otro modo si se facilita identificador y éste existe, el sistema intentará actualizar siempre que sea posible.
template_name: [opcional] delimita el contenido correspondiente al nombre que el usuario da al "template".
Ubicación: formando parte directamente del contenido de 'template'. No importa su posición dentro de los contenidos de template.
Los atributos que puede contener son:
1.- xml:lang: [opcional] idioma utilizado para el nombre del template. Si se omite el atributo, el sistema eligirá el primer idioma (idioma por defecto) utilizado por el usuario. Podrán existir tantos template_name como idiomas utilizados para los datos.
url_list: [opcional] delimita el contenido correspondiente al camino de raiz donde esta ubicado el archivo modelo de visualización a emplear en listados.
Ubicación: formando parte directamente del contenido de 'template'. No importa su posición dentro de los contenidos de template.
Los atributos que puede contener son:
1.- xml:lang: [opcional] idioma utilizado para la url_list del template. Si se omite el atributo, el sistema eligirá el primer idioma (idioma por defecto) utilizado por el usuario. Podrán existir tantos url_list como idiomas utilizados para los datos.
url_detail: [opcional] delimita el contenido correspondiente al camino de raiz donde esta ubicado el archivo modelo de visualización a emplear en vistas detalle.
Ubicación: formando parte directamente del contenido de 'template'. No importa su posición dentro de los contenidos de template.
Los atributos que puede contener son:
1.- xml:lang: [opcional] idioma utilizado para la url_detail del template. Si se omite el atributo, el sistema eligirá el primer idioma (idioma por defecto) utilizado por el usuario. Podrán existir tantos url_detail como idiomas utilizados para los datos.
label: [opcional] define un campo del template. las etiquetas label delimitan el contenido correspondiente al nombre del campo "label". La etiqueta "label" o nombre del campo permite identificar de forma unívoca un campo de contenido dentro de un modelo de datos "template".
Ubicación: formando parte directamente del contenido de 'template'. Su posición respecto a otros "label" determinará el orden de aparición dentro del formulario de contenidos del modelo de datos tratado.
Los atributos que puede contener son:
1.- id: [opcional] identificador único del campo.
Si se facilita el atributo 'id', en un proceso de importación, el sistema procederá a actualizar la definición del campo "label". Si se omite el atributo identificador, el sistema en primer lugar, tratará de localizar e identificar el campo utilizado para ello el nombre. Si el campo es identificado, se procederá a actualizar. Si el campo no existe, se procederá a insertar.
2.- label_type: [requerido] identificador que designa el tipo de datos que contendrá el campo. Los valores posibles para éste atributo son:
atributo |
descripción |
atributos asociados |
short_text |
texto de longitud máxima 100 caracteres. |
email, show_in_admin_list |
text |
texto de longitud ilimitada |
num_rows |
closed_list |
lista de valores cerrado |
list_style, show_in_admin_list |
open_list |
texto de longitud máxima 100 caracteres. en formulario del gestor de contenidos aparece siempre acompañado de un menú desplegable con todos los valores utilizados en el conjutno de registros del modelo de datos tratado. |
email, show_in_admin_list |
image |
campo para la gestión de archivos imágen. Los tipos adminitidos son: 'image/gif', 'image/pjpeg', 'image/jpeg' |
|
document |
campo para la gestión de archivos documento. Los tipos admitidos son: '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] atributo destinado a indicar presencia del campo en los listados de gestión de contenido. Este atributo tiene validez para campos de tipo label_type: "short text" y "open list".
los valores posibles para éste atributo son: 1 -> mostrar, 0 -> ocultar (defecto).
4.- email: [opcional] atributo destinado a indicar que el contenido del campo corresponde a un correo electrónico. Los modelos de datos que contengan campos designados como "email" permitiran, desde los listados de gestión, el volcado de los correos electrónicos a listas de distribución.
los valores posibles para éste atributo son: 1 -> si, 0 -> no (defecto).
4.- num_rows: [opcional] atributo destinado a indicar en campos de tipo label_type: "text" (texto), el número de líneas visibles de la caja de texto que aparecerán en los formularios del gestión de contenidos.
los valores posibles para éste atributo son: valor entero, p.ej.: 15
5.- list_style: [requerido] atributo destinado a indicar en campos de tipo label_type: "closed list" (lista cerrada), el formato de la lista cerrada a utilizar en los formularios del gestión de contenidos.
los valores posibles para éste atributo son: "checkbox", "multiple select", "drop down menu" y "radio button". closed_list: [opcional] delimita el contenido correspondiente las opciones de un campo 'closed_list' (lista cerrada). Los campos de tipo 'closed_list' (lista cerrada) estan compuestos por distintas opciones. Las etiquetas closed_list permitiran definir el conjunto de opciones asociados a un campo lista cerrada.
Ubicación: formando parte directamente del contenido de 'template', siempre tras la definición del campo 'label' de tipo label_type: "closed_list" al que referenciará mediante el atributo 'label'.
Su posición respecto a otros 'closed_list' determinará el orden de aparición.
los atributos que puede contener son:
1.- id: [opcional] identificador único. Si se facilita el atributo 'id', en un proceso de importación, el sistema procederá a actualizar la opción de la lista cerrada. Si se omite el atributo identificador, el sistema procederá a insertar.
2.- label: [requerido] identificador único del campo 'label' de tipo label_type: "closed_list" al que va asociada la opción.
3.- xml:lang: [opcional] idioma utilizado para el contenido de 'closed_list'. Si se omite el atributo, en un proceso de importación, el sistema eligirá el primer idioma (idioma por defecto) utilizado por el usuario.
4.- status: [opcional] atributo que designa el estado de la opción.
Si se omite el atributo, en un proceso de importación, el sistema tomará el valor por defecto 1 -> activo. El estado inactivo indica opción en desuso, es decir opción visible desde el espacio de gestión de contenidos, pero ocultada al ser utilizada en modelos de visualización (espacio web).
Los valores posibles para éste atributo son: 1 -> activo (defecto), 2 -> inactivo. |