ScreenAgent pour Windows

Le terme ScreenAgentClosed NiCE ScreenAgent is a service that runs on agent desktops that require screen recording. est disponible si vous possédez les licences suivantes :

  • CXone ACD (voice) ou Third Party Telephony Providers

  • Enregistrement d'écran Basic ou Advanced

Installez ScreenAgent sur les ordinateurs pour enregistrer ou surveiller l’activité sur l’écran d’un agent pendant une interaction. ScreenAgent s’exécute en arrière-plan et enregistre automatiquement selon les politiques d’enregistrement (voir Recording Management (CXone)). Les Superviseurs et les évaluateurs peuvent également surveiller l’activité d’un agent pendant une interaction.

Vous pouvez installer ScreenAgent sur les ordinateurs des agents ou dans un environnement d’infrastructure de bureau virtuel (VDI).

Pour garantir que Recording Management (CXone) offre une expérience client fluide utilisant la technologie la plus récente, assurez-vous d'utiliser les versions prises en charge de ScreenAgent :

  • ScreenAgent pour les versions Windows 3.0.22 ou ultérieures

  • ScreenAgent pour les versions MAC 3.0.1 ou ultérieures

Si vous utilisez des versions plus anciennes de ScreenAgent, vous devez mettre à jour vos utilisateurs vers les versions ScreenAgent 3.0.x. Les versions antérieures ne sont pas prises en charge et risquent de ne pas enregistrer les écrans de vos agents.

Vous trouverez la dernière version de ScreenAgent sur la page Soutien et téléchargements.

Vous pouvez utiliser l'ScreenAgent Outil de vérification de la connectivité avant ou après l'installation.

Pour les locataires configurés avec un enregistrement d'écran à 100 %, l'enregistrement d'écran démarre jusqu'à 25 secondes après la connexion de l'Agent. L’enregistrement d’écran peut ne pas fonctionner correctement pendant ces 25 secondes.

Vous pouvez regarder une vidéo qui donne une vue d’ensemble de l'installation de base de ScreenAgent sur l'ordinateur d'un Agent. La vidéo comprend les prérequis et les étapes d'installation.

Pour plus d'informations, consultez FAQ pour ScreenAgent.

Pour obtenir la liste des fonctionnalités ajoutées aux versions ScreenAgent précédentes, consultez ScreenAgent : Notes de version cumulatives.

VDI pris en charge

Pour l'environnement d'infrastructure de bureau virtuel (VDI), les VDI pris en charge incluent :

  • VMware Horizon

  • Citrix Virtual Desktops (anciennement XenDesktop)

  • Citrix Virtual Apps (anciennement XenApp) - Pris en charge uniquement dans les environnements sur site

  • Environnements VDI non persistants

  • Environnements multisession

  • Environnements VDI de type terminal-serveur

  • Applications Distantes AVD (nécessite la solution de contournement pour les applications Distantes VDI)

VMware Horizon ne nécessite aucune configuration particulière. Pour les autres environnements VDI, voir Conditions préalables.

Considérations relatives à Zscaler

Bien que NiCE CXone ne soit pas conçu pour interagir avec des services de proxy d'inspection du trafic tels que Zscaler et Netscape, certains utilisateurs ont réussi à configurer l'enregistrement d'écran avec ces services.

Si votre organisation utilise Zscaler, vérifiez que les politiques Zscaler ne bloquent pas la communication des agents ou des superviseurs avec les serveurs NiCE CXone CoTurn (TURN), qui sont requis pour la connectivité de l'enregistrement et de la surveillance des écrans. Les Tests ont montré que certaines configurations ZPA (Zscaler Private Access) peuvent empêcher l'enregistrement ou la surveillance des agents distants, même lorsque l'enregistrement ou la surveillance fonctionne pour les utilisateurs sur site.

Si l'enregistrement ou la surveillance des écrans échoue pour les utilisateurs distant :

  • Assurez-vous que les dernières mises à jour de la politique Zscaler ont été appliquées aux appareils des agents et des superviseurs.

  • Vérifiez que les politiques de routage et d'accès ZPA autorisent la communication avec les serveurs CoTurn NiCE CXone.

  • Collectez et signalez les journaux dès que possible. Les journaux de dépannage NiCE CXone sont écrasés au fil du temps, ce qui peut limiter l'analyse de la cause racine si les problèmes sont signalés ultérieurement.

NiCE CXone Screen Recording nécessite que les appareils de l'Agent et du superviseur établissent tous deux une connectivité WebRTC. Il est possible qu'un superviseur parvienne à se connecter aux serveurs CoTurn alors qu'un Agent ne le peut pas. Validez toujours la connectivité depuis les points de terminaison de l'Agent et du superviseur lors du dépannage des problèmes de Recording ou de supervision.

Conditions préalables

Avant d’installer ScreenAgent, veillez à :

  1. Vérifiez les exigences de connectivité pour votre région avec l'assistant des exigences de connectivité.

  2. Si votre site utilise des VDI, assurez-vous que:

    • Vous utilisez ScreenAgent V3.x.x et versions ultérieures.

      • Pour le mode des applications virtuelles Citrix :

        Citrix ne prend pas en charge la configuration du bouclage IP virtuel sur les machines hébergées dans le cloud. Cette fonctionnalité est essentielle au fonctionnement de ScreenAgent en tant qu'application distante ; elle n'est donc prise en charge que lorsque Citrix fonctionne sur une machine sur site.

        Pour plus d'informations, consultez la documentation Citrix.

        • Activez une stratégie de bouclage IP virtuel. Ajoutez ScreenAgent.exe etChrome.exe à la liste des programmes de bouclage virtuel IP virtuel. Gardez à l'esprit que chaque programme doit être répertorié sur une ligne distincte.

        • Installez ScreenAgent sur le serveur Citrix Virtual Apps.

    • Dans un environnement VDI non persistant :

      • Utilisez ScreenAgent version 3.0.22 ou supérieure.

      • Installez ScreenAgent sur l’image de base du VDI.

      • Effectuez un instantané de l'image de base.

      • Distribuer à toutes les instances VDI.

    • Pour les environnements multi-sessions et VDI de type terminal-serveur :

      • Utilisez ScreenAgent version 3.0.22 ou supérieure.

      • Configurez ScreenAgent de manière qu’il fonctionne en mode Connexion au Système d’exploitation.

      • Les utilisateurs doivent se connecter à ScreenAgent en utilisant les informations d’authentification propres au Système d’exploitation.

      La valeur Connexion au SE pour chaque profil employé doit être unique par locataire. La valeur Connexion au SE ne peut pas être utilisée pour plusieurs profils employé au sein du même locataire, même si certains des profils employé en double sont inactifs. Si plusieurs profils employé ont la même valeur Connexion au SE, ScreenAgent ne s'exécutera pour aucun agent utilisant cette valeur Connexion au SE.

    Si vous travaillez dans un environnement VDI multisession ou non persistant et que vous rencontrez des problèmes, contactez le soutien NiCE pour vérifier que votre environnement précis est pris en charge.

    Le mode bureau virtuel VMware Horizon et Citrix ne nécessite aucune configuration particulière.

  3. Vérifiez la configuration informatique de l'agent.

  4. Assurez-vous que l'utilisateur qui installe ScreenAgent (par exemple, l'administrateur) dispose de privilèges Admin sur l'ordinateur de l'agent.

  5. Assurez-vous que l'utilisateur qui installe ScreenAgent (par exemple, l'administrateur) dispose de ces NiCE CXone autorisations :

    • Peut accéder aux téléchargements d'assistance: Activé, cela vous permet d'accéder à la page Supports - Téléchargements.

    • Clef d'accès:Créer, il s'agit de gérer les Clés d'accès de votre organisation.

  6. Générez une clé d’accès pour ScreenAgent.

    Vous pouvez utiliser la même clé d’accès pour installer ScreenAgent sur tous les ordinateurs des agents de votre locataire.

    La clé d'accès reçoit toutes les autorisations du NiCE CXone utilisateur qui le génère. Si cet utilisateur est un administrateur, toute personne disposant de la clé d'accès aurait des privilèges d'administrateur. Ainsi, pour des raisons de sécurité, commencez par créer un utilisateur et un rôle NiCE CXone pour ScreenAgent, puis générez la clé avec l'utilisateur ScreenAgent.

    1. Créez un rôle pour le service ScreenAgent :

      1. Cliquez sur le sélecteur d'application icon of app selector et sélectionnez Admin.
      2. Accédez à Sécurité > Rôles et Autorisations.

      3. Cliquez sur Nouveau rôle.

      4. Donnez un nom au rôle, par exemple ScreenAgent clé d'accès.

      5. Supprimez toutes les autorisations pour le rôle, à l’exception de Access Key et My Access Key.

      6. Enregistrer et activer le profil.

    2. Créez un employé pour le service ScreenAgent :

      1. Cliquez sur le sélecteur d'application icon of app selector et sélectionnez Admin.
      2. Cliquez sur Employés.

      3. Cliquez sur Nouvel employé.

      4. Donnez un nom à l'employé, par exemple ScreenAgent.

      5. Dans la liste déroulante Rôle principal, sélectionnez le Rôle ScreenAgent clé d’accès que vous venez de créer.

      6. Dans l'Onglet général, effacez tous les attributs.

      7. Créer l'employé ScreenAgent. Vous pouvez générer des clés d’accès uniquement après avoir créé le compte.

    3. Ouvrez à nouveau l'employé ScreenAgent et accédez à l'onglet Sécurité. Cliquez sur ajouter une clé d’accès pour générer une clé d’accès.

    4. Copiez à la fois l’Id DE LA clé d’accès et la Clé d’accès secrète, puis enregistrez-les dans un endroit sûr. Si vous ne copiez pas le Clé d'accès secrète ou si vous le perdez, vous devrez en créer un nouveau. Utilisez cet id DE LA clé d’accès et cette Clé d’accès secrète lors de l'installation de ScreenAgent sur les ordinateurs de tous les agents.

    5. Activez le compte employé ScreenAgent en cliquant sur le bouton Activer le compte dans l'e-mail d'activation.

  7. Téléchargez le MSI ScreenAgent :

    1. Allez à NiCE CXone et connectez-vous en tant qu'utilisateur avec l'autorisation Peut accéder aux téléchargements d'assistance.

    2. Cliquez sur votre Nom d’utilisateur et sélectionnez Soutien et téléchargements.

    3. Téléchargez le MSI requis. Notez où vous téléchargez le MSI, vous aurez besoin de l'emplacement du fichier plus tard.

  8. ScreenAgent prend en charge cinq méthodes d’authentification proxy pour l’enregistrement d’écran : Basic, Digest, Kerberos, NTLM et Negotiate. Lors de l'utilisation de la méthode d'authentification proxy :

    • Veillez à définir le proxy au niveau du système d’exploitation dans les paramètres du proxy.

    • Pour les méthodes d'authentification de base et Digest, vous devez définir les identifiants dans Windows Credential Manager.

    • Il n'y a aucun changement dans l'installation. Toutefois, si vous souhaitez utiliser un proxy pour ScreenAgent sans changer de proxy au niveau du système d’exploitation, vous pouvez utiliser le proxy direct dans l’installation de ScreenAgent.

    • Conservez à l'esprit, ces méthodes d'authentification sont uniquement destinées à l'enregistrement d'écran et non à l'observation d'écran.

Installer ScreenAgent pour Windows

Vous pouvez installer ScreenAgent à l'aide d'un outil de déploiement ou l'installer manuellement sur l'ordinateur de chaque agent.

Si vous utilisez un outil de déploiement, configurez l'installation selon l'une des options suivantes :

  • Exécuter avec les droits de l'utilisateur (mode utilisateur/contexte utilisateur)—Vous n'êtes pas obligé de redémarrer l'ordinateur de l'agent.

  • Exécuter avec des droits d'administration—Vous devez redémarrer les ordinateurs de tous les agents.

Vous pouvez préciser l'emplacement d'installation :

  • Par défaut, ScreenAgent est installé sur le lecteur C, dans le dossier \NICE-InContact\ScreenAgent. Vous pouvez spécifier un autre chemin d’installation dans la commande d’installation.

  • En cas de mise à niveau vers une version ultérieure, vous pouvez définir un chemin d’installation différent. La version précédente est supprimée et la nouvelle version est installée à l’emplacement spécifié.

  • Si vous réinstallez la même version de ScreenAgent, l’installation existante est remplacée au même emplacement. Pour modifier le chemin d’installation, désinstallez l’instance existante, puis spécifiez l’emplacement voulu lors de la réinstallation.

Certains paramètres ScreenAgent peuvent être modifiés après l’installation. Voir Modifier la configuration de base ScreenAgent. Pour mettre à jour d’autres paramètres d’installation, réinstallez le client ScreenAgent.

Pour mettre à niveau ScreenAgent vers une version ultérieure, installez le client ScreenAgent. Il est inutile de désinstaller la version précédente. Pour plus de détails sur ce qui reste sur le système après la désinstallation de ScreenAgent, consultez Poste-désinstallation : Informations.

Lorsque vous mettez à niveau ou réinstallez ScreenAgent, l'installation utilise automatiquement la configuration existante, sauf si vous précisez des paramètres différents. Voir Utilisez cette commande : . Lorsque vous désinstallez ScreenAgent, la configuration n'est pas sauvegardée et vous devez préciser les paramètres d'installation lorsque vous mettez à niveau ou réinstallez l'application.

Effectuez la mise à niveau ou la réinstallation de ScreenAgent lorsque les agents ne sont pas en cours d’enregistrement. Si un agent est en cours d’appel pendant l’installation, l’enregistrement d’écran arrête l’appel. À l’issue de l’installation, les appels seront enregistrés conformément aux politiques d’enregistrement et aux scripts Studio.

Pour installer ScreenAgent:

  1. Assurez-vous que toutes les conditions préalables sont en place.

  2. Ouvrez l'invite de commande en tant qu'Administrateur. Dans la ligne de commande, accédez à l'emplacement où vous avez téléchargé le MSI et entrez la commande d'installation avec les paramètres pertinents :

  3. Vérifiez le succès de l'installation à partir du fichier journal. Le fichier install.log se trouve dans le dossier à partir duquel vous avez installé le MSI, il s'agit généralement du dossier %UserProfile%\downloads.

    • Vérifiez que le programme d'installation dispose des privilèges d'administrateur.

    • Si l'ordinateur de l'agent ne dispose pas de Microsoft .NET Framework 4.0 ou version ultérieure, installez-le.

    Le fichier de config, configFile.ini (dans les versions antérieures) ou config.json (ScreenAgentversion 3.2.49 et ultérieures), est automatiquement masqué après l'installation. Pour afficher et ouvrir le fichier, activez éléments masqués dans l’explorateur de fichiers de Windows.

  4. Assurez-vous que l'agent dispose de l'attribut Peut être enregistré (écran) (dans NiCE CXone, accédez à Admin > Employés, puis cliquez sur l'agent). Cet attribut est nécessaire pour activer le recording d'écran, l'observation d'écran, ou les deux.

  5. Enregistrez un appel et vérifiez le fichier journal ScreenAgent. Le fichier ScreenAgent.log est situé dans : %appdata%\ScreenAgent\logs\ScreenAgent.log.

    Vos journaux ScreenAgent sont téléchargés lorsqu'un Agent se connecte, puis toutes les 2 heures et lorsqu'un Agent se déconnecte à la fin d'une équipe. Vos journaux ScreenAgent sont automatiquement téléchargés dans le cloud, où l'équipe de Soutien NiCE CXone peut y accéder, si nécessaire.

    S'il y a des erreurs, consultez Dépannage des enregistrements et FAQ.

Vous pouvez regarder une vidéo qui donne une vue d’ensemble de la manière d’améliorer les interactions des Agent grâce à l’observation d’écran en temps réel en utilisant les fonctions de base de ScreenAgent.

Installer Advanced ScreenAgent

Lors de l'installation de Advanced ScreenAgent :

  • Vous bénéficiez de mises à niveau automatiques et de mises à jour pour toutes les instances ScreenAgent.

  • Il n'est pas nécessaire d'utiliser une infrastructure tierce (FFmpeg) pour réduire le temps de résolution des problèmes.

  • Moins de ressources (Unité centrale, ram) sont nécessaires pour maximiser les ressources du VDI et de l'ordinateur de bureau physique.

  • Si vous utilisez Advanced ScreenAgent avec l'observation d'écran en temps réel, vous pouvez activer Screen Assist afin que les superviseurs puissent placer des notes contextuelles sur les écrans des agents pendant une session de surveillance.

Advanced ScreenAgent nécessite la licence Enregistrement d'écran Advanced.

Pour installer Advanced ScreenAgent :

  1. Assurez-vous que tous les Conditions préalables sont en place.

  2. Ouvrez l'invite de commande en tant qu'Administrateur. Dans la ligne de commande, accédez à l'emplacement où vous avez téléchargé le fichier MSI, puis entrez la commande d'installation avec les paramètres pertinents :

  3. Vérifiez le succès de l'installation à partir du fichier journal. Le fichier install.log se trouve dans le dossier à partir duquel vous avez installé le MSI ; il s'agit généralement du dossier %UserProfile%\downloads.

    • Vérifiez que le programme d'installation dispose des privilèges d'administrateur.

    • Si l'ordinateur de l'agent ne dispose pas de Microsoft .NET Framework 4.0 ou version ultérieure, installez-le.

    Le fichier Config, config.json , est automatiquement masqué après l'installation. Pour afficher et ouvrir le fichier, activez éléments masqués dans l’explorateur de fichiers de Windows.

  4. Assurez-vous que l'Agent dispose de l'attribut Peut être enregistré (écran) (dans NiCE CXone, accédez à Admin > Employés, puis cliquez sur l'Agent). Cet attribut est nécessaire pour activer l'enregistrement d'écran, l'observation d'écran, ou les deux.

  5. Enregistrez un appel et vérifiez le fichier journal ScreenAgent. Le fichier ScreenAgent.log se trouve ici : %appdata%\AdvancedScreenAgent\logs\AdvancedScreenAgent.log.

    Vos journaux ScreenAgent sont téléchargés lorsqu'un Agent se connecte, puis toutes les 2 heures et lorsqu'un Agent se déconnecte à la fin d'un quart de travail. Vos journaux ScreenAgent sont automatiquement téléchargés vers le cloud, où l'équipe Soutien NiCE CXone peut y accéder, si nécessaire.

    S'il y a des erreurs, consultez Dépannage des enregistrements et FAQ.

Configuration de la Clé de registre Google Chrome pour la liste de refus

Lors de l'utilisation des navigateurs Google Chrome sur la machine de l'agent, si la valeur UiAutomationProviderEnabled n'est pas présente dans la Clé de registre Google Chrome, les URL spécifiées dans la liste de refus peuvent ne pas être exclues de l'enregistrement. Voir Gérer une liste de refus d'enregistrement de l'écran.

Pour ajouter la valeur à la clé de registre :

  1. Assurez-vous que la machine de l'Agent utilise le navigateur Chrome 126 ou une version ultérieure.

  2. Assurez-vous que vous disposez de droits d'Administrateur de Windows.

  3. Vérifiez que le chemin d'accès au registre HKLM:\SOFTWARE\Policies\Google\Chrome existe.

  4. Exécutez la ligne de script Powershell suivante pour ajouter la valeur au registre Google Chrome :

    Set-ItemProperty -Path "HKLM:\SOFTWARE\Policies\Google\Chrome" -Name "UiAutomationProviderEnabled" -Value 1 -Type DWord

Contournement potentiel des applications Distantes VDI

Lorsque les agents utilisent les applications Distantes VDI et que le processus ScreenAgentWatchDog.exe ne démarre pas :

  1. Publiez ScreenAgent.exe sur RemoteApps. Veillez à ce que seuls les administrateurs (et non les agents) y aient accès.

  2. Créez et publiez un raccourci vers RemoteApps. Utilisez un script, comme l'un de ceux présentés ci-dessous, pour ouvrir le navigateur et exécuter ScreenAgentWatchDog.exe. Les agents doivent utiliser ce raccourci pour ouvrir le navigateur, sinon le ScreenAgent ne s'exécutera pas.

ScreenAgent pour les Environnements Engagement Hub (Multi-ACD/Open)

Engagement Hub (Multi-ACD/Open) est pris en charge par ScreenAgent dans des environnements virtuels ou physiques. Dans ces environnements, le paramètre RESOLVE_USER doit être configuré avec la valeur oslogin. Voir Installation command parameters pour obtenir des informations sur ce paramètre.

Modifier la configuration de base ScreenAgent

Après installation, vous pouvez modifier certaines configurations de ScreenAgent.

Le fichier de configuration, configFile.ini (dans les versions antérieures) ou config.json (ScreenAgent version 3.2.49 et ultérieures), est automatiquement masqué après l'installation. Pour afficher et ouvrir le fichier, activez éléments masqués dans l’explorateur de fichiers de Windows.

  1. Ouvrez le fichier configFile.ini ou config.json (ScreenAgent version 3.2.49 et supérieures) dans le dossier d'installation ScreenAgent, généralement sous C:\Program Files\NICE-InContact\ScreenAgent.

  2. Modifiez les valeurs des paramètres :

    • Modifiez la valeur framePerSecond à la section [recordingParameters]. Par défaut, cette valeur est de 5.

      Les valeurs autorisées sont 1, 2, 3, 4 ou5.

      La réduction du nombre d'images par seconde diminue la taille du fichier, l'utilisation de l'Unité centrale et de la ram.

      Images par seconde Réduction des images Impact sur la taille des fichiers/la bande passante, l'Unité centrale et la ram (estimé)

      5

      Par défaut (maximum)

      Aucun

      4

      20 % de moins

      ~15 % de réduction

      3.

      40% de moins

      ~30% de réduction

      2

      60% de moins

      ~45% de réduction

      1

      80 % de moins

      ~60% de réduction

    • Modifiez la valeur resolutionLevel à la section [recordingParameters]. Par défaut, cette valeur est null, la résolution d'écran actuelle.

      Les valeurs autorisées sont null, low, medium ou high (tout en minuscules).

      La réduction de la résolution réduit la taille du fichier, l'Unité centrale et la RAM.

      Niveau de résolution Réduction de la Résolution Incidence sur la taille de fichier/bande passante, l'Unité centrale et la ram (estimée)

      Null

      Par défaut (résolution native)

      Aucun

      Élevé

      Résolution d'écran / 1,5

      ~20% de réduction

      Moyen

      Résolution d'écran / 2

      ~40% de réduction

      Faible

      Résolution d'écran / 4

      ~60% de réduction (recommandé uniquement pour les écrans 4K et 5K)

      Pour rétablir la résolution de l'écran, modifiez la valeur de resolutionLevel à null.

    • Modifiez la valeur loadCertificates sous la section [autres]. Par défaut, cette valeur est true.

      Les valeurs acceptables sont true oufalse.

  3. Enregistrez le fichier configFile.ini ou config.json.

  4. Pour appliquer les modifications, relancez l’application ScreenAgent :

    1. Dans le Gestionnaire des tâches Windows, mettez fin à la tâche ScreenAgentWatchDog.exe en cours, puis mettez fin aux processus ScreenAgent.exe.

    2. À partir du dossier d'installation ScreenAgent, exécutez ScreenAgentWatchdog.exe.

Modifier la configuration de Advanced ScreenAgent

Après l'installation, vous pouvez modifier certaines configurations Advanced ScreenAgent.

Si vous utilisez Advanced ScreenAgent, il est recommandé de mettre à jour votre configuration à l'aide du ScreenAgent Manager.

  1. Ouvrez le fichier config.json dans le dossier d'installation Advancecd ScreenAgent, généralement situé sous C:\Program Files\NICE CXone\AdvancedScreenAgent.

  2. Modifiez les valeurs des paramètres :

    • Modifiez la valeur de la propriété FRAME_PER_SECOND . Par défaut, cette valeur est de 5.

      Les valeurs autorisées sont 1, 2, 3, 4 ou5.

      Réduire le nombre d'images par seconde diminue la taille du fichier, l'Unité centrale et la ram.

      Images par seconde Réduction des images Impact sur la taille des fichiers/bande passante, l'Unité centrale et la RAM (estimé)

      5

      Par défaut (maximum)

      Aucun

      4

      20 % de moins

      ~15 % de réduction

      3.

      40% de moins

      ~30% de réduction

      2

      60% de moins

      ~45% de réduction

      1

      80 % de moins

      ~60% de réduction

    • Modifiez ou ajoutez la valeur de la propriété RESOLUTION_LEVEL. Par défaut, cette valeur est null, la Résolution d'écran actuelle.

      Les valeurs autorisées sont null, low, medium ou high (tout en minuscules).

      La réduction de la résolution réduit la taille du fichier, l'Unité centrale et la RAM.

      Niveau de résolution Réduction de la Résolution Incidence sur la taille des fichiers/la bande passante, l'Unité centrale et la RAM (estimation)

      Null

      Par défaut (résolution d'écran actuelle)

      Aucun

      Élevé

      Résolution d'écran / 1,5

      ~20% de réduction

      Moyen

      Résolution d'écran / 2

      ~40% de réduction

      Faible

      Résolution d'écran / 4

      ~60% de réduction (recommandé uniquement pour les écrans 4K et 5K)

      Pour rétablir la résolution de l'écran, remplacez la valeur de RESOLUTION_LEVEL par null.

    • Modifiez la valeur loadCertificates sous la section [autres]. Par défaut, cette valeur est true.

      Les valeurs acceptables sont true oufalse.

  3. Enregistrez le fichier config.json.

  4. Pour appliquer les modifications, redémarrez l'application Advanced ScreenAgent :

    1. Dans le gestionnaire des tâches Windows, mettez fin à la tâche ScreenAgentWatchDog.exe en cours, puis mettez fin aux processus ScreenAgent.exe.

    2. À partir du dossier d'installation ScreenAgent, exécutez ScreenAgentWatchdog.exe.

Préserver votre configuration lors de l'installation de Advanced ScreenAgent

Lorsque vous installez une nouvelle version Advanced ScreenAgent ou que vous effectuez une mise à niveau de Basic vers Advanced ScreenAgent, le programme d'installation conserve votre configuration existante par défaut. Ce comportement est contrôlé par le paramètre KEEP_CURRENT_CONFIG dans Paramètres de la commande d'installation.

La valeur par défaut est true. Lorsque KEEP_CURRENT_CONFIG=true , le programme d'installation utilise votre configuration existante. Si KEEP_CURRENT_CONFIG=false, le programme d'installation ignore toute configuration existante, y compris toute donnée ScreenAgent de base. Il écrit une nouvelle configuration en utilisant uniquement les valeurs que vous fournissez dans INSTALL_PARAMS.

Pour préserver vos configurations existantes lors de la mise à niveau :

  1. Suivez les étapes indiquées dans Installer Advanced ScreenAgent

  2. Ajoutez le paramètre KEEP_CURRENT_CONFIG=true à la Commande Prompt.

  3. Terminez les étapes d'installation restantes.

Autorisations

ScreenAgent nécessite les autorisations suivantes pendant son exécution :

  • Accès aux fichiers

    • Accès en lecture/écriture à %appdata%\ScreenAgent\

    • Accès en lecture/exécution au dossier d'installation :
      Pour Basic ScreenAgent - C:\Program Files\NICE-InContact\ScreenAgent) (Ce chemin est configurable.)

      Pour Advanced ScreenAgent - C:\Program Files\NICE CXone\AdvancedScreenAgent (Ce chemin est configurable.)

  • Accès conditionnel (basé sur le paramètre RESOLVE_USER)

    • Si RESOLVE_USER=auto (par défaut) :

    • Si RESOLVE_USER=oslogin :

      • Lire les variables d'environnement (requis pour Connexion au SE)

  • Autorisations supplémentaires (en cas d'utilisation d'une liste de refus)

    • Récupérer des informations sur les autres processus en cours d'exécution visibles

    • Interagir avec les éléments de fenêtre d'autres processus (pour capturer des URL)

Les clés de registre ne sont consultées que lors de l'installation ou de la désinstallation. Aucun accès au registre n'est requis pendant le fonctionnement ordinaire.

ScreenAgent Outil de vérification de la connectivité

Utilisez l'outil ScreenAgent Connectivity Check pour exécuter une séquence de tests afin de vérifier l'accès au réseau et de vous assurer que ScreenAgent pour Windows et Advanced ScreenAgent pour Windows fonctionneront correctement.

  • Cet outil peut être utilisé avant ou après l'installation de ScreenAgent.

  • Vous pouvez télécharger la dernière version de l’outil de vérification de la connectivité sur la page de téléchargement.

  • Il est recommandé d’utiliser cet outil lorsque la configuration réseau d’un agent a changé ou qu’elle diffère de la configuration normale. Vous n'avez pas besoin d'exécuter l'outil pour chaque Agent.

  • Vous pouvez exécuter l’outil de vérification de la connectivité plusieurs fois en utilisant la même commande.

  • Après exécution de chaque test, une notification indique si les tests ont réussi ou échoué. À la fin de l'exécution, un résumé affiche l'état de chaque test.

  • Une fois les tests réalisés, l’outil de vérification de la connectivité crée un fichier journal.

  1. Téléchargez le fichier EXE de l'outil de vérification de la connectivité :

    1. Allez à NiCE CXone et connectez-vous en tant qu'utilisateur avec l'autorisation Peut accéder aux téléchargements d'assistance.

    2. Cliquez sur votre Nom d’utilisateur et sélectionnez Soutien et téléchargements.

    3. Téléchargez le fichier EXE requis. Notez l'endroit où vous téléchargez le fichier EXE, car vous aurez besoin de l'emplacement du fichier ultérieurement.

  2. Exécutez l'outil de vérification de la connectivité.

    1. Exécutez l’invite de commande en tant qu’Administrateur.

    2. Copiez et collez la commande dans l'invite de Commandes et modifiez les paramètres répertoriés dans le tableau.

      <Chemin d'accès au fichier exe> ACCESS_KEY_ID=<id DE LA clé d'accès> ACCESS_KEY_SECRET=<Clé d'accès secret> REGION_TYPE=<sous-domaine (les 3 premiers caractères) de l'URL NiCE CXone> WEB_PROXY=<en option : URL du serveur proxy>

    Exemple de commande :

    C:%UserProfile%\downloads ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 WEB_PROXY=https://proxyserver:8088
  3. L'outil de vérification de la connectivité commence à exécuter les tests. Après exécution de chaque test, une notification indique si les tests ont réussi ou échoué. Si un test échoue, la raison de l'échec s'affiche. À la fin de l'exécution, un résumé s'affiche indiquant si chaque test a réussi, échoué ou n'a pas eu besoin d'être exécuté (N/A). Par exemple, si ScreenAgent ne s'exécutait pas en arrière-plan au démarrage de l'outil de vérification de la connectivité, les tests permettant de fermer ScreenAgent et de le redémarrer n'ont pas besoin de s'exécuter.

    Une fois les tests terminés, l'outil de vérification de la connectivité crée un fichier journal (SA_Connectivity_tool_log_<runUniqueUUID>) dans le même dossier que le fichier d'installation de l'outil de vérification de la connectivité. Le fichier journal inclut toutes les informations qui étaient affichées à l’invite de commande.

Tests de connectivité

Configurer ScreenAgent dans un Environnement multi-Locataire

Dans un environnement multilocataire, chaque agent dispose de sa propre ACCESS_KEY et SECRET_KEY spécifiques au locataire pour lequel il travaille. Multiple locataires sont pris en charge pour les locataires résidant dans la même région.

Cette procédure utilise Microsoft Active Directory, et la configuration peut être différente pour d'autres solutions de service d'annuaire.

Pour configurer Active Directory pour plusieurs locataires :

  1. Créez un fichier JSON pour chaque locataire que vous gérez :

    • Chaque fichier doit inclure l'accessKey ID et l'AccessKey Secret du locataire.

      Par exemple, si vous gérez le Locataire A et le Locataire B, vous pouvez les nommer TenantA_connection.json et TenantB_connection.json (ou tout autre nom pertinent pour vos besoins spécifiques).

    • Les membres de chaque locataire doivent avoir accès au fichier pertinent. Par exemple, tous les utilisateurs du Locataire A mentionné précédemment doivent avoir accès au fichier TenantA_connection.json.

    Utilisez la structure suivante pour chaque fichier. Les valeurs des paramètres doivent être uniques pour chaque locataire.

    var(--codeSnippetCopyLabel)
    {
      "accessKeyId": "{{ACCESS_KEY}}",
      "accessKeySecret": "{{SECRET_KEY}}"
    }
  2. Placez ces fichiers à un endroit de votre réseau où tous les utilisateurs du locataire peuvent y accéder. Par exemple, créez un dossier sur un serveur de fichiers (comme \\fileserver\partagé\files\).

    Chaque locataire peut disposer de son propre dossier partagé.

  3. Créez un groupe de Sécurité pour les utilisateurs de chaque locataire dans Active Directory en suivant les étapes ci-dessous :

    1. Sur la machine du contrôleur de Domaine, ouvrez la console Utilisateurs et ordinateurs Active Directory.

    2. Clic droit sur l'Unité organisationnelle (UO) dans laquelle vous souhaitez créer les groupes (Users par défaut), puis sélectionnez New > Group.

    3. Préciser le nom du groupe. Par exemple, UsersGroup_TenantA.

    4. Sélectionnez les options Global scope et Security.

    5. Cliquez sur OK.

    6. Clic droit sur le groupe de sécurité nouvellement créé et sélectionnez Properties.

    7. Dans l'onglet Membres, ajoutez tous les utilisateurs correspondant à ce locataire.

    8. Cliquez sur OK pour achever les modifications.

    9. Répétez les étapes précédentes pour créer un groupe de Sécurité pour chaque locataire.

  4. Créez un Objet de politique de groupe (GPO) avec des politiques pour la distribution des Fichiers qui couvrira tous les locataires :

    1. Ouvrez le GPO Console.

    2. Clic droit sur le Domaine ou l'OU où se trouvent les utilisateurs et sélectionnez Create a GPO.

    3. Précisez un nom pour le GPO (par exemple, Tenant_Files_Distribution) et cliquez sur OK.

    4. Clic droit sur le GPO que vous venez de créer, puis sélectionnez Modifier pour ouvrir l'Éditeur de Gestion des politiques de groupe.

    5. Accédez à Configuration de l'utilisateur > Préférences > Paramètres Windows > Fichiers.

    6. Créez une nouvelle action File pour chaque locataire distinct en faisant un clic droit sur Fichiers, puis sélectionnez New > File.

    7. Configurez les paramètres File suivants :

      1. Sous Action, sélectionnez Mettre à jour.

      2. Sous Fichier(s) source, saisissez le chemin réseau du fichier JSON spécifique créé pour le locataire au début de cette procédure (par exemple, \\fileserver\shared\files\TenantA_connection.JSON).

      3. Sous Fichier de destination, entrez : %appdata%\ScreenAgent\TenantA_connection.json

    8. Sous l'onglet Commun, sélectionnez Item-level targeting et cliquez sur Targeting….

    9. Dans la fenêtre Éditeur de ciblage, cliquez sur New Item et sélectionnez Security Group.

    10. Dans le champ Group, précisez le groupe d'utilisateurs créé précédemment pour le Locataire approprié (par exemple, UsersGroup_TenantA).

    11. Cliquez sur OK pour finaliser la configuration.

    12. Répétez les étapes pour créer une action File pour chaque locataire distinct avec son propre fichier JSON.

  5. Pour appliquer et actualiser la politique de groupe, exécutez gpupdate/force sur le serveur ou attendez le prochain cycle d'actualisation de la politique de groupe.

  6. Chaque utilisateur doit procéder à la déconnexion de sa session actuelle, puis se reconnecter à son compte utilisateur sur sa machine pour garantir la prise en compte de toutes les modifications.

Paramètres de la commande d'installation

Paramètre

Description

Exemple

msiexec /i ScreenAgent-32bit-<MSI version>.msi

32 bits ou 64 bits

Si vous installez sur un ordinateur avec:

  • Windows 32 bits installé, entrez 32 bits

  • Windows 64 bits installé, entrez 64 bits

version MSI

Saisissez la version MSI du fichier d’installation que vous avez téléchargé à partir de la page Assistance et téléchargements. Par exemple, 3.0.22.

msiexec /i ScreenAgent-64bit-3.0.22.msi

 

msiexec /i ScreenAgent-32bit-3.0.22.msi

KEEP_CURRENT_CONFIG

(En option) Incluez ce paramètre lors d'une mise à niveau de ScreenAgent de base vers avancé, d'une réinstallation ou de l'installation d'une nouvelle version.

Lorsque KEEP_CURRENT_CONFIG=true (valeur par défaut), le programme d'installation utilise votre configuration existante.

Lorsque KEEP_CURRENT_CONFIG=false, le programme d'installation ignore votre configuration existante et utilise les valeurs spécifiées dans la commande d'installation. Pour tout paramètre non spécifié, le programme d'installation utilise les valeurs par défaut. Ce comportement s'applique également à une installation propre.

Pour plus d'informations, voir Utilisez cette commande : et Préserver votre configuration lors de l'installation de Advanced ScreenAgent.

KEEP_CURRENT_CONFIG=true

INSTALL_PATH

(Facultatif) Vous pouvez spécifier le chemin d’installation. Les fichiers d'installation seront sauvegardés dans le dossier \NICE-InContact\ScreenAgent sous le chemin d'installation spécifié.

Si vous n’ajoutez pas ce paramètre, ScreenAgent est installé suivant le chemin d’installation par défaut sur le lecteur C, même si KEEP_CURRENT_CONFIG= true.

INSTALL_PATH=d:\newdir

ACCESS_KEY_ID

Collez l'id DE LA clé d'accès créé dans le compte Employé. Pour générer une clé d'accès, consultez Générez une clé d’accès pour ScreenAgent.

ACCESS_KEY_ID=ABCDEF12345====

ACCESS_KEY_SECRET

Collez la clé d’accès secrète créée dans le compte Employé.

ACCESS_KEY_SECRET=12345ABCDEF

REGION_TYPE

Entrez le sous-domaine (les 3 premiers caractères) de l'URL de votre NiCE CXone (par exemple : na1, na2, au1, eu1)

REGION_TYPE=na1

STATISTICS (Optional) By default, this value is set to true and allows the ScreenAgent to collect data on the user machines (RAM, CPU).

Si vous ne souhaitez pas que ScreenAgent collecte les données, il est possible de changer cette valeur en false.

Les valeurs acceptables sont true et false.

Vous pouvez modifier cette configuration après installation.

STATISTICS=true

WEB_PROXY

N'incluez ce paramètre que si vous utilisez un serveur proxy pour vous connecter à Internet.

Conserver à l'esprit :

  • Héberger peut être un nom d'hôte ou une adresse IP

  • Utilisez http ou https selon vos paramètres de proxy

  • Utilisez le nom d’utilisateur et le mot DE passe du serveur s'il est défini dans vos paramètres de proxy

Par exemple :

  • http://server_username:server_password@host:port

  • https://server_username:server_password@host:port

  • https: // hôte: port

Lorsque vous utilisez une URL de proxy qui fonctionne avec un fichier pac de proxy, ajoutez le préfixe pac+ devant l'URL de proxy, par exemple, si l'URL de proxy est https://<proxy server>.pac, utilisez :

PROXY WEB=pac+https://<serveur proxy>.pac

WEB_PROXY=http://admin:pwd@168.63.76.32:3128

 

 

WEB_PROXY=https://proxyserver:8088

 

 

 

 

 

 

 

 

RESOLVE_USER

(En option) Configurez RESOLVE_USER=oslogin pour utiliser la Connexion au SE de l'Agent. Dans ce mode, ScreenAgent se connecte au serveur avec les informations de Connexion au SE de l'agent, et peut effectuer des configurations avancées, telles que Engagement Hub (Multi-ACD/Open), des environnements multi-session, et plus. Si l’identifiant de Connexion au SE est utilisé, ScreenAgent n’utilise pas le port 31322.

Si vous n'ajoutez pas ce paramètre, ScreenAgent s'installe avec la valeur par défaut, auto, et s'appuie sur les clients NiCE CXone (MAX, Agent Workspace (Agent), et ainsi de suite) pour se connecter au serveur. Dans ce mode, ScreenAgent utilise le port 31322 pour se connecter au client NiCE CXone.

L’identifiant de Connexion au SE de l’agent est défini sur l’Onglet général de la configuration Employé suivant le format Domaine\nom d’utilisateur.

  • Pour les environnements Engagement Hub (Multi-ACD/Open), ce paramètre doit être configuré avec la valeur oslogin .

    Cela permettra au client Screen Agent de lire la Connexion au SE de l'agent à partir du système d'exploitation.

  • Les clients disposant de plusieurs agents travaillant sur la même machine (pas en parallèle) doivent utiliser la configuration OSLogin. Si la configuration OSLogin n'est pas possible, les agents doivent se déconnecter de Windows à la fin de leur quart de travail afin que ScreenAgent fonctionne correctement pour le prochain agent qui se connecte à cette machine.

RESOLVE_USER=oslogin

FRAME_PER_SECOND

(En option) Vous pouvez définir le nombre d'images enregistrées par seconde pour le fichier MP4 de sortie. Si vous n'ajoutez pas ce paramètre, ScreenAgent s'installe avec la valeur par défaut de 5 images par seconde.

Les valeurs autorisées sont 1, 2, 3, 4 ou5. Réduire le nombre d'images par seconde diminue la taille du fichier, la bande passante, l'Unité centrale et la ram.

Vous pouvez modifier cette configuration après installation.

FRAME_PER_SECOND=3

RESOLUTION_LEVEL

(En option) Vous pouvez définir la résolution du fichier MP4 enregistré afin d'optimiser la consommation de ram et d'Unité centrale. Si vous n'ajoutez pas ce paramètre, ScreenAgent s'installe avec le paramètre de résolution par défaut, null, la résolution d'écran actuelle.

Les valeurs autorisées sont null, low, medium ou high (tout en minuscules). Réduire la résolution diminue la taille du fichier, l'Unité centrale et la ram.

Vous pouvez modifier cette configuration après installation.

RESOLUTION_LEVEL=low

LOAD_CERTIFICATES

(Facultatif) Définissez ce paramètre sur false si ScreenAgent ne doit pas accéder à et charger des certificats autosignés à partir du magasin de certificats Windows.

Les valeurs acceptables sont true oufalse.

Si vous n’ajoutez pas ce paramètre, ScreenAgent accède aux certificats autosignés à partir du magasin de certifications Windows.

Vous pouvez modifier cette configuration après installation.

LOAD_CERTIFICATES=false

/log install.log

Imprime les résultats de l'installation dans le fichier journal.

/log install.log

/quiet

(Facultatif) À inclure si vous souhaitez supprimer les fenêtres contextuelles lors de l'installation. Vous pourrez afficher les résultats de l'installation dans le fichier journal.

/quiet

SHOW_NOTIFICATIONS

(En option) Affiche aux agents une courte Notification ordinateur de bureau depuis l'icône de la zone de notification lorsque le Recording d'écran démarre ou s'arrête, et lorsque le masquage d'écran démarre ou s'arrête.

Par défaut :

Définissez sur true pour activer les notifications.

Ce paramètre s'applique uniquement à Advanced ScreenAgent.

SHOW_NOTIFICATIONS=true

Poste-désinstallation : Informations

Lorsque vous désinstallez ScreenAgent d'un poste client, les éléments du système :

  • Contenu du dossier AppData : l'intégralité du dossier %AppData%\ScreenAgent\ est conservée, y compris les journaux et les fichiers de configuration.

  • Dossier d'installation : le dossier situé à ...\Program Files\NICE-InContact\ScreenAgent ou C:\Program Files\NICE CXone\AdvancedScreenAgent reste présent, mais son contenu est supprimé pendant le processus de désinstallation.

Ces fichiers et dossiers résiduels :

  • Ne pas interférer avec une installation nouvelle ou mise à jour de ScreenAgent.

  • Peut être supprimé manuellement si nécessaire, si un environnement complètement propre est requis.

Si vous souhaitez supprimer toute trace de ScreenAgent, assurez-vous que ces dossiers sont supprimés manuellement après la désinstallation.