Variables personalizadas

Insights siempre incorpora datos a través de los campos predefinidos disponibles en el modelo de datos de Insights, pero los administradores también pueden configurar variables personalizadas extraídas de los registros y las colas de los robots para usarlas para calcular KPI específicos o crear paneles más especializados.

Consejo:

Para incluir variables personalizadas para procesos, primero debes asegurarte de que se añadan a los registros de tu automatización a través de la actividad UiPath.System.Activities.AddLogFields en Studio, y después debes seleccionarlas para su incorporación.
Para incluir variables personalizadas para colas, primero debes comprobar que se añadan a los flujos de trabajo a través de una actividad en Studio, y después debes seleccionarlas para su incorporación.
- Utiliza la actividad UiPath.System.Activities.AddQueueItem para datos específicos;
- Utiliza la actividad UiPath.System.Activities.SetTransactionStatus para datos de salida y datos de análisis.

Configurar variables personalizadas

Para configurar variables personalizadas, un administrador debe seguir estos pasos:

Abre el menú de tres puntos situado en la esquina superior derecha de cualquier página de Insights y selecciona la opción Configurar variables personalizadas. Se abre la página de configuración, en la que figuran todos los campos personalizados que están disponibles para la extracción.
Decide si quieres configurar variables personalizadas para procesos o colas haciendo clic en la pestaña correspondiente en la parte superior de la página de configuración.
En la columna Extraer, elige las variables personalizadas que quieres usar para crear los paneles.
En la columna Tipo, selecciona el tipo de variable personalizada. Puedes elegir String, Número o FechaHora.
Importante:
- Los campos están limitados a 40 caracteres y se eliminará cualquier carácter después de este número. Para agregar más de 40 caracteres, cambie la Insights.Etl.Json.MaxStringLen . Puedes añadir este marcador en la configuración web de Orchestrator y establecer el valor según las necesidades de tu proyecto. Por ejemplo:
<add key="Insights.Etl.Json.MaxStringLen" value="60" />
- El porcentaje de relleno muestra el progreso de extracción de una variable personalizada de todos los procesos o colas. Tendrás que actualizar la página para ver el porcentaje de relleno más reciente. Esto puede tardar algún tiempo en función del tamaño de los datos. Los valores de variables personalizadas se rellenarán de datos más recientes a más antiguos. El campo estará disponible para su uso poco después de que se guarde la configuración; no tendrás que esperar hasta que esté relleno al 100 %.
- Puedes extraer variables de un máximo de 500 procesos o colas, y un máximo de 200 variables por proceso o cola.
- Si configuras el tipo de una variable personalizada como Número, asegúrate de que no contenga , u otros caracteres no numéricos como $, ya que estos caracteres no son admitidos. Para números con caracteres especiales, selecciona el tipo String.
- Cada cambio en la configuración de variables personalizadas hará que se produzca un nuevo relleno completo para ese proceso específico. El tiempo del relleno depende del número de registros almacenados en la base de datos de Insights para ese proceso específico.

Guarda la configuración. Todas las variables extraídas para un proceso específico deberían aparecer en una exploración llamada *Proceso - NombreProceso, y todas las variables extraídas para una cola específica deberían aparecer en una exploración llamada *Cola - NombreCola.

Importante: Puedes extraer variables de un máximo de 500 procesos o colas, y un máximo de 200 variables por proceso o cola.

Número de variables personalizadas configuradas	Escala de hardware	Número de procesos	Número de registros de UiPath Robot por proceso	Tiempo aproximado para la extracción
30	Gran escala	1	1 000 000	5 minutos
30	Gran escala	1	40 000 000	120 minutos

Editar una configuración existente

Para editar una configuración existente, un administrador debe seguir estos pasos:

Abre el menú de tres puntos situado en la esquina superior derecha de cualquier página de Insights y selecciona la opción Configurar variables personalizadas. Se abre la página de configuración, en la que figuran todos los campos personalizados que están disponibles para la extracción.
Decide si quieres configurar variables personalizadas para procesos o colas haciendo clic en la pestaña correspondiente en la parte superior de la página de configuración.
Para eliminar variables que fueron seleccionadas anteriormente, desmarca la casilla Extraer.
Para cambiar el tipo de una variable, selecciona el nuevo tipo deseado de la lista desplegable.
Guarda la configuración.
Realiza las siguientes comprobaciones en los paneles existentes que utilizaron una variable modificada o eliminada:
1. Si eliminaste la variable, elimina todas las referencias a la variable de las fórmulas que se crearon o modificaron, de los filtros y de las visualizaciones internas;
2. Si modificaste el tipo de variable, comprueba que el nuevo tipo se aplique correctamente;

Ejemplo de configuración

Esta sección proporciona un ejemplo de uso de una variable personalizada en un panel.

Sigue estos pasos para configurar variables personalizadas:

Selecciona la variables ProcessCount para su extracción y elige el tipo Cadena.
Habilita la variable Argument1_Email, selecciona el tipo String y haz clic en Guardar.
Vuelve a Paneles, crea un panel nuevo y añade un mosaico nuevo.
Elige la exploración *Proceso - RegistrosPersonalizados2 y luego elige la vista RegistrosPersonalizados2 para usar las variables personalizadas configuradas de este proceso en tu mosaico.

Casos nulos de variables personalizadas

Las variables personalizadas pueden tener un valor nulo en algunos casos concretos, como se describe en las siguientes secciones.

Escenario 1

Si utilizas un campo del modelo de datos estándar en una visualización emparejada con un campo de variable personalizada de proceso y un proceso no contiene la variable personalizada en los registros de robot, el valor de todos los campos asociados al proceso que no contiene la variable personalizada en sus registros de robot es nulo.

Existen dos formas de eliminar los valores nulos para este escenario:

Opción 1: añadir la variable personalizada a modo de filtro, y establecer la condición en no es nulo
Opción 2: establecer un filtro para el nombre del proceso que no incluye la variable personalizada. Ten en cuenta que si adoptas este enfoque, puedes ejecutar en el segundo escenario.

Escenario 2

Si una variable personalizada no está presente en todos los registros generados por un proceso, los registros que no contienen un valor para esa variable personalizada mostrarán el valor de la variable como nulo, como se ve en la captura de la imagen a continuación.

El siguiente ejemplo ilustra este caso concreto.

Vete a Configurar variables personalizadas. Puedes ver que el campo de la variable personalizada Cumpleaños2 tiene lugar en el proceso RegistrosPersonalizados2.
Abre un panel nuevo o existente y añade un mosaico.
Ve a la exploración RegistrosPersonalizados2. Selecciona el campo Nombre del proceso de la vista Trabajos y el campo de la variable personalizada. En este caso, el campo de la variable personalizada es RegistrosPersonalizados2.Cumpleaños2.
Haz clic en Ejecutar. Los resultados obtenidos deben ser similares a los que se muestran en la siguiente captura de pantalla.

Para eliminar los valores nulos, añade el campo de la variable personalizada a modo de filtro. Por último, establece la condición en no es nulo, para poder eliminar los valores nulos de la visualización.

Nota: Ambos casos se producen cuando visualizas los datos brutos del campo personalizado. Cuando aplicas una función (Suma, Promedio, etc.) a las variables personalizadas, excluyes los valores nulos.