Document toolboxDocument toolbox

Campos 'Lista'

Los campos Lista permiten crear una lista de valores. Los valores se pueden añadir de manera manual o  importando desde una fuente de datos externa. 

 

PropiedadDescripción
NombreEl nombre aparecerá como etiqueta del campo. Tiene una limitación de 100 caracteres.
DescripciónDescripción del campo. Esta descripción aparecerá junto al campo en el proyecto.
JavaScriptProfields permite asociar código JavaScript a cualquier tipo de campo. El código aquí incluido se ejecutará al salir de ese campo cuando se edite por un usuario.
Rol de VisualizaciónPermite elegir el rol que podrá visualizar el campo que se está creando.
Rol de EdiciónSelecciona el rol que podrá editar el campo que se está creando.
MultiselecciónEste checkbox permite indicar que se puede seleccionar más de un valor de la lista.

Fuente de Datos

Desde ésta opción decidimos la manera en la que se obtendrán los valores del campo, existen dos opciones: Interna o Externa.

Interna

Selecciona la opción Interna para añadir los valores de la lista uno a uno o bien importarlos desde una base de datos. Al seleccionar la opción Interna aparece la siguiente pantalla:

 

  • Campo Padre

Selecciona un Campo Padre para relacionar los valores de la lista con el valor de ese campo. Mediante ésta opción podemos hacer que los valores mostrados en el campo lista dependan del valor que se seleccione en el Campo Padre.

Ej. Vamos a crear un campo lista llamado ‘Cities’ cuyos valores cambien en función del valor seleccionado en un campo ‘Country’, para ello primero selecciona ‘Country’ (este campo ha sido creado previamente y ya contiene valores) de la lista 'Campo Padre'.

Los valores del campo padre ‘Country’ aparecen en una lista. 

A continuación, seleccionando cada valor del campo ‘Country’ puedo crear valores específicos para cada uno de ellos, en este caso ‘Cities’. 

Una vez hecho, el campo lista ‘Municipios’ mostrará los valores en función del valor del campo padre ‘Provincia’...

  • Valores

Desde el apartado Valores eligiremos la forma en la que vamos a añadar los valores de los campos lista, se pueden añadir de dos maneras:

Importar desde Base de Datos. Si queremos ahorrarnos tener que introducir los valores manualmente, ésta opción permite conectarse a una base de datos y ejecutar una consulta para importar los valores desde una tabla al campo lista, éstos valores no permanecen vinculados a la base  de datos:

Los datos importados mediante ésta opción no guardan integridad con la fuente de datos. Si cambian los valores de la fuente de datos no se reflejarán en los valores de la lista. Esta acción borrará los Valores existentes en la lista.


Manualmente. Selecciona esta opción para añadir uno por uno cada valor de la lista.

Para ello se debe introducir el nombre de cada Valor y su Id (opcional) correspondiente:

Los valores también se pueden eliminar una vez añadidos y de manera opcional también se pueden deshabilitar de manera individual para que no aparezcan en la lista sin necesidad de eliminarlos.

Externa

Selecciona la opción Externa para hacer que el campo Lista se conecte a una base de datos para obtener los valores. 

Al seleccionar la opción Externa aparece la siguiente pantalla:

  • Campo Padre

Selecciona un Campo Padre para relacionar los valores de la lista con el valor de ese campo. Mediante ésta opción podemos hacer que los valores mostrados en el campo lista dependan del valor que se seleccione en el Campo Padre.

  • Conexión

Selecciona una conexión de la lista para elegir a qué Base de Datos vas a conectarte para obtener los valores.

Éstas conexiones se configuran y almacenan desde: 'Administration' > 'Plugins' > 'Profields' > 'Conexiones a Fuentes de Datos' .

  • Query "SELECT" *

Después de seleccionar la Conexión correspodniente, en este campo se introduce la query SQL que tiene que obtener los valores que queremos.

El botón Previsualizar nos muestra en una ventana los datos obtenidos mediante la query introducida

Los valores del campo lista obtenidos mediante la opción Externa quedan vinculados a la fuente de datos seleccionada, conectándose ésta fuente de datos cada vez que el campo aparece en pantalla para obtener los valores.