• Antes de empezar a programar +
  • 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
    • Modelos de Más de Una Tabla
    • Modelos Especiales
    • Cómo crear una factura, albarán, pedido o presupuesto
    • Herencia de Modelos
    • $modelo->getModelFields()
    • $modelo->all()
    • $modelo->clear()
    • $modelo->count()
    • $modelo->delete()
    • $modelo->loadFromData()
    • $modelo->install()
    • $modelo->exists()
    • $modelo->get()
    • $modelo->load() ...
    • $modelo->primaryColumnValue()
    • $modelo->primaryColumn()
    • $modelo->newCode()
    • $modelo->save()
    • $modelo->primaryDescription()
    • $modelo->tableName()
    • $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 +
      • Autocomplete
      • Bytes
      • Checkbox
      • Color
      • Datalist
      • Date
      • Datetime
      • File
      • Library
      • Link
      • Money
      • Number
      • Password
      • Select
      • Stars
      • Text
      • Textarea
      • Time
      • Subcuenta
      • Radio
      • 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 (obsoleta)
  • 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
  • La cola de trabajos
  • La clase Request
  • La clase Response
  • Uso de la caché
  • Descarga archivos de MyFiles
  • La clase Tools
  • 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)
  • ¿Qué versión de Symfony utiliza?
  • ModelOnChange (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, albaranes ...
  • Marcar factura como pagada
  • Hacer una factura rectificativa
  • Obtener el PDF de una factura, albarán ...
  • Subir archivos
  • Modificar registros
  • Eliminar registros
  • Obtener esquema modelo

$modelo->load(), loadWhere() y loadWhereEq()

Los modelos tienen los métodos load() y loadWhere() para recuperar registros. El método loadFromCode() permanece como alias por compatibilidad, pero está en desuso y debería evitarse en el código nuevo.

load($code)

Permite cargar el registro cuyo valor de clave primaria coincide con $code.

Parámetros

• code: Valor de la clave primaria. Si es null, el método devuelve FALSE sin realizar consultas.

Retorno y efectos

• Devuelve TRUE si encuentra el registro y carga los datos en el modelo.
• Devuelve FALSE si no existe y limpia el estado (clear()), dejando el modelo sin identificador.
• Tras una carga correcta se sincronizan los valores originales (syncOriginal()), lo que permite detectar cambios antes de guardar.

Ejemplo: Cargar el cliente 123

use FacturaScripts\Core\Model\Cliente;

$cliente = new Cliente();
if ($cliente->load('123')) {
    // OK, hemos cargado los datos del cliente 123
} else {
    // No existe ningún cliente 123
}

loadWhere(array $where, array $order = [])

Permite cargar el primer registro que cumple una lista de filtros.

Parámetros

• where: Array de filtros. Lo habitual es usar objetos de la clase FacturaScripts\Core\Where.
  • Construye filtros AND/OR con métodos como Where::eq(), Where::orLike(), Where::sub(), etc.
  • Puedes filtrar varios campos a la vez usando el separador | en la definición (Where::like('nombre|razonsocial', 'demo')).
  • Los operadores soportados incluyen =, !=, >, <, BETWEEN, IN, LIKE, XLIKE, REGEXP, además de comparaciones entre columnas mediante valores Where::column('campo', 'field:otro_campo').
• order: (opcional) Array asociativo ['campo' => 'ASC|DESC'] que se aplica al conjunto filtrado. Admite varios campos de ordenación.

Retorno y efectos

• Devuelve TRUE si encuentra un registro y lo carga.
• Devuelve FALSE si no hay coincidencias y limpia el estado del modelo.
• También sincroniza los valores originales para que funciones como hasChanged() sigan operativas.

Ejemplo: Cargar el cliente con teléfono 555444333

use FacturaScripts\Core\Model\Cliente;
use FacturaScripts\Core\Where;

$cliente = new Cliente();
if ($cliente->loadWhere([Where::eq('telefono1', '555444333')])) {
    // OK
} else {
    // Cliente no encontrado
}

Ejemplo: Combinar filtros complejos

use FacturaScripts\Core\Model\Cliente;
use FacturaScripts\Core\Where;

$where = [
    Where::like('telefono1|telefono2', '%444%'),
    Where::eq('estado', 'ACTIVO'),
    Where::isNull('fechabaja')
];

$cliente = new Cliente();
if ($cliente->loadWhere($where, ['fechaalta' => 'DESC'])) {
    // Cliente activo más reciente con un teléfono que contiene 444
}

Ejemplo: Cargar el primer producto con stock mayor que 0

use FacturaScripts\Core\Model\Producto;
use FacturaScripts\Core\Where;

$producto = new Producto();
$producto->loadWhere([Where::gt('stockfis', 0)], ['stockfis' => 'ASC']);

loadWhereEq(string $field, $value)

Atajo para llamar a loadWhere() con un filtro de igualdad sobre un único campo.

Parámetros

• field: Nombre del campo sobre el que se aplicará el filtro.
• value: Valor que debe tener el campo. Se convierte a SQL mediante var2str, por lo que puedes pasar cadenas, números o nulos.

Retorno y efectos

• Devuelve TRUE si encuentra un registro con el valor indicado.
• Devuelve FALSE si no hay coincidencias y limpia el estado del modelo.
• Internamente llama a loadWhere([Where::eq($field, $value)]), por lo que comparte el mismo comportamiento que loadWhere().

Ejemplo: Cargar un almacén por código

use FacturaScripts\Core\Model\Almacen;

$almacen = new Almacen();
if ($almacen->loadWhereEq('codigo', 'MADRID')) {
    // Almacén encontrado
}

Evita loadFromCode()

loadFromCode() sigue existiendo como alias para proyectos antiguos, pero está deprecated. No admite todas las capacidades de Where y será retirado en futuras versiones. Siempre que necesites cargar datos:

• Usa load($codigo) si conoces la clave primaria.
• Usa loadWhere($filtros, $orden) para cualquier otra búsqueda.