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.
Deshabilitar las variables personalizadas puede interrumpir los paneles existentes que hacen referencia a las variables.
You only have to designate a Transaction Item as either Successful or Failed, and you don't need to fill in the OutputData or AnalyticsData properties.

Uso de variables personalizadas en paneles de ámbito de organización

Cuando utilices variables personalizadas en paneles de la organización, ten en cuenta lo siguiente:

Solo las variables personalizadas extraídas de la ventana Configurar variable personalizada mientras se está en la vista Tenant se muestran en la sección de configuración de variables personalizadas del ámbito de la organización. Las variables personalizadas que no se extraen del tenant no se muestran en los paneles del ámbito de la organización.
Al cambiar las variables personalizadas del tenant, las variables personalizadas del ámbito de la organización se deshabilitan. Asegúrate de volver a habilitarlos cuando se hayan realizado todos los cambios para ue se muestren en los paneles.
Las secciones ROI y variables personalizadas son de solo lectura.

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 eliminar el estado Común de una variable, desmarca la casilla correspondiente.
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;
3. Si la variable deja de tener el estado Común, debes reemplazar la referencia a la variable común por el valor por proceso actualizado.

Ejemplo de configuración

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

En la siguientes imagen, la variable ProcessCount está presente en múltiples procesos, mientras que la variable Argument1_Email solo ocurre en un proceso.

Sigue estos pasos para configurar variables personalizadas:

Selecciona la variables ProcessCount para su extracción y elige el tipo Cadena. Marca la variable como Común para llevar su valor a todos los procesos en los que aparece.
Habilita la variable Argument1_Email y selecciona el tipo Cadena. Puesto que esta variable no ocurre en múltiples procesos, no debes seleccionar la opción Común. Haz clic en Guardar.
Vuelve a Paneles, crea un panel nuevo y añade un mosaico nuevo.
Elige la exploración Registros de robot para ver las variables personalizadas ya configuradas.

Como seleccionaste Común para ProcessCount, puedes ver que no hay prefijo de nombre de proceso porque este se añadió al modelo de datos estándar. A diferencia de ProcessCount, no elegiste Común para Argument1_Email, por lo que el campo personalizado se añadió como Log_Email.Argument1_Email.

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.

El siguiente ejemplo ilustra este caso concreto.

Vete a Configurar variables personalizadas. Puedes ver que el campo de variable personalizada Argument1_Email solo se encuentra en el proceso Log_Email. Teniendo en cuenta que Argument1_Email es un campo de variable personalizada específica de un proceso, deja sin seleccionar la opción Común.
Abre un panel nuevo o existente y añade un mosaico.
Accede a la exploración Registros de robot. Selecciona el Nombre del proceso y el campo de la variable personalizada. En este caso, el campo de la variable personalizada es Log_Email.Argument1_Email.
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.