Configuration de l'application CX Component

Le CX Component peut être utilisé tel quel ou personnalisé en fonction des besoins de votre entreprise. Cette section explique comment configurer le composant CX à l'aide de l' exemple d'application pour illustrer certains des paramètres.

Prérequis

• Le composant CX nécessite la configuration d'un robot sans serveur ou Unattended dans le dossier déployé.
• Nous recommandons d’utiliser CX Component en mode d’événements externes. Notez, cependant, que pour une facilité d’utilisation, le mode des paramètres de requête est activé par défaut. Voir la section Configurer le mode d'entrée de données ci-dessous pour plus de détails. Lors de l'utilisation d'événements externes :
  • Pour l'intégration à Salesforce, installez et configurez le plug-in CX Componion SF dans Salesforce.
  • Pour s'intégrer à une plate-forme hôte différente, installez et configurez le pilote de communication UiPath dans l'application hôte.
• Pour exécuter des actions en mode Attended, le composant CX nécessite l'Assistant UiPath version 2025.0.167 ou ultérieure.
• Si vous souhaitez lancer d’autres applications à partir du composant CX, vous devez utiliser le connecteur Apps dans Integration Service. Assurez-vous que les politiques de gouvernance de votre organisation sont configurées de façon à autoriser l'utilisation de ce connecteur :
  • Étant donné que ce connecteur est actuellement disponible en aperçu, l’option Activer l’aperçu des packages et des activités doit être sélectionnée dans la politique de gouvernance de Studio Web déployée dans votre organisation. Cela rend l'activité Répertorier les applications déployées disponible dans les workflows. Pour plus d'informations, consultez les Paramètres des politiques Studio Web dans le guide Automation Ops.
  • Assurez-vous que le connecteur Apps est activé dans votre politique Integration Service. Pour plus d'informations, consultez les Paramètres des politiques Integration Service dans le guide Automation Ops.

Configurer le mode de saisie des données

L'application peut utiliser l'un des modes d'entrée de données suivants :

• Paramètres de requête : utilisez cette option si le CX Component doit être déployé de manière autonome. Pour vous permettre de tester rapidement l'application CX Component, cette option est activée par défaut dans le modèle. Le workflow de lancement pour l'utilisation des paramètres de requête est MainPage_Load_Initiate_Request_QueryParam.xaml.
• Événements externes : utilisez cette option si vous souhaitez intégrer CX Component dans une application hôte telle que Salesforce. Le workflow de lancement pour l'utilisation d'événements externes est MainPage_Initiate_Request.xaml. Il s'agit de l'option recommandée, mais elle n'est pas activée par défaut dans le modèle. Pour utiliser cette option :

  • Dans le concepteur d’application CX Compatibilité : dans le panneau Propriétés de l’application, assurez-vous que les Événements externes sont activés et ajoutez le domaine de votre application hôte dans la zone de texte Sources autorisées . Pour plus d'informations sur l'activation des événements externes, consultez Définir un contexte externe à l'aide d'événements externes.

    

  • Dans le concepteur d'application CX Companion - Désactivez le mode des paramètres de recherche en ouvrant le gestionnaire de données dans le fichier de workflow

    MainPage_Load_Initiate_Request_QueryParam.xaml et en définissant la variable ConfigEnableQueryParamMode sur False. La valeur par défaut est True.
  • Dans l'application hôte - Pour Salesforce, installez et configurez le plug-in CX Componaison SF. Pour toutes les autres applications hôtes, installez et configurez le pilote de communication UiPath.

Configurer un processus 360 (facultatif)

Un processus simulé 360 est inclus dans la solution et invoqué par l'application pour récupérer les données client à partir de l'application hôte. Vous pouvez personnaliser ce processus selon vos besoins ou créer un autre processus, le publier dans Orchestrator et configurer le composant CX pour l'utiliser en le sélectionnant depuis l' activité Invoquer le processus : Démarrer le processus 360 dans le workflow de lancement et en configurant les arguments requis selon vos besoins.

Configurer le dossier pour les actions

Les actions font référence aux automatisations, applications et agents publiés dans Orchestrator que les utilisateurs peuvent exécuter. Le composant CX est configuré de manière à avoir différents dossiers pour les actions en fonction du type d'objet d'entrée. Par exemple, dans l' exemple d'application, deux types sont définis : Incident et Compte. Tant que la structure des dossiers dans Orchestrator correspond à la configuration dans l'application, lorsqu'un enregistrement d'un certain type est chargé dans l'application, le panneau Actions est renseigné avec les actions dans le dossier défini pour ce type.

1. Ouvrez le Gestionnaire de données dans le workflow de lancement pour le mode d'entrée des données.
2. Saisissez le chemin du dossier racine des automatisations dans le champ de valeur de la variable ConfigAutomationsRootFolderPath . Par exemple, CXCompanionAutomations/AllActions dans l'exemple d'application.
3. Configurez les types d'automatisation dans la variable ConfigAutomationFoldersByType . Dans cette variable de dictionnaire, chaque clé est un type d'objet et sa valeur est le nom du sous-dossier Orchestrator qui contient les automatisations de ce type d'objet.

   Dans l'exemple d'application, la variable est configurée comme suit :

   Clé (Key)	Valeur (Value)
   Cas	Automatisations de cas
   Compte (Account)	Automatisations de compte

   Cela correspond à la structure de dossiers suivante dans Orchestrator.

   

   Dans le panneau Actions de l'application, les actions du type d'objet sont affichées, avec un onglet représentant chaque sous-dossier trouvé dans le dossier pour ce type d'objet.

   
4. Configurez si vous souhaitez inclure ou non les applications déployées dans les actions disponibles :
   • Si vous utilisez le mode paramètres de requête et que vous souhaitez également lancer des applications déployées, configurez l'activité Répertorier les applications déployées dans MainPage_Load_Initiate_Request_QueryParam.xaml et MainPage_Initiate_Request.xaml en ajoutant une connexion UiPath Apps.
   • Si vous utilisez le mode d'événements externes et que vous souhaitez également déployer des applications, configurez l'activité Répertorier les applications déployées dans MainPage_Initiate_Request.xaml en ajoutant une connexion UiPath Apps, et supprimez ou désactivez l'activité Si : charger la liste des applications si activée dans MainPage_Load_Initiate_Request_QueryParam.xaml.
   • Si vous n'avez pas l'intention de déployer des applications à partir du composant CX, supprimez ou désactivez l'activité Si : charger la liste des applications si elle est activée dans les deux workflows de lancement.

5. Une fois la solution déployée :

   1. Accédez au dossier dans lequel l'application est déployée et modifiez-la.
   2. Sur la page Exigences du package , sélectionnez la configuration de la connexion.
   3. Si vous souhaitez que la même connexion soit utilisée par tous les utilisateurs, sélectionnez cette connexion. Si vous souhaitez autoriser les utilisateurs de l'application à créer leur propre connexion, sélectionnez Configurable par les utilisateurs afin d'inviter les utilisateurs à créer une connexion la toute première fois qu'ils chargent l'application.

Remarque : vous pouvez tester l'application à l'aide d'exemples d'automatisation simulées.

Exécution en mode Attended ou Unattended

Le composant CX nécessite la configuration d'un robot sans serveur ou Unattended dans le dossier déployé.

Pour exécuter des actions en mode Unattended ou sans serveur, après avoir déployé l'application, vous pouvez utiliser l'URL dans votre environnement hôte sans configuration supplémentaire requise.

Si vous devez exécuter certaines actions en mode Attended, vous devez exécuter l'application en mode Attended en ajoutant un paramètre de requête à l'URL de l'application :

• Lorsque vous utilisez le complément CX dans Salesforce, ajoutez attendedMode=enabledWithRobotJSHandler.
• Lorsque vous utilisez le composant CX dans un autre système tiers, ajoutez attendedMode=enabled.

Assurez-vous qu'Assistant est en cours d'exécution et qu'il est connecté au même locataire que l'application est déployée. Le complément CX nécessite la version 2025.0.167 ou une version ultérieure d’Assistant.

Par défaut, toutes les actions s'exécuteront uniquement en mode Unattended, même si l'application s'exécute en mode Attended. Pour exécuter des actions en mode Attended, marquez l'action comme Attended ou ajoutez l'étiquette Attended au processus déployé dans Orchestrator.

Configurez l'application pour utiliser un seul type d'objet

Si vous ne souhaitez pas que des actions soient affichées en fonction de différents types d'objets (par exemple l'incident et le compte), vous pouvez le configurer de façon à utiliser un seul type d'objet :

1. Supprimer la valeur par défaut de la variable ConfigInputDataObjectTypeKeyName dans le workflow de lancement.
2. Supprimez Type de la variable ConfigRequiredInputProperties dans le workflow de lancement.
3. Paire clé-valeur Type distante à partir de la variable ConfigQueryParameterNameMap dans le workflow de lancement.
4. Définissez le nom du dossier racine dans la variable ConfigAutomationsRootFolder dans le workflow de lancement.
5. Si le dossier racine se trouve en haut, vous pouvez supprimer la valeur dans le ConfigAutomationsRootFolderPath. S’il s’agit d’un niveau imbriqué, définissez le chemin du dossier racine dans cette variable.
6. Personnalisez le panneau 360 selon vos besoins. Pour plus de détails, consultez Données affichées dans le panneau 360 dans la section Personnalisations supplémentaires ci-dessous. Les blocs d'incident Basculer peuvent être supprimés et vous pouvez conserver l'ensemble des activités Attribuer une valeur. Par ailleurs, le cas échéant, mettez à jour la propriété masquée du conteneur du panneau 360 afin qu'elle soit basée uniquement sur show360Spinner et non sur le type.

Entrées des actions

Le formulaire d'entrée est créé dynamiquement en fonction d'arguments d'entrée. Le formulaire ne prend actuellement en charge que les types primitifs suivants : Texte, Nombre, Booléen, DateOnly. Si un autre argument de type est passé, une zone de texte sera affichée. Pour les entrées basées sur la date, au lieu d'utiliser DateHeure, utilisez DateOnly pour obtenir une commande de sélecteur de date.

Sorties des actions

Tous les arguments de sortie d'action sont affichés dans Automation Tracker avec le nom de l'argument comme titre. Les valeurs des arguments de sortie peuvent être du texte brut ou HTML. Toutes les autres données de type complexe reçues sont affichées au format chaîne.

Automation Tracker prend en charge la copie dans le presse-papiers. L'une des trois options suivantes peut être ajoutée à un élément et l'élément obtiendra une icône de copie :

• data-copyable="true" : copie le contenu textuel de l'élément.
• class="copyable" : copie le contenu textuel de l'élément.
• data-copy-text="custom text" : copie le texte personnalisé spécifié.

Intégration de l'application

Vous pouvez copier l'URL de l'application à partir d'une boîte de dialogue affichée à la fin du processus de déploiement. Sinon, après avoir déployé l'application, accédez à Orchestrator > Automatisations > [nom_dossier] > Apps, puis cliquez sur Plus d'options à côté de l'application et sélectionnez Copier l'URL.

Pour plus d’informations, consultez Publier, déployer et mettre à niveau des projets d’applications et Gérer les applications.

Lors de l'intégration de l'application dans les iframes de l'application hôte, incluez embed_ dans l'URL pour permettre la connexion via une fenêtre contextuelle. Pour le mode d'événements externes, incluez le paramètre de requête target et définissez le nom de domaine comme valeur, par exemple &target=https://www.example.com Par exemple : https://cloud.uipath.com/embed_/appsdev/apps_/default/run/production/22986e36-8b04-4593-b82f-aae4c14bb2dc/bd8c8ef5-a94a-43f5-9a5b-6df73d8f7aa6/IDc0b72c47295b49abaea6b701cfa5b730?el=VB&uts=true&target=https://www.example.com

Personnalisations supplémentaires

La plupart des personnalisations peuvent être effectuées en modifiant les variables dans les fichiers de workflow de l'application. Les variables dont le nom commence par Config peuvent être modifiées pour personnaliser l'application. Dans certains scénarios, les activités doivent également être mises à jour.

• Nom de clé unique : en mode événements externes, l'objet de demande d'entrée peut avoir plusieurs propriétés, tandis qu'en mode paramètres de requête, plusieurs paramètres de requête peuvent être envoyés en tant qu'entrées. La propriété qui contient l'identifiant unique doit être configurée dans la variable ConfigInputDataObjectUniqueKeyName dans le workflow de lancement. Dans l'exemple d'application, Id est le nom de la propriété utilisé pour identifier de manière unique la requête actuelle. Cette valeur unique est également utilisée pour gérer les résultats d'exécution de l'action.
• Nom de clé de type d'entrée : pour permettre la configuration de différents dossiers racine en fonction du type de requête, l'application doit connaître le nom de la propriété qui contient le type d'objet. La propriété qui contient l'identifiant unique doit être configurée dans la variable ConfigInputDataObjectTypeKeyName dans le workflow de lancement. Dans l'exemple d'application, Type est le nom de la propriété. Si vous n'avez pas différents types d'objets, supprimez la valeur de cette variable.
• Propriétés requises au démarrage : si des entrées obligatoires sont requises pour démarrer le processus 360, spécifiez ces propriétés dans la variable ConfigRequiredInputProperties du workflow de lancement. Si les propriétés requises définies n'ont pas de valeurs, un message d'erreur sera généré lors de l'exécution et les activités ultérieures ne seront pas exécutées. Lors de la configuration de cette variable, tenez compte des éléments suivants :
  • Il est obligatoire d'ajouter le Nom de clé unique à la collection.
  • Si vous n'avez pas différents types d'objets, vous ne devez pas inclure le Nom de la clé de type Entrée dans la collection.
  • Ajoutez toutes les propriétés requises supplémentaires à la collection.
• Configurer les paramètres de requête: En mode paramètre de requête, les valeurs des paramètres de la variable ConfigQueryParameterNameMap dans MainPage_Load_Initiate_Request_QueryParam.xaml seront récupérées et définies sur l’objet d’entrée. Dans ce dictionnaire, les clés sont les noms de propriété de l'objet d'entrée et les valeurs sont les noms des paramètres de requête.
• Données affichées dans le panneau 360 : elles sont configurées en définissant directement la valeur de chaque élément. Dans l'exemple d'application, deux ensembles sont disponibles : un pour le type d'incident et un autre pour le type de compte . Lorsqu'un ensemble est affiché, l'autre est masquée en fonction du type. Les libellés sont statiques et peuvent être modifiés au besoin.
  • Définissez les valeurs de contrôle respectives dans l'activité Try Catch : Définir les données d'entrée dans le panneau 360 dans le workflow de lancement. Dans ce bloc, un Switch est utilisé pour configurer en fonction du type. Utilisez ce bloc pour définir des valeurs en fonction des données de l'objet d'entrée.
  • Pour définir les données du processus 360 à afficher dans le panneau 360, utilisez l'activité Essayer de capturer : définir les données 360 du processus dans le panneau 360 dans le lancement du workflow et configurer les valeurs comme nécessaire.
• Masquer le panneau 360 : pour masquer le panneau 360 de l'application, définissez la variable ConfigHide360Panel sur True dans le workflow de lancement. Même si le panneau est masqué, le processus 360 est toujours exécuté et les valeurs sont utilisées pour pré-remplir les arguments d'entrée du formulaire lorsqu'une action est exécutée.
• Mapper les propriétés d'entrée vers les arguments d'entrée des actions : les valeurs provenant d'un événement externe, d'un paramètre de requête et du processus 360 peuvent être utilisés pour préremplir le formulaire d'entrée indiqué avant d'exécuter une action. Par défaut, si les noms des arguments d'action correspondent à l'un des noms de propriété d'objet d'entrée ou à un nom de propriété de sortie 360, les valeurs sont préremplies. Vous pouvez configurer des valeurs supplémentaires à l'aide des variables suivantes dans le workflow ActionListPage_StartActionButton_click.xaml :
  • ConfigInputArgumentsInputObjectPropertyMap : dictionnaire où les clés sont des noms d'arguments d'entrée d'action et les valeurs sont des noms de propriété d'objet d'entrée. Les objets d'entrée sont créés à partir de paramètres de requête ou de messages d'événements externes.
  • ConfigInputArgumentsDat360ObjectPropertyMap : dictionnaire où les clés sont des noms d'arguments d'entrée d'action et les valeurs sont des noms d'arguments de sortie 360.
• Activer le filtrage des actions basé sur le contexte : par défaut, toutes les actions sont toujours répertoriées pour tous les types de requêtes. Grâce à cette option, vous pouvez afficher des actions liées en fonction du contexte de la requête actuelle. Pour l’activer :
  1. Dans le workflow MainPage_Action_Folder_Change.xaml , définissez la variable ConfigEnableContextFiltering sur True.
  2. Définissez la valeur ConfigContextFilteringPropertyName sur le nom de la propriété de l'objet de processus 360 qui doit correspondre aux libellés d'action.
  3. Ajoutez des balises aux actions déployées dans Orchestrator. Ajoutez l'étiquette Common aux actions que vous souhaitez toujours disponibles, quel que soit le type d'action.
  4. Pour les autres actions qui ne devraient être disponibles que pour des types de requête spécifiques, ajoutez des balises si nécessaire. Les actions s'afficheront lorsque la valeur de la balise correspond à la valeur de la propriété configurée à l'étape 2. Plusieurs balises peuvent être ajoutées à une seule action afin de répertorier l'action pour plusieurs types de requête.
  5. Si vous utilisez le mode de paramètre de requête, configurez également les variables mentionnées aux étapes 1 et 2 dans le workflow MainPage_Load_Initiate_Request_QueryParam.xaml .

Limitations et solutions de contournement

• Le contrôle de liste personnalisée utilisé pour afficher la liste des actions ne peut pas se développer en fonction de l'espace disponible. Configurez la hauteur de ce contrôle afin qu'il s'adapte à la taille d'écran la plus utilisée.

  
• Chaque ligne de la liste personnalisée a une hauteur fixe. Si le nom ou la description de l’action est long, il peut être tronqué. Utilisez un nom et une description plus courts pour un meilleur alignement.
• Le workflow des événements externes ne peut pas être testé à l'aide de l'option de débogage. Pour tester, vous devez déployer et intégrer l'application dans un environnement hôte.