• Antes de empezar a programar +
  • ¿Qué versión de Symfony utiliza?
  • Sistema de Prioridades de Plugins
  • Diagramas de tablas
  • Cómo hacer un pull-request
• Creación de Plugins
  • El archivo facturascripts.ini
  • El archivo Init.php
  • Los Controladores +
    • Controladores extendidos +
      • ListController en FacturaScripts +
        • addFilterAutocomplete()
        • addFilterCheckbox()
        • addFilterDatePicker()
        • addFilterNumber()
        • addFilterPeriod()
        • addFilterSelect()
        • addFilterSelectWhere()
      • EditController
      • PanelController +
        • addHtmlView()
        • addEditView()
        • addEditListView()
        • addListView()
      • Personalizando con Settings
      • Método disableColumn()
      • Interacción con las Vistas
    • Obtener Parámetros de la URL, Formularios o Cookies
    • Cómo guardar una cookie
    • Consultar el usuario y sus permisos
    • Formularios de edición de facturas, albaranes, etc
  • Añadir un Endpoint a la API
  • Los modelos +
    • Operaciones comunes con modelos
    • XML de la tabla
    • ModelOnChangeClass
    • Modelos de Más de Una Tabla
    • Modelos Especiales
    • Cómo crear una factura, albarán, pedido o presupuesto
    • Herencia de Modelos
    • $modelo->install()
    • $modelo->all()
    • $modelo->clear()
    • $modelo->count()
    • $modelo->delete()
    • $modelo->exists()
    • $modelo->loadFromData()
    • $modelo->get()
    • $modelo->getModelFields()
    • $modelo->loadFromCode()
    • $modelo->primaryColumnValue()
    • $modelo->primaryColumn()
    • $modelo->newCode()
    • $modelo->tableName()
    • $modelo->save()
    • $modelo->primaryDescription()
    • $modelo->primaryDescriptionColumn()
    • $modelo->url()
    • $modelo->test()
  • Las vistas HTML +
    • Iconos disponibles
    • Herencia de plantillas
  • Las vistas XML (XMLView) +
    • Columns
    • Rows +
      • Row status
      • Row statistics
      • Row actions
      • Row header y footer
    • Modals
    • Group
    • Column
    • Widgets +
      • Widget Autocomplete
      • Widget Bytes
      • Widget Checkbox
      • Widget Color
      • Widget Datalist
      • Widget Date
      • Widget Datetime
      • Widget File
      • Widget Library
      • Widget Link
      • Widget Money
      • Widget Number
      • Widget Password
      • Widget Select
      • Widget Stars
      • Widget Text
      • Widget Textarea
      • Widget Time
      • Widget Radio
      • Widget Variante
  • Las traducciones en Plugins
  • Las extensiones
    • Extensiones de controladores
    • Extensiones de modelos
    • Extensiones de tablas
    • Extensiones de XMLView
    • Extensiones de Vistas HTML
  • Mostrar mensajes, errores y alertas
  • Acceso a la Base de Datos +
    • DbQuery
    • Where
    • DataBaseWhere
  • Settings: opciones del panel de control +
    • Cómo crear preferencias de aplicación para su plugin
  • Generación de PDF y Excel
  • AssetManager
  • El archivo Cron.php
  • Cómo publicar plugins
• Profundizando en el CORE +
  • Enrutado
  • Gestión de Errores
  • Gestión de Plugins
  • Uso de la caché
  • La cola de trabajos
  • Descarga de Archivos desde MyFiles
  • Cliente de API de OpenAI
  • Cliente HTTP +
    • Conectar con otro FacturaScripts mediante API
  • Validar Emails, Cadenas y URLs
  • Enviar emails con NewMail
• Test unitarios en plugins +
  • Añadir github action
• Migración de plugins antiguos +
  • Row Business (Obsoleto)
  • Migrar los XML de las tablas de 2017
  • Migrar Modelos de 2017
  • addGridView() - (obsoleto)
• La API REST +
  • Listado de recursos
  • Listar, filtrar y ordenar registros
  • Obtener un registro concreto
  • Crear o añadir registros
  • Cómo crear facturas
  • Obtener el PDF de una factura
  • Modificar registros
  • Eliminar registros

Extensiones de tablas

Para modificar la tabla de otro plugin (o del core) podemos crear una extensión de esa tabla, es decir, crearemos un archivo xml con el nombre de la tabla en la carpeta Extension/Table de nuestro plugin.

Ejemplo: añadir columnas a la tabla productos

Supongamos que queremos añadir la columna "usado" a la tabla de productos. Lo que normalmente harías es añadir el archivo Table/productos.xml a tu plugin con la columna deseada. Pero esto no es correcto. Al hacer esto lo que le estás diciendo a FacturaScripts es que la tabla productos se compone únicamente de la columna "usado".

Para este caso lo correcto es crear el archivo Extension/Table/productos.xml:

<?xml version="1.0" encoding="UTF-8"?>
<table>
    <column>
        <name>usado</name>
        <type>boolean</type>
    </column>
</table>

De esta forma lo que estamos indicando a FacturaScripts es que añada esta columna a la definición de la tabla productos. Los cambios se pueden ver reflejados en el archivos FacturaScripts/Dinamic/Table/productos.xml Observación: Las tablas en la base de datos sólo se modifican cuando son llamadas desde Facturascripts, en éste caso cuando naveguemos al menú productos.

fsmaker

Para crear este archivo con fsmaker simplemente ejecutamos:

fsmaker extension

En el asistente elegimos tabla y después escribimos el nombre de la nueva columna.

Añadir columnas al modelo

Los modelos de FacturaScripts cargan automáticamente todas las columnas de la tabla, es decir, si la tabla tiene una columna nueva también la va a cargar. Por este motivo no es necesario modificar el modelo al añadir una columna a la tabla.

¿No ve los cambios del xml en la base de datos?:

Es posible que durante el desarrollo no vea la tabla creada en la base de datos o no se realicen los cambios del xml en la tabla. Si es así, vaya al menú administrador, Plugins y pulse el botón reconstruir.

Facturascripts crea las tablas que no existen cuando se instancia el modelo(por ejemplo new FacturaCliente()). Si ha creado un xml y aún no se ha instanciado al menos una vez, no se creará la tabla en la base de datos.

Cuando se realizan cambios en el xml no se aplican hasta que se borra la Cache ya que el sistema usa un sistema de Cache para evitar comprobar las tablas en cada petición. Así que si desea forzar la creación y modificación de la tabla en la base de datos siga los siguientes pasos:

Forzar la creación y modificación de las tablas en la base de datos

• Vaya al menú administrador, Plugins y pulse el botón reconstruir.
• Instanciar el modelo que quiere actualizar. (por ejemplo new FacturaCliente()).