Estas fórmulas son presentadas cuando se accede al editor de fórmulas en el componente SE Formulario. En SE Formulario estas funciones serán presentadas al editar una fórmula en algún campo del formulario o para un formulario asociado en algún proceso.
Formulario
Funciones que devuelven valores de la tabla:
▪VALOR DE LA LISTA DE TABLA: Devuelve el valor del campo de una tabla.
Sintaxis:
|
VALORLISTA('<identificador de la tabla>';'<identificador de la relación>';'<identificador del campo>')
|
▪VALOR DEL CAMPO DE TABLA: Devuelve el valor del campo de una tabla.
Sintaxis:
|
VALORCAMPO('<identificador de la tabla>';'<identificador del campo>')
|
▪VALOR DEL CAMPO CON FILTRO: Devuelve el valor de la tabla.
Sintaxis:
|
VALORCAMPOFILTRO('<identificador de la tabla>';'<identificador del campo>';'<filtro>')
|
▪TOTAL DEL GRID: Devuelve el valor total.
Sintaxis:
|
TOTALGRID('<identificador de la relación>';'<identificador de la tabla>';'<identificador del campo>';'<operación>')
|
|
Funciones que ejecutan alguna acción en ítems del formulario:
▪ACCIÓN: La cantidad de parámetros es variable, ya que depende de la cantidad de variables para realizar el cálculo.
Sintaxis:
|
ACCION(<lista de identificadores del campo>; <lista de identificadores del campo>; <lista de identificadores del campo>; <lista de identificadores del campo>; <lista de identificadores del campo>; ... ; <cantidad de parámetros variable>)
|
▪ACCIÓN EN EL GRUPO: Aplica acciones (habilitar, deshabilitar, etc.) para un grupo de ítems dentro de un fieldset.
Sintaxis:
|
ACCIONGRUPO('<identificador del campo campo>';'<operación>';'<valor>')
|
▪ACCIÓN EN ÍTEM GRÁFICO: Aplica acciones (habilitar, deshabilitar, etc.) para un elemento gráfico. Ejemplo: Fieldset, imagen, etc.
Sintaxis:
|
ACCIONITEMGRAFICO (<identificador del campo>; <operación>; <valor>)
|
▪DESHABILITAR ACCIÓN DEL GRID: Deshabilita determinados botones del grid del formulario.
Sintaxis:
|
DESHABILITARACCIONGRID('<identificador del grid>';'<botones del grid que serán deshabilitados (Ej:Incluir, Modificar, Excluir)>')
|
▪HABILITAR ACCIÓN DEL GRID: Habilita determinados botones del grid del formulario.
Sintaxis:
|
HABILITARACCIONGRID('<identificador del grid>';'<botones del grid que serán habilitados (Ej:Incluir,Modificar,Excluir)>')
|
▪EJECUTAR SCRIPT: Ejecuta un evento en el elemento elegido
Sintaxis:
|
EJECUTESCRIPT('<Identificador>';'<Evento>')
|
|
▪MODIFICAR LIMITE: Modifica el límite del campo (textarea/memo) de 4000 caracteres para menos.
Sintaxis:
|
MODIFICARLIMITE ('<identificador del campo>';'<valor>')
|
▪ABRIR FORMULARIO: Abre el formulario en modo ejecución.
Sintaxis:
|
ABRIRFORMULARIO(<Identificador del formulario>)
|
|
▪IMPORTAR PLANILLA PARA GRID: Actualiza un grid con el contenido de una planilla.
Sintaxis:
|
IMPORTARPLANILLAPARAGRID('<Identificador de la relación del grid>';'<Lista de la relación entre los atributos de la tabla y las columnas de la planilla (Ej: ATR01=A,ATR02=D, ATR03=E)>';'<¿Limpiar el grid antes de la importación? (Ej: VERDADERO|FALSO)>';'<Línea inicial de la planilla>';'<Línea final de la planilla>';'<Nombre de la planilla>')
|
▪OPERACIÓN DEL CAMPO CON FILTRO: Devuelve la operación del campo filtro.
Sintaxis:
|
OPERACIONCAMPOFILTRO('<identificador de la tabla>';'<identificador del campo>';'<operación>';'<filtro>')
|
▪MODIFICAR CAMPO DEL COMBOBOX: Modifica el campo de un combobox.
Sintaxis:
|
MODIFICARCAMPOCOMBOBOX('<Identificador del combobox>';'<Identificador del atributo de la tabla>')
|
▪GEOLOCALIZACIÓN: Devuelve la longitud o latitud actual, siendo 1 para devolver la longitud y 2 para la latitud.
Sintaxis:
|
GEOLOCALIZACIÓN('<1 o 2>';'<Identificador del campo>')
|
▪EJECUTAR QUERY: Ejecuta la query y actualiza los campos con el resultado de la ejecución.
Sintaxis:
|
QUERYEXECUTE(<Identificador de la query previamente registrada: ej: listausuario>;<Persistir valores: ej: FORMFIELD1=CODE, FORMFIELD2=NAME>)
|
▪ABRIR ZOOM A PARTIR DE LA QUERY: Abre una pantalla y muestra el resultado de la ejecución de la consulta. Se puede seleccionar un registro para actualizar los campos del formulario.
Sintaxis:
|
QUERYZOOM(<Identificador de la query previamente registrada: ej: listausuario>;<Persistir valores: ej: FORMFIELD1=CODE, FORMFIELD2=NAME>;<Columnas: ej: CODE, NAME>)
|
▪ABRIR ZOOM A PARTIR DE LA QUERY PARA ACTUALIZAR GRID: Abre una pantalla y muestra el resultado de la ejecución de la consulta. Se pueden seleccionar múltiples registros para insertarlos en el grid del formulario.
Sintaxis:
|
QUERYZOOMTOGRID(<Identificador de la query previamente registrada: ej: listausuario>;<Identificador de la relación del grid: ej: Rel01>;<De/Para de campos del zoom que se incluirán en las columnas en el grid: ej: FORMFIELD1=CODE, FORMFIELD2=NAME>;<¿Limpiar el grid antes de la actualización? ej: VERDADERO | FALSO>;<Columnas: ej: CODE, NAME>)
|
|
Funciones que muestran mensajes en el formulario:
▪ALERT: Devuelve una alerta en la pantalla.
Sintaxis:
|
ALERT('<valor>')
|
▪CONFIRM: Devuelve una caja de diálogo.
Sintaxis:
|
CONFIRM(<parámetro>)
|
|
Funciones que hacen conversiones de información en el formulario:
▪FILTRO DE TABLA: Devuelve un objeto de filtro
Sintaxis:
|
FILTROTABLA('<identificador de la tabla>';'<identificador del campo>';'<valor>')
|
▪FECHA PARA NÚMERO: Convierte el parámetro <Fecha> para un número Timestamp Unix. Si la <Fecha> está con formato diferente al estándar del sistema, se puede informar el formato en el parámetro <Formato>. De forma predeterminada se puede informar ' '(vacío).
Sintaxis:
|
FECHAPARANUMERO(<Fecha>; <Formato>)
|
▪NÚMERO PARA FECHA: Convierte un <Número> Timestamp Unix para una fecha en el <Formato>, por ejemplo, NUMEROPARAFECHA(1411603200; 'dd/mm/yyyy'). Parámetro <Formato> es opcional, o sea se puede pasar ' ' (vacío).
Sintaxis:
|
NUMEROPARAFECHA(<Número>; <Formato>)
|
▪HORA PARA NÚMERO: Convierte el parámetro <Hora> para número de segundos. Si la <Hora> está con formato diferente al estándar del sistema, se puede informar el formato en el parámetro <Formato>. De forma predeterminada se puede informar ' ' (vacío).
Sintaxis:
|
HORAPARANUMERO('<Hora>';'<Formato>')
|
▪NÚMERO PARA HORA: Convierte un <Número> de segundos para una hora en el <Formato>, por ejemplo, NUMEROPARAHORA(7200; 'HH:mm:ss'). Parámetro <Formato> es opcional, o sea se puede pasar ' ' (vacío).
Sintaxis:
|
NUMEROPARAHORA('<Número>';'<Formato>')
|
▪TEXTO PARA NÚMERO: Convierte el parámetro <Texto> para un número.
Sintaxis:
|
TEXTOPARANUMERO('<Texto>')
|
|
Proceso
Funciones que devuelven información sobre la instancia del proceso (workflow, incidente o problema):
▪TÍTULO DEL PROCESO: Devuelve el título del proceso.
Sintaxis:
|
TITULOPROCESO()
|
▪IDENTIFICADOR SE SUITE: Devuelve el identificador del proceso (Workflow, Incidente, Problema) o del proyecto (SE Proyecto) donde el formulario fue asociado.
Sintaxis:
|
IDENTIFICADORSESUITE()
|
▪DESCRIPCIÓN DEL PROCESO: Devuelve la descripción del proceso.
Sintaxis:
|
DESCRIPCIONPROCESO()
|
▪SITUACIÓN: Devuelve la situación de automatización de la instancia del proceso. El <retorno> puede ser "Identificador" o "Nombre".
Sintaxis:
|
SITUACION('<retorno>')
|
▪PRIORIDAD: Devuelve la prioridad. El <retorno> puede ser "Nombre", "Orden" o "Valor".
Sintaxis:
|
PRIORIDAD('<retorno>')
|
▪ACTIVIDAD: Devuelve la actividad donde se muestra el formulario. El <retorno> puede ser 'Identificador' o 'Nombre de la actividad'.
Sintaxis:
|
ACTIVIDAD('<retorno>')
|
▪FIGURA SOLICITANTE: Devuelve la información del solicitante. Para cliente puede ser el nombre de la empresa, nombre del contacto o e-mail del contacto. Para el usuario puede ser login, matrícula, nombre de usuario, e-mail, área o función.
Sintaxis:
|
FIGURASOLICITANTE('<Figura>';'<Retorno>')
|
▪DEFINE ATRIBUTO DEL PROCESO: Define el valor de un atributo del proceso, si el atributo es multivalorado, los valores deben ser separados por "|". Ejemplo: valor1|valor2|valor3.
Sintaxis:
|
DEFINEATRIBUTOPROCESO(<identificador del atributo>; <valor del atributo>)
|
|
▪INICIADOR: Devuelve el usuario iniciador del proceso. El <retorno> puede ser el "login", "matrícula" o el "nombre del usuario".
Sintaxis:
|
INICIADOR('<retorno>')
|
▪ÁREA DEL INICIADOR: Devuelve el identificador del área del iniciador del proceso.
Sintaxis:
|
AREAINICIADOR()
|
▪FUNCIÓN DEL INICIADOR: Devuelve el identificador de la función del iniciador del proceso.
Sintaxis:
|
FUNCIONINICIADOR()
|
▪USUARIO CONECTADO: Devuelve el usuario conectado en el sistema. El <retorno> puede ser "código", "login", "matrícula" o "nombre del usuario".
Sintaxis:
|
USUARIOCONECTADO('<retorno>')
|
▪ATRIBUTO DEL USUARIO CONECTADO: Devuelve el valor de un atributo asociado al usuario conectado en el sistema.
Sintaxis:
|
ATRIBUTODELUSUARIOCONECTADO(<retorno>)
|
|
▪GUARDAR COMENTARIO: Guarda el <comentario> en el historial de la instancia del workflow, incidente o problema.
Sintaxis:
|
GUARDARCOMENTARIO(<comentario>)
|
▪EJECUTAR ACCIÓN DE ACTIVIDAD: Ejecuta la acción con el mismo nombre y que esté relacionada con la actividad que cargó el formulario.
Sintaxis:
|
EJECUTEACCIONACTIVIDAD('<Nombre de la acción>')
|
▪MODIFICAR SITUACIÓN: Modifica la situación de la instancia.
Sintaxis:
|
MODIFICARSITUACION('<identificador de la situación>')
|
|
▪MODIFICAR PRIORIDAD: Flecha el <valor de la prioridad> en la instancia
Sintaxis:
|
MODIFICARPRIORIDAD('<método de evaluación>';'<identificación de la prioridad>';'<valor de la prioridad>')
|
▪CREAR CAUSA: Crea una causa en la instancia de problema.
Sintaxis:
|
CREARCAUSA('<identificador de la causa>';'<nombre de la causa>';'<tipo de la causa>')
|
|
FECHA/HORA
▪HOY: Crea una fecha representando la fecha de hoy.
▪FECHA DEL SERVIDOR: Devuelve la fecha del servidor.
|
▪TIEMPO CORRIENTE: Devuelve la hora actual en el formato 'HH:mm:ss'.
Sintaxis:
|
TIEMPOCORRIENTE()
|
▪HORA DEL SERVIDOR: Devuelve el horario del servidor.
|
▪CALENDARIO: Devuelve el identificador del calendario.
▪CALENDARIO DEL PROCESO: Devuelve el identificador del calendario del proceso.
Sintaxis:
|
CALENDARIOPROCESO()
|
▪FECHA LABORABLE: Devuelve si el calendario considera la fecha como laborable
Sintaxis:
|
FECHALABORABLE('<fecha>';'<código del calendario>')
|
|
▪FECHA/HORA: Devuelve fecha/hora en el formato 'dd/mm/yyyy HH:mm:ss'.
Sintaxis:
|
FECHAHORA('<fecha>';'<hora>')
|
|
▪ANTES: Compara dos fechas y devuelve VERDADERO si la <Fecha 1> es anterior a la <Fecha 2>; en caso contrario devuelve FALSO.
Sintaxis:
|
ANTES('<Fecha 1>';'<Fecha 2>')
|
▪FECHA IGUAL: Compara dos fechas y devuelve VERDADERO si la <Fecha 1> es igual a la <Fecha 2>, en caso contrario, devuelve FALSO.
Sintaxis:
|
FECHAIGUAL('<Fecha 1>';'<Fecha 2>')
|
▪DESPUÉS: Compara dos fechas y devuelve VERDADERO si la <Fecha 1> es posterior a la <Fecha 2>, en caso contrario, devuelve FALSO.
Sintaxis:
|
DESPUES('<Fecha 1>';'<Fecha 2>')
|
▪DÍAS ENTRE: Devuelve el número de días entre las fechas <Fecha 1> y <Fecha 2>.
Sintaxis:
|
DIASENTRE('<Fecha 1>';'<Fecha 2>')
|
|
▪HORAS ENTRE: Devuelve el número de horas entre las horas <Hora 1> y <Hora 2>. Los parámetros <Hora 1> y <Hora 2> deben estar en el formato 'HH:mm:ss'.
Sintaxis:
|
HORASENTRE('<Hora 1>';'<Hora 2>')
|
▪HORAS ANTES: Compara dos horas y devuelve VERDADERO si la <Hora 1> es anterior a la <Hora 2>, en caso contrario, devuelve FALSO. Los parámetros <Hora 1> y <Hora 2> deben estar en el formato 'HH:mm:ss'.
Sintaxis:
|
HORA_ANTES('<Hora 1>';'<Hora 2>')
|
▪HORAS DESPUÉS: Compara dos horas y devuelve VERDADERO si la <Hora 1> es posterior a la <Hora 2>, en caso contrario, devuelve FALSO. Los parámetros <Hora 1> y <Hora 2> deben estar en el formato 'HH:mm:ss'.
Sintaxis:
|
HORA_DESPUES('<Hora 1>';'<Hora 2>')
|
▪HORA IGUAL: Compara dos fechas y devuelve VERDADERO si la <Fecha 1> es igual a la <Fecha 2>, en caso contrario, devuelve FALSO. Los parámetros <Fecha 1> y <Data 2> deben estar en el formato "HH:mm:ss".
Sintaxis:
|
FECHAHORA_IGUAL('<Hora 1>';'<Hora 2>')
|
|
▪FECHA/HORA ANTES: Compara dos fechas y devuelve VERDADERO si la <Fecha 1> es anterior a la <Fecha 2>, en caso contrario, devuelve FALSO. Los parámetros <Fecha 1> y <Fecha 2> deben estar en el formato 'dd/mm/yyyy HH:mm:ss'.
Sintaxis:
|
FECHAHORA_ANTES(<Fecha 1>;<Fecha 2>)
|
▪FECHA/HORA DESPUÉS: Compara dos fechas y devuelve VERDADERO si la <Fecha 1> es posterior a la <Fecha 2>, en caso contrario, devuelve FALSO. Los parámetros <Fecha 1> y <Fecha 2> deben estar en el formato 'dd/mm/yyyy HH:mm:ss'.
Sintaxis:
|
FECHAHORA_DESPUES(<Fecha 1>;<Fecha 2>)
|
▪FECHA/HORA IGUAL: Compara dos fechas y devuelve VERDADERO si la <Fecha 1> es igual a la <Fecha 2>, en caso contrario, devuelve FALSO. Los parámetros <Fecha 1> y <Fecha 2> deben estar en el formato 'dd/mm/yyyy HH:mm:ss'.
Sintaxis:
|
FECHAHORA_IGUAL(<Fecha 1>;<Fecha 2>)
|
|
▪SEPARAR FECHA DE FECHA/HORA: Devuelve la fecha de fecha/hora en el formato 'dd/mm/yyyy'. El parámetro <fecha/hora> debe estar en el formato 'dd/mm/yyyy HH:mm:ss'.
Sintaxis:
|
FECHAHORA_FECHA(<fecha/hora>)
|
▪SEPARAR HORA DE FECHA/HORA: Devuelve la hora de <fecha/hora> en el formato "HH:mm:ss". El parámetro <fecha/hora> debe estar en el formato 'dd/mm/yyyy HH:mm:ss'.
Sintaxis:
|
FECHAHORA_HORA(<fecha/hora>)
|
|
▪AÑO: Extrae el año de la <Fecha>.
▪MES: Extrae el mes de la <Fecha>.
▪DÍA: Extrae el día de la <Fecha>.
▪DÍA DE LA SEMANA: Extrae el día de la semana de la <Fecha>.
Sintaxis:
|
DIADELASEMANA('<Fecha>')
|
▪NÚMERO DE LA SEMANA: Extrae el número de la semana (dentro del año) de la <Fecha>.
Sintaxis:
|
NUMSEMANA('<Fecha>')
|
|
▪HORA: Devuelve el número de horas.
▪MINUTO: Devuelve los minutos.
Sintaxis:
|
MINUTO('<hora>')
|
|
▪AGREGAR NÚMERO DE HORAS: Devuelve nueva fecha/hora, en el formato 'dd/mm/yyyy HH:mm:ss', después de agregar número de horas. El parámetro <fecha/hora> debe estar en el formato 'dd/mm/yyyy HH:mm:ss'.
Sintaxis:
|
AGREGANRHORAS('<fecha/hora>';'<número>';'<calendario>')
|
▪AGREGAR HORAS: Devuelve nueva fecha/hora, en el formato 'dd/mm/yyyy HH:mm:ss', después de agregar horas. El parámetro <fecha/hora> debe estar en el formato 'dd/mm/yyyy HH:mm:ss'.
Sintaxis:
|
AGREGARHORAS('<fecha/hora>';'<horas>';'<calendario del proceso>')
|
▪AGREGAR DÍAS: Devuelve nueva fecha/hora, en el formato 'dd/mm/yyyy HH:mm:ss', después de agregar número de días. El parámetro <fecha/hora> debe estar en el formato 'dd/mm/yyyy HH:mm:ss'.
Sintaxis:
|
AGREGARDIAS('<fecha/hora>';'<días>';'<calendario del proceso>')
|
|
|