Explore permite escribir fórmulas que accionan métricas y atributos personalizados. Para asegurarse de que las fórmulas funcionen correctamente, constrúyalas correctamente. Si la fórmula no está construida correctamente, el editor de fórmulas muestra un mensaje de error en tiempo real mientras escribe o edita. El mensaje de error identifica el problema y proporciona orientación sobre cómo resolverlo.
En este artículo se explica cómo corregir una fórmula mal configurada en los informes. Enumera los mensajes de error que se pueden encontrar en el editor de fórmulas y proporciona consejos sobre cómo corregir la fórmula, incluidos ejemplos de fórmulas incorrectas y correctas.
En este artículo se tratan los siguientes temas:
- Corrección de fórmulas configuradas incorrectamente
- Tipos de mensajes de error en el editor de fórmulas
Artículos relacionados:
Corrección de fórmulas configuradas incorrectamente
Si una métrica calculada o un atributo contiene una fórmula mal configurada, no devolverá resultados. Para identificar las fórmulas mal configuradas, verifique los siguientes lugares:
- La biblioteca de informes. Los informes que usan una fórmula mal configurada aparecen en la categoría Actualizaciones requeridas en la biblioteca de informes
- La biblioteca de paneles. Los paneles que usan los informes afectados aparecen en la pestaña Actualizaciones requeridas en la biblioteca de paneles
- El generador de informes. En la parte inferior de un informe que utiliza la fórmula aparece un mensaje de advertencia.
- El editor de fórmulas. Aquí aparece un mensaje de advertencia en relación a la fórmula afectada.
Para corregir una fórmula configurada incorrectamente, abra el informe que utiliza la fórmula y corríjala en el editor de fórmulas. Luego vuelva a publicar todos los paneles que utilizan ese informe.
) y seleccionando Creado por.Para actualizar una fórmula configurada incorrectamente
- En Explore, haga clic en el icono Informes (
) para abrir la biblioteca de informes. - Haga clic en la pestaña Se requieren actualizaciones.
- Haga clic en uno de los informes que se muestran para abrirlo.
- Para cada métrica calculada o atributo:
- Haga clic en la métrica o el atributo y luego haga clic en el icono de lápiz.
- Revise la fórmula para detectar incorrecciones. Las partes de la fórmula que no están bien configuradas aparecen subrayadas. Un mensaje de error le indica qué necesita corregirse.
- (Opcional) Haga una copia de la métrica o del atributo antes de hacer ningún cambio. Así se evita que los informes existentes se vean afectados durante la corrección del problema.
- Corrija los problemas con la fórmula especificada por el mensaje de error. Consulte las secciones que siguen si desea más ayuda sobre determinados mensajes de error.
Tenga en cuenta que cuando se corrige la fórmula de una métrica calculada o un atributo en un informe, también se corrige en todos los informes donde se utiliza.
- (Opcional) Si creó una copia de la métrica o del atributo, actualice el original.
- Guardar el informe
Para volver a publicar los paneles afectados
- Haga clic en el icono de Paneles (
) para abrir la biblioteca de paneles. - Haga clic en la pestaña Se requieren actualizaciones.
- Pase el mouse por encima de los paneles y haga clic en Editar.
- En el panel, haga clic en la flecha hacia abajo que está junto a Compartir y seleccione Publicar. La próxima vez que los usuarios miren el panel compartido, verán la versión más reciente.
- Haga clic en Publicar.
Tipos de mensajes de error en el editor de fórmulas
En esta sección se describen los siguientes tipos de mensajes de error y se recomienda cómo resolverlos:
Errores de fórmula más comunes
El video que sigue explica cómo corregir algunas advertencias habituales.
Consulte las secciones que siguen si desea más ayuda sobre determinados mensajes de error.
Mensajes de error de sintaxis en general
Si ve el siguiente mensaje de error, quiere decir que parte de la sintaxis de la fórmula está incorrecta:
- "Hay un problema con la fórmula. Verifique la sintaxis del cálculo y vuelva a intentarlo".
Las razones que suelen ocasionar este error se pueden ver en la tabla que sigue.
| Razón | Fórmula incorrecta | Fórmula correcta |
|---|---|---|
| Se abrió pero no se cerró un corchete o un paréntesis. O se cerró más de lo que se abrió. | IF ([Estado del ticket] = "Solved")) THEN [ID del ticket] ENDIF | IF ([Estado del ticket] = "Solved") THEN [ID del ticket] ENDIF |
| Se abrió pero no se cerró un par de comillas. | [Estado del ticket] = "Solved | [Estado del ticket] = "Solved” |
| No se encerró el atributo dentro de corchetes. | Estado del ticket = "Solved” | [Estado del ticket] = "Solved” |
| No se agregó un agregador delante de una métrica. |
Tiempo de primera respuesta (min) |
SUM(Tiempo de primera respuesta (min)) |
| Falta una parte esencial de la declaración IF. En este ejemplo, falta ENDIF. |
IF ([Estado del ticket] = "Solved") THEN [ID del ticket] |
IF ([Estado del ticket] = "Solved") THEN [ID del ticket] ENDIF |
Mensajes de error de tipo de datos
Las tablas a continuación muestran mensajes de error relacionados con tipos de datos que se podrían ver en el editor de fórmulas, lo que incluye versiones correctas e incorrectas de una fórmula.
En las secciones siguientes se describen los mensajes de error relacionados con tipos de datos:
Expresiones Igual a, No es igual a, Mayor que o Menor que
| Ejemplo de mensaje de error | Fórmula incorrecta | Fórmula correcta |
|---|---|---|
| No se puede usar [Fase del proyecto] como texto y 1 como número. Utilice el mismo tipo. | [Fase del proyecto]=1 |
[Fase del proyecto]="1" Se debe usar el mismo tipo de datos en ambos lados de la expresión de igualdad. Un valor encerrado entre comillas se considera texto, pero un número sin comillas es un número. Como Fase del proyecto es un atributo de texto, el valor debe ir encerrado entre comillas. |
| No se puede usar [País del ticket] como texto y [Código de país del usuario] como número. Utilice el mismo tipo. | [País del ticket]!=[Código de país del usuario] |
[País del ticket]!=[Nombre de país del usuario] Se debe usar el mismo tipo de datos en ambos lados de la expresión de desigualdad. País del ticket es texto, de modo que el atributo de la derecha también debe ser texto. |
| No se puede usar [Ticket asignado - Fecha] como texto y 26 como número. Utilice solo números o solo texto. | [Ticket asignado - Fecha] >= 26 |
[Ticket asignado - Fecha] >= "2023-01-26" Se debe usar el mismo tipo de datos en ambos lados de la expresión Mayor o igual que. En este caso, es una fecha encerrada entre comillas. |
| No se puede usar VALUE(Respuestas del agente) como número y 2 como texto. Utilice solo números o solo texto. | VALUE(Respuestas del agente)<”2” |
VALUE(Respuestas del agente)<2 Se debe usar el mismo tipo de datos en ambos lados de la expresión Menor que. Un valor encerrado entre comillas se considera texto, pero un número sin comillas es un número. Puesto que Respuestas del agente es una métrica, el valor debe ser un número, de modo que no se debe usar comillas. |
Operaciones aritméticas y combinación de valores de texto
| Ejemplo de mensaje de error | Fórmula incorrecta | Fórmula correcta |
|---|---|---|
| No se puede usar [Grupo del ticket] como texto además de [ID del ticket] como número. Utilice solo números o solo texto. Si es necesario, use la función STRING para transformar números en texto, o la función NUMBER para transformar texto en números. | [Grupo del ticket]+[ID del ticket] |
[Grupo del ticket]+STRING([ID del ticket]) El objetivo de esta fórmula consiste en combinar texto tal como se ilustra en la Receta de Explore: Combinar atributos. Eso significa que es necesario transformar el atributo numérico en texto a través de la función STRING. |
| No se puede usar VALUE(Tiempo de resolución completa (min)) como número y [Tiempo de tarea adicional] como texto. Utilice solo números o solo texto. Si es necesario, use la función STRING para transformar números en texto, o la función NUMBER para transformar texto en números. | VALUE(Tiempo de resolución completa (min))+[Tiempo de tarea adicional] |
VALUE(Tiempo de resolución completa (min))+NUMBER([Tiempo de tarea adicional]) El objetivo de esta fórmula consiste en sumar dos valores. Tiempo de resolución completa (min) es un número, mientras que Tiempo de tarea adicional es un campo de texto que contiene valores numéricos. Lo mejor sería crear un nuevo campo numérico personalizado en Support para registrar el tiempo de tarea adicional, lo que no requiere ninguna transformación y viene listo para usarse en Explore. Como alternativa, el atributo de texto se puede transformar en un número a través de la función NUMBER. |
| No se puede usar VALUE(Tiempo de primera respuesta (min)) como número y "60" como texto. Utilice solo números. | VALUE(Tiempo de primera respuesta (min))/"60" |
VALUE(Tiempo de primera respuesta (min))/60 Las operaciones aritméticas como la división necesitan valores numéricos. Un valor encerrado entre comillas se considera texto, pero un número sin comillas es un número. Aquí no se deben usar comillas. |
| No se puede usar COUNT(Comentarios) como número y [Comentario público] como texto. Utilice solo números. | COUNT(Comentarios)-[Comentario público] |
COUNT(Comentarios)-COUNT(Comentarios públicos) Las operaciones aritméticas como la sustracción necesitan valores numéricos. Comentario público es un atributo de texto. Se necesita usar una métrica en lugar. |
Funciones
| Ejemplo de mensaje de error | Fórmula incorrecta | Fórmula correcta |
|---|---|---|
| No se pueden usar tipos diferentes en la declaración THEN. 1 es número y "0" es texto. Utilice el mismo tipo. | IF [Estado del ticket]="Open" THEN 1 ELSE "0" ENDIF |
IF [Estado del ticket] = "Open" THEN 1 ELSE 0 ENDIF o bien IF [Estado del ticket] = "Open" THEN "1" ELSE "0" ENDIF Los valores que se utilizan después de las palabras clave THEN y ELSE deben ser valores del mismo tipo. Un valor encerrado entre comillas se considera texto, pero un número sin comillas es un número. Hay dos maneras de corregir este error, como se ilustra más arriba. |
| No se puede usar 1 como número y 2 como número. Utilice solo valores booleanos. | IF 1 OR 2 THEN [ID del ticket] ENDIF |
IF VALUE(Respuestas del agente) = 1 OR VALUE(Respuestas del agente) = 2 THEN [ID del ticket] ENDIF Las condiciones indicadas dentro de la declaración IF deben ser TRUE o FALSE. La sintaxis correcta es como sigue: IF TRUE OR FALSE THEN [ID del ticket] ENDIF En su lugar, agregue algunas condiciones. Pero el editor de fórmulas no verifica la validez de las condiciones propiamente dichas. |
| No se pueden usar números en esta función. Use texto. | NUMBER([ID del ticket]) |
NUMBER([ID externa del ticket]) La función NUMBER está diseñada para transformar en texto los atributos de texto con valores numéricos. El atributo ID del ticket es un campo numérico, razón por la cual no se puede usar con esta función. Sin embargo, los atributos de texto como ID externa del ticket sí se pueden usar. |
| No se puede usar texto, booleano en esta función. Utilice texto, texto o número. |
LINK("https://subdomain.zendesk.com/ agent/organizations/" + STRING([ID de la organización del ticket]), [Casilla de verificación de organización]) |
LINK(” o bien LINK(” La función LINK espera texto como segundo parámetro, razón por la cual no se puede usar un atributo booleano. Hay dos opciones, como se muestra arriba. Se puede usar un atributo de texto, o bien transformar el atributo booleano en texto a través de la función STRING. |
| No se puede usar [Ticket creado - mes] como texto aquí. Use tipo de marca de tiempo. | DATE_LAST([Ticket creado - Mes]) |
DATE_LAST([Ticket creado - Marca de tiempo]) La función DATE_LAST espera un atributo de marca de tiempo. |
| No se pueden usar distintos tipos de condiciones. Use tipo de texto. |
SWITCH ([Grupo de tickets]) {CASE "Support": "1" CASE 3: "2" } |
SWITCH ([Grupo del ticket]) {CASE "Support": "1" CASE 3: "2" } Puesto que Grupo del ticket es un atributo de texto, las condiciones de todos los casos deben ser de tipo de texto. Un valor encerrado entre comillas se considera texto, pero un número sin comillas es un número. Eso significa que el 3 debe encerrarse entre comillas. |
| No se pueden usar distintos tipos en la declaración SWITCH. "1" es texto y 2 es número. Utilice el mismo tipo. | SWITCH ([Grupo del ticket]) {CASE "Support": "1" CASE "IT": 2 } |
SWITCH ([Grupo del ticket]) {CASE "Support": "1" CASE "IT": "2" } Los resultados de todos los casos deben ser del mismo tipo. Un valor encerrado entre comillas se considera texto, pero un número sin comillas es un número. Eso significa que el 2 debe encerrarse entre comillas. |
| No es posible usar distintos tipos en la matriz. Utilice el mismo tipo. | IN([Instancia del segmento], ARRAY(1, "2", "3")) |
IN([Instancia del segmento], ARRAY(1, 2, 3)) Use comillas para todos los valores si se trata de un atributo de texto, o bien no use comillas para ninguno de los valores si se trata de un atributo numérico. Instancia del segmento es un atributo numérico, por lo que la fórmula no debe utilizar comillas. |
Mensajes de error de agregador de métricas
| Ejemplo de mensaje de error | Fórmula incorrecta | Fórmula correcta |
|---|---|---|
| No se puede usar el agregador SUM(métrica de base de datos). Utilice el agregador VALUE, función ATTRIBUTE_FIX o ATTRIBUTE_ADD. | IF SUM(Tiempo de espera del solicitante (min))>120 THEN "Long wait time" ELSE "Short wait time" ENDIF |
IF VALUE(Tiempo de espera del solicitante (min))>120 THEN "Long wait time" ELSE "Short wait time" ENDIF Este mensaje de error aparece en los atributos calculados, no en las métricas. En este caso, es necesario usar el agregador VALUE. |
| No se puede usar COUNT(Tickets resueltos) en un atributo calculado. Encierre la métrica en la función ATTRIBUTE_FIX o ATTRIBUTE_ADD. | IF COUNT(Tickets resueltos)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
IF ([Estado del ticket - Sin ordenar] = "Solved" OR [Estado del ticket - Sin ordenar] = "Closed") "Solved" ELSE "Unsolved" ENDIF Este mensaje de error aparece en los atributos calculados, no en las métricas. La mejor manera de corregir este error es usando las mismas condiciones que las que se usaron en la métrica Tickets resueltos. La fórmula de esta métrica es como sigue: IF ([Estado del ticket - Sin ordenar] = "Solved" OR [Estado del ticket - Sin ordenar] = "Closed") THEN [ID del ticket] ENDIF La fórmula se puede actualizar como se muestra más arriba. |
| No se puede usar COUNT(Asignaciones de tickets a Desarrollo) en un atributo calculado. Encierre la métrica en la función ATTRIBUTE_FIX o ATTRIBUTE_ADD. | IF COUNT(Asignaciones de tickets a Desarrollo)>1 THEN "Solved" ELSE "Unsolved" ENDIF |
IF ATTRIBUTE_FIX(COUNT(Asignaciones de tickets a Desarrollo), [ID del ticket de actualización])>1 THEN "Multiple escalations" ELSE "One or no escalations" ENDIF Este mensaje de error aparece en los atributos calculados, no en las métricas. Si la fórmula original es más compleja y no se puede reutilizar, intente usar la función ATTRIBUTE_FIX para especificar en qué niveles debe agregarse este atributo. En este caso, debe calcularse en el nivel ID del ticket de actualización. |
| Tiempo en estado ya contiene agregadores. Reemplace AVG con SUM o asegúrese de que Tiempo en estado solo contiene agregadores VALUE. | AVG(Tiempo en estado) |
SUM(Tiempo en estado) Tiempo en estado es una métrica anidada. Su fórmula ya contiene un agregador. Por ejemplo, podría ser MED(Tiempo de primera respuesta (h)). No está permitido calcular un promedio sobre una media, de modo que el agregador de nivel superior debe establecerse en SUM o el agregador de nivel inferior tendrá que cambiarse a VALUE. |
Otros mensajes de error
| Ejemplo de mensaje de error | Fórmula incorrecta | Fórmula correcta |
|---|---|---|
| [Estados del ticket] no existe en este conjunto de datos. Verifique si hay un error tipográfico. | [Estados del ticket] ="Solved" |
[Estado del ticket] ="Solved" Las razones que suelen ocasionar este error son las siguientes:
En este ejemplo, el nombre del atributo tenía un error tipográfico. |
| [Grupo calculado] tiene una fórmula configurada incorrectamente. Corríjala antes de guardar. | IF [Grupo calculado] = "light" THEN TRUE ELSE FALSE ENDIF | Grupo calculado contiene una configuración incorrecta en su fórmula. Primero hay que corregir ese error. |
| El cálculo se refiere a sí mismo aquí: COUNT(Tickets de ventas). Elimínelo o sustitúyalo. | COUNT(Tickets de ventas)/COUNT(Tickets) | Se está agregando una fórmula dentro de sí misma. En este caso, la fórmula que se está editando es Tickets de ventas y el usuario está intentando agregar Tickets de ventas dentro de la fórmula. |
| Máximo de 3 niveles en un cálculo. Elimine el cálculo anidado aquí: SUM((Tiempo de 2da respuesta) | MED(Tiempo de 2da respuesta) / MED(Tiempo de primera respuesta (min) | La métrica calculada Tiempo de 2da respuesta se basa en otro cálculo que a su vez se basa en otro cálculo. A estos cálculos se les llama anidados. Solo se permite un máximo de 3 niveles anidados. |
| No se puede usar [Grupo del ticket] aquí. INCLUDES_ALL solo se puede usar en atributos de etiqueta. | INCLUDES_ALL([Grupo del ticket], "Support", "Sales") |
Las funciones INCLUDES se permiten solo con los atributos de etiqueta. Para los otros atributos, utilice la función IN. |