Compartilhar via

Dicas e exemplos

  • Artigo

Fórmula da métrica

Defina a fórmula métrica em um formulário de texto. Ela pode consistir em operações predefinidas.

As operações individuais sã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 mais).

  • Operações escalares: A entrada da 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 mais).

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

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

Algumas operações também dão suporte à especificação do contexto para o qual a operação é avaliada. Isso é importante para operações de agregação que podem 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 do contexto da operação pai também é suportado.

Uma fórmula métrica pode retornar um dos tipos de dados compatíveis. Os tipos de dados para fórmulas específicas são definidos neste artigo ao lado da 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 usadas com mais frequência são:

  • CONTAGEM: Retorna o número de valores agregados (incl. COUNTIF, COUNTUNIQUE).
  • SOMA: Retorna a soma dos valores agregados (incl. SUMIF).
  • MÉDIA: Retorna a média dos valores agregados.
  • MIN: Retorna o valor mínimo dos valores agregados.
  • MÁX: Retorna o valor 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 em Contexto de cálculo.

Operações escalares

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

  • Matemática: inclui operações para obter o valor absoluto de um número, arredondamento e muito mais.
  • Data e Hora: inclui operações para trabalhar com a data, como obter parte da data, somar datas e muito mais.
  • Cadeia de caracteres: inclui operações para trabalhar com dados de cadeias de caracteres, como obter uma substring, dividir cadeias de caracteres e muito mais.
  • Estatística: inclui operações para obter estatísticas diferentes, como número de casos, tempo de espera do caso e muito mais.
  • Outras: inclui outras operações, por exemplo, operações que acessam evento, caso, estatísticas derivadas e muito mais.

Nomes de atributo

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

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

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

  • Use o nome de atributo abreviado diretamente (por exemplo, attribute "Resource ID" pode ser referenciado como ResourceID).

O segundo formulário é usado quando o nome do atributo não atende à convenção de nomenclatura. A convenção de nomenclatura de atributos é definida da seguinte forma:

  • O nome do atributo deve começar com uma letra ou sublinhado.

  • O nome do atributo pode conter apenas caracteres das seguintes classes padrão Unicode: caractere de letra (Lu, Ll, Lt, Lm, Lo ou Nl), caractere de combinação (Mn ou Mc), caractere de dígito decimal (Nd), caractere de conexão (Pc ) ou caractere de formatação (Cf).

    Para obter informações sobre classes de caracteres Unicode mencionadas anteriormente, confira o Unicode Standard, versão 3.0, seção 4.5.

O terceiro formulário é usado opcionalmente quando o nome do atributo atende à convenção de nomenclatura, mas também contém caracteres de espaço. Em vez de usar o segundo formulário GETVALUE("attribute name"), é possível remover os caracteres de espaço e usar a versão abreviada, attributename. Ambas as formas são equivalentes.

Exemplos de nomes de atributos VÁLIDOS

  • DocumentCategory

  • DocCat

  • DocCat23

Exemplos de nomes de atributos INVÁLIDOS

  • Document.Category

  • Document Category

  • 23DocCat

Exemplos de fórmula métrica

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

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