Los archivos Tabla de Citas son archivos con formato XML en los que
se guardan las citas listadas una tras otra. Su formato, muy sencillo,
es el siguiente:
1. Estructura XML de las citas
Como se puede ver, cada cita tiene un número de registro único
dentro de la tabla de citas. La estructura de las citas en sí,
que ya es más compleja, varía según se trate de
un tipo de cita u otro:
Estos son sus elementos:
- <taxon icode=""
namecode=""/>: este tag guardará
el Nombre Original del taxon, que será el que aparecerá
en el tesauro de taxones para el namecode indicado. Esto
podría parecer redundante, ya que el namecode y el
contenido del tag darán en realidad la misma información,
pero así el programa se ahorra estar constantemente consultando
el tesauro y además retiene una mínima funcionalidad
en caso de no haber tesauro adjunto al proyecto. El icode
hará referencia al Nombre Corregido, es decir, en
caso de que icode y namecode no sean iguales,
Fagus buscará en el tesauro de taxones el taxon relacionado
con el icode para obtener el Nombre Corregido de la
cita.
- <author/>:
guarda el nombre del autor de la cita.
- <observation_date
day="" month="" year=""/>:
en este tag se guarda la fecha de observación separada en
día, mes y año.
- <fagus_user/>:
corresponderá al nombre del informatizador de la cita.
- <entry_date day=""
month="" year=""/>: contendrá
la fecha de informatización separada en día, mes y
año.
- <sureness/>:
guardará el grado de seguridad en la determinación
del taxon de la cita.
- <natureness/>:
este tag califica la espontaneidad de la cita.
- <accepted/>:
indica con los valores true (verdadero) y false (falso) si el informatizador
da la cita como válida o no.
- <side_data
type="ECO">: dentro de este elemento
se agruparán los atributos ecológicos de la cita y
sus valores. Estará presente en todas las citas.
- <side_data
type="GEO">: englobará los atributos
geográficos de la cita y sus valores. También estará
presente en todas las citas.
- <side_data
type="BIB">: almacenará los atributos
específicos de las citas provenientes de bibliografía
y estará vacío en las que no sean de este tipo, como
se puede observar en la imagen.
- <side_data
type="PLEC">: estará vacío
en las citas no referentes a pliegos de herbario ya que sólo
contendrá los atributos referentes a estas.
- <comentari/>:
se guardará un texto con un comentario referente a la cita.
-
Citas bibliográficas
Contendrá los mismos elementos que en el caso anterior, pero
ahora el tag <side_data
type="BIB"> no estará vacío.
-
Pliegos de herbario
Esta es su forma xml:
Como se puede observar, este caso presenta diferencias con los anteriores,
ya que faltan los tags de <author/>
y <observation_date/>.
Esto se debe a que en este tipo de citas, estos atributos vienen substituidos
por los atributos específicos de pliegos de herbario legit
y legit_date que, junto con otros, se encuentran dentro del tag <side_data
type="PLEC">.
2. Los tags side_data
Dentro de ellos se guardan los valores de los diferentes atributos
de cada cita. El valor concreto se guarda dentro de los elementos datum
englobados por cada side_data. Estos elementos tienen los
atributos name (o nombre interno), que hace referencia al nombre
con el que trabaja Fagus, y label (o nombre externo), que será
el texto con el que el usuario reconocerá al datum concreto.
De hecho, al añadir o quitar campos desde el panel Campos
del Diálogo de Entorno lo que
hacemos es añadir o quitar elementos datum al archivo
proyecto. Luego las citas que se generen basándose en ese proyecto
incorporarán o eliminarán al side_data adecuado
el elemento datum especificado por el usuario de Fagus.
Hay hasta cuatro de tipos de elementos side_data que pueden
aparecer en la estructura XML de una cita. Estos son:
- ECO: contendrá los atributos que caracterizarán el
entorno ecológico de las citas. Por defecto su contenido será
el siguiente:
- GEO: aquí se encontrarán los atributos de carácter
geográfico, que por defecto serán:
- BIB: específico para citas bibliográficas. Por defecto
contendrá sólo dos elementos datum, que serán:
- PLEC: guardará información útil para citas
provenientes de pliegos de herbario. Su estructura por defecto será
la siguiente: