Compartir a través de

Sugerencias y ejemplos

  • Artículo

Fórmula de la métrica

Defina la fórmula de la métrica en forma de texto. Puede consistir en operaciones predefinidas.

Las operaciones individuales se dividen en dos grupos básicos:

  • Operaciones de agregación: la entrada de la operación de agregación es un conjunto de valores para los cuales se calculará el valor resultante (por ejemplo, promedio, máximo y más).

  • Operaciones escalares: la entrada de la operación escalar es uno o más valores para los cuales se calculará el valor resultante (por ejemplo, valor absoluto del número, obtención de parte del impuesto, y más).

Las operaciones pueden usar constantes, se pueden combinar usando operadores unarios o binarios (por ejemplo, suma, resta y más), o anidado.

Las operaciones escalares también incluyen operaciones para obtener un valor, ya sea directamente disponible en forma de atributo o en forma de estadísticas derivadas (duración del evento).

Algunas operaciones también admiten la especificación del contexto para el que se evalúa la operación. Esto es importante para las operaciones de agregación que pueden agregar valores, por ejemplo, solo para una actividad específica o para todas las actividades o eventos. También se admite el contexto implícito resultante del contexto de la métrica o el contexto de la operación principal.

Una fórmula de la métrica puede devolver uno de los tipos de datos admitidos. Los tipos de datos para fórmulas específicas se definen en este artículo junto a la definición de sintaxis de la fórmula.

Operaciones de agregación

Las operaciones de agregación son la base de cada métrica. Las operaciones de agregación usadas más habitualmente son:

  • COUNT: devuelve el número de valores agregados (incl. COUNTIF, COUNTUNIQUE).
  • SUM: devuelve la suma de valores agregados (incl. SUMIF).
  • AVG: devuelve el promedio de valores agregados.
  • MIN: devuelve el mínimo de valores agregados.
  • MAX: devuelve el máximo de valores agregados.

El parámetro voluntario de las operaciones de agregación será el contexto de la operación y la operación escalar de modificación del valor de entrada. La lista completa de contextos de cálculo admitidos se describe en Contexto de cálculo.

Operaciones escalares

El propósito de las operaciones escalares es obtener un valor y su transformación al estado deseado. Las operaciones admitidas actualmente se pueden dividir en varios tipos:

  • Matemáticas: incluye operaciones para obtener el valor absoluto de un número, redondeo y más.
  • Fecha y hora: incluye operaciones para trabajar con la fecha, como obtener parte de la fecha, sumar fechas y más.
  • String: incluye operaciones para trabajar con datos de cadena, como obtener una subcadena, dividir cadenas y más.
  • Estadística: incluye operaciones para obtener diferentes estadísticas, como el número de casos, el tiempo de espera de los casos y más.
  • Otro: incluye otras operaciones, por ejemplo, operaciones de acceso a eventos, casos, estadísticas derivadas y más.

Nombres de atributo

Si se utiliza un nombre de atributo como parámetro para la operación, hay tres formas de hacer referencia a él:

  • Utilice el nombre del atributo directamente (por ejemplo, Resource).

  • Utilice la operación GETVALUE("nombre de atributo") (por ejemplo, GETVALUE("Resource")).

  • Utilice el nombre de atributo abreviado directamente (por ejemplo, attribute "Resource ID" podría referenciarse como ResourceID).

La segunda forma se usa cuando el nombre del atributo no cumple con la convención de nomenclatura. La convención de nomenclatura de atributos se define de la siguiente manera:

  • El nombre del atributo debe comenzar con una letra o un guion bajo.

  • El nombre del atributo solo puede contener caracteres de las siguientes clases estándar de Unicode: carácter de letra (Lu, Ll, Lt, Lm, Lo o Nl), carácter de combinación (Mn o Mc), carácter de dígito decimal (Nd), carácter de conexión (Pc ), o carácter de formato (Cf).

    Para obtener información sobre las clases de caracteres Unicode mencionadas anteriormente, vea el Estándar Unicode, versión 3.0, sección 4.5.

La tercera forma se usa opcionalmente cuando el nombre del atributo cumple con la convención de nomenclatura, pero también contiene caracteres de espacio. En lugar de usar la segunda forma GETVALUE("attribute name"), es posible eliminar los espacios y usar la versión abreviada, attributename. Ambas formas son equivalentes.

Ejemplos de nombres de atributos VÁLIDOS

  • DocumentCategory

  • DocCat

  • DocCat23

Ejemplos de nombres de atributos NO VÁLIDOS

  • Document.Category

  • Document Category

  • 23DocCat

Ejemplos de la fórmula de la métrica

Para calcular la duración relativa de la actividad en una representación:

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