ScreenAgent pour Windows
ScreenAgent NICE ScreenAgent est un service qui s’exécute sur les ordinateurs de bureau des agents qui nécessitent une vidéocapture d’écran. est disponible si vous avez CXone Recording Avancé et une licence de vidéocapture d’écran.
Installez ScreenAgent sur les ordinateurs pour enregistrer ou surveiller l’activité sur l’écran d’un agent pendant une interaction. ScreenAgent fonctionne en arrière-plan et enregistre automatiquement selon les politiques d’enregistrement (voir CXone Recording). Les superviseurs et les évaluateurs peuvent également surveiller l’activité d’un agent pendant une interaction.
Afin de garantir que CXone Recording Workforce Engagement (WEM) offre une expérience client transparente qui utilise la technologie la plus récente, assurez-vous que vous utilisez les versions ScreenAgent prises en charge :
-
ScreenAgent pour les versions Windows 3.0.22 et ultérieures
-
ScreenAgent pour les versions MAC 3.0.1 et ultérieures
Si vous utilisez des versions antérieures de ScreenAgent, vous devrez mettre à jour tous vos utilisateurs vers 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 pouvez trouver la dernière version de ScreenAgent dans la page Téléchargements.
Pour utiliser les versions ScreenAgent 3.0.x, assurez-vous d’avoir autorisé les noms de domaines complets suivants :
-
Pour FedRamp : cxone-gov.niceincontact.com
-
Pour toutes les autres régions : cxone.niceincontact.com
Vous pouvez installer ScreenAgent sur les ordinateurs des agents ou dans un environnement d’infrastructure de bureau virtuel (VDI). Les VDI pris en charge comprennent :
-
VMware Horizon
-
Citrix Virtual Desktops (anciennement XenDesktop)
-
Citrix Virtual Apps (anciennement XenApp) - Pris en charge dans les environnements sur site uniquement
-
Environnements VDI non persistants
-
Environnements multi-sessions
-
Environnements VDI de type terminal-serveur
-
AVD Remote Apps (nécessite le contournement pour les applications distantes VDI)
VMware Horizon ne nécessite aucune configuration particulière. Pour les autres environnements VDI, consultez les conditions préalables.
Vous pouvez Vérifiez la connectivité de ScreenAgent avant ou après l’installation.
Pour les locataires configurés avec 100 % de vidéocapture d’écran, la vidéocapture d’écran commence jusqu’à 25 secondes après que l’agent s’est connecté. L’enregistrement d’écran ne fonctionne pas correctement pendant ces 25 secondes.
Vous pouvez regarder une vidéo qui donne un aperçu de l’installation de ScreenAgent sur l’ordinateur d’un agent. La vidéo comprend les prérequis et les étapes d’installation.
Pour plus d’informations, voir FAQ pour ScreenAgent
Pour une liste des fonctionnalités ajoutées aux versions précédentes de ScreenAgent, voir ScreenAgent : Notes de version cumulatives.
Conditions préalables
Avant d’installer ScreenAgent, assurez-vous de :
-
Vérifier les Exigences de connectivité. Garder à l’esprit que ScreenAgent n’enregistre pas si votre pare-feu génère des certificats auto-signés ou supprime les en-têtes de demande à partir des paquets HTTPS.
-
Si votre site utilise des VDI, assurez-vous que :
-
Vous utilisez ScreenAgent V3.x.x ou une version supérieure.
-
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 nuage. Cette fonction est essentielle au fonctionnement de ScreenAgent en tant qu’application distante, et n’est donc prise en charge que lorsque Citrix fonctionne sur une machine sur site.
Pour plus d’informations, reportez-vous à la documentation Citrix.
-
Activez une stratégie de bouclage IP virtuel. Ajouter ScreenAgent.exe et Chrome.exe à la liste des programmes de bouclage virtuel Virtual IP. 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 une version supérieure.
-
Installez ScreenAgent sur l’image de base VDI.
-
Prendre un instantané de l’image de base
-
Procédez à la distribution à toutes les instances VDI.
-
-
Pour les environnements multisessions et les environnements VDI de type serveur de terminal :
-
Utilisez ScreenAgent version 3.0.22 ou une version supérieure.
-
ConfigurezScreenAgent pour un fonctionnement en mode Connexion au système d’exploitation.
-
Les utilisateurs doivent se connecter à ScreenAgent avec leurs informations de connexion au système d’exploitation.
La valeur de Connexion au système d’exploitation pour chaque profil d’employé doit être unique. La valeur Connexion au système d’exploitation ne peut pas être utilisée pour plusieurs profils d’employés, même si certains des profils d’employés dupliqués sont inactifs. Si plusieurs profils d’employés ont la même valeur Connexion au système d’exploitation, ScreenAgent ne sera pas exécuté pour les agents utilisant cette valeur Connexion au système d’exploitation.
-
Si vous travaillez dans un environnement VDI multi-sessions ou non persistant et que vous rencontrez des problèmes, contactez le soutien de NICE pour vérifier si votre environnement spécifique est pris en charge.
Le mode bureau virtuel VMware Horizon et Citrix ne nécessite aucune configuration particulière.
-
-
Vérifier la configuration informatique de l’agent.
Configuration requise pour l’ordinateur de l’agent-
Microsoft .NET 4 ou supérieur installé sur l’ordinateur de l’agent.
-
L’une des solutions de téléphone logiciel pour les agents :
-
CXone Agent.
-
Téléphone logiciel Salesforce Agent installé sur le même ordinateur que ScreenAgent.
-
Téléphone logiciel MAX.
-
-
Spécifications informatiques pertinentes dans Exigences de plateforme.
Gardez à l’esprit que si la configuration de l’ordinateur est définie sur Full HD (haute définition intégrale) ou 4K et que l’utilisation du processeur est élevée, un processeur plus puissant (tel que i5) peut être nécessaire.
-
Port 31322 ouvert. Ce port n’est utilisé que pour la communication interne entre ScreenAgent et le téléphone logiciel MAX/CXone Agent/Salesforce Agent sur l’ordinateur de l’agent. Non requis lors de l’utilisation de la connexion au système d’exploitation.
-
-
Assurez-vous que l’utilisateur qui installe ScreenAgent (par exemple, l’administrateur) dispose de droits d’administrateur sur l’ordinateur de l’agent.
-
Assurez-vous que l’utilisateur qui installe ScreenAgent (par exemple, l’administrateur) dispose de ces autorisations CXone :
-
Peut accéder à la page Support et téléchargements : Activée, cela vous permet d’accéder à la page Support et téléchargements.
-
Clef d’accès :Créer, il s’agit de gérer les clés d’accès de votre organisation.
-
-
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 de l’utilisateur CXone qui la génère. Si cet utilisateur est un administrateur, toute personne disposant de la clé d’accès aurait des privilèges d’administrateur. Pour des raisons de sécurité, créez d’abord un utilisateur CXone et un rôle pour ScreenAgent, puis générez la clé avec l’utilisateur ScreenAgent.
-
Créez un rôle pour le service ScreenAgent :
- Cliquez sur le sélecteur d’applications et sélectionnezAdmin.
-
Accédez à Sécurité > Rôles et autorisations.
-
Cliquez sur Nouveau rôle.
-
Donnez un nom au rôle, tel que Clé d’accès ScreenAgent.
-
Supprimez toutes les autorisations pour le rôle, à l’exception de Clé d’accès et Ma clé d’accès.
-
Enregistrez et activez le profil.
-
Créez un employé pour le service ScreenAgent :
- Cliquez sur le sélecteur d’applications et sélectionnezAdmin.
-
Cliquez sur Employés.
-
Cliquez sur Nouvel employé.
-
Donnez un nom à l’employé, tel que ScreenAgent.
-
Dans la liste déroulante Rôle principal, sélectionnez le rôle de clé d’accès ScreenAgent que vous venez de créer.
-
Dans l’onglet Général, effacez tous les attributs.
-
Créez l’employé ScreenAgent. Vous ne pouvez générer des clés d’accès qu’après avoir créé le compte.
-
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.
-
Copiez à la fois l’ID de la clé d’accès et la clé d’accès secrète et enregistrez-les dans un endroit sûr. Si vous ne copiez pas la clé d’accès secrète ou si vous la perdez, vous devrez en créer une nouvelle. Utilisez cet ID de 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.
-
Activez le compte employé ScreenAgent en cliquant sur le bouton Activer le compte dans le courriel d’activation.
-
-
Téléchargez le MSI ScreenAgent :
-
Accédez à CXone. et ouvrez une session en tant qu’utilisateur avec une autorisation Peut accéder à la page Support et téléchargements.
-
Cliquez sur votre nom d’utilisateur et sélectionnez Support et téléchargements.
-
Téléchargez le MSI requis. Notez où vous téléchargez le MSI, vous aurez besoin de l’emplacement du fichier plus tard.
-
-
ScreenAgent prend en charge cinq méthodes d’authentification mandataire pour la vidéocapture d’écran : Basic, Digest, Kerberos, NTLM et Negotiate. Lors de l’utilisation de la méthode d’authentification mandataire :
-
Assurez-vous de définir le mandataire au niveau du système d’exploitation dans les paramètres du mandataire.
-
Pour les méthodes d’authentification Basic et Digest, vous devez définir les informations d’identification dans Windows Credential Manager.
-
Il n’y a aucun changement dans l’installation. Toutefois, si vous souhaitez utiliser le mandataire pour ScreenAgent sans changer de mandataire au niveau du système d’exploitation, vous pouvez utiliser le mandataire direct dans l’installation de ScreenAgent.
-
Gardez à l’esprit que ces méthodes d’authentification sont uniquement destinées à la vidéocapture d’écran et non à la surveillance 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 de l’une des manières suivantes :
-
Exécuter avec les droits de l’utilisateur (mode utilisateur/contexte utilisateur) : vous n’avez pas besoin 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 spécifier l’emplacement de l’installation :
-
Par défaut, ScreenAgent est installé sur le lecteur C dans le dossier \NICE-InContact\ScreenAgent. Vous pouvez spécifier un chemin d’installation différent dans la commande d’installation.
-
Lors de la mise à jour 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 dernière version est installée à l’emplacement spécifié.
-
La réinstallation de la même version de ScreenAgent remplace l’installation existante au même emplacement. Pour modifier le chemin d’installation, désinstallez l’instance existante et spécifiez l’emplacement requis lors de la réinstallation.
Certains paramètres de ScreenAgent peuvent être modifiés après l’installation. Voir Modifier la configuration de ScreenAgent. Pour mettre à jour d’autres paramètres d’installation, réinstallez le client ScreenAgent.
Pour mettre à jour ScreenAgent vers une version plus récente, installez le client ScreenAgent. Vous n’avez pas besoin de désinstaller la version précédente.
Lorsque vous mettez à niveau ou réinstallez ScreenAgent, l’installation utilise automatiquement la configuration existante, à moins que vous ne spécifiiez des paramètres différents. Voir Réinstallation ou mise à niveau avec la configuration actuelle. Lorsque vous désinstallez ScreenAgent, la configuration n’est pas enregistrée et vous devez spécifier les paramètres d’installation lors de la mise à niveau ou de la réinstallation.
Mettez à jour ou réinstallez ScreenAgent lorsque les agents ne sont pas enregistrés. Si un agent est en communication pendant l’installation, la vidéocapture d’écran s’arrête pour cette communication. Une fois l’installation terminée, les appels seront enregistrés conformément aux politiques d’enregistrement et aux scripts Studio.
Pour installer ScreenAgent
-
Assurez-vous que toutes les conditions préalables sont en place.
-
Ouvrez l’invite de commande en tant qu’administrateur. Sur 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 appropriés :
Instructions étape par étape-
Accédez au dossier dans lequel vous avez téléchargé le MSI et copiez le chemin d’accès au dossier. Il s’agit généralement du dossier %UserProfile%\downloads.
-
Exécutez l’invite de commande en tant qu’administrateur :
-
Sous Windows, cliquez sur le bouton Windows et tapez cmd.
-
Cliquez avec le bouton droit sur la vignette d’invite de commandes et cliquez sur Exécuter en tant qu’administrateur.
-
-
Tapez cd/ et appuyez sur Entrée.
-
Tapez cd et collez l’emplacement de votre fichier, puis appuyez sur Entrée.
Par exemple, cd %UserProfile%\downloads.
-
Copiez et collez la commande dans l’invite de commandes et modifiez les paramètres d’installation.
-
Si vous n’avez pas de mandataire Web ou si le mandataire est défini au niveau du système d’exploitation, utilisez cette commande :
msiexec /i ScreenAgent-<32|64>bit-<version MSI>.msi INSTALL_PATH=<facultatif : chemin d’installation> ACCESS_KEY_ID=<ID de clé d’accès> ACCESS_KEY_SECRET=<clé d’accès secrète> REGION_TYPE=<sous-domaine (3 premiers caractères) de l’URL CXone> RESOLVE_USER=<facultatif : auto|oslogin> FRAME_PER_SECOND=<facultatif : 1, 2, 3, 4 ou 5> RESOLUTION_LEVEL=<facultatif : nulle, faible, moyenne ou élevée> LOAD_CERTIFICATES=<facultatif : true|false> STATISTICS=<facultatif : true|false>/log install.log /quiet
-
Si vous utilisez l’authentification par mandataire et que le mandataire n’est pas défini au niveau du système d’exploitation, utilisez cette commande :
msiexec /i ScreenAgent-<32|64>bit-<version MSI>.msi INSTALL_PATH=<facultatif : chemin d’installation> ACCESS_KEY_ID=<ID de clé d’accès> ACCESS_KEY_SECRET=<clé d’accès secrète> REGION_TYPE=<sous-domaine (3 premiers caractères) de l’URL CXone WEB_PROXY=<uniquement si un serveur mandataire est utilisé pour la connexion Internet> RESOLVE_USER=<facultatif : auto|oslogin> FRAME_PER_SECOND=<facultatif : 1, 2, 3, 4 ou 5> RESOLUTION_LEVEL=<facultatif : nulle, faible, moyenne ou élevée> LOAD_CERTIFICATES=facultatif : true|false> STATISTICS=facultatif : true|false> /log install.log /quiet
Exemple de commande d’installation (en l’absence de mandataire Web ou lorsque le mandataire est défini au niveau du système d’exploitation) :
msiexec /i ScreenAgent-64bit-3.0.37.msi
INSTALL_PATH=d:\newdir
ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1
RESOLVE_USER=oslogin
FRAME_PER_SECOND=5 RESOLUTION_LEVEL=high LOAD_CERTIFICATES=true STATISTICS=true /log install.log /quiet
-
Réinstallation ou mise à niveau avec la configuration actuelleUtilisez cette commande :
msiexec /i ScreenAgent-<32|64>bit-<version MSI>.msi KEEP_CURRENT_CONFIG= true
KEEP_CURRENT_CONFIG= true est facultatif, car la valeur par défaut de ce paramètre est true (vrai).
-
Si toutes les configurations ont été définies lors de l’installation précédente, ScreenAgent est installé avec toutes les configurations existantes.
-
Si certaines configurations étaient manquantes ou n’avaient pas été définies lors de l’installation précédente, ScreenAgent est installé avec les configurations existantes et les valeurs par défaut pour les paramètres manquants.
-
Le chemin d’installation n’est pas enregistré après l’installation; s’il n’est pas fourni dans la commande d’installation, ScreenAgent est installé à l’emplacement par défaut même si KEEP_CURRENT_CONFIG= true.
Pour conserver certains paramètres et en modifier d’autres, utilisez la commande ci-dessus et ajoutez d’autres paramètres si nécessaire. Par exemple, pour modifier uniquement le nombre d’images par seconde et le niveau de résolution, procédez comme suit (KEEP_CURRENT_CONFIG=true est facultatif) :
msiexec /i ScreenAgent-64bit-2.2.18.msi KEEP_CURRENT_CONFIG=true FRAME_PER_SECOND=5 RESOLUTION_LEVEL=high
-
-
Vérifiez la réussite de l’installation à partir du fichier journal. Le fichier install.log se trouve dans le dossier à partir duquel vous avez installé le MSI, c’est-à-dire généralement le dossier %UserProfile%\downloads.
-
Vérifiez que le programme d’installation dispose des privilèges d’administration.
-
Si l’ordinateur de l’agent ne dispose pas de Microsoft .NET Framework 4.0 ou version ultérieure, installez-le.
Le fichier de configuration, configFile.ini, est automatiquement masqué après l’installation. Pour visualiser et ouvrir le fichier, activez Éléments masqués dans l’Explorateur de fichiers de Windows.
-
-
Assurez-vous que l’agent a l’attribut Peut être enregistré (écran) (dans CXone, accédez à Admin > Employés, puis cliquez sur l’agent). Cet attribut est nécessaire pour activer la vidéocapture d’écran, l’observation d’écran ou les deux.
-
Enregistrez un appel et consultez le fichier journal ScreenAgent. Le fichier ScreenAgent.log se trouve ici : %appdata%\ScreenAgent\logs\ScreenAgent.log.
Vos journaux ScreenAgent sont également automatiquement téléversés dans le nuage où l’équipe de soutien NICE CXone peut y accéder, si nécessaire.
S’il y a eu des erreurs, voir Dépanner les enregistrements.
Vous pouvez regarder une vidéo qui donne un aperçu de la façon d’améliorer les interactions des agents avec la surveillance d’écran en temps réel à l’aide de ScreenAgent.
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 GoogleChrome, 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 de vidéocapture d’écran.
Pour ajouter la valeur à la clé de registre :
-
Assurez-vous que la machine de l’agent utilise le navigateur Chrome 126 ou une version ultérieure.
-
Assurez-vous que vous disposez des droits d’administrateur dans Windows.
-
Vérifiez que le chemin d’accès au registre HKLM:\NSOFTWARE\NPolicies\NGoogle\NChrome existe.
-
Exécutez la ligne de script Powershell suivante pour ajouter la valeur au registre de Google Chrome :
Set-ItemProperty -Path "HKLM:\SOFTWARE\Policies\Google\Chrome" -Name "UiAutomationProviderEnabled" -Value 1 -Type DWord
Contournement potentiel pour les applications distantes VDI
Lorsque les agents utilisent VDI Remote Apps et que le processus ScreenAgentWatchDog.exe ne démarre pas :
-
Publiez ScreenAgent.exe dans RemoteApps. Veillez à ce que seuls les administrateurs (et non les agents) y aient accès.
-
Créez et publiez un raccourci vers RemoteApps. Utilisez un script, comme celui présenté ci-dessous, pour ouvrir le navigateur et exécuter ScreenAgentWatchDog.exe. Les agents doivent utiliser ce raccourci pour ouvrir le navigateur, sinon ScreenAgent ne s’exécutera pas.
Dans l’exemple suivant, remplacez <USER_ID> et <TENANT_ID> par les informations correspondantes. En outre, l’URL présentée dans cet exemple peut être remplacée par toute autre URL que vous souhaiteriez utiliser.
@echo Off
cd " C:\Program Files (x86)\Microsoft\Edge\Application"
start msedge.exe https://account.activedirectory.windowsazure.com/applications/signin/<USER_ID>?tenantId=<TENANT_ID>
REM Check if ScreenAgentWatchDog is already running for the current user profile
tasklist /FI "USERNAME eq %USERNAME%" /FI "IMAGENAME eq ScreenAgentWatchDog.exe" | find /I "ScreenAgentWatchDog.exe" > nul
if "%errorlevel%" neq "0" (
cd "%ProgramFiles%\NICE-InContact\ScreenAgent"
start ScreenAgentWatchDog.exe
)
Exit
Dans l’exemple suivant, remplacez <USER_ID> et <TENANT_ID> par les informations correspondantes. En outre, l’URL présentée dans cet exemple peut être remplacée par toute autre URL que vous souhaiteriez utiliser.
WorkaroundChrome
@echo Off
cd "C:\Program Files (x86)\Google\Chrome\Application"
start chrome.exe https://account.activedirectory.windowsazure.com/applications/signin/<USER_ID>?tenantId=<TENANT_ID>
REM Check if ScreenAgentWatchDog is already running for the current user profile
tasklist /FI "USERNAME eq %USERNAME%" /FI "IMAGENAME eq ScreenAgentWatchDog.exe" | find /I "ScreenAgentWatchDog.exe" > nul
if "%errorlevel%" neq "0" (
cd "%ProgramFiles%\NICE-InContact\ScreenAgent"
start ScreenAgentWatchDog.exe
)
Exit
Modifier la configuration de ScreenAgent
Après l’installation, vous pouvez modifier certaines configurations ScreenAgent.
Le fichier de configuration, configFile.ini, est automatiquement masqué après l’installation. Pour visualiser et ouvrir le fichier, activez Éléments masqués dans l’Explorateur de fichiers de Windows.
-
Ouvrez le fichier configFile.ini dans le dossier d’installation ScreenAgent, généralement sous C:\Program Files\NICE-InContact\ScreenAgent.
-
Modifier les valeurs des paramètres :
-
Modifiez la valeur framePerSecond dans la section [recordingParameters]. Par défaut, cette valeur est 5.
Les valeurs autorisées sont 1, 2, 3, 4, ou5.
La diminution du nombre d’images par seconde réduit la taille du fichier et l’utilisation du processeur et de la mémoire vive.
Images par seconde Réduction du nombre d’images Impact sur la taille des fichiers, la bande passante, le processeur et la mémoire vive (estimation) 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.
de 80 % de moins
~60 % de réduction
-
Modifiez la valeur resolutionLevel dans la section [recordingParameters]. Par défaut, cette valeur est nul, soit la résolution actuelle de l’écran.
Les valeurs autorisées sont nul, faible, moyen ou élevé (insensible à la casse).
La diminution de la résolution réduit la taille du fichier et l’utilisation du processeur et de la mémoire vive.
Niveau de résolution Réduction de la RÉSOLUTION Impact sur la taille des fichiers, la bande passante, le processeur et la mémoire vive (estimation) Nul
Par défaut (résolution actuelle de l’écran)
Aucun
Élevé
Résolution de l’écran / 1,5
~20 % de réduction
Moyen
Résolution de l’écran / 2
~40 % de réduction
Bas
Résolution de l’écran / 4
Réduction de ~60 % (recommandé uniquement pour les écrans 4K)
Pour revenir à la résolution de l’écran, définissez la valeur resolutionLevel sur nul.
-
Modifiez la valeur de loadCertificates dans la section [others]. Par défaut, cette valeur est vraie.
Les valeurs autorisées sont vrai ou faux.
-
-
Enregistrez le fichier configFile.ini .
-
Pour appliquer les modifications, redémarrez l’application ScreenAgent :
-
Dans le Gestionnaire de tâches de Windows, mettez fin à la tâche ScreenAgentWatchDog.exe en cours, puis terminez les processus ScreenAgent.exe.
-
Depuis le dossier d’installation de ScreenAgent, exécutez ScreenAgentWatchdog.exe.
-
Vérifiez la connectivité de ScreenAgent
Utilisez l’outil de vérification de la connectivité ScreenAgent pour exécuter une séquence de tests afin de vérifier l’accès au réseau et de confirmer que ScreenAgent fonctionnera correctement.
-
Vous pouvez utiliser l’outil 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é à partir de la page Téléchargements.
-
Il est recommandé d’utiliser cet outil lorsque la configuration du réseau d’un agent a changé ou est différente de la configuration habituelle. Il n’est pas nécessaire d’exécuter l’outil pour chaque agent.
-
Vous pouvez exécuter l’outil de vérification de la connectivité plusieurs fois à l’aide de la même commande.
-
Après l’exécution de chaque test, une notification de réussite ou d’échec s’affiche. À la fin de l’exécution, un résumé affiche l’état de chaque test.
-
Une fois les tests terminés, l’outil de vérification de la connectivité crée un fichier journal.
-
L’outil de vérification de la connectivité ne comprend pas actuellement de tests permettant de vérifier la mise en réseau pour la surveillance de l’écran en temps réel.
-
Téléchargez le fichier EXE de l’outil de vérification de la connectivité :
-
Accédez à CXone. et ouvrez une session en tant qu’utilisateur avec une autorisation Peut accéder à la page Support et téléchargements.
-
Cliquez sur votre nom d’utilisateur et sélectionnez Support et téléchargements.
-
Téléchargez le fichier EXE requis. Notez où vous téléchargez le fichier EXE, car vous aurez besoin de l’emplacement du fichier plus tard.
-
-
Lancez l’outil de vérification de la connectivité.
-
Exécutez l’invite de commande en tant qu’administrateur.
-
Copiez et collez la commande dans l’invite de commandes et modifiez les paramètres répertoriés dans le tableau.
<chemin vers le fichier exe> ACCESS_KEY_ID=<ID de clé d’accès> ACCESS_KEY_SECRET=<clé d’accès secrète> REGION_TYPE=<sous-domaine (3 premiers caractères) de l’URL CXone> WEB_PROXY=<facultatif : URL du serveur mandataire>
Paramètres de commande de l’outil de connectivitéParamètre
Description
Exemple
chemin d’accès vers le fichier exe
Emplacement du fichier EXE téléchargé.
C:%UserProfile%\downloads
ACCESS_KEY_ID
Collez l’ID de clé d’accès créé dans le compte de l’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 (3 premiers caractères) de votre URL CXone (par exemple : na1, na2, au1, eu1)
REGION_TYPE=na1
WEB_PROXY
N’incluez ce paramètre que si vous utilisez un serveur mandataire (proxy) pour vous connecter à Internet.
-
Hôte peut être un nom d’hôte ou IP
-
Utilisez http ou https selon vos paramètres de serveur mandataire (proxy)
-
Utilisez le nom d’utilisateur et le mot de passe du serveur s’ils sont définis dans vos paramètres de serveur mandataire (proxy)
WEB_PROXY=http://admin:mdp@168.63.76.32:3128
WEB_PROXY=https://serveurmandataire:8088
-
Exemple de commande :
C:%UserProfile%\downloads ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 WEB_PROXY=https://proxyserver:8088
-
-
L’outil de vérification de la connectivité commence à exécuter les tests. Après l’exécution de chaque test, une notification de réussite ou d’échec s’affiche. Si un test échoue, la raison de l’échec est affichée. À la fin de l’exécution, un résumé indique si chaque test a réussi, échoué ou n’a pas eu besoin d’être exécuté (N/A). Par exemple, si ScreenAgent n’était pas en cours d’exécution en arrière-plan lorsque l’outil de vérification de la connectivité a démarré, les tests visant à fermer ScreenAgent et à le redémarrer n’ont pas besoin d’être exécutés.
Une fois les tests terminés, l’outil de vérification de la connectivité crée un fichier journal (SA_Connectivity_tool_log_<runUniqueUID>) dans le même dossier que le fichier d’installation de l’outil de vérification de la connectivité. Le fichier journal contient toutes les informations affichées à l’invite de commande.
Tests de connectivité
Test |
Description |
---|---|
Fermer ScreenAgent | Fermez ScreenAgent (ScreenAgent.exe et ScreenAgentWatchdog.exe) s’il fonctionne en arrière-plan. Cela permet de s’assurer qu’il n’interrompt pas les tests de l’outil de connectivité. |
Vérifier le port 31322 | Testez la communication avec le port 31322. |
Obtenir un jeton | Faites un test pour obtenir le jeton. |
Obtenir un jeton d’actualisation | Faites un test pour obtenir un jeton d’actualisation. |
Recevoir les informations d’identification STS pour la catégorie de journaux du service de notification | Testez l’envoi et la réception de messages à partir du socket Web du service de notification. |
Recevoir les informations d’identification STS pour la catégorie de supports du service de notification | Testez l’envoi et la réception de messages à partir du socket Web du service de notification. |
Téléverser le journal d’exécution de l’outil de connectivité dans la catégorie de journaux S3 | Testez le téléversement vers la catégorie de journaux S3. |
Téléverser le fichier dans la catégorie de supports S3 | Testez le téléversement vers la catégorie de supports S3. |
Lancer ScreenAgent | Redémarrez ScreenAgent (ScreenAgent.exe et ScreenAgentWatchdog.exe) s’il a été fermé précédemment. |
Arrêter le serveur sur le port 31322 | Arrêtez le serveur de test qui a été utilisé pour tester la communication avec le port 31322. |
Paramètres de commande d’installation
Paramètre |
Description |
Exemple |
---|---|---|
msiexec /i ScreenAgent-32bits-<MSI version>.msi |
32 bits ou 64 bits Si vous installez sur un ordinateur avec :
Version MSI Entrez la version MSI du fichier d’installation que vous avez téléchargé à partir de la page Support 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 |
(Facultatif) Par défaut, l’installation utilise la configuration actuelle lorsque vous réinstallez ou mettez à niveau ScreenAgent. Voir Réinstallation ou mise à niveau avec la configuration actuelle. Lorsque la valeur est false (faux), l’installation ScreenAgent n’utilise pas la configuration existante. L’installation utilise tous les paramètres spécifiés et les valeurs par défaut pour les paramètres non configurés. La valeur par défaut est true (vrai). Pour une nouvelle installation, les valeurs par défaut sont utilisées pour les paramètres sans configuration. |
KEEP_CURRENT_CONFIG=true |
INSTALL_PATH |
(Facultatif) Vous pouvez spécifier le chemin d’installation. Les fichiers d’installation seront enregistré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é sous le chemin d’installation par défaut sur le lecteur C, même si KEEP_CURRENT_CONFIG= true. |
INSTALL_PATH=d:\Nnewdir |
ACCESS_KEY_ID |
Collez l’ID de clé d’accès créé dans le compte de l’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 (3 premiers caractères) de votre URL CXone (par exemple : na1, na2, au1, eu1) |
REGION_TYPE=na1 |
STATISTIQUES | (Facultatif) Par défaut, cette valeur est définie sur vrai et permet à ScreenAgent de collecter des données sur les machines des utilisateurs (RAM, UC). Si vous ne souhaitez pas que ScreenAgent collecte des données, il est possible de changer cette valeur sur faux. Les valeurs autorisées sont vrai et faux. Vous pouvez modifier cette configuration après l’installation. |
STATISTIQUES=vrai |
WEB_PROXY |
N’incluez ce paramètre que si vous utilisez un serveur mandataire (proxy) pour vous connecter à Internet. Souvenez-vous :
Par exemple :
Lorsque vous utilisez une URL mandataire qui fonctionne avec un fichier pac mandataire, ajoutez le préfixe pac+ devant l’URL mandataire, par exemple, si l’URL mandataire est https://<serveur mandataire>.pac, utilisez : WEB_PROXY=pac+https://<serveur mandataire>.pac |
WEB_PROXY=http://admin:mdp@168.63.76.32:3128
WEB_PROXY=https://serveurmandataire:8088
|
RESOLVE_USER |
(Facultatif) Configurez RESOLVE_USER=oslogin pour utiliser la connexion au système d’exploitation de l’agent. Dans ce mode, ScreenAgent se connecte au serveur avec les informations de connexion au système d’exploitation de l’agent et peut travailler sur des configurations avancées, telles que CXone Multi-ACD (CXone Open), des environnements multi-sessions, etc. Lors de l’utilisation de la connexion au système d’exploitation, 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 CXone (MAX, CXone Agent, etc.) pour se connecter au serveur. Dans ce mode, ScreenAgent utilise le port 31322 pour se connecter au client CXone. La connexion au système d’exploitation de l’agent est définie dans l’onglet Général de la configuration Employé au format Domaine\Nomutilisateur. |
RESOLVE_USER=oslogin |
FRAME_PER_SECOND |
(Facultatif) 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. Diminuer le nombre d’images par seconde réduit la taille du fichier et de la bande passante et l’utilisation du processeur et de la mémoire vive. Vous pouvez modifier cette configuration après l’installation. |
FRAME_PER_SECOND=3 |
RESOLUTION_LEVEL |
(Facultatif) Vous pouvez définir la résolution du fichier MP4 enregistré afin d’optimiser la consommation de mémoire vive et du processeur. Si vous n’ajoutez pas ce paramètre, ScreenAgent est installé avec le paramètre de résolution par défaut, nul, soit la résolution actuelle de l’écran. Les valeurs autorisées sont nul, faible, moyen ou élevé (insensible à la casse). La diminution de la résolution réduit la taille du fichier et l’utilisation du processeur et de la mémoire vive. Vous pouvez modifier cette configuration après l’installation. |
RESOLUTION_LEVEL=low |
LOAD_CERTIFICATES |
(Facultatif) Définissez ce paramètre sur faux si ScreenAgent ne doit pas accéder aux certificats auto-signés et les charger à partir du magasin de certificats Windows. Les valeurs autorisées sont vrai ou faux. Si vous n’ajoutez pas ce paramètre, ScreenAgent accède aux certificats auto-signés du magasin de certificats de Windows. Vous pouvez modifier cette configuration après l’installation. |
LOAD_CERTIFICATES=false |
/log install.log |
Imprime les résultats de l’installation dans le fichier journal. |
/log install.log |
/quiet |
(Facultatif) Indiquez si vous souhaitez supprimer les fenêtres contextuelles lors de l’installation. Vous pourrez voir les résultats de l’installation dans le fichier journal. |
/quiet |