Añadir datos personalizados a Insights

Importante:

• For deployments exceeding 75 processes and/or queues with custom data added per tenant, you must either add your desired process and queue tables to an allowlist or Enable Table Grouping.
• A configurable alert is displayed warning you when you are approaching this limit.
• Table grouping may also need to be enabled based upon the total number of such tables across all tenants. Review the Hardware and Software Requirements for additional details.
• El número de columnas en proceso y tablas de la cola está limitado a 40.

Diseño de flujos de trabajo para Insights

Importante:

Unique case-insensitive names must be used for all custom variables (i.e. do not use successfulTransaction and SuccessfulTransaction). If your variables are not unique, you must set Insights to be case insensitive.

Al diseñar tus flujos de trabajo de automatización destinados a consumo y análisis en Insights, debes tener en cuenta cambios en el enfoque de buenas prácticas utilizado hasta ahora.

No es necesario "etiquetar" elementos individuales y/o puntos de datos para garantizar su disponibilidad para el análisis en Insights. Para todos los procesos y/o colas con campos personalizados, se genera automáticamente una tabla personalizada con esos campos disponibles.

Las siguientes actividades pueden utilizarse para diseñar tus flujos de trabajo de automatización para capturar los datos deseados:

• Add Log Fields - all added log fields are ingested as a custom table in Insights. See [here] (doc:adding-custom-data-to-insights#logs) for more details.
• Add Queue Item - all data added via the ItemInformation property are ingested as a custom table in Insights. See here for more details.
• Set Transaction Status - all data added via the Analytics and Output properties are ingested as a custom table in Insights. See here for more details.

For complete details about all data ingested by Insights, see the Insights Data Model page.

Nota:

Para los flujos de trabajo que desees analizar en Insights, se recomienda registrar todos los datos deseados al final de cada flujo de trabajo.

Where previously you would use the RemoveLogFields activity at the end of any individual sequence to remove logs not needed in the rest of the workflow, removing all custom logs as such results in the process and data not being ingested into the Insights database.

Registros

Existen 2 métodos para aprovechar los registros para enviar datos a Insights:

• Mensaje de registro: te permite añadir un mensaje de cadena personalizado que se envía a Insights, en forma de evento de registro, en caso de que se produzca un error en tu flujo de trabajo.
• Añadir campos de registro: te permite añadir variables personalizadas a paneles de Insights predeterminados.

Cuando Insights detecta que un mensaje de registro tiene campos de registro personalizados añadidos por medio de la actividad Añadir campos de registro, se crea una tabla nueva en Insights que contiene esos campos personalizados con el título "Process-<your process name>”. Estos campos personalizados se extraen del mensaje básico por medio de un analizador JSON personalizado y se añaden a la tabla en el formato RawMessage_CustomFieldName.

Se admiten los siguientes tipos de datos para campos personalizados: Integer, String, Boolean, Double, y Float.

Nota:

Las tablas personalizadas no se vinculan al esquema de datos OOTB, por lo que los widgets de tablas cruzadas no serán posibles, a menos que se cree la relación. Para dicha personalización, ponte en contacto con tu representante de UiPath.

Insights solo recibe el último evento de registro para procesos correctos. Si utilizas la actividad Eliminar campos de registro, Insights no podrá capturar los campos personalizados, porque estos se eliminarán del flujo de trabajo antes de completar el proceso.

Esto también significa que los procesos transaccionales que utilizan los registros para capturar datos por transacción no enviarán los datos de cada registro de transacción a Insights. Si utilizas un proceso que se itera mediante transacciones y quieres almacenar datos personalizados para cada uno, debes seguir las mejores prácticas de UiPath y usar colas. Colas permite enviar variables personalizadas para cada elemento de cola a Insights.

Colas

Cada elemento de cola tiene tres secciones en las que puedes almacenar variables personalizadas. Al crear un elemento de cola por medio de la actividad Añadir elemento de cola, se habilita un campo llamado ItemInformation. En él puedes almacenar las variables personalizadas deseadas. Los tipos de datos admisibles para todos los datos de colas son los mismos que para los registros personalizados: Integer, String, Boolean, Double y Float.

Para añadir variables personalizadas a un elemento de cola una vez finalizado el proceso, utiliza la actividad Establecer el estado de la transacción. Esta actividad contiene dos entradas en las que puedes almacenar variables: Analytics y Output.

Si Insights detecta campos personalizados en una cola, se crea una tabla personalizada en el modelo de datos llamada Queue-"your queue name”. Los campos se identificarán por medio de la entrada en la que se almacenaron:

• Las variables almacenadas en Analytics se denominarán “AnalyticsData_<yourfieldname>”.
• Las variables almacenadas en Output se denominarán “Output_<yourfieldname>”
• Las variables almacenadas en ItemInformation se denominarán “SpecificData_<yourfieldname>”.

Nota:

Las tablas personalizadas de cola no se vinculan al esquema de datos OOTB, por lo que los widgets de tablas cruzadas no serán posibles, a menos que se cree la relación. Para dichas personalizaciones, ponte en contacto con tu representante de UiPath.