Función
Última actualización
¿Te fue útil?
Última actualización
¿Te fue útil?
La función definible por el programador. Las instrucciones se ejecutarán de forma secuencial y harán uso de que pueden acceder a otros objetos de los 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 seleccionar la opción nuevo objeto/función del menú objetos de Velneo vDevelop o a través de la galería de objetos.
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.
Constará de mayúsculas y números exclusivamente. Al identificar de forma unívoca un objeto no puede haber duplicidad.
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.
Podemos definir los estilos:
Limita el acceso del usuario final al objeto desde puntos donde no se haya programado el acceso al mismo.
Si está activado la función podrá ser ejecutada de forma remota desde otros proyectos de Velneo.
Esta propiedad nos permite documentar el uso del objeto.
Si la función va a recibir parámetros tendremos que crear en la misma tantas variables locales como parámetros necesite.
Una vez establecidas las propiedades podremos pasar a crear las instrucciones.
Podremos hacer llamadas a funciones declaradas en el proyecto.
En ambos casos, podremos hacer la llamada desde cualquier objeto o subobjeto donde pueda declararse una fórmula.
rfc:idFuncion(dominioIP, idInstancia, usuario, contraseña, parámetros)
Por defecto, un servidor de Velneo no permite recibir peticiones de ejecución de funciones remotas desde versiones anteriores a la versión 32. En el caso de que queramos hacer esto posible, debemos una clave beta en la máquina donde tengamos instalado el servidor de la versión actual.
Configuración de sistema: Escribir cadena de texto ( "Velneo", "beta", "clave", "valor" ):
Clave: enableRetrocompatibilidadFuncionesRemotas
Valor: 3BFD2F9B103174596FF78C23CE8DDE77EC917BEA
Ámbito: servidor
Duración: cuando una función es ejecutada de forma remota, si una instrucción de la misma dura más de 10 minutos, hará que la función no pueda reportar al llamador que continúa ejecutándose, por lo que de desenganchará y se deshará.
No podemos usar funciones remotas transaccionales en contenidos iniciales de campos de tipo fórmula.
Solamente en los casos estrictamente necesarios, podría configurarse en la máquina una excepción, ya que la comunicación dejará de ser segura si se hace. Para ello debemos instalar cualquier componente cliente de la plataforma (Velneo vClient, por ejemplo) conectarnos con el servidor. En la ventana de conexión dará un aviso de error de SSL y si hacemos clic sobre él, nos preguntará si queremos generar una excepción par ese servidor. Confirmamos y ya la tendremos creada.
El aplicativo que nos permite disponer de esta funcionalidad es la librería vRemoteFunctionV7.dll, la cual es distribuida con el componente Velneo vClient.
Esta librería es funcional solamente en sistemas operativos Windows.
El nombre de la librería es vRemoteFunctionV7.dll. Se trata de una librería para usar con aplicaciones de 64 bits.
Dicha librería contiene una función. La configuración debe ser:
Los parámetros que afectan a la función son los siguientes:
1.- El retorno será char *, por lo que la función definida en Velneo siempre devolverá una cadena de texto. Caso de no ser así, y si por ejemplo devolviese un número, dicho número sería convertido automáticamente a cadena de texto.
2.- La convención será _cdecl por diseño.
3.- El nombre de la función debe ser RemoteFunc.
4.- El número de parámetros definidos para la función serán 13, todos ellos del tipo char *. Los parámetros serían:
Ccontiene el Velneo vServer al que deseamos conectarnos. La cadena debe comenzar siempre por "vatps://" seguido del nombre o dirección IP del servidor y su puerto. Por ejemplo: "vatps://80.80.80.80:691" o "vatps://servidor.com"
Contiene el identificador que definimos para la instancia que queremos ejecutar. Para las capturas de imagen anteriores, el identificador sería "FUNCAPP".
Contiene el identificador de la función que queremos ejecutar dentro de la instancia definida en el punto anterior. Para las capturas de imagen anteriores, el identificador sería "FUNCION".
El nombre de usuario con el que conectarnos al Velneo vServer.
La clave del usuario anterior.
Son los parámetros que enviamos a la función remota para su ejecución. El número máximo de parámetros como vemos es 8, no es posible introducir más. En caso de que nuestra función necesite menos de 8 parámetros, para evitar problemas deberemos definir igualmente los 8 aunque posteriormente no se usen.
Una función remota no podrá durar más de 30 minutos.
Dado que Velneo 6x es una plataforma de 32 bits y Velneo es de 64 bits, si necesitas usar esta librería para poder ejecutar desde tus aplicaciones 6x funciones remotas de Velneo, tendrás que usar la vRemoteFunctionV7.dll y el resto de librería necesarias de 32 bits. Para obtenerlas, puedes descargar Velneo vClient de 32 bits de la versión 32, que es la útima versión que aún soportaba 32 bits. Si la descarga no está disponible en la página de descargas, solicítala a Velneo a través de su centro de soporte.
Por defecto, un servidor de esta versión no permite recibir peticiones de ejecución de funciones remotas desde versiones anteriores a la versión 32. En el caso de que queramos hacer esto posible, debemos una clave beta en la máquina donde tengamos instalado nuestro servidor de la versión.
Configuración de sistema: Escribir cadena de texto ( "Velneo", "beta", "clave", "valor" ):
Clave: enableRetrocompatibildadFuncionesRemotas
Valor: 3BFD2F9B103174596FF78C23CE8DDE77EC917BEA
Ámbito: servidor
Para conocer cómo hacer llamadas a funciones locales consultar el punto .
Para hacer llamadas a funciones remotas tendremos que escribirlo directamente en una , siguiendo la sintaxis siguiente:
Haz clic para ampliar información.
Existe una librería de funciones dll para Windows, que permite hacer llamadas a funciones remotas declaradas en proyectos de Velneo. Consultar el punto para ampliar información al respecto.
Las claves beta son entradas en la rama beta de Velneo del registro del sistema operativo. Se recomienda generarlas desde un proceso con el comando de instrucción de proceso para establecerlos, ejecutándolo en 3er plano. Los parámetros se resolverán como indicamos a continuación:
Excepciones SSL: para conectarnos a un Velneo vServer por que produce excepciones de SSL por no tener un certificado válido, la solución debería pasar por configurar en el mismo un certificado válido ().
Esta librería debe ser distribuida junto todas las librerías que encontremos en la carpeta de instalación de . Todas ellas las encontraremos en el directorio de instalación de Velneo vClient. Además, deben cumplirse los en la página de requerimientos de la versión.
Si la conexión se va a establecer con servidores que usan el antiguo protocolo en lugar de, tendremos que especificar "vatp:" en lugar de "vatps://").
Las claves beta son entradas en la rama beta de Velneo del registro del sistema operativo. Se recomienda generarlas desde un proceso con el comando de instrucción de proceso para establecerlos, ejecutándolo en 3er plano. Los parámetros se resolverán como indicamos a continuación:
