• 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

Guía del Widget Autocomplete

El Widget Autocomplete en los archivos XMLView permite autocompletar valores asociados a otra tabla o a la misma. A diferencia del widget select, este widget no selecciona opciones predefinidas; los usuarios escriben para que el sistema sugiera posibles valores.

<column name="customer" numcolumns="3" order="190">
    <widget type="autocomplete" fieldname="codcliente" onclick="EditCliente">
        <values source="clientes" fieldcode="codcliente" fieldtitle="nombre"/>
    </widget>
</column>

Atributos del Widget

Los siguientes son los atributos disponibles para la etiqueta <widget>:

• fieldname: Nombre del campo que contiene la información. Es obligatorio.
• required: Previene el guardado del formulario si no se ingresa un valor en el campo.
• readonly: Hace que el campo no sea editable.
• onclick: URL o controlador al que se redirigirá al usuario al hacer clic. Se añade ?code= seguido del valor del campo.
• icon: Icono a mostrar en el campo de edición.
• translate: Si se establece en true, los títulos de los valores se traducirán automáticamente.
• strict: true (predeterminado) para no permitir valores fuera de los dados.

Ejemplos de Visualización

En Formularios de Edición

En Listados

Definición de la Clase

Consulta la lista completa de propiedades y métodos del Widget Autocomplete en la documentación de la clase WidgetAutocomplete.

Configuración de Valores

Al igual que el widget select, el Widget Autocomplete requiere una etiqueta <values> para definir la fuente de los valores. Las propiedades disponibles para <values> son:

• source: Nombre de la tabla o modelo a consultar (por ejemplo, Cliente).
• fieldcode: Columna que contiene el valor seleccionado. Opcional si source es un modelo.
• fieldtitle: Columna que contiene el texto mostrado al usuario.
  • Si no se especifica fieldtitle, se utiliza fieldcode.
  • Opcional si source es un modelo.
  • Si translate está activado, el texto se traducirá.
• fieldfilter: (Opcional) Nombre de otro widget para enlazar resultados.

Nota

Si se utiliza un modelo en source y no se especifican fieldcode y fieldtitle, se mostrará el ID guardado. Para mostrar el valor correspondiente, es necesario especificar estos atributos.

Ejemplo de Uso

• Con source=Contacto, si no se especifican fieldcode y fieldtitle, el valor será el ID del contacto.
• Con fieldcode="idcontacto" y fieldtitle="nombre", se mostrará el nombre completo del contacto.

Modificación de Valores desde el Controlador

Es posible personalizar los valores devueltos sobrescribiendo el método autocompleteAction() en el controlador, el cual devuelve un JSON con los valores para el widget.

Opciones de Coloreado

Recuerda que todos los widgets comparten propiedades y opciones comunes.