Funções de scripts globais do EmailPlus que podem ser usadas para criar regras
avançadas EmailPlusRule.
- OneOf($list, $item)
- Procura em uma matriz de valores de sequência a presença do item especificado. O
parâmetro $list é uma referência para uma matriz. O parâmetro
$item é uma sequência. A função retornará TRUE se o item for
localizado; caso contrário, retornará FALSE. O exemplo a seguir retorna 1 ou TRUE porque
a sequência value2 está na matriz: OneOf( ['value1', 'value2', 'value3'], 'value2' )
- Gfv($fieldName)
- Encapsulamento simples da chamada da API do IBM Rational ClearQuest,
GetFieldValue, que equivale a esta instrução: GetFieldValue($fieldName)->GetValue().
- Gfov($fieldName)
- Encapsulamento simples da chamada da API do ClearQuest,
GetFieldOriginalValue, que retorna o valor original de um campo antes
que mudanças fossem feitas.
- Gfvs($fieldName)
- Encapsulamento simples da chamada da API do ClearQuest, GetFieldValueStatus,
que equivale a esta instrução: GetFieldValue($fieldName)->GetValueStatus().
- FChg($list)
- Avalia todos os campos definidos no parâmetro $list para
identificar se algum valor de campo foi alterado. Retornará ANY se um ou mais valores de
campo tiverem sido alterados. Retornará ALL se todos os valores de campo tiverem sido
alterados. Retornará NONE se nenhum dos valores de campo tiver sido alterado. O
parâmetro $list é uma referência para uma matriz.
- StoDT($dateString)
- Converte um valor de sequência de data no formato “AAAA-MM-DD hh:mm:ss” de um campo
DATE_TIME do ClearQuest para uma expressão de data/hora UTC em segundos. O valor de
retorno é o número de segundos não extras desde a época. Na maioria dos sistemas, a
época é 00:00:00 UTC, 1 de janeiro, 1970.
- DTtoS($timestamp)
- Converte uma expressão de data/hora UTC em segundos em uma sequência de data no
formato AAAA-MM-DD hh:mm:ss.
- EMP_ReFormatDateString($dateString, $template, $timezone)
- Converte um campo DATE_TIME do ClearQuest do formato AAAA-MM-DD hh:mm:ss para um
formato de sua escolha. O parâmetro $template é um modelo definido
usando as categorias LC_TIME do código de idioma do programa, por exemplo, “%d-%m-%Y
%H:%M:%S”. O parâmetro opcional $timezone define o fuso horário. Se
nenhum fuso horário for definido, o padrão do host que envia a notificação será usado. Se
o valor da sequência de data que é transmitido a essa função estiver vazio, uma sequência
vazia será retornada. Essa função utiliza o módulo Perl Date::Format incluído no CQPerl,
por exemplo:
#@EXPRESSION::EMP_ReFormatDateString(
Gfv("DueDate"), "%d-%m-%Y %H:%M:%S", "UTC" );@#
Esse exemplo gera a data
no formato ctime: #@EXPRESSION::EMP_ReFormatDateString(
Gfv("DueDate"), "%C", "UTC" );@#.