Función

Función
La función es un objeto contenedor de instrucciones definible por el programador. Las intrucciones se ejecutarán de forma secuencial y harán uso de comandos de instrucción de proceso que pueden acceder a otros objetos de las proyectos incluyendo otros procesos.

Es similar al objeto proceso, pero con unas características especiales:

Solamente pueden ser ejecutados en primer plano.

Puede recibir parámetros.

No tiene origen, es decir, el origen de la función siempre es “Ninguno”.
Para crear un objeto de este tipo hacer doble clic sobre el icono correspondiente de la galería de objetos (Ins) de Velneo vDevelop.

Las propiedades de este objeto son:

Identificador: Etiqueta alfanumérica que identifica de forma unívoca al objeto dentro del proyecto. Este identificador será el que usemos para referenciarlo en otras propiedades de otros objetos.
El identificador constará de mayúsculas y números exclusivamente. Al identificar de forma unívoca un objeto no puede haber duplicidad.

Nombre: Etiqueta alfanumérica que servirá como descriptor del objeto. Se usará para presentar información del objeto en otros objetos y en los inspectores.

Podemos definir una etiqueta por cada idioma presente en el proyecto.

Estilos: Podemos definir los estilos Privado que limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo, y Ejecutable en remoto que, si está activado la función podrá ser ejecutada de forma remota desde otros proyectos de Velneo V7.

Comentarios: Esta propiedad nos permite documentar el uso del objeto.

Parámetro 1 a n: Si la función va a recibir parámetros tendremos que crear en la misma tantas variables locales (del tipo que corresponda) como parámetros necesite.

Una vez establecidas las propiedades podremos pasar a crear las instrucciones que la conformarán, para ello disponemos de un editor que se abre en el panel central de Velneo vDevelop. Si no se encuentra abierto, haremos doble clic sobre la función creada para abrirlo. Los parámetros de la función serán accesibles desde cualquier fórmula de los comandos de instrucción de la misma, en la lista de variables locales del asistente para edición de fórmulas.

Podremos hacer llamadas a funciones declaradas tanto en el proyecto en curso como en proyectos heredados (funciones locales) como llamadas a funciones declaradas en otros proyectos, tanto instanciados en el mismo Velneo vServer V7 como en Velneo vServers V7 remotos (funciones remotas).

En ambos casos, podremos hacer la llamada desde cualquier objeto o subbojeto donde pueda declararse una fórmula.

Para conocer cómo hacer llamadas a funciones locales consultar el punto Funciones de proceso del capítulo dedicado al asistente para edición de fórmulas.

Para hacer llamadas a funciones remotas tendremos que escribirlo directamente en la fórmula, siguiendo la sintaxis siguiente:

rfc:idFuncion(dominioIP, idInstancia, usuario, contraseña, parametros)

Donde:

rfc: Acrónimo de Remote Function Call. Es un dato fijo. Es un prefijo que indica al calculador de fórmulas que se trata de una llamada a una función remota.

idFuncion: Identificador de la función a ejecutar.

dominioIP: Dominio o IP de la máquina donde está instalado el Velneo vServer V7 donde se encuentra instanciado el proyecto donde la función ha sido declarada. Debe ir precedido del esquema vatp:// y, si el puerto es distinto del 690, seguido de dos puntos (:) y el número de puerto.

idInstancia: Identificador de la instancia a la que queremos acceder. Para conocer el identificador de la instancia usaremos Velneo vAdmin V7 haciendo doble clic sobre la definición de instancia.

usuario: Nombre de un usuario declarado en Velneo vServer V7 que tenga permisos de acceso a la
instancia.

contraseña: Del usuario anterior. Si ese usuario no tiene contraseña este parámetro será resuelto con “”.

parametros: Si la función tiene declarado más de un parámetro, éstos irán separados por comas.

rfc:GET_USER_SESION_NUMBER(“vatp://localhost:85″, “GESTION”, “velneo”, “”, “carlos@gmail.com”, “ib3zax1″)

NOTA: El límite máximo de parámetros soportados por una función es de 10.