Partilhar via

Sugestões e exemplos

  • Artigo

Fórmula da métrica

Defina a fórmula de métricas num formulário de texto. Pode ser composto pelas operações predefinidas.

As operações individuais estão divididas em dois grupos básicos:

  • Operações de agregação: a entrada da operação de agregação é um conjunto de valores para os quais o valor resultante será calculado (por exemplo, média, máximo e muito mais).

  • Operações escalares: a entrada de uma operação escalar é um ou mais valores para os quais o valor resultante será calculado (por exemplo, valor absoluto do número, obtenção de parte do imposto e muito mais).

As operações podem utilizar constantes, podem ser combinadas utilizando operadores unários ou binários (por exemplo, adição, subtração e muito mais), ou serem aninhadas.

As operações escalares também incluem operações para obter um valor, diretamente disponíveis no formulário de um atributo ou no formulário de estatísticas derivadas (duração do evento).

Algumas operações também suportam a especificação do contexto para o qual a operação é avaliada. Isto é importante para as operações de agregação que possam agregar valores, por exemplo, apenas para uma atividade específica ou para todas as atividades ou eventos. O contexto implícito resultante do contexto da métrica ou o contexto da operação principal também é suportado.

Uma fórmula de métrica pode devolver um dos tipos de dados suportados. Os tipos de dados para fórmulas específicas são definidos neste artigo junto à definição da sintaxe da fórmula.

Operações de agregação

As operações de agregação são a base de cada métrica. As operações de agregação utilizadas mais frequentemente são:

  • COUNT: devolve o número de valores agregados (incl. COUNTIF, COUNTUNIQUE).
  • SUM: devolve a soma de valores agregados (incl. SUMIF).
  • AVG: devolve a média de valores agregados.
  • MIN: devolve o mínimo dos valores agregados.
  • MAX: devolve o máximo dos valores agregados.

O parâmetro voluntário das operações de agregação será o contexto da operação e a operação escalar para modificação do valor de entrada. A lista completa de contextos de cálculo suportados é descrita no Contexto de cálculo.

Operações escalares

A finalidade das operações escalares é obter um valor e a sua transformação para o estado pretendido. As operações suportadas atualmente podem ser divididas em vários tipos:

  • Matemática: inclui as operações para obter o valor absoluto de um número, arredondamento, e muito mais.
  • Data e Hora: — inclui as operações para trabalhar com a data, como obter parte da data, adicionar datas, e muito mais.
  • Cadeia: - inclui as operações para trabalhar com dados da cadeia, tais como obter uma subcadeia, dividir cadeias, e muito mais.
  • Estatísticas: inclui operações para obter estatísticas diferentes, tais como o número de casos, o tempo de espera dos casos, e muito mais.
  • Outras: inclui outras operações, por exemplo, operações que acedem a eventos, casos, estatísticas derivadas, e muito mais.

Nomes de atributos

Se um nome de atributo for utilizado como parâmetro para a operação, existem três formas de referenciá-lo:

  • Utilize o nome do atributo diretamente (por exemplo, Resource).

  • Utilize a operação GETVALUE("nome de atributo") (por exemplo, GETVALUE("Resource")).

  • Utilize o nome do atributo abreviado diretamente (por exemplo, attribute "Resource ID" poderá ser referenciado como ResourceID).

O segundo formulário é utilizado quando o nome do atributo não cumpre a convenção de nomenclatura. A convenção de nomenclatura do atributo é definida da seguinte forma:

  • O nome Atributo deve começar com um carácter de letra ou de sublinhado.

  • O Nome do Atributo só pode conter caracteres das seguintes classes padrão Unicode: carácter de letra (Lu, Ll, Lt, Lm, Lo ou Nl), carácter de combinação (Mn ou Mc), carácter de dígito decimal (Nd), carácter de ligação (Pc) ou carácter de formatação (Cf).

    Para obter informações sobre as classes de carateres Unicode acima mencionadas, consulte The Unicode Standard, Versão 3.0, secção 4.5.

O terceiro formulário é utilizado opcionalmente quando o nome do atributo preenche a convenção de nomenclatura, mas também contém caracteres de espaço. Em vez de utilizar o segundo formulário GETVALUE("attribute name"), é possível remover os caracteres de espaço e utilizar a versão abreviada, attributename. Os dois formulários são equivalentes.

Exemplos de nomes de atributos VALID

  • DocumentCategory

  • DocCat

  • DocCat23

Exemplos de nomes de atributos INVALID

  • Document.Category

  • Document Category

  • 23DocCat

Exemplos de fórmula da métrica

Para calcular a duração relativa da atividade num mapa:

AVG (DURATION()) / AVG (VIEWCASES, DURATION())