Listas
Última actualización
¿Te fue útil?
Última actualización
¿Te fue útil?
Conjunto de comandos de proceso que permite interactuar con una lista de registros de una .
Este tipo de comandos solamente estarán accesibles en aquellas líneas de proceso cuyo origen sea una lista de de registros de una tabla.
Comando de instrucción del grupo Listas que permite añadir una ficha a la lista en curso.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
Identificador o manejador dado a la ficha mediante la ejecución previa de los comandos Crear nueva ficha en memoria o Crear copia de ficha en memoria.
Permite añadir a la lista en curso una ficha local al proceso creada previamente mediante los comandos Crear nueva ficha en memoria o Crear copia de ficha en memoria.
Esta ficha será local al proceso, por lo que será destruida al finalizar el mismo. En el caso de una ficha creada mediante el comando , para que ésta pueda ser añadida a la lista ha de ser guardada en disco previamente, por lo que antes de añadirla a la lista tendremos que guardarla en disco usando el comando , en este comando la ficha será referenciada con el manejador declarado en su parámetro.
Comando de instrucción del grupo Listas que recorta el número de elementos de una la lista a partir de una posición determinada.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
Tamaño o número de elementos de la nueva lista.
Posición a partir de la cual se quiere cortar la lista. La primera posición de la lista será la 1. El número 0 no es un valor válido para este parámetro.
Este comando de instrucción recorta el número de elementos de la lista de origen de la línea del proceso al tamaño dado en el primer parámetro desde la posición especificada en el segundo parámetro.
El resto de los elementos no son borrados de la tabla de datos, sólo son quitados de la lista de origen.
Este comando no crea ningún tipo de subproceso, es simplemente un paso que altera el contenido de la lista de origen. La siguiente línea del proceso al mismo nivel que ésta partirá de la lista obtenida.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
Objeto informe cuya tabla asociada es la misma que la del origen de la línea del proceso donde estamos incluyendo este comando de instrucción.
Senda del fichero a generar. La senda ha de incluir el nombre y la extensión del fichero. Este parámetro puede ser una cadena o literal, un campo, una variable, el retorno de una función, etc. Para su especificación podemos hacer uso del asistente para la creación de formularios.
Comando de instrucción de proceso que genera el fichero indicado en el segundo parámetro a partir del informe seleccionado en el primer parámetro.
El proceso se paralizará durante la generación del informe y, una vez generado, continuará la ejecución secuencial del proceso.
Los formatos posibles de fichero son pdf y eps. La generación de uno u otro dependerá de la extensión que especifiquemos al definir la senda. Ejemplo:
Exportar informe a fichero (FACTURA, sysCacheClientPath + “/Informe.pdf”) El informe se generará en formato pdf.
Exportar informe a fichero (FACTURA, sysCacheClientPath + “/Informe.eps”) El informe se generará en formato eps.
Comando de instrucción del grupo Listas que quita de la lista de origen los elementos que no cumplan una determinada condición.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
Expresión de tipo fórmula en la que se establecerá el filtro a realizar. En la misma podremos usar campos de la tabla en curso.
Quita de la lista los elementos que no cumplan la condición especificada en sus parámetros. Los elementos filtrados no son borrados en la tabla de datos, sólo son quitados de la lista.
Este comando no crea ningún tipo de subproceso, es simplemente un paso que altera el contenido de la lista en curso. La siguiente función del proceso al mismo nivel tendrá como origen la lista filtrada.
Para facilitar la especificación de la fórmula podremos hacer uso del asistente para edición de fórmulas.
Comando de instrucción del grupo Listas que se encarga de realizar la acción de enviar a una impresora un informe.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
Objeto informe cuya tabla asociada es la misma que la del origen de la línea del proceso donde estamos incluyendo este comando de instrucción.
Si seleccionamos el valor .ninguno lo que mandará será la salida declarada en el objeto informe:
Si la salida del informe es cuadro selección de impresora: Antes de imprimir el informe en el proceso se presentará el cuadro de selección de impresora del sistema.
Si la salida del informe es impresora por defecto: El informe será enviado directamente a la impresora por defecto del sistema.
Si la salida del informe es impresora lógica: El informe será impreso en la impresora lógica asociada al objeto informe.
Si la salida del informe es presentación prelimnar: El informe será enviado directamente a la impresora por defecto del sistema.
Si la salida del informe es fichero: El informe será generado directamente en el disco en la senda y con el nombre especificado en sus propiedades.
Comando de instrucción de proceso que realiza la acción de enviar a una impresora un informe.
El proceso se paralizará durante la generación del informe y, una vez generado, continuará la ejecución secuencial del proceso.
Este comando está programado para imprimir directamente sin generar interfaz. Por eso en aquellos informes cuya salida genere interfaz, como la presentación preliminar, si no se selecciona impresora lógica, son enviados directamente a la impresora por defecto del sistema.
Si en el parámetro Identificador de impresora lógica hemos seleccionado alguna y ésta no está asociada a ninguna impresora física, al imprimir el informe se abrirá el cuadro de diálogo de selección de impresora del sistema operativo.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
En este parámetro, que es de tipo fórmula, resolveremos el informe personalizable. El contenido dependerá de lo que hayamos indicado en el parámetro anterior. Si es fórmula, en la fórmula compondremos directamente el código xml correspondiente a la definición del informe. Si es fichero, indicaremos la senda donde está almacenado el archivo XML con la definición del informe.
Nos permitirá definir el tipo de fichero de salida. Los formatos posibles son: html, imagen, pdf y svg.
Senda del fichero a generar. La senda ha de incluir el nombre y la extensión del fichero. Este parámetro puede ser una cadena o literal, un campo, una variable, el retorno de una función, etc. Para su especificación podemos hacer uso del asistente para la creación de formularios.
Es posible pasar parámetros al informe personalizable a generar. Estos han de ser resueltos con el formato siguiente: parametro1:valor1|parametro2:valor2….
Para usar estos parámetros en un campo de un informe, tendremos que especificar en la propiedad tipo de origen de campo el valor parámetro y, en la propiedad campo especificar el identificador del parámetro dado en este comando de instrucción de proceso.
Por lo tanto, estos parámetros no se declaran en el informe, sino que se declaran en el comando de instrucción de proceso que genera el informe.
“fecha:” + currentDate() + “|” + “hora:” + currentTime()
Para crear un campo en el informe para imprimir el parámetro al que hemos llamado fecha, haríamos:
Permite exportar a disco un informe personalizable alimentado con los registros de la lista de origen.
No es posible exportar a fichero informes personalizables desde procesos ejecutados en tercer o en cuarto plano.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
Es posible pasar parámetros al informe personalizable a generar. Estos han de ser resueltos con el formato siguiente: parametro1:valor1|parametro2:valor2….
Para usar estos parámetros en un campo de un informe, tendremos que especificar en la propieda dtipo de origende campo el valor parámetro y, en la propiedad campo especificar el identificador del parámetro dado en este comando de instrucción de proceso.
Por lo tanto, estos parámetros no se declaran en el informe, sino que se declaran en el comando de instrucción de proceso que genera el informe.
Por ejemplo, supongamos que en el comando de instrucción de proceso de informe personalizable: previsualizar informe queremos pasar en, sendas variables, la fecha y la hora del sistema. Podríamos resolverlos como sigue:
“fecha:” + currentDate() + “|” + “hora:” + currentTime()
Para crear un campo en el informe para imprimir el parámetro al que hemos llamadofecha, haríamos:
Funcionalidad
El informe solamente se necesita para obtener el origen de datos y definir las secciones y es en el siguiente parámetro donde definimos qué campos se muestran y cómo.
Comando de instrucción del grupo listas que permite imprimir un informe personalizable alimentado con los registros de la lista de origen. Un informe personalizable es un archivo con formato XML que puede ser usado desde Velneo, de forma integrada con la base de datos.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
En este parámetro especificaremos de qué modo vamos a suministrar el XML del informe a exportar a disco. Los valores posibles son fórmula, que implicará que compondremos el código XML directamente en una fórmula o fichero, que implicará la selección de un fichero externo que contendrá el XML con la configuración del informe.
En este parámetro, que es de tipo fórmula, resolveremos el informe personalizable. El contenido dependerá de lo que hayamos indicado en el parámetro anterior. Si es fórmula, en la fórmula compondremos directamente el código xml correspondiente a la definición del informe. Si es fichero, indicaremos la senda donde está almacenado el archivo XML con la definición del informe.
Nos permitirá definir si el informe será enviado a la impresora por defecto del sistema o no.
Es posible pasar parámetros al informe personalizable a generar. Estos han de ser resueltos con el formato siguiente: parametro1:valor1|parametro2:valor2….
Para usar estos parámetros en un campo de un informe, tendremos que especificar en la propiedad tipo de origen de campo el valor parámetro y, en la propiedad campo especificar el identificador del parámetro dado en este comando de instrucción de proceso.
Por lo tanto, estos parámetros no se declaran en el informe, sino que se declaran en el comando de instrucción de proceso que genera el informe.
Por ejemplo, supongamos que en el comando de instrucción de proceso de informe personalizable: previsualizar informe queremos pasar en, sendas variables, la fecha y la hora del sistema. Podríamos resolverlos como sigue:
“fecha:” + currentDate() + “|” + “hora:” + currentTime()
Para crear un campo en el informe para imprimir el parámetro al que hemos llamado fecha, haríamos:
Este comando de instrucción permite imprimir un informe personalizable alimentado con los registros de la lista de origen.
No es posible imprimir informes personalizables desde procesos ejecutados en tercer o en cuarto plano.
Comando de instrucción del grupo listas que permite hacer la vista previa de un informe personalizable con los registros de la lista de origen. Un informe personalizable es un archivo con formato XML que puede ser usado desde Velneo, de forma integrada con la base de datos.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
En este parámetro especificaremos de qué modo vamos a suministrar el XML del informe a exportar a disco. Los valores posibles son fórmula, que implicará que compondremos el código XML directamente en una fórmula o fichero, que implicará la selección de un fichero externo que contendrá el XML con la configuración del informe.
En este parámetro, que es de tipo fórmula, resolveremos el informe personalizable. El contenido dependerá de lo que hayamos indicado en el parámetro anterior. Si es fórmula, en la fórmula compondremos directamente el código xml correspondiente a la definición del informe. Si es fichero, indicaremos la senda donde está almacenado el archivo XML con la definición del informe.
Es posible pasar parámetros al informe personalizable a generar. Estos han de ser resueltos con el formato siguiente: parametro1:valor1|parametro2:valor2….
Para usar estos parámetros en un campo de un informe, tendremos que especificar en la propiedad tipo de origen de campo el valor parámetro y, en la propiedad campo especificar el identificador del parámetro dado en este comando de instrucción de proceso.
Por lo tanto, estos parámetros no se declaran en el informe, sino que se declaran en el comando de instrucción de proceso que genera el informe.
Por ejemplo, supongamos que en el comando de instrucción de proceso de informe personalizable: previsualizar informe queremos pasar en, sendas variables, la fecha y la hora del sistema. Podríamos resolverlos como sigue:
"fecha:" + currentDate() + “|” + “hora:” + currentTime()
Para crear un campo en el informe para imprimir el parámetro al que hemos llamado fecha, haríamos:
Este comando de instrucción permite hacer la vista previa de un informe personalizable con los registros de la lista de origen.
Comando de instrucción del grupo Listas que invierte el orden de la lista de origen.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
No tiene.
Invierte el orden de la lista de origen, tomando como campo de referencia aquel por el que la lista haya sido ordenada previamente.
Este comando no crea ningún tipo de subproceso. La siguiente línea del proceso al mismo nivel tendrá como origen la lista ya invertida.
Comando de instrucción del grupo Listas que parte la lista actual por cada ficha encontrada en la que el valor del campo de partición sea diferente al anterior.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Lista de la tabla en curso.
En este parámetro se especificará el campo de la tabla el curso por el que la lista será multipartida.
Por cada valor diferente que tenga el campo seleccionado se originará una nueva sub-lista que agrupará los registros correspondientes a ese valor. El subproceso que este comando genera será ejecutado por cada sub-lista obtenida. Si no hay registros en la lista de origen, no será ejecutado el subproceso.
Este comando ordena ascendentemente la lista por el campo seleccionado en el parámetro antes de realizar la multipartición.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
Primer campo de ordenación. Podrá tratarse de un campo de la tabla de origen o de un campo de cualquiera de sus tablas enlazadas.
Segundo campo de ordenación.
Tercer campo de ordenación.
Cuarto campo de ordenación.
Quinto campo de ordenación.
Sexto campo de ordenación.
Este comando de instrucción permite ordenar la lista en curso por el campo o campos especificados en sus parámetros. La lista será ordenada en primera instancia por el campo seleccionado en el primer parámetro y si se especifica más de un campo de ordenación, la lista ordenará por el segundo cuando haya valores coincidentes en el primero, por el tercero cuando haya valores coincidentes en el segundo y así sucesivamente.
Ejemplo: Si ordenamos una lista de artículos por los campo FAMILIA, MARCA y NOMBRE, ésta será ordenada por FAMILIA dentro de cada familia por MARCA y dentro de cada MARCA por orden alfabético.
Esta función no crea ningún subproceso, es un simple paso. La siguiente línea del proceso que se cree al nivel de ésta, tendrá como origen la lista ordenada.
Para realizar la ordenación, el sistema hace una indexación previa. El tamaño de las claves es de 24 caracteres para los campos alfabéticos menores que alfa256 y de 48 para campos alfa256 y superiores. Por lo tanto, si queremos ordenar listas que contengan cadenas cuya parte común supere esos límites, nuestra recomendación es crear un índice alfabético con dicho campo y en el proceso usar el comando Cargar lista.
Comando de instrucción del grupo Listas que permite quitar un elemento de la lista de origen pero sin borrarlo de la base de datos.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ninguno.
Expresión fórmula que resuelva la posición del elemento a quitar de la lista. La primera posición será 1.
Comando de instrucción que permite quitar el elemento especificado en el parámetro fórmula posición de la lista de origen pero sin borrarlo de la base de datos.
Para facilitar la especificación del elemento a quitar podremos hacer uso del asistente para edición de fórmulas. Al tratarse de una fórmula podrá ser tanto un dato constante como uno variable.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ficha a eliminar de la tabla en curso.
No tiene.
Recorre la lista de origen borrando los registros de la misma, disparando, por cada ficha borrada, las actualizaciones declaradas en la tabla asociada a la lista.
Este comando genera un subproceso que será ejecutado por cada ficha a borrar; el origen de dicho subproceso, por tanto, será ficha de la tabla en curso. Las instrucciones que se incluyan dentro del subproceso serán ejecutadas por cada registro de la lista. Este subproceso será ejecutado antes del borrado de la ficha. El subproceso que genera no se ejecutará si no hay registros.
Si queremos borrar las fichas sin que se disparen las actualizaciones tendremos que usar el comando de instrucción Recorrer lista eliminando fichas sin desactualizar.
Comando de instrucción del grupo Listas que recorre la lista de origen borrando los registros de la misma sin disparar, por cada ficha borrada, las actualizaciones declaradas en la tabla asociada a la lista.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ficha a eliminar de la tabla en curso.
No tiene.
Recorre la lista de origen borrando los registros de la misma pero no disparará, por cada ficha borrada, las actualizaciones declaradas en la tabla asociada a la lista.
Este comando genera un subproceso que será ejecutado por cada ficha a borrar; el origen de dicho subproceso, por tanto, será ficha de la tabla en curso. Las instrucciones que se incluyan dentro del subproceso serán ejecutadas por cada registro de la lista. Este subproceso será ejecutado antes del borrado de la ficha. Dicho subproceso no se ejecutará si no hay registros.
Este comando, dado que implica escritura en disco, genera transacción.
El borrado de un registro implicará la ejecución de los eventos de tabla de baja de ficha.
Comando de instrucción del grupo Listas que recorre la lista de origen y modifica los registros de la misma.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ficha a eliminar de la tabla en curso.
No tiene.
Recorre la lista de origen y ejecuta las instrucciones que cuelgan en el subproceso con cada registro de la misma. Este comando genera un subproceso que será ejecutado por cada ficha a modificar; el origen de dicho subproceso, por tanto, será ficha de la tabla en curso.
Las instrucciones que se incluyan dentro del subproceso serán ejecutadas por cada registro de la lista. Este subproceso será en el que se incluyan las instrucciones que modifiquen los campos de la ficha. Dicho subproceso no se ejecutará si no hay registros en la lista.
Este comando, dado que implica escritura en disco, genera transacción.
La modificación de un registro implicará la ejecución de los eventos de tabla de modificación de ficha y el disparo de las actualizaciones en las que intervengan los campos modificados en el proceso.
Cada ficha procesada permanecerá bloqueada mientras dure el subproceso que este comando genera; esto quiere decir que la ficha podrá ser leída pero no bloqueada en modo lectura-escritura desde otros procesos o por otros usuarios.
Para modificar el contenido de un campo usaremos el comando de proceso Modificar campo.
Comando de instrucción del grupo Listas que recorre la lista de origen y permite leer uno a uno los registros de la misma.
Origen de la instrucción: Lista de la tabla en curso.
Destino del subproceso: Ficha a eliminar de la tabla en curso.
No tiene.
Recorre la lista de origen y ejecuta las instrucciones que cuelgan en el subproceso con cada registro de la misma. Este comando genera un subproceso que será ejecutado por cada ficha a leer; el origen de dicho subproceso, por tanto, será ficha de la tabla en curso.
Las instrucciones que se incluyan dentro del subproceso serán ejecutadas por cada registro de la lista. Dicho subproceso no se ejecutará si no hay registros en la lista.
Este comando abre las fichas en modo de sólo lectura, por tanto, no genera transacción y no es posible modificar las fichas procesadas en el subproceso que genera.
En el caso de que se desee recorrer la lista de origen para modificar los registros contenidos en la misma, tendremos que usar el comando de instrucción Recorrer lista lectura/escritura.
Los dos parámetros son expresiones de tipo fórmula por lo que podremos hacer uso del para facilitar su especificación.
Comando de instrucción del grupo Listas que se encarga de realizar la acción de generar un fichero en disco a partir del .
No es posible exportar informe a fichero desde procesos ejecutados en .
Si queremos imprimir el informe en una en este parámetro seleccionaremos la impresora lógica de salida.
Como sabemos, en las propiedades de un objeto de Velneo se define una salida, pues bien, en el caso de que desde un proceso queramos enviar un informe usando la salida definida en sus propiedades, podremos hacerlo usando .
No es posible imprimir informes desde procesos ejecutados en .
Comando de instrucción del grupo listas que permite exportar a disco un alimentado con los registros de la lista de origen. Un informe personalizable es un archivo con formato XML que puede ser usado desde Velneo, de forma integrada con la base de datos.
En este parámetro especificaremos de qué modo vamos a suministrar el XML del informe a exportar a disco. Los valores posibles son fórmula, que implicará que compondremos el código XML directamente en una o fichero, que implicará la selección de un fichero externo que contendrá el XML con la configuración del informe.
Por ejemplo, supongamos que en el comando de instrucción de proceso de informe queremos pasar en, sendas variables, la fecha y la hora del sistema. Podríamos resolverlos como sigue:
Comando de instrucción de proceso que permite exportar a un fichero de texto en disco un con los registros de la lista de origen. Un informe personalizable es un archivo con formato XML que puede ser usado desde Velneo, de forma integrada con la base de datos.
En este parámetro especificaremos de qué modo vamos a suministrar el XML del informe a exportar a disco. Los valores posibles sonfórmula, que implicará que compondremos el código XML directamente en una o fichero, que implicará la selección de un fichero externo que contendrá el XML con la configuración del informe.
En este parámetro, que es de tipo , resolveremos el informe personalizable. El contenido dependerá de lo que hayamos indicado en el parámetro anterior. Si esfórmula, en la fórmula compondremos directamente el código xml correspondiente a la definición del informe. Si esfichero, indicaremos la senda donde está almacenado el archivo XML con la definición del informe. El informe solamente se necesita para obtener el origen de datos y definir las secciones y es en el siguiente parámetro donde definimos qué campos se muestran y cómo.
La plantilla de texto será un fichero de texto donde se indica qué campos se muestran y cómo serán impresos. Los valores posibles son fórmula, que implicará que compondremos el texto directamente en una o fichero, que implicará la selección de un fichero externo que contendrá el fichero de texto.
En este parámetro, que es de tipo , resolveremos el fichero de texto. El contenido dependerá de lo que hayamos indicado en el parámetro anterior. Si esfórmula, en la fórmula compondremos directamente el contenido del fichero de texto. Si esfichero, indicaremos la senda donde está almacenado el archivo fichero de texto.
Senda del fichero a generar. La senda ha de incluir el nombre y la extensión del fichero. Este parámetro puede ser una cadena o literal, un campo, una variable, el retorno de una función, etc. Para su especificación podemos hacer uso del .
Este comando de instrucción permite exportar a un fichero de texto plano en disco un con los registros de la lista de origen.
Si queremos que el informe sea enviado a una la seleccionaremos en este parámetro.
Comando de instrucción del grupo Listas que permite ordenar la lista en curso por uno o varios .
La última posición de la lista podremos obtenerla por medio de la variable del sistema
Comando de instrucción del grupo Listas que recorre la lista de origen borrando los registros de la misma, disparando, por cada ficha borrada, las declaradas en la tabla asociada a la lista.
Este comando, dado que implica escritura en disco, genera .
El borrado de un registro implicará la ejecución de los de baja de ficha.
Si queremos borrar las fichas y que se disparen las actualizaciones tendremos que usar el comando de instrucción
