Variables

Conjunto de comandos del grupo Básicos. En el caso de los comandos de instrucción de proceso para operar con variables locales de tipo array, se puede observar que no existe un comando para leer una posición de un array.
Esto es así porque la lectura de una posición de una variable local de tipo array se hace de forma directa.
Para leer una posición del array, lo único que tendremos que hacer es añadir a su identificador el número de la posición a leer entre corchetes. La primera posición de un array es la 0. Ejemplo:
ID_VARIABLE[3]
Array: convertir a cadena
Comando de instrucción que permite convertir el contenido de una variable local de tipo array en una cadena. 
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
Identificador de variable local array
Identificador de la Variable local de tipo array a convertir a cadena.
Fórmula de separador
Expresión de tipo fórmula donde especificaremos el carácter que se usará en la cadena para separar los distintos elementos del array.
Identificador de variable local alfabética de retorno
Aquí se declara una variable local de tipo alfabético que recogerá el contenido de la variable local del tipo array especificada en el primer parémetro separados los elementos por el carácter indicado en el segundo parámetro.
Funcionalidad
Este comando de instrucción permite convertir el contenido de una variable local de tipo array en una cadena. 
Ejemplo
Vamos a convertir a cadena el contenido de la variable de tipo array ARRAY, usando el carácter | como seperador y dejando el resultado en una variable local alfabética llamada CADENA_ARRAY:
Array: Convertir a cadena ( ARRAY, "|", CADENA_ARRAY )
Array: crear desde cadena
Comando de instrucción que permite convertir una cadena en un array.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
Fórmula de cadena
Expresión de tipo fórmula donde especificaremos la cadena cuyo contenido se quiere convertir en array.
Fórmula de separador
Expresión de tipo fórmula donde especificaremos el carácter que se usa en la cadena de origen para separar sus elementos.
Identificador de variable local array
Identificador de la Variable local de tipo array de destino.
Funcionalidad
Este comando de instrucción permite convertir el contenido de una cadena en un array. La cadena tendrá que tener un carácter de separación entre los distintos elementos y la variable local de destino tendrá que ser de tipo array.
Ejemplo
Vamos a convertir a array el contenido de una cadena, en la que se usa el carácter | como seperador y dejando el resultado en una variable local de tipo array llamada ARRAY:
Array: Crear desde cadena ( "uno|dos|tres|cuatro", "|", ARRAY )
Array: eliminar item
Comando de instrucción del grupo Arrays que permite eliminar un item del array.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
Identificador de variable local array
Identificador de la Variable local del objeto.
Fórmula de posición
Posición del item a eliminar en el array. En este parámetro podrá especificar tanto una constante como una expresión fórmula. La primera posición es la número 0.
Identificador de variable local booleana de retorno de ok
Aquí se declara una variable que retornará 1 si se elimina el item. Si no lo elimina devolverá 0.
Funcionalidad
Esta instrucción permite eliminar un item de una Variable local array declarada en el objeto.
Ejemplo
Procedemos a eliminar el item de la posición 1 de la variable MATRIZ_TMP de tipo array.
Array: eliminar ítem ( MATRIZ_TMP, 1,  )
Array: eliminar todos
Comando de instrucción del grupo Arrays que permite eliminar todos los items del array.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
Identificador de variable local array
Identificador de la Variable local del objeto.
Funcionalidad
Esta instrucción permite eliminar todos los items de una Variable local array declarada en el objeto.
Ejemplo
Eliminamos todos los ítems de la variable MATRIZ_TMP de tipo array.
Array: eliminar todos ( MATRIZ_TMP )
Array: get tamaño
Comando de instrucción del grupo Arrays que permite conocer el número de items del array.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
Identificador de variable local array
Identificador de la Variable local del objeto.
Identificador de variable local numérica de retorno
Aquí se declara una variable que retornará el número de items del array.
Funcionalidad
Esta instrucción permite obtener el número de items de una variable local array declarada en el objeto.
Ejemplo
Leemos el número de ítems o tamaño de la variable local de tipo array MATRIZ_TMP guardándolo en la variable TAMAÑO. Posteriormente mostramos un mensaje informando del tamaño.
Array: get tamaño ( MATRIZ_TMP, TAMAÑO )
Mensaje ( "Hay " + TAMAÑO + " ítems en el array", Información, ,  )
Array: insertar item
Comando de instrucción del grupo Arrays que permite insertar un item en el array.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
Identificador de variable local array
Identificador de la Variable local del objeto.
Fórmula de posición
Posición del array donde insertar el item. En este parámetro podrá especificar tanto una constante como una expresión fórmula. La primera posición es la número 0.
Fórmula de dato
Valor a establecer al item indicado en el parámetro posición. En este parámetro podrá especificar tanto una constante como una expresión fórmula.
Identificador de variable local booleana de retorno de ok
Aquí se declara una variable que retornará 1 si se inserta el item. Si no lo inserta devolverá 0.
Funcionalidad
Esta instrucción permite insertar y establecer el valor de un item de una Variable local array declarada en el objeto.
Ejemplo
Insertamos un ítem al array MATRIZ_TMP al final de la misma conociendo previamente el tamaño del array.
Array: get tamaño ( MATRIZ_TMP, TAMAÑO )
Array: insertar ítem ( MATRIZ_TMP, TAMAÑO + 1, "Valor añadido en el array",  )
Array: ordenar
Comando de instrucción del grupo Básicos que permite ordenar los items del array.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
Identificador de variable local array
Identificador de la Variable local del objeto.
Orden
Podrá optan entre dos modos: ascendente o descendente.
Identificador de variable local booleana de retorno de ok
Opcional. Identificador de la variable local.
Funcionalidad
Esta instrucción ordena los ítems de un array definido en el objeto.
Comentarios
La ordenación se realizará en función del tipo de contenido de la Variable local. Si es de tipo alfabético el orden será alfabético, si es de tipo numérico la ordenación será numérica y así con todos los tipos.
Ejemplo
Ordenamos los ítems del array MATRIZ_TMP de forma ascendente
Array: ordenar ( MATRIZ_TMP, Ascendente,  )
Array: recorrer
Comando de instrucción de proceso que permite recorrer de forma secuencial el contenido de una variable local de tipo array. 
Origen de la instrucción: cualquiera.
Destino del subproceso: el mismo que el origen.
Parámetros
Identificador de variable local array
En este parámetro se ha de especificar la variable local de tipo array a recorrer.
Identificador de variable local de retorno
En este parámetro se ha de especificar la variable local donde se retornará el valor de cada ítem leído del array. No concatena sino que 
Identificador de posición de un elemento en el array (opcional)
En este parámetro se puede especificar una variable local de tipo numérico donde se retornará la posición del ítem leído del array.
Funcionalidad
Este comando de instrucción genera un bucle, que se repetirá por cada ítem del array. Genera un subproceso que será repetido por cada ítem del array. En dicho subproceso podremos leer el valor del ítem leído en el segundo parámetro y su posición en el tercero.
Ejemplo
El siguiente proceso crea una variable local de tipo array con varios ítems y luego la recorre, mostrando un mensaje con valor del ítem leído y su posición en cada iteración del bucle:
Rem ( Creamos un array a partir de una cadena )
Array: Crear desde cadena ( "1;2;3;4;5;6;7", ";", ARRAY )
Rem ( Recorremos el array y presentamos un mensaje con el ítem leído y su posición )
Array: Recorrer ( ARRAY, ITEM_ARRAY, POSICION_ITEM_ARRAY )
    Mensaje ( "Item leido: " + ITEM_ARRAY + ", posición: " + POSICION_ITEM_ARRAY, Información, ,  )
Array: set
Comando de instrucción del grupo Arrays que permite asignar valor a un item del array.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
Identificador de variable local array
Identificador de la Variable local del objeto.
Fórmula de posición
Posición del array donde está el item. En este parámetro podrá especificar tanto una constante como una expresión fórmula. La primera posición es la número 0.
Fórmula de dato
Valor a establecer al item indicado en el parámetro posición. En este parámetro podrá especificar tanto una constante como una expresión fórmula.
Identificador de variable local booleana de retorno de ok
Aquí se declara una variable que retornará 1 si se modifica el item seleccionado. Si no lo modificase devolverá 0.
Funcionalidad
Esta instrucción permite establecer el valor de un item de una Variable local array declarada en el objeto.
Ejemplo
Modificamos el contenido del ítem de la posición 0 del array MATRIZ_TMP estableciendo su contenido con el texto "Valor modificado"
Array: set ( MATRIZ_TMP, 0, "Valor modificado",  )
Modificar variable global
Comando de instrucción del grupo Básicas.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
Identificador variable global
Variable global a modificar. En este parámetro se desplegará una lista con todas las variables globales disponibles.
Fórmula dato
Expresión de tipo fórmula para calcular el nuevo contenido de la variable.
Identificador de la variable local de retorno (Opcional)
Permite guardar en una variable local del proceso el valor asignado a la variable global.
Funcionalidad
Permite modificar, por medio de una expresión de tipo fórmula, el valor de una variable global del proyecto de datos​
Comentarios
Para facilitar la creación de la fórmula podremos usar el asistente para edición de fórmulas.
Como variable local del retorno podremos tanto usar tanto una ya existente como crearla nueva.
Ejemplo
Asignamos a la variable global FCH_SYS la fecha del sistema y a la variable ESADM el valor booleano correspondiente dependiendo de si el usuario es administrador o no.
Modificar variable global ( [email protected]_dat, currentDate(),  )
If ( sysIsAdministrator )
    Modificar variable global ( [email protected]_dat, 1,  )
Else
    Modificar variable global ( [email protected]_dat, 0,  )
Pedir dato
Comando de instrucción del grupo Básicas.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
Fórmula descripción
Expresión de tipo fórmula con texto al presentar en la ventana de solicitud del dato.
Identificador de variable local de retorno
Variable local en la que se guardará el dato escrito por el usuario.
Tipo de dato
Permite especificar de qué tipo será el dato guardado en la variable local del parámetro anterior. Los tipos de dato posibles son:
Fecha: el dato será una fecha.
Hora: el dato será una hora (de reloj).
Número: el dato será un número.
Texto: el dato será una cadena, una expresión alfabética.
Fórmula título opcional
Expresión de tipo fórmula que permite establecer un título opcional de la ventana. Si no se especifica título alguno, se usará como título el nombre del ejecutable. Ejemplo: vClient
Identificador de variable local booleana de retorno de ok
Variable local la ventana.
Funcionalidad
Comando de instrucción que muestra una ventana solicitando un dato al usuario y lo almacena una variable local.
Comentarios
Como variable local de los retornos podremos tanto usar tanto una ya existente como crearla nueva.
La variable local booleana de retorno de ok podremos evaluarla a posteriori con un comando de instrucción If en el caso de que queramos que el proceso siga caminos diferentes en función de si el usuario ha aceptado o no la ventana.
Si el tipo de dato a recoger es de tipo fecha, el modo de edición será tipo alfanumérico, es decir, podremos escribir la fecha como una cadena y al perder foco el control será cuando se valida y cuando la cadena escrita se convierta en un dato de tipo fecha. Para conocer los formatos de edición disponibles haz clic aquí. Además, el control incluirá un botón desde el que podremos desplegar un calendario para la selecicón de la fecha.
Ejemplo
Pedimos al usuario que teclee SEGUIR para continuar con la ejecución del proceso de altas de maestros y, en el caso contrario finalizamos el proceso para salir.
Pedir dato ( "Teclee SEGUIR para continuar", TEXTO, Texto, "Solicitud al usuario", OK )
If ( OK )
    If ( TEXTO ! "SEGUIR" )
        Finalizar proceso
    Else
        Ejecutar proceso ( [email protected]_dat, 1º plano: local (síncrono), , ,  )
            Libre
Set
Comando de instrucción del grupo Básicas del proceso.
Origen de la instrucción: cualquiera.
Destino del subproceso: ninguno.
Parámetros
Identificador de variable local
Identificador variable local cuyo valor queremos asignar.
Fórmula de dato
Expresión fórmula con el valor a asignar a la variable local.
Funcionalidad
Asigna un valor a una variable variable local del proceso. La variable puede ser cualquiera de las ya declaradas previamente o puede ser creada nueva.
Comentarios
Para la especificación del contenido de la variable podemos hacer uso del asistente para edición de fórmulas.
Si el proceso es un evento al que pertenece el evento, el valor de la variable será modificado tanto dentro del proceso como en el propio objeto padre.
Si queremos inicializamos una variable local alfabética sin ningún valor, le asignaremos como fórmula dato "", ya que se no especificamos nada se inicializará con un 0.
Ejemplo
Asignación de valores de cadena a variables locales de tipo alfabética concatenando la suma de las tres variables en una cadena final NOMBRE_COMPLETO.
Set ( NOMBRE, "Juan" )
Set ( APELLIDO1, "Pérez" )
Set ( APELLIDO2, "García" )
Set ( NOMBRE_COMPLETO, NOMBRE + " " + APELLIDO1 + " " + APELLIDO2 )

Transacciones (comandos)

Comunicación

Última actualización 1yr ago

Copiar enlace

Esquema

Array: convertir a cadena

Array: crear desde cadena

Array: eliminar item

Array: eliminar todos

Modificar variable global

Pedir dato

Set