Saltar al contenido principal
Versión: 20 R10 BETA

Fuente de datos

Inserción automática​

Cuando se selecciona esta opción, si un usuario introduce un valor que no se encuentra en la lista asociada al objeto, este valor se añade automáticamente a la lista almacenada en memoria.

Cuando la opción inserción automática no está definida (por defecto), el valor introducido se almacena en el objeto formulario pero no en la lista en memoria.

Esta propiedad es soportada por:

  • objetos formulario Combo box y columna list box asociadoa a una lista de selección.
  • objetos de formulario Combo box cuya lista asociada se llena mediante su array o fuente de datos de objetos.

Por ejemplo, dada una lista de selección que contiene "Francia, Alemania, Italia" que está asociada a un combo box "Países": si la propiedad inserción automática está activada y un usuario introduce "España", entonces el valor "España" se añade automáticamente a la lista en memoria:

Si la lista de selección se creó a partir de una lista definida en el modo Diseño, la lista original no se modifica.

Gramática JSON​

NombreTipos de datosValores posibles
automaticInsertionbooleantrue, false

Objetos soportados​

Combo Box - Columna List Box

Lista de selección​

Asocia una lista de selección a un objeto. Puede ser un nombre de lista de elección (una referencia de lista) o una colección de valores por defecto.

Gramática JSON​

NombreTipos de datosValores posibles
choiceListlist, collectionUna lista de valores posibles
listalist, collectionUna lista de valores posibles (listas jerárquicas únicamente)

Objetos soportados​

Lista desplegable - Combo box - Lista Jerárquica - Columna List Box

Comandos​

OBJECT Get list name - OBJECT Get list reference - OBJECT SET LIST BY NAME - OBJECT SET LIST BY REFERENCE

Lista de selección (lista estática)​

Lista de valores estáticos a utilizar como etiquetas para el objeto de control de pestañas.

Gramática JSON​

NombreTipos de datosValores posibles
labelslist, collectionUna lista de valores para llenar el control de pestañas

Objetos soportados​

Control de pestañas

Elemento actual​

List box colección o entity selection

Especifica una variable o expresión a la que se asignará el elemento/entidad de la colección seleccionado por el usuario. Debe utilizar una variable objeto o una expresión asignable que acepte objetos. Si el usuario no selecciona nada o si ha utilizado una colección de valores escalares, se asigna el valor Null.

Esta propiedad es de "sólo lectura", se actualiza automáticamente según las acciones del usuario en el list box. No se puede editar su valor para modificar el estado de selección del list box.

Gramática JSON​

NombreTipos de datosValores posibles
currentItemSourcestringExpresión del objeto

Objetos soportados​

List Box

Comandos​

LISTBOX Get property - LISTBOX SET PROPERTY

Posición elemento actual​

List box colección o entity selection

Indica una variable o expresión a la que se le asignará un entero largo que indica la posición del elemento/entidad de colección seleccionado por el usuario.

  • si no se selecciona ningún elemento/entidad, la variable o expresión recibe cero,
  • si se selecciona un solo elemento/entidad, la variable o expresión recibe su ubicación,
  • si se seleccionan varios elementos/entidades, la variable o expresión recibe la posición del elemento/entidad que se seleccionó de última.

Esta propiedad es de "sólo lectura", se actualiza automáticamente según las acciones del usuario en el list box. No se puede editar su valor para modificar el estado de selección del list box.

Gramática JSON​

NombreTipos de datosValores posibles
currentItemPositionSourcestringExpresión numérica

Objetos soportados​

List Box

Comandos​

LISTBOX Get property - LISTBOX SET PROPERTY

Tipo de datos (tipo de expresión)​

Define el tipo de datos para la expresión mostrada. Esta propiedad se utiliza con:

Ver también la sección Tipo de Expresión.

Gramática JSON​

NombreTipos de datosValores posibles
dataSourceTypeHintstring
  • columnas list box: "boolean", "number", "picture", "text", date", "time". Sólo array/list box selección: "integer", "object"
  • listas desplegables: "object", "arrayText", "arrayDate", "arrayTime", "arrayNumber"

    • Objetos soportados​

    Listas desplegables asociadas a objetos o arrays - Columna List Box

    Tipo de datos (lista)​

    Define el tipo de datos a guardar en el campo o variable asociado a la lista desplegable. Esta propiedad se utiliza con:

    Hay tres opciones disponibles:

    • Referencia de lista: declara que la lista desplegable es jerárquica. Significa que la lista desplegable puede mostrar hasta dos niveles jerárquicos y su contenido puede gestionarse mediante los comandos del lenguaje 4D del tema Listas jerárquicas.
    • Valor del elemento seleccionado (por defecto): la lista desplegable no es jerárquica y el valor del elemento elegido en la lista por el usuario se guarda directamente. Por ejemplo, si el usuario elige el valor "Azul", este valor se guarda en el campo.
    • Referencia del elemento seleccionado: la lista desplegable no es jerárquica y la referencia del elemento de la lista de selección se guarda en el objeto. Esta referencia es el valor numérico asociado a cada elemento, ya sea a través del parámetro itemRef de los comandos APPEND TO LIST o SET LIST ITEM, o en el editor de listas. Esta opción permite optimizar el uso de la memoria: almacenar valores numéricos en los campos ocupa menos espacio que almacenar cadenas. También facilita la traducción de aplicaciones: basta con crear varias listas en distintos idiomas pero con las mismas referencias de elementos y, a continuación, cargar la lista en función del idioma de la aplicación.

    La utilización de la opción Referencia del elemento seleccionado requiere el cumplimiento de los siguientes principios:

    • Para poder almacenar la referencia, el campo o fuente de datos variable debe ser de tipo Número (independientemente del tipo de valor que aparezca en la lista). La propiedad expresión se define automáticamente.
    • Las referencias válidas y únicas deben estar asociadas a los elementos de la lista.
    • La lista desplegable debe estar asociada a un campo o a una variable.

    Gramática JSON​

    NombreTipos de datosValores posibles
    saveAsstring"value", "reference"

    Definir sólo "dataSourceTypeHint" : "integer" con un "type": "dropdown" objeto de formulario declarará una lista desplegable jerárquica.

    Objetos soportados​

    Listas desplegables asociadas a listas

    Valores por defecto (lista de)​

    Lista de valores que se utilizarán como valores por defecto para la columna del list box (sólo de tipo array). Lista de valores que se utilizarán como valores por defecto para la columna del list box (sólo de tipo array). Utilizando el lenguaje, se puede gestionar el objeto haciendo referencia a este array.

    No confunda esta propiedad con la propiedad "valor por defecto" que permite definir un valor de campo en los nuevos registros.

    Debe introducir una lista de valores. En el editor de formularios, un diálogo específico permite introducir valores separados por retornos de carro:

    También puede definir una lista de selección con la columna list box. Sin embargo, se utilizará una lista de selección como lista de valores seleccionables para cada línea de columna, mientras que la lista por defecto rellena todas las líneas de columna.

    Gramática JSON​

    NombreTipos de datosValores posibles
    valuescollectionUna colección de valores por defecto (cadenas), por ejemplo: "a", "b", "c", "d"

    Objetos soportados​

    Columna List Box (sólo tipo array)

    Expression​

    This description is specific to selection and collection type list box columns. Ver también la sección Variable o Expresión.

    Una expresión 4D que se asociará a una columna. Puede introducir:

    • Una variable simple (en este caso, debe ser declarada explícitamente para la compilación). Se puede utilizar cualquier tipo de variable excepto BLOBs y arrays. El valor de la variable se calculará generalmente en el evento On Display Detail.

    • Un campo que utiliza la sintaxis estándar [Tabla]Campo (solo list box tipo selección), por ejemplo: [Employees]LastName. Se pueden utilizar los siguientes tipos de campos:

      • String
      • Numeric
      • Fecha
      • Hora
      • Picture
      • Boolean
        Puede utilizar campos de la tabla maestra o de otras tablas.

    • Una expresión 4D (expresión simple, fórmula o método 4D). La expresión debe devolver un valor. La expresión debe devolver un valor. El resultado de la expresión se mostrará automáticamente cuando cambie al modo Aplicación. La expresión se evaluará para cada registro de la selección (actual o temporal) de la tabla maestra (para list boxes de tipo selección), cada elemento de la colección (para list boxes de tipo colección) o cada entidad de la selección (para list boxes selección de entidades). Si está vacía, la columna no mostrará ningún resultado. Se soportan los siguientes tipos de expresiones:

      • String
      • Numeric
      • Fecha
      • Picture
      • Boolean

    Para los list boxes colección/entity selection, Null o tipos no soportados se muestran como cadenas vacías.
    Cuando utilice colecciones o selecciones de entidades, normalmente declarará la propiedad del elemento o el atributo de entidad asociado a una columna dentro de una expresión que contenga This.
    Cuando utilice colecciones o selecciones de entidades, normalmente declarará la propiedad del elemento o el atributo de entidad asociado a una columna dentro de una expresión que contenga This.
    Cuando utilice colecciones o selecciones de entidades, normalmente declarará la propiedad del elemento o el atributo de entidad asociado a una columna dentro de una expresión que contenga This. This es un comando 4D dedicado que devuelve una referencia al elemento actualmente procesado. Por ejemplo, puede utilizar This.\<propertyPath> donde \<propertyPath> es la ruta de una propiedad en la colección o una ruta de atributo de entidad para acceder al valor actual de cada elemento/entidad. Si utiliza una colección de valores escalares, 4D creará un objeto para cada elemento de la colección con una única propiedad (llamada "valor"), llenada con el valor del elemento. En este caso, utilizará This.value como expresión.

    Si se utiliza una expresión no asignable (por ejemplo, [Person]FirstName+" "+[Person]LastName), la columna nunca se podrá introducir aunque la propiedad Editable esté activada.

    Si se utiliza un campo, una variable o una expresión asignable (por ejemplo Person.lastName), la columna puede ser editable o no dependiendo de la propiedad Editable.

    Gramática JSON​

    NombreTipos de datosValores posibles
    dataSourcestringUna variable 4D, un nombre de campo o una expresión del lenguaje compleja arbitraria.

    Objetos soportados​

    Columna de list box

    Tabla principal​

    Current selection list boxes

    Especifica la tabla cuya selección actual se utilizará. Esta tabla y su selección actual constituirán la referencia de los campos asociados a las columnas del list box (referencias de campo o expresiones que contienen campos). Aunque algunas columnas contengan campos de otras tablas, el número de líneas mostradas será definido por la tabla maestra.

    Se pueden utilizar todas las tablas de la base de datos, independientemente de si el formulario está relacionado con una tabla (formulario tabla) o no (formulario proyecto).

    Gramática JSON​

    NombreTipos de datosValores posibles
    tablanumberNúmero de tabla

    Objetos soportados​

    List Box

    Comandos​

    LISTBOX GET TABLE SOURCE - LISTBOX SET TABLE SOURCE

    Guardar como​

    Esta propiedad está disponible en las siguientes condiciones:

    Esta propiedad especifica, en el contexto de un campo o variable asociado a una lista de valores, el tipo de contenido a guardar:

    • Guardar como valor (opción por defecto): el valor del elemento elegido en la lista por el usuario se guarda directamente. Por ejemplo, si el usuario elige el valor "Azul", este valor se guarda en el campo.
    • Guardar como referencia: la referencia del elemento de la lista de opciones se guarda en el objeto. Esta referencia es el valor numérico asociado a cada elemento, ya sea a través del parámetro itemRef de los comandos APPEND TO LIST o SET LIST ITEM, o en el editor de listas.

    Esta opción permite optimizar el uso de la memoria: almacenar valores numéricos en los campos ocupa menos espacio que almacenar cadenas. También facilita la traducción de aplicaciones: basta con crear varias listas en distintos idiomas pero con las mismas referencias de elementos y, a continuación, cargar la lista en función del idioma de la aplicación.

    El uso de esta propiedad requiere el cumplimiento de los siguientes principios:

    • Para poder almacenar la referencia, el campo o fuente de datos variable debe ser de tipo Número (independientemente del tipo de valor que aparezca en la lista). La propiedad expresión se define automáticamente.
    • Las referencias válidas y únicas deben estar asociadas a los elementos de la lista.

    Gramática JSON​

    NombreTipos de datosValores posibles
    saveAsstring"value", "reference"

    Objetos soportados​

    Área de entrada - Columna List Box

    Elementos seleccionados​

    List box colección o entity selection

    Especifica una variable o expresión a la que se asignarán los elementos o entidades seleccionados por el usuario.

    • para un list box colección, debe utilizar una variable colección o una expresión asignable que acepte colecciones,
    • para un list box selección de entidades, se crea un objeto de selección de entidades. Debe utilizar una variable objeto o una expresión asignable que acepte objetos.

    Esta propiedad es de "sólo lectura", se actualiza automáticamente según las acciones del usuario en el list box. No se puede editar su valor para modificar el estado de selección del list box.

    Gramática JSON​

    NombreTipos de datosValores posibles
    selectedItemsSourcestringAssignable collection or object expression

    Objetos soportados​

    List Box

    Comandos​

    LISTBOX Get property - LISTBOX SET PROPERTY

    Selección temporal​

    List boxes de tipo selección nombrada

    Especifica la selección temporal a utilizar. Debe introducir el nombre de una selección temporal válida. Puede ser una selección temporal proceso o interproceso. El contenido del list box se basará en esta selección. La selección elegida debe existir y ser válida en el momento en que se muestre el list box; de lo contrario, el list box se mostrará en blanco.

    Las selecciones temporales son listas ordenadas de registros. Se utilizan para mantener en memoria el orden y el registro actual de una selección. Para más información, consulte la sección Selecciones temporales del manual Lenguaje 4D.

    Gramática JSON​

    NombreTipos de datosValores posibles
    namedSelectionstringNombre de la selección

    Objetos soportados​

    List Box

    Comandos​

    LISTBOX GET TABLE SOURCE - LISTBOX SET TABLE SOURCE