Este clase representa a la aplicación. Dispone de funciones para ver información de sus proyectos, acceso a variables globales, constantes, utilidades de base de datos, disco, etc.
El objeto theApp
Todos los scripts están conectados a un objeto global y único que representa a la aplicación cuyo nombre es theApp. Este objeto está disponible en ejecución de scripts en Velneo vClient, pero también en extensiones en Velneo vDevelop, aunque no aquellas funciones que tienen sentido únicamente en ejecución (Ver documentación de VExtension).
Herencia
Hay que tener en cuenta que la aplicación da acceso al proyecto principal con el que se ha arrancado la aplicación y todos sus objetos heredados lo que permite el acceso y uso de cualquier objeto de la aplicación desde cualquier script.
Devuelve en minúsculas el hash de una cadena en función del parámetro.
Parámetro:
AlgoritmoHash: ver enum de algoritmos disponibles.
String exeName()
Devuelve el nombre del navegador en curso, por ejemplo: vClient, vWebClient, etc.
void processEvents()
Procesa los eventos que haya en la cola de la aplicación, excluyendo los de entrada de usuario (teclado, ratón...). Debe usarse donde se consuma mucho tiempo o bucles largos para que se refresque el interfaz. Solo actúa en procesos en primer plano ya que es en estos donde estamos ocupando el hilo principal que es el que atiende la cola de eventos. En los demás no hace nada.
String stripHtml( String szHtml )
Retorna la cadena que pasamos como parámetro sin etiquetas html. El código html debe estar bien conformado para que retorne contenido.
Parámetros:
szHtml: cadena de texto que contiene el código Html correctamente conformado del que queremos extraer el texto sin etiquetas html.
void wait( Number miliSegs )
El proceso queda detenido en este punto durante el tiempo especificado en el parámetro.
Parámetros:
miliSegs: número de milisegundos de espera, por ejemplo: 1000 = 1 segundo.
Funciones de proyectos
VProjectInfo mainProjectInfo()
Devuelve el objeto VProjectInfo del proyecto principal.
Si la usamos en un proceso ejecutado en 4º plano, esta función devolverá el proyecto donde esté declarado el proceso, tenga proyectos o no por encima, el motivo de esto es que
cuando se ejecuta el proceso el servidor crea un enganche temporal para gestionarlo, en ese momento, conoce el proyecto donde está el objeto y lo que hereda, pero no conoce todo lo que tiene por encima.
VProjectInfo projectInfo( Number nProjectType, int index )
Esta función es de uso exclusivo en las extensiones de Velneo vDevelop (clase vExtension).Devuelve un objeto VProjectInfo con la información del proyecto cuyo tipo e index dentro de la solución hayamos pasado como parámetro.
Parámetros:
nProjectType: tipo de proyecto. Ver enum de tipos de proyecto.
index: index dentro de la solución.
VProjectInfo projectInfo( String szAlias )
Devuelve un objeto VProjectInfo del proyecto con el alias especificado.
Parámetros:
szAlias: alias del proyecto.
Funciones de variables globales
QDate globalVarToDate( String szIdRefVar )
Devuelve el valor de una variable global de tipo fecha.
Parámetros:
szIdRefVar: identificador de referencia de la variable global.
Asigna el valor a la variable global de tipo hora.
Parámetros:
szIdRefVar: identificador de referencia de la variable global.
tValue: valor de tipo hora.
Funciones de constantes
String constant( String szIdRefConstante )
Devuelva el contenido de una constante.
Parámetros:
szIdRefConstante: idRef del objeto constante "ALIAS_PROYECTO/ID_OBJETO".
String constant( String szIdRefConstante, Number idioma, [Number pais] )
Devuelve el contenido de una constante en el idioma y país especificado en los parámetros. El país es un parámetro opcional, si no se especifica asume el más genérico de los existentes para ese idioma.
Parámetros:
szIdRefConstante: idRef del objeto constante "ALIAS_PROYECTO/ID_OBJETO".
idioma: código numérico del idioma, por ejemplo: English = 31. Ver enum de idiomas
país: código numérico del país, por ejemplo: UnitedKingdom = 224. Este es un parámetro opcional. Ver enum de países
Regenera el área de datos de la tabla indicada en el primer parámetro. Si indicamos true en el 2º parámetro se mostrará la barra de progreso. Esta función lanzada sobre tablas en memoria siempre devuelve false.
Parámetros:
idRefTabla: idRef de la tabla "ALIAS_PROYECTO/ID_TABLA".
bProgressDialog: true para indicar que sea visible la barra de progreso.