Ajout de données personnalisées à Insights

Important :

• 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.
• Le nombre de colonnes dans les tables de processus et de file d'attente est limité à 40.

Conception du workflow d'Insights

Important :

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.

Lors de la conception de vos workflows d'automatisation destinés à être utilisés et analysés dans Insights, vous devez prendre en compte certaines évolutions dans les bonnes pratiques utilisées actuellement.

Vous n'avez pas besoin de « marquer » les éléments individuels ou les points de données pour garantir leur disponibilité pour l'analyse dans Insights. Pour tous les processus ou les files d'attente contenant des champs personnalisés, une table personnalisée possédant ces champs est automatiquement générée.

Les activités suivantes peuvent être utilisées dans la conception de vos workflows d'automatisation afin de capturer les données souhaitées :

• 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.

Remarque :

Pour les workflows que vous souhaitez analyser dans Insights, il est recommandé de consigner toutes les données souhaitées à la fin de chaque workflow.

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.

Journaux (Logs)

Il existe 2 méthodes pour exploiter les journaux permettant d'envoyer des données à Insights :

• Message de journal : vous permet d'ajouter un message de chaîne personnalisé envoyé à Insights sous la forme d'un événement de journal en cas d'erreur dans votre workflow.
• Ajouter des champs de journal : vous permet d'ajouter des variables personnalisées aux tableaux de bord Insights par défaut.

Lorsque Insights détecte qu'un message de journal contient des champs de journal personnalisés ajoutés via l'activité Ajouter des champs de journal, une nouvelle table est créée dans Insights contenant ces champs personnalisés avec comme titre "Process-<your process name>”. Ces champs personnalisés sont extraits du message brut via un analyseur JSON personnalisé et ajoutés à la table au format RawMessage_CustomFieldName.

Les types de données suivants sont pris en charge pour les champs personnalisés : Integer, String, Boolean, Double et Float.

Remarque :

Les tables personnalisées ne sont pas jointes au schéma de données OOTB, c'est pourquoi les widgets inter-tables ne seront pas possibles tant que la relation n'est pas créée. Pour une personnalisation de ce type, veuillez contacter votre représentant UiPath.

Insights reçoit le dernier événement de journal uniquement pour les processus réussis. Si vous utilisez l'activité Supprimer les champs du journal, Insights ne pourra pas capturer les champs personnalisés car ceux-ci seront supprimés par le workflow avant la fin du processus.

Cela signifie également que les processus transactionnels exploitant les journaux pour capturer les données de chaque transaction n'enverront pas à Insights les données de chaque journal de transaction. Si vous utilisez un processus qui parcourt les transactions et que vous souhaitez stocker des données personnalisées pour chacune d'entre elle, vous devez suivre les bonnes pratiques UiPath et utiliser des files d'attente. Les files d'attente prennent en charge l'envoi de variables personnalisées à Insights pour chaque élément de file d'attente

Files d'attente (Queues)

Chaque élément de file d'attente comporte trois sections dans lesquelles vous pouvez stocker des variables personnalisées. Lors de la création d'un élément de file d'attente via l'activité Ajouter un élément de file d'attente, un champ appelé ItemInformation devient disponible. Vous pouvez ici stocker toutes les variables personnalisées souhaitées. Les types de données pris en charge pour toutes les données de file d'attente sont les mêmes que pour les journaux personnalisés : Integer, String, Boolean, Double et Float.

Pour ajouter des variables personnalisées à un élément de file d'attente une fois son traitement terminé, utilisez l'activité Définir le statut de la transaction. Celle-ci contient deux entrées dans lesquelles vous pouvez stocker des variables : Analytics et Output.

Si des champs personnalisés sont détectés par Insights dans la file d'attente, une table personnalisée est créée dans le modèle de données, appelée Queue-"your queue name”. Les champs seront identifiés via l'entrée dans laquelle ils ont été stockés :

• Les variables stockées dans Analytics seront nommées “AnalyticsData_<yourfieldname>”.
• Les variables stockées dans Output seront nommées “Output_<yourfieldname>”
• Les variables stockées dans ItemInformation seront nommées “SpecificData_<yourfieldname>”.

Remarque :

Les tables personnalisées de file d'attente ne sont pas jointes au schéma de données OOTB, c'est pourquoi les widgets inter-tables ne seront pas possibles tant que la relation n'est pas créée. Pour des personnalisations de ce type, veuillez contacter votre représentant UiPath.