• 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
        • 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
• 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

addFilterAutocomplete()

Añade un filtro de tipo autocompletar a la pestaña del ListController. Permite filtrar los resultados aplicando el filtro a la columna indicada. Los resultados para autocompletar los puede extraer de la tabla que le indiquemos.

Parámetros:

• viewName: nombre identificador de la pestaña.
• key: identificador del filtro. Generalmente el nombre del campo que quieras filtrar.
• label: etiqueta a mostrar en el filtro. Se traducirá.
• field: nombre del campo del modelo donde se aplica el filtro.
• table: nombre de la tabla donde buscar todos los resultados a autocompletar.
• fieldcode: nombre de la columna de la tabla donde buscar.
• fieldtitle: nombre de la columna de la tabla donde buscar. Pero para mostrar esta columna al usuario en lugar de fieldcode.
• where: (opcional) array de filtros para la búsqueda.

Ejemplo: añadir un filtro autocompletar

Imaginemos que queremos añadir un filtro por país al listado de facturas de venta en ListFacturaCliente.php

$this->addFilterAutocomplete('ListFacturaCliente', 'codpais', 'country', 'codpais', 'facturascli', 'codpais', 'codpais');

Esto nos permite filtrar por país. Pero cuando el usuario escriba sobre este campo, solamente va a autocompletar con los resultados de la tabla de facturascli. Y además solamente va a poner el código del país, no el nombre, porque el nombre no está en la tabla de facturas.

Imaginemos que queremos hacer el mismo filtro, pero que aparezcan todos los nombres de los países. Para eso lo mejor es que filtremos indicando que queremos que los resultados los busque en la tabla paises.

$this->addFilterAutocomplete('ListFacturaCliente', 'codpais', 'country', 'codpais', 'paises', 'codpais', 'nombre');

Ahora si. Está filtrando todos los resultados de facturas del país indicado, pero sacando los nombres de los paises de la tabla paises.

Ejemplo en un EditController

En los EditController no se puede llamar directamente a $this->addFilterAutocomplete(). Hay que hacerlo con $this->views.

$this->listView($viewName)->addFilterAutocomplete('codpais', 'country', 'codpais', 'paises', 'codpais', 'nombre');