Representa una origen de datos del sistema y una instancia de cada tipo necesario en un formulario es creada automáticamente por la aplicación. Esta instancia puede ser accedida en el código del formulario simplemente por su nombre. Asimismo una instancia adicional necesaria puede ser creada por código mediante la invocación del método de la aplicación 'datasource'.
Cambia el modo de ejecución del datasource a 'new' y agrega un registro al final de la colección.
Cambia el modo de ejecución del datasource a 'edit' permitiendo editar y guardar los datos del registro actual.
callback | Función a ser invocada luego de la ejecución del método en modo asíncrono. Cuando se utiliza este parametro la ejecución de la función se realiza de forma asíncrona. | ||||
|
Borra el registro actual del datasource.
callback | Función a ser invocada luego de la ejecución del método en modo asíncrono. Cuando se utiliza este parametro la ejecución de la función se realiza de forma asíncrona. | ||||
|
Guarda el registro activo si el datasource está en modo 'edit' o 'new'.
// sin callback if(clientes.save()){ alert("Los datos fueron guardados correctamente"); }else{ alert("Error guardando datos.\n"+clientes.lastError.description); }
clientes.save(function(status,result){ if (status){ alert("Los datos fueron guardados correctamente"); }else{ alert("Error guardando datos.\n"+result.description); } });
Cancela el modo 'edit' o 'new' volviendo al modo 'browse'.
callback | Función a ser invocada luego de la ejecución del método en modo asíncrono. Cuando se utiliza este parametro la ejecución de la función se realiza de forma asíncrona. | ||||
|
Valida todas las condiciones necesarias para ejecutar la acción indicada. Puede ser usada en modo síncrono y asíncrono excepto para datasources de tipo interacción en que es necesario usar la forma asíncrona debido a limitaciones tecnológicas en la integración con el Agente (Protocolo jsonp hacia el Baragent.exe).
Setea el modo de solo lectura al datasource entero y por lo tanto a los controles vinculados impidiendo que el usuario cambie datos.
Devuelve un array con los registros del datasource.
Devuelve el registro activo del datasource, undefined si no existe uno.
var part = stock.row(); if (part){ alert("Precio de venta "+part.price); }else{ ... }
Realiza una búsqueda recibiendo un json con los valores de los campos. Estos campos pueden ser los definidos como parámetros del filtro o cualquier otro campo del datasource. La expresión formada para la búsqueda es la indicada en el filtro mas un AND por cada uno de los parámetros que no forman parte del filtro. El parámetro opcional callback hace que el llamado a esta función sea de forma asíncrona.
// Ejemplo asincrono stock.find({partNro:10},function(status,error){ if(status){ if(stock.moveFirst()){ // } }else{ icc.ui.displayMessage(error) } })
// Ejemplo sincrono if (stock.find({partNro:10})){ if(stock.moveFirst()){ // } }else{ icc.ui.displayMessage(stock.lastError); }
callback | Función a ser invocada luego de la ejecución del método en modo asíncrono. Cuando se utiliza este parámetro la ejecución de la función se realiza de forma asíncrona | ||||
|
Mueve al principio el registro activo y retorna un boolean indicando el resultado de la operación.
callback | Función a ser invocada luego de la ejecución del método en modo asíncrono. Cuando se utiliza este parámetro la ejecución de la función se realiza de forma asíncrona. | ||||
|
Mueve hacia atrás el registro activo y retorna un boolean indicando el resultado de la operación.
callback | Función a ser invocada luego de la ejecución del método en modo asíncrono. Cuando se utiliza este parámetro la ejecución de la función se realiza de forma asíncrona. | ||||
|
Mueve hacia adelante el registro activo y retorna un boolean indicando el resultado de la operación.
callback | Función a ser invocada luego de la ejecución del método en modo asíncrono. Cuando se utiliza este parámetro la ejecución de la función se realiza de forma asíncrona. | ||||
|
Refresca la colección de registros utilizando los datos de los parámetros del filtro.
En modo 'new' o 'edit' borra los datos del registro actual dejando en ellos los valores iniciales definidos.
Borra la colección de registros actuales que tiene en memoria, así como también los datos ingresados en los parámetros del filtro.
field | Nombre del campo. | |
value | Valor a asignar al campo. |
Asigna valor a un campo del datasource. Dependiendo del modo en que se encuentre y si hay un registro activo el datasource puede automáticamente cambiar a otro estado como 'new' o 'edit'. El nombre del campo puede ser también el de uno de los parámetros del filtro prefijados con '@' en este caso el valor es almacenado para ser utilizado luego en la ejecución del método 'refresh'.
El modo de ejecución del datasource.
Contiene el último error encontrado en cualquier operación. Utilizada para obtener información detallada del error en la ejecución de métodos de forma síncrona, es decir sin utilizar función callback.