Ajout de données personnalisées à Insights

Important :

• Pour les déploiements dépassant 75 processus et/ou les files d'attente avec des données personnalisées ajoutées par locataire, vous devez soit ajouter à la liste d'autorisation le processus et les tables de file d'attente souhaités, soit Activer le regroupement de tables.
• Une alerte configurable s'affiche pour vous avertir lorsque vous approchez de cette limite.
• Il peut également être nécessaire d'activer le regroupement de tables en fonction du nombre total de ces tables sur l'ensemble des locataires. Consultez la Configuration matérielle et logicielle requise pour plus de détails.
• Le nombre de colonnes dans les tables de processus et de file d'attente est limité à 40.

Conception du workflow d'Insights

Important:Des noms uniques insensibles à la casse doivent être utilisés pour toutes les variables personnalisées (en d'autres termes, n'utilisez pas successfulTransaction ni SuccessfulTransaction). Si vos variables ne sont pas uniques, vous devez définir Insights comme insensible à la casse.

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 :

• Ajouter des champs de journal (Add Log Fields) - tous les champs de journal ajoutés sont ingérés en tant que table personnalisée dans Insights. Voir [ici] (doc:adding-custom-data-to-insights#logs) pour plus de détails.
• Ajouter un élément de file d'attente (Add Queue Item) - toutes les données ajoutées via la propriété ItemInformation sont ingérées en tant que table personnalisée dans Insights. Voir ici pour plus de détails.
• Définir l'état de la transaction (Set Transaction Status) - toutes les données ajoutées via les propriétés Analytics et Output sont ingérées en tant que table personnalisée dans Insights. Voir ici pour plus de détails.

Pour plus de détails sur l'ensemble des données ingérées par Insights, consultez la page Modèle de données Insights.

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.

Là où vous utilisiez auparavant l'activité RemoveLogFields à la fin d'une séquence spécifique pour supprimer les journaux non nécessaires dans le reste du workflow, ici la suppression de tous les journaux personnalisés en tant que tels fera que le processus et les données ne seront pas ingérés dans la base de données Insights.

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.