# Funciones API

Conjunto de [Funciones de fórmula ](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/editores/asistente-de-formulas)que hacen de uso del API de Velneo para retornar valores propios de los proyectos y objetos en tiempo de ejecución.

## getCurrentInstanceCode

Devuelve el código de la instancia en curso.

### Sintaxis

getCurrentInstanceCode() 

### Parámetros

No tiene.

Devuelve el código de la instancia en curso. Se refiere al código que ésta tiene en Velneo vAdmin. Podemos verlo en el título de la ventana de las propiedades de la misma en Velneo vAdmin:

<figure><img src="https://1848050135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F94cA90VyUzOKumOI5EMW%2Fuploads%2F7QUSLxOUMLAxKx6feVIi%2Fimage.png?alt=media&#x26;token=4ffa9f5f-b02c-4ca8-bf37-891949914f94" alt=""><figcaption></figcaption></figure>

### Ejemplo

`getCurrentInstanceCode()` = 12

## getCurrentInstanceConnectionToken

Devuelve el testigo del enganche de la instancia en curso.

### Sintaxis

getCurrentInstanceConnectionToken()

### Parámetros

No tiene.

Devuelve el testigo del enganche de la instancia en curso, es decir, en enganche que se ha generado en Velneo vAdmin.

### Ejemplo

<figure><img src="https://1848050135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F94cA90VyUzOKumOI5EMW%2Fuploads%2FpcOMH3KkouhpTLdCaKSH%2Fimage.png?alt=media&#x26;token=2d74c471-9511-41c2-b7f8-00037c2837f3" alt=""><figcaption></figcaption></figure>

`getCurrentInstanceConnectionToken()` = 2-10-800-0529

## getCurrentInstanceId()

Devuelve el identificador de la instancia en curso.

### Sintaxis

getCurrentInstanceId()&#x20;

### Parámetros

No tiene.

Devuelve el identificador de la instancia en curso. Se refiere al identificador que ésta tiene en Velneo vAdmin. Podemos verlo en el título de la ventana de las propiedades de la misma en Velneo vAdmin:

<figure><img src="https://1848050135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F94cA90VyUzOKumOI5EMW%2Fuploads%2FK8XDyn2XSYhP9bcdowN8%2Fimage.png?alt=media&#x26;token=7fdfd30a-accf-4599-867b-96753ffb0d70" alt=""><figcaption></figcaption></figure>

### Ejemplo

`getCurrentInstanceId()` = VERP

## getCurrentInstanceName

Devuelve el nombre de la instancia en curso.

### Sintaxis

getCurrentInstanceName()

### Parámetros

No tiene.

Devuelve el nombre de la instancia en curso, es decir, el nombre que tiene la isntancia en Velneo vAdmin. Podemos verlo en las propiedades de la misma en Velneo vAdmin:

<figure><img src="https://1848050135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F94cA90VyUzOKumOI5EMW%2Fuploads%2FOm61MDKDjiHbpPHtiHQ1%2Fimage.png?alt=media&#x26;token=a1963e67-665c-4f96-b31c-67d7eb69bec1" alt=""><figcaption></figcaption></figure>

### Ejemplo

`getCurrentInstanceName()`  = vERP

## getCurrentObjectId

Devuelve el identificador del objeto en curso.

### Sintaxis

`getCurrentObjectId()`

### Parámetros

No tiene.

Devuelve una cadena con el identificador del objeto en curso.

### Ejemplo

Para obtener el identificador del formulario en curso desde un [manejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) del mismo:

`getCurrentObjectId()` = ENT\_M

## getCurrentObjectName

Devuelve el nombre del objeto en curso.

### Sintaxis

`getCurrentObjectName()`

### Parámetros

No tiene.

Devuelve una cadena con el nombre del objeto en curso.

### Ejemplo

Para obtener el nombre del formulario en curso desde un [manejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) del mismo:

`getCurrentObjectNAME()` = Contacto

## getCurrentObjectTableId

Devuelve el identificador de la [tabla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla) asociada al objeto en curso.

### Sintaxis

`getCurrentObjectTableId()`

### Parámetros

No tiene.

Devuelve una cadena con el identificador de la tabla asociada al objeto en curso. Si el objeto no tiene tabla asociada, no devolverá nada.

### Ejemplo

Para obtener el identificador de la tabla del formulario en curso desde un [manejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) del mismo:

`getCurrentObjectTableId()` = ENT\_M

## getCurrentObjectTableName

Devuelve el nombre plural de la [tabla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla) asociada al objeto en curso.

### Sintaxis

`getCurrentObjectTableName()`

### Parámetros

No tiene.

Devuelve una cadena con el nombre de la tabla asociada al objeto en curso. Si el objeto no tiene tabla asociada, no devolverá nada.

### Ejemplo

Para obtener el nombre de la tabla del formulario en curso desde un [manejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) del mismo:

`getCurrentObjectTableName()` = Contactos

## getCurrentObjectTableSingleName

Devuelve el nombre singular de la [tabla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-datos/tabla) asociada al objeto en curso.

### Sintaxis

`getCurrentObjectTableSingleName()`

### Parámetros

No tiene.

Devuelve una cadena con el nombre singular de la tabla asociada al objeto en curso. Si el objeto no tiene tabla asociada, no devolverá nada.

### Ejemplo

Para obtener el nombre de la tabla del formulario en curso desde un [manejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) del mismo:

`getCurrentObjectTableSingleName()` = Contacto

## getCurrentObjectType

Devuelve el tipo de objeto en curso.

### Sintaxis

`getCurrentObjectType()`

### Parámetros

No tiene.

Devuelve una cadena con el nombre del tipo de objeto en curso.&#x20;

### Ejemplo

Para obtener el tipo de objeto del formulario en curso desde un [manejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) del mismo:

`getCurrentObjectType()` = Formulario

## getMainInstanceCode

Devuelve el código de la instancia principal.

### Sintaxis

getMainInstanceCode()

### Parámetros

No tiene.

Devuelve el código de la instancia principal, es decir, el código que ésta tiene en Velneo vAdmin. El valor que devuelva cuando hay herencia variará en función del proyecto en el que usemos la función y el plano de ejecución. Para entenderlo mejor partiremos de una solución con un proyecto de datos que hereda  uno de aplicación. En el proyecto de datos creamos un proceso que usa esta función:

Ejecutado en primer plano desde Velneo vCleint, devolverá el código de la instancia del proyecto de aplicación.

Ejecutado en tercer plano desde Velneo vCleint, devolverá el código de la instancia del proyecto de aplicación.

Ejecutado en primer plano desde Velneo vDataClient, devolverá el código de la instancia del proyecto de datos.

Ejecutado en tercer plano desde Velneo vDataCleint, devolverá el código de la instancia del proyecto de datos.

### Ejemplo

<figure><img src="https://1848050135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F94cA90VyUzOKumOI5EMW%2Fuploads%2Fu2yQwu5kl1pq7LLlqbO3%2Fimage.png?alt=media&#x26;token=13a14781-c444-4cda-bdc6-01fafe415674" alt=""><figcaption></figcaption></figure>

`getMainInstanceCode()` = 12

## getMainInstanceConnectionToken

Devuelve el testigo del enganche de la instancia principal.

### Sintaxis

getMainInstanceConnectionToken()

### Parámetros

No tiene.

Devuelve el testigo del enganche de la instancia principal. es decir, , es decir, en enganche que se ha generado en Velneo vAdmin. El valor que devuelva cuando hay herencia variará en función del proyecto en el que usemos la función y el plano de ejecución. Para entenderlo mejor partiremos de una solución con un proyecto de datos que hereda  uno de aplicación. En el proyecto de datos creamos un proceso que usa esta función:

Ejecutado en primer plano desde Velneo vCleint, devolverá el testigo del enganche del proyecto de aplicación.

Ejecutado en tercer plano desde Velneo vCleint, devolverá el el testigo del enganche del proyecto de aplicación.

Ejecutado en primer plano desde Velneo vDataClient, devolverá el el testigo del enganche del proyecto de datos.

Ejecutado en tercer plano desde Velneo vDataCleint, devolverá el el testigo del enganche del proyecto de datos.

### Ejemplo

<figure><img src="https://1848050135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F94cA90VyUzOKumOI5EMW%2Fuploads%2FqP4MycSc3nXLjXOTKClh%2Fimage.png?alt=media&#x26;token=cfd9920a-9af2-472b-9676-042a79c0c834" alt=""><figcaption></figcaption></figure>

`getMainInstanceConnectionToken()` = 2-10-800-0529

## getMainInstanceId

Devuelve el identificador de la instancia principal.

### Sintaxis

getMainInstanceId()

### Parámetros

No tiene.

Devuelve el identificador de la instancia principal, es decir, el identificador que ésta tiene en Velneo vAdmin. El valor que devuelva cuando hay herencia variará en función del proyecto en el que usemos la función y el plano de ejecución. Para entenderlo mejor partiremos de una solución con un proyecto de datos que hereda  uno de aplicación. En el proyecto de datos creamos un proceso que usa esta función:

Ejecutado en primer plano desde Velneo vCleint, devolverá el identificador de la instancia del proyecto de aplicación.

Ejecutado en tercer plano desde Velneo vCleint, devolverá el identificador de la instancia del proyecto de aplicación.

Ejecutado en primer plano desde Velneo vDataClient, devolverá el identificador de la instancia del proyecto de datos.

Ejecutado en tercer plano desde Velneo vDataCleint, devolverá el identificador de la instancia del proyecto de datos.

### Ejemplo

<figure><img src="https://1848050135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F94cA90VyUzOKumOI5EMW%2Fuploads%2FyB0J8GdqsjXzCVYOdszT%2Fimage.png?alt=media&#x26;token=6eec6545-de27-4d61-9fa9-f758a082b43d" alt=""><figcaption></figcaption></figure>

`getMainInstanceId()` = VERP

## getMainInstanceName

Devuelve el nombre de la instancia principal.

### Sintaxis

getMainInstanceName()

### Parámetros

No tiene.

Devuelve el nombre de la instancia principal, es decir, el nombre que ésta tiene en Velneo vAdmin. El valor que devuelva cuando hay herencia variará en función del proyecto en el que usemos la función y el plano de ejecución. Para entenderlo mejor partiremos de una solución con un proyecto de datos que hereda  uno de aplicación. En el proyecto de datos creamos un proceso que usa esta función:

Ejecutado en primer plano desde Velneo vCleint, devolverá el nombre de la instancia del proyecto de aplicación.

Ejecutado en tercer plano desde Velneo vCleint, devolverá el nombre de la instancia del proyecto de aplicación.

Ejecutado en primer plano desde Velneo vDataClient, devolverá el nombre de la instancia del proyecto de datos.

Ejecutado en tercer plano desde Velneo vDataCleint, devolverá el nombre de la instancia del proyecto de datos.

### Ejemplo

<figure><img src="https://1848050135-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F94cA90VyUzOKumOI5EMW%2Fuploads%2FBjBBoEpTMwLrOcQtysdG%2Fimage.png?alt=media&#x26;token=19049cb9-2b31-46ab-a7b7-7c2d62e27e40" alt=""><figcaption></figcaption></figure>

`getMainInstanceName()` = vERP

## getMainObjectId

Devuelve el identificador del objeto principal que se está ejecutando.

### Sintaxis

`getMainObjectId()`

### Parámetros

No tiene.

Devuelve una cadena con el identificador del objeto principal que se está ejecutando. Por ejemplo, si estamos ejecutando un [menejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de una [rejilla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/rejilla) que está incrustada en un [formulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario), nos devolverá el identificador del formulario.

### Ejemplo

Para obtener el identificador del formulario donde está incrustada una rejilla en curso desde un [manejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de la misma:

`getMainObjectId()` = ENT\_M

## getMainObjectName

Devuelve el nombre del objeto principal que se está ejecutando.

### Sintaxis

`getMainObjectName()`

### Parámetros

No tiene.

Devuelve una cadena con el nombre del objeto principal que se está ejecutando. Por ejemplo, si estamos ejecutando un [menejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de una [rejilla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/rejilla) que está incrustada en un [formulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario), nos devolverá el nombre del formulario.

### Ejemplo

Para obtener el nombre del formulario donde está incrustada una rejilla en curso desde un [manejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de la misma:

`getMainObjectName()` = Contacto

## getMainObjectType

Devuelve el tipo del objeto principal que se está ejecutando.

### Sintaxis

`getMainObjectType()`

### Parámetros

No tiene.

Devuelve una cadena con el tipo del objeto principal que se está ejecutando. Por ejemplo, si estamos ejecutando un [menejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de una [rejilla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/rejilla) que está incrustada en un [formulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario), nos devolverá el tipo de objeto del formulario.

### Ejemplo

Para obtener el tipo de objeto del formulario donde está incrustada una rejilla en curso desde un [manejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de la misma:

`getMainObjectType()` = Formulario

## getParentObjectId

Devuelve el identificador del objeto padre que contiene el objeto en curso.

### Sintaxis

`getParentObjetctId()`

### Parámetros

No tiene.

Devuelve el identificador del objeto padre que contiene el objeto en curso.

### Ejemplo

Ejecutamos esta función desde un [menejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de una [rejilla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/rejilla) que está incrustada en un [formulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario):

`getParentObjectId()` = ENT\_M\_MEN

## getParentObjectName

Devuelve el nombre del objeto padre que contiene el objeto en curso.

### Sintaxis

`getParentObjectName()`

### Parámetros

No tiene.

Devuelve el nombre del objeto padre que contiene el objeto en curso.

### Ejemplo

Ejecutamos esta función desde un [menejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de una [rejilla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/rejilla) que está incrustada en un [formulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario):

`getParentObjectName()` = Contacto.

## getParentObjectType

Devuelve el tipo del objeto padre que contiene el objeto en curso.

### Sintaxis

`getParentObjectType()`

### Parámetros

No tiene.

Devuelve el tipo del objeto padre que contiene el objeto en curso.

### Ejemplo

Ejecutamos esta función desde un [menejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de una [rejilla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/rejilla) que está incrustada en un [formulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario):

`getParentObjectType()` = Formulario.

## getPathObjectIds

Devuelve una cadena separada por comas con los identificadores de todos los objetos desde el objeto principal hasta el objeto en curso.

### Sintaxis

`getPathObjectIds()`

### Parámetros

No tiene.

Devuelve una cadena separada por comas con los identificadores de todos los objetos desde el objeto principal hasta el objeto en curso.

### Ejemplo

Ejecutamos esta función desde un [menejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de una [rejilla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/rejilla) de facturas que está incrustada en un [subformulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario/contenedores/separador-de-formularios) de un [formulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario) de Clientes:

`getPathObjectIds()` = CLI,CLI\_SUB,FAC.

## getPathObjectINames

Devuelve una cadena separada por comas con los nombres de todos los objetos desde el objeto principal hasta el objeto en curso.

### Sintaxis

`getPathObjectNames()`

### Parámetros

No tiene.

Devuelve una cadena separada por comas con los nombres de todos los objetos desde el objeto principal hasta el objeto en curso.

### Ejemplo

Ejecutamos esta función desde un [menejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de una [rejilla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/rejilla) de facturas que está incrustada en un [subformulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario/contenedores/separador-de-formularios) de un [formulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario) de Clientes:

`getPathObjectNames()` = Cliente,Facturas,Facturas.

## getPathObjectITypes

Devuelve una cadena separada por comas con los tipos de todos los objetos desde el objeto principal hasta el objeto en curso.

### Sintaxis

`getPathObjectTypes()`

### Parámetros

No tiene.

Devuelve una cadena separada por comas con los tipos de todos los objetos desde el objeto principal hasta el objeto en curso.

### Ejemplo

Ejecutamos esta función desde un [menejador de evento](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/sub-objetos-de-vistas-de-datos/manejador-de-evento) de una [rejilla](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/rejilla) de facturas que está incrustada en un [subformulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario/contenedores/separador-de-formularios) de un [formulario](https://doc.velneo.com/33/velneo-vdevelop/proyectos-objetos-y-editores/proyecto-de-aplicacion/formulario) de Clientes:

`getPathObjectTypes()` = Formulario,Formulario,Rejilla.

## getProjectName

Devuelve el nombre del proyecto en curso.

### Sintaxis

`getProjectName()`

### Parámetros

No tiene.

Devuelve una cadena con el nombre del proyecto en curso.

### Ejemplo

`getProjectName()` = Velneo vSalesDaybook

## getProjectVersion

Devuelve la versión del proyecto en curso.

### Sintaxis

`getProjectVersion()`

### Parámetros

No tiene.

Devuelve una cadena con la versión del proyecto en curso.

### Ejemplo

`getProjectVersion()` = 0.1 Beta

## getTableHandle

Devuelve el manejador o handle de la tabla en curso en formato hexadecimal.

### Sintaxis

`getTableHandle()`

### Parámetros

No tiene.

Devuelve el manejador hexadecimal de la tabla en la que nos encontramos. Este manejador se corresponderá con el orden de creación de la tabla dentro del proyecto. El manejador correspondiente a la primera tabla creada en el proyecto será 0.

### Ejemplo

`getTableHandle()` = 1A