¿Cómo la uso?

• Configurar
• Instalar
• Crear y gestionar estructuras
• Programar

Las constantes del sistema están en 'ModelClass.php'. La mayoría de estas constantes tienen un valor por defecto que no tienes que cambiar si no lo deseas.
Recomendamos cambiar:

• DEFDATABASE_*: Hay 4 constantes para configurar la base de datos para utilizar la interfaz web (host, database, username, password).
• PREFIX: Todas las tablas serán nombradas con el prefijo (prefix) + nombre de la tabla (tablename)
• ROOT_NAME: Es el nombre de la raíz interna (la estructura vacía tendrá sólo este nodo).

Interfaz web: Existe una interfaz web en 'configTables.php' (vista previa) para definir los parámetros para crear las tablas. Recomendamos utilizar los valores por defecto (simplemente clickando en GO!). Si no quieres escribir los parámetros de tu base de datos en 'ModelClass.php', puedes fijarlos en esta interfaz.

• Parámetros de la base de datos
  Aquí aparecerán por defecto los parámetros definidos en 'ModelClass.php'. Si no están definidos en el archivo, se pueden definir en la propia interfaz.
  
  
  

• Tipos de datos de las columnas
  Aquí se muestra una lista de cada campo y tipo de cada tabla. En principio recomendamos mantener los valores por defecto, aunque hay dos campos que pueden presentar problemas para necesidades muy concretas:
  

  • STRUCTURE -> VALUE Es el campo donde se almacena el nombre de los nodos. Si la estructura va a ser muy grande, o muy profunda, o los nombres de los nodos demasiado largos conviene aumentar el tamaño del VARCHAR.
    
  • ELEMENTS -> TYPE Es el campo que indica el tipo de elemento que hay en esa fila. El tamaño del VARCHAR por defecto puede ocasionar problemas para relaciones con nombres muy largos, o relaciones entre muchos elementos. Por ejemplo, si es VARCHAR(25) (como viene por defecto), tendremos problemas para crear relaciones como USUARIO-RECURSO_ORIGEN-RECURSO_DESTINO, dado que la longitud de esta cadena supera los 25 caracteres permitidos. La solución es ampliar el tamaño del VARCHAR.
    
    
  
  

• Índices
  Aquí aparecen los distintos índices que se van a crear. Recomendamos dejar los parámetros por defecto (el que el índice de la tabla DATA esté sin marcar es correcto así, dado que es su clave primaria).
  Por defecto se crearán 3 índices (además de los que se creen automáticamente al definir las claves primarias).
  
  
  

Interfaz web
Existe otra interfaz web en 'schemeHandler.php' para definir la estructura. Puedes construir la estructura creando nodos hijos, hermanos... sólo necesitas marcar la caja 'Modo edición' y hacer click en 'Actualizar'. Ahora puedes añadir un nuevo nodo, o eliminar nodos existentes.
Con esta interfaz también puedes guardar los datos en un xml haciendo click en el botón 'Guardar XML'. Un nuevo archivo llamado 'esquema.xml' será creado en el directorio donde está este archivo. También puedes cargar un XML haciendo click en el botón 'Cargar XML'.

Diseño de una estructura. Ejemplo
Supongamos que queremos implementar el siguiente esquema entidad-relación en el modelo de datos.

Como se ve en el esquema, hay dos entidades: “usuario” y “examen” y una relación “Hace” de la que cuelga un atributo “Nota”.Usuario tiene un atributo compuesto “Login”, que se compone de otros dos atributos: “username” y “pass”. Examen tiene dos atributos: “Fecha” y “Asignatura”.

• ENTIDADES USUARIO Y EXAMEN
  Usuario debe ser un nodo de tipo ELEMENT, puesto que se van a crear instancias de usuarios.
  Login debe ser un nodo de tipo NODE, hijo de Usuario, puesto que no va a tener valores asociados.
  Username y pass serán dos nodos hermanos, hijos de Login, de tipo STRING puesto que serán los valores que tendrán asociados.
  De manera análoga, Examen debe ser un nodo de tipo ELEMENT, y sus dos atributos dos nodos hermanos, hijos de Examen, del tipo correspondiente.

Nombre del nodo	Tipo del nodo
/SISTEMA/USUARIO	ELEMENT
/SISTEMA/USUARIO/LOGIN	NODE
/SISTEMA/USUARIO/LOGIN/USERNAME	STRING
/SISTEMA/USUARIO/LOGIN/PASSWORD	STRING
/SISTEMA/EXAMEN	ELEMENT
/SISTEMA/EXAMEN/NOTA	INTEGER
/SISTEMA/EXAMEN/FECHA	DATE

• RELACIÓN HACE
  Es una relación entre los dos elementos que tenemos, por lo que será un nodo de tipo ELEMENT llamado USUARIO-EXAMEN (daría igual llamarlo EXAMEN-USUARIO).
  El atributo nota será un hijo suyo de tipo INTEGER.

Nombre del nodo	Tipo del nodo
/SISTEMA/USUARIO-EXAMEN	ELEMENT
/SISTEMA/USUARIO-EXAMEN/NOTA	INTEGER

La clase principal 'Model' está en el archivo 'ModelClass.php'. Necesitas incluirlo en tus archivos php y construir un nuevo objeto 'Model'. Este objeto tendrá todas las funciones que necesitas para gestionar el modelo de datos (insertar elementos, asignar valores, construir nuevos nodos en la estructura...). Mira la documentación de 'ModelClass.php' para aprender a usar estas funciones.