La definición de la estructura de la tabla

FacturaScripts utiliza archivos XML para definir las estructuras de las tablas de la base de datos. De esta forma, el núcleo revisa las tablas y:

  • Si no existe la tabla, la crea.
  • Si existe la tabla, comprueba si tiene todas las columnas necesarias, si no, las crea.
  • Si tiene más columnas de las necesarias, no hace nada.

Los archivos XML de las tablas se deben alojar en la carpeta Table de tu plugin. Y cada archivo debe llamarse igual que la tabla.

Ejemplo: projects.xml

<?xml version="1.0" encoding="UTF-8"?>
<table>
    <column>
        <name>name</name>
        <type>character varying(100)</type>
        <null>NO</null>
    </column>
    <column>
        <name>codproject</name>
        <type>character varying(8)</type>
        <null>NO</null>
    </column>
    <constraint>
        <name>projects_pkey</name>
        <type>PRIMARY KEY (codproject)</type>
    </constraint>
</table>

Podemos ver como hay una etiqueta column para cada una de las columnas de la tabla, que puede contener a su vez las siguientes etiquetas:

  • name: para el nombre de la tabla. Importante, no utilices mayúsculas para los nombres de las tablas.
  • type: para indicar el tipo de dato que almacena la tabla.
  • null: YES si la columna admite null. NO si la columna no admite valores null. Si no hay etiqueta null, se interpreta como YES.
  • default: para indicar el valor por defecto a asignar en caso de no proporcionar uno, por ejemplo, cuando ya hay registros en esa tabla y justo se añade esta nueva columna. En ese caso se utiliza default para rellenar en los registros antiguos. Pero para el día a día, los valores por defecto hay que definirlos en el método clear() del modelo, no aquí.

Tipos soportados:

FacturaScripts fué desarrollador originalmente para usar PostgreSQL, por lo que los nombres de los tipos de datos son en su mayoría los de PostgreSQL. Aquí tienes la lista en detalle:

  • serial: este es un entero autoincremental. Es el que debes utilizar para las claves primarias numéricas.
  • integer: entero, el de toda la vida.
  • double precision: para números con decimales.
  • boolean: para valores lógicos, true o false.
  • character varying(100): para texto de hasta 100 caracteres. Para usar más o menos caracteres, simplemente cambia el número.
  • text: para texto de hasta 4000 caracteres.
  • date: para fechas.
  • time, para guardar horas. (without time zone)

Clave primaria, claves ajenas, etc...

La clave primaria, así como las claves ajenas y otras restricciones se definen con etiquetas constraint. Cada una de estas restricciones tiene un nombre, que debe ser único, y que se utiliza para comprobar en la tabla.

  • Si no se encuentra una restricción con ese nombre en la tabla, se crea.
  • Si ya existe una restricción con ese nombre en la tabla, no se hace nada.
  • Si le cambias el nombre a la restricción, se elimina la que hay en la tabla y se crea la nueva.

Ejemplo de clave ajena:

<constraint>
    <name>ca_albaranesprov_series</name>
    <type>FOREIGN KEY (codserie) REFERENCES series (codserie) ON DELETE RESTRICT ON UPDATE CASCADE</type>
</constraint>

En este ejemplo se está indicando:

  • Que la columna codserie de esta tabla, se corresponde con la columna codserie de la tabla series.
  • Que en caso de eliminación en la tabla series, se bloquee.
  • Que en caso de modificación en la tabla series, se propague el cambio a la columna en esta tabla.

Ejemplo de restricción para no repetir valores en una o varias columnas:

<constraint>
    <name>uniq_codigo_albaranesprov</name>
    <type>UNIQUE (codigo,idempresa)</type>
</constraint>

En este ejemplo se está indicando que no se debe repetir un conjunto codigo + idempresa.


  Siguiente

Necesita identificarse para continuar con esta acción. Haga clic en iniciar sesión o cree una cuenta.

Iniciar sesión
neorazorx_1
neorazorx_1
4682 Puntos 8 años
Fecha de creación 27-04-2018 00:00:00
Última actualización 15-06-2020
Contador de visitas 1526
Curso básico de usuario

Con este curso aprenderá a gestionar el día a día de su negocio con FacturaScripts 2021: hacer facturas, albaranes, pedidos y presupuestos. Gestionar clientes, proveedores y tarifas. Y a realizar la regularización de impuestos (trimestre de IVA). ¿A quién va dirigido? A cualquier usuario que ya tenga FacturaScripts instalado en su PC o hosting y quiera aprender rápidamente el manejo diario del programa. ¿Qué incluye? 18 lecciones con 17 vídeos explicativos.

212 4,99 €
Curso básico de programación

Con este curso aprenderá cómo crear un plugin sencillo para FacturaScripts 2021: añadir nuevas páginas, tablas y columnas. Para entender este curso no se necesita mucha experiencia en programación, le enseñaremos los básico para modelar problemas sencillos. ¿A quién va dirigido? A cualquier persona con unos conocimientos muy básicos de programación. ¿Qué incluye? 18 lecciones con 14 vídeos explicativos.

213 8,99 €
Sesiones de programación 2021

Esta es una recopilación de vídeos y documentación de pequeños desarrollos sobre FacturaScripts 2021 y sus plugins. Perfecto para expandir tus conocimientos de programación. ¿A quién va dirigido? A personas que ya hayan superado el curso básico de programación y busquen ampliar sus conocimientos. ¿Qué incluye? 9 lecciones con 9 vídeos explicativos (más de 5 horas de vídeos) y el código fuente de los ejemplos. Novedades mensuales: Este curso se amplía cada mes con nuevas lecciones.

33 14,99 €

Copyright (c) 2013-2021 FacturaScripts