DICCIONARIO DE FUNCIONES

Función

Sintaxis

Parámetros

Descripción

sum ()

sum(FORM[formadetalle].FIELD[campodeformadetalle])

Un campo de tipo numérico de la forma detalle, no se soportan campos calculados de forma o cálculos de dos o más campos.

Obtiene la suma del valor numérico del campo de la forma detalle de todos los registros detalles que existan en la tabla física de la forma detalle

Nota: Esta función calculará el valor total del campo de la forma detalle de todos los registros existentes en la forma detalle, estén o no visibles para el usuario que se haya firmado

getMonth()

Define un mes.

currentDate()

currentDate

Muestra la fecha actual con formato yyyy/MM/dd

currentTime()

currentTime

Despliega la hora actual con formato de 0 a 24 horas.

setValue()

setValue(parametro1, parametro2, parametro3)

Parametro1: nombre del campo de la otra forma al cual se le asignará un nuevo valor, escribir con corchetes cuadrados y entre comillas sencillas o dobles.

Parametro2: Es el valor que se le asignará al campo definido en el Parametro1 escrito entre comillas dobles o sencillas. También es posible definirlo a través de un campo de la forma del evento, en tal caso no va con comillas solo con corchetes cuadrados.

Parametro3: Es el filtro  que define qué registros de la otra forma se verán afectados, el cual debe especificarse como cadena entre comillas para que sea recibido por la función setValue.

Se utiliza para cambiar el valor de un campo específico en otra forma en lo(s) registros(s) que cumplan con el filtro

getValue()

getValue(parametro1, parametro2)

Parametro1. Es el campo de la otra forma cuyo valor se quiere obtener. Con la sintaxis FORM[NombreForma].FIELD[NombreCampo] y entre corchetes cuadrados y comillas dobles o sencillas.

Parametro2. Es el filtro definido por los campos de una y otra forma con el cual se identifica el registro que se va afectar.

Regresa el valor de un campo de otra forma según el filtro definido

sendEmail()

sendEmail(Parametro1, Parametro2, Parametro3)

Parametro1, es el correo electrónico destinatario, puede referirse directamente a una dirección de correo o a las variables Supervisor1, Supervisor2 o Supervisor3. Solamente un destinatario.

Parametro2, es el texto que se incluirá en el titulo del correo, es posible combinar texto con contenido de campos de la forma del evento.

Parametro3, es el texto que se presentará como cuerpo o contenido del correo, también es posible utilizar campos de la forma del evento.

Enviar un correo en el campo siempre y cuando se cumpla o no la condición.

inMonth()

inMonth(dateFecha, numberMonth)

Valida que una fecha esté dentro de un mes especificado.

dateAdd()

dateAdd(tipoIncremento,Incremento,dateFecha)

Ejemplos:

IF(dateAdd(“Day”,5,currentDate())>"2013-10-03",cierto,falso)

dateAdd(“Day”,5,"2013/10/03")

dateAdd(“Day”,5,currentDate())>FORM[Catalogo].FIELD[Fecha]

tipoIncremento, Day,Month o Year

Incremento, Es un parámetro numérico entero que define las unidades a incrementar en la fecha. El cual puede asignarse en la configuración o tomarlo de algún campo de la forma.

dateFecha, Fecha a la que se le realizará el aumento, puede ser la fecha de un campo, una fecha específica fijada manualmente por el usuario o la función currentDate()

Agrega un intervalo de tiempo a una fecha especificada.

Nota: el formato de la fecha debe ser año/mes/día, debe estar entre comillas y el separador a utilizar es /

Ejemplo “2013/10/10”.

Esta función puede utilizarse en un defaultValue de un campo Date, en una condición de comparación y en un catalog_filter.

dateSub()

dateSub(tipoDecremento,Decremento,dateFecha)

Ejemplos:

IF(dateSub(“Day”,1,"2016/10/12")>"2016/10/10",cierto,falso)

dateSub(“Year”,1,"2012/10/03")> FORM[Catalogo].FIELD[Fecha]

dateSub(“Year”,2,FORM[test fechas].FIELD[fecha 1])

tipoDecremento, Day,Month o Year

Decremento, Es un parámetro numérico entero que define las unidades a restar en la fecha. El cual puede asignarse en la configuración o tomarlo de algún campo de la forma.

dateFecha, Fecha a la que se le realizara el decremento, puede ser la fecha de un campo, una fecha específica fijada manualmente por el usuario o la función currentDate()

Resta un intervalo de tiempo a una fecha.

Nota: Al igual que la función dateAdd, la fecha debe tener el mismo formato e ir entre comillas dobles. De la misma manera puede utilizarse en defaultValue, catalog_filter y en condiciones de comparación.

dateDif()

dateDif(DateFecha1,DateFecha2,tipoDif)

Ejemplos:

IF(dateAdd(“Year”,1,"2010/10/03")>currentDate(),cierto,falso)

dateDif(currentDate(),FORM[Catalogo].FIELD[Fecha],”Year”)>3

dateDif(FORM[test fechas].FIELD[fecha 1],FORM[Catalogo].FIELD[Fecha],”Day”)>5

DateFecha1, Parámetro de tipo Date al que se le restará la fecha dos. Puede ser un campo, una fecha o la función currentDate().

DateFecha2, Parámetro de tipo Date, de igual forma puede ser un campo, una fecha o la función currentDate().

tipoDif, Es una constante que puede ser Day, Month o Year que define la unidad de tiempo en la que se regresará la diferencia entre ambas fechas. Solo se regresará la parte entera de dicha diferencia.

Regresa la diferencia del intervalo de tiempo entre dos fechas.

Nota: Si se utiliza en un defaultValue el tipo de campo debe ser numeric. Al igual que las funciones anteriores debe tener el mismo formato de fecha y se puede utilizar tanto en catalog_filter como en condiciones de comparación.

getHistoryCount()

getHistoryCount(campo)

Obtiene el número de registros de historia del campo.

getHistoryData()

getHistoryData(campo, tipo, índice)

Obtiene el dato del campo “tipo”, almacenado en la historia “índice”. El número de índice comenzaría en 1 con la modificación de la más reciente a la más antigua.

IF()

defaultValue

IF(condición, valor si es verdadero, valor si es falso)

Se utiliza para mostrar un valor si se cumple cierta condición.