Variables personnalisées

Insights ingère toujours les données via les champs prédéfinis disponibles dans le modèle de données Insights, mais les administrateurs peuvent également configurer des variables personnalisées extraites des journaux et des files d'attente du robot à utiliser pour calculer des ICP spécifiques ou créer des tableaux de bord plus spécialisés.

Astuce :

• Pour inclure des variables personnalisées pour les processus, vous devez d'abord vous assurer qu'elles sont ajoutées aux journaux de votre automatisation via l'activité UiPath.System.Activities.AddLogFields dans Studio, puis vous devez les sélectionner pour l'ingestion.
• Pour inclure des variables personnalisées pour les files d'attente, vous devez d'abord vous assurer qu'elles sont ajoutées aux workflows via une activité dans Studio, puis les sélectionner pour l'ingestion
  • Utilisez l'activité UiPath.System.Activities.AddQueueItem pour les données spécifiques (Specific Data) ;
  • Utilisez l'activité UiPath.System.Activities.SetTransactionStatus pour les données de sortie (Output Data) et les données analytiques (Analytics Data).
• La désactivation des variables personnalisées peut casser les tableaux de bord existants référençant les variables.

Utilisation de variables personnalisées dans les tableaux de bord au niveau de l'organisation

Lorsque vous utilisez des variables personnalisées dans des tableaux de bord à l'échelle de l'organisation, tenez compte des points suivants :

• Seules les variables personnalisées extraites de la fenêtre Configurer la variable personnalisée (Configure Custom Variable) de la vue Locataire s'afficheront dans la section de configuration des variables personnalisées au niveau de l'organisation. Aucune variable personnalisée non extraite du locataire ne s'affichera dans les tableaux de bord au niveau de l'organisation.
• Lors de la modification des variables personnalisées au niveau du locataire, les variables personnalisées au niveau de l'organisation seront désactivées dans l'organisation. Veillez à bien les réactiver une fois que toutes les modifications auront été effectuées, afin qu'elles s'affichent sur les tableaux de bord.
• Les sections variables personnalisées et ROI sont en lecture seule.

Configuration des variables personnalisées

Pour configurer des variables personnalisées, un administrateur doit suivre les étapes suivantes :

1. Ouvrez le menu à 3 points dans le coin supérieur droit de n'importe quelle page Insights et sélectionnez Configurer les variables personnalisées (Configure Custom Variables). La page de configuration s'ouvre, répertoriant tous les champs personnalisés disponibles pour l'extraction.

2. Décidez si vous souhaitez configurer des variables personnalisées pour les processus ou les files d'attente en cliquant sur l'onglet correspondant en haut de la page de configuration.

   
   

   

   
   
3. Dans la colonne Extraire (Extract), choisissez les variables personnalisées que vous souhaitez utiliser lors de la création de tableaux de bord.

4. Dans la colonne Type, sélectionnez le type de variable personnalisée. Vous pouvez choisir Chaîne (String), Nombre (Number) ou DateHeure (DateTime).

   Important :

   • Les champs sont limités à 40 caractères et tous les caractères après ce nombre seront coupés. Pour ajouter plus de 40 caractères, modifiez l'indicateur Insights.Etl.Json.MaxStringLen . Vous pouvez ajouter cet indicateur dans la configuration Web d'Orchestrator et définir la valeur en fonction des besoins de votre projet. Par exemple :

   <add key="Insights.Etl.Json.MaxStringLen" value="60" />

   • Le pourcentage de renvoi indique la progression de l'extraction d'une variable personnalisée à partir de tous les processus ou files d'attente. Vous devrez actualiser la page pour voir le dernier pourcentage de renvoi. Cela peut prendre un certain temps en fonction de la taille des données. Les valeurs des variables personnalisées renverront les données des plus récentes aux plus anciennes. Le champ sera utilisable peu de temps après l'enregistrement de la configuration, vous n'aurez pas besoin d'attendre le renvoi à 100 %.
   • Vous pouvez extraire des variables d’un maximum de 500 processus ou files d’attente et un maximum de 200 variables pour chaque processus ou file d’attente.
   • Si vous configurez le Type d'une variable personnalisée sur Nombre (Number), assurez-vous qu'elle ne contient pas de , ou d'autres caractères non numériques tels que $ car ces caractères ne sont pas pris en charge. Pour les nombres avec des caractères spéciaux, veuillez sélectionner le type Chaîne (String).
   • Chaque modification de la configuration des variables personnalisées entraînera un nouveau renvoi complet pour ce processus spécifique. L'heure du renvoi dépend du nombre de journaux stockés dans la base de données Insights pour ce processus spécifique.

5. Enregistrez la configuration. Toutes les variables extraites pour un processus spécifique doivent apparaître dans une exploration nommée *Processus - NomProcessus (Process - ProcessName), et toutes les variables extraites pour une file d'attente spécifique doivent apparaître dans une exploration nommée *File d'attente - NomFileAttente (Queue - QueueName).

   Important: Vous pouvez extraire des variables d’un maximum de 500 processus ou files d’attente et un maximum de 200 variables pour chaque processus ou file d’attente.

   Nombre de variables personnalisées configurées	Échelle matérielle	Nombre de processus	Nombre de journaux de Robot par processus	Durée approximative de l'extraction
   30	Grande échelle	1	1 000 000	5 minutes
   30	Grande échelle	1	40 000 000	120 minutes

Modification d'une configuration existante

Pour modifier une configuration existante, un administrateur doit suivre les étapes suivantes :

1. Ouvrez le menu à 3 points dans le coin supérieur droit de n'importe quelle page Insights et sélectionnez Configurer les variables personnalisées (Configure Custom Variables). La page de configuration s'ouvre, répertoriant tous les champs personnalisés disponibles pour l'extraction.
2. Décidez si vous souhaitez configurer des variables personnalisées pour les processus ou les files d'attente en cliquant sur l'onglet correspondant en haut de la page de configuration.
3. Pour supprimer des variables précédemment sélectionnées, décochez la case Extraire (Extract).
4. Pour modifier le type d'une variable, sélectionnez le nouveau type souhaité dans la liste déroulante.
5. Assurez-vous d'enregistrer la configuration.
6. Effectuez les vérifications suivantes sur les tableaux de bord existants qui utilisaient une variable modifiée ou supprimée :
   1. Si vous avez supprimé la variable, assurez-vous de supprimer toutes les références à la variable des formules qui ont été créées ou modifiées, des filtres, ou à l'intérieur des visualisations ;
   2. Si vous avez modifié le type de variable, assurez-vous que le nouveau type s'applique toujours correctement ;

Exemple de configuration

Cette section fournit un exemple d'utilisation d'une variable personnalisée dans un tableau de bord.

Suivez les étapes suivantes pour configurer les variables personnalisées :

1. Sélectionnez la variable ProcessCount pour l'extraction et choisissez le type String.

2. Activez la variable Argument1_Email, sélectionnez le type Chaîne (String) puis cliquez sur Enregistrer (Save).

   
   

   

   
   
3. Revenez à Tableaux de bord (Dashboards), créez un nouveau tableau de bord et ajoutez une nouvelle vignette.

4. Choisissez l'exploration *Processus - JournauxPersonnalisés2 (Process - CustomLogs2), puis choisissez la vue JournauxPersonnalisés2 (CustomLogs2) pour utiliser les variables personnalisées configurées à partir de ce processus dans votre vignette.

   
   

   

   
   

Variables personnalisées Null Cases

Les variables personnalisées peuvent avoir une valeur null dans certains cas particuliers, comme décrit dans les sections suivantes.

Scénario 1

Si vous utilisez un champ du modèle de données standard dans une visualisation associée à un champ de variable personnalisé spécifique au processus et qu'un processus ne contient pas la variable personnalisée dans les journaux du robot, la valeur de tous les champs associés au processus qui ne contient pas la variable personnalisée dans ses journaux de robot est null.

Il existe deux manières d'éliminer les valeurs null pour ce scénario :

• Option 1 : ajoutez la variable personnalisée en tant que filtre et définissez la condition sur is not null
  
  

  

  
  
• Option 2 : définissez un filtre pour le nom du processus qui inclut la variable personnalisée. Notez, cependant, que si vous adoptez cette approche, vous pouvez rencontrer le deuxième scénario ci-dessous.
  
  

  

  
  

Scénario 2

Si une variable personnalisée n'est pas présente dans tous les journaux générés par un processus, les journaux qui ne contiennent pas de valeur pour cette variable personnalisée afficheront la valeur de la variable comme étant une valeur null, comme illustré dans l'image ci-dessous.

L'exemple suivant illustre ce cas particulier.

1. Accédez à Configurer les variables personnalisées (Configure Custom Variables). Vous pouvez voir que le champ variable personnalisé Anniversaire2 (Birthday2) apparaît dans le processus JournauxPersonnalisés2 (CustomLogs2).

   
   

   

   
   
2. Ouvrez un tableau de bord nouveau ou existant et ajoutez une vignette.
3. Accédez à l'exploration JournauxPersonnalisés2 (CustomLogs2). Sélectionnez le champ Nom du processus (Process Name) et le champ de variable personnalisée. Dans ce cas, le champ de variable personnalisé est JournauxPersonnalisés2.Anniversaire2 (CustomLogs2.Birthday2).

4. Cliquez sur Exécuter (Run). Les résultats que vous voyez devraient être similaires à ceux illustrés dans la capture d'écran suivante.

   
   

   

   
   

Pour éliminer les valeurs null, ajoutez le champ de variable personnalisé en tant que filtre. Enfin, définissez la condition sur is not null, afin de pouvoir supprimer les valeurs de type null de la visualisation.

Remarque : Ces deux cas se produisent lorsque vous affichez les données brutes du champ personnalisé. Lorsque vous appliquez une fonction (Somme, Moyenne, etc.) aux variables personnalisées, vous excluez les valeurs null.

Dépannage et limitations

Consultez notre section Dépannage (Troubleshooting) pour plus d'informations sur le dépannage et les limitations.