getChange (cadeia de caracteres do indicador, objeto fromDate, objeto toDate)

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 1 min. de leitura
  • Retorna a mudança na pontuação de um indicador entre duas datas especificadas.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    indicador Cadeia de caracteres Identificador exclusivo do indicador para o qual a mudança será calculada.
    fromDate Objeto Data inicial da comparação.
    atéAtual Objeto Data de término da comparação.
    Tabela 2. Retorna
    Tipo Descrição
    Número Diferença na pontuação do indicador especificado entre as duas datas.

    Mudar do início do mês até o último período de coleta

    Neste exemplo, temos o indicador Número de incidentes abertos, cujas pontuações são coletadas diariamente. O parâmetro fromDate é o primeiro segundo do mês atual, construído usando o carimbo de data/hora do último período de coleta (score_start), extraindo o ano e o mês do carimbo de data/hora e acrescentando o numeral 01 para o dia. O parâmetro toDate é o carimbo de data/hora do início do último período de coleta, que seria o primeiro segundo do dia anterior, dependendo das diferenças de fuso horário.

    pa.getChange($[[Number of open incidents]], new GlideDateTime(score_start.getYear() + '-' + score_start.getMonth() + '-01'), score_start);