Funciones de script global de EmailPlus

EmailPlus tiene funciones de scripts globales que puede utilizar para crear reglas avanzadas de EmailPlusRule.

OneOf($list, $item)
Busca en una matriz de valores de serie para ver si contiene el elemento especificado. El parámetro $list es una referencia a una matriz. El parámetro $item es una serie. La función devuelve TRUE si se encuentra el elemento; de lo contrario, devuelve FALSE. El siguiente ejemplo devuelve 1 o TRUE porque la serie value2 está en la matriz: OneOf( ['value1', 'value2', 'value3'], 'value2' )
Gfv($fieldName)
Encapsulación simple de la llamada a la API de IBM Rational ClearQuest GetFieldValue, que es equivalente a este sentencia: GetFieldValue($fieldName)->GetValue().
Gfov($fieldName)
Encapsulación simple de llamada a la API de ClearQuest GetFieldOriginalValue, que devuelve el valor original de un campo antes de que se hayan realizado cambios.
Gfvs($fieldName)
Encapsulación simple de la llamada a la API de ClearQuest GetFieldValueStatus, que es equivalente a este sentencia: GetFieldValue($fieldName)->GetValueStatus().
FChg($list)
Evalúa todos los campos definidos en el parámetro $list para identificar si alguno de los valores de campo ha cambiado. Devuelve ANY si uno o más campos han cambiado. Devuelve ALL si todos los valores de campo han cambiado. Devuelve NONE si ninguno de los valores de campo ha cambiado. El parámetro $list es una referencia a una matriz.
StoDT($dateString)
Convierte un valor de serie de fecha del formato “AAAA-MM-DD hh:mm:ss” del campo de ClearQuest DATE_TIME en una expresión de fecha y hora UTC en segundos. El valor de retorno es el número de segundos sin salto desde la época. En la mayoría de los sistemas, la época es 00:00:00 UTC, 1 de enero de 1970.
DTtoS($timestamp)
Convierte una expresión de fecha y hora UTC en segundos en una serie de fecha en el formato AAAA-MM-DD hh:mm:ss.
EMP_ReFormatDateString($dateString, $template, $timezone)
Convierte un campo de ClearQuest DATE_TIME del formato AAAA-MM-DD hh:mm:ss al formato que elija el usuario. El parámetro $template es una plantilla que se define utilizando las categorías LC_TIME del entorno local del programa, por ejemplo “%d-%m-%Y %H:%M:%S”. El parámetro $timezone opcional define el huso horario. Si no se define ningún huso horario, se utiliza el huso horario predeterminado del host que envíe la notificación. Si el valor de la serie de fecha que se pasa a esta función está vacío, se devuelve una serie vacía. Esta función utiliza el módulo Perl Date::Format que se incluye con CQPerl, por ejemplo:

#@EXPRESSION::EMP_ReFormatDateString( Gfv("DueDate"), "%d-%m-%Y %H:%M:%S", "UTC" );@#

Este ejemplo genera la fecha en formato ctime: #@EXPRESSION::EMP_ReFormatDateString( Gfv("DueDate"), "%C", "UTC" );@#.


Comentarios