ScreenAgent voor Windows

ScreenAgent NICE ScreenAgent is een service die wordt uitgevoerd op agentdesktops die opgenomen moeten worden. is beschikbaar indien u beschikt over CXone Recording Geavanceerd en een licentie voor schermopname.

Installeer ScreenAgent op computers van agents om de activiteit op het scherm van de agent tijdens een interactie op te nemen of te monitoren. ScreenAgent draait op de achtergrond en neemt automatisch op volgens het ingestelde opnamebeleid (zie CXone Recording). Supervisors en beoordelaars kunnen bovendien de activiteit van een agent tijdens een interactie monitoren.

U kunt ScreenAgent installeren op computers van uw agents of in een virtual desktop infrastructuur (VDI)-omgeving. Ondersteunde VDI's zijn onder andere:

• VMware Horizon

• Citrix Virtual Desktops (voorheen XenDesktop)

• Citrix Virtual Apps (voorheen XenApp) - alleen ondersteund in omgevingen op locatie

• Niet-persistente VDI-omgevingen

• Multi-sessie systeemomgevingen

• VDI-omgevingen van het type terminalserver

• AVD Remote Apps (hiervoor is VDI Remote Apps Workaround nodig)

VMware Horizon vereist geen speciale configuratie. Zie vereisten voor informatie over overige VDI-omgevingen.

U kunt voor of na de installatie Verbinding van ScreenAgent controleren.

 

Zie Veelgestelde vragen over ScreenAgent voor meer informatie.

Voor een lijst van functies die zijn toegevoegd aan de vorige ScreenAgent releases, zie ScreenAgent: cumulatieve Netwerkinstelling

Vereisten

Voordat u ScreenAgent installeert, moet u het volgende doen:

1. Controleer de Verbindingsvereisten. Houd er rekening mee dat ScreenAgent niet kan opnemen als uw firewall zelfondertekende certificaten genereert of request-headers verwijdert uit HTTPS-pakketten.

2. Als uw site gebruik maakt van VDI, doet u het volgende:

   • Controleer of u ScreenAgent V3.x.x of hoger gebruikt.

     • Voor Citrix Virtual Apps:

       Citrix biedt geen ondersteuning voor de configuratie van virtuele IP-loopback die wordt gehost op machines in de cloud. Deze functie is essentieel voor het gebruik van ScreenAgent als externe applicatie en wordt daarom alleen ondersteund wanneer Citrix wordt gebruikt op een machine op locatie.

       Zie de Citrix-documentatie voor meer informatie.

       • Schakel een Virtual IP Loopback-beleid in. Voeg ScreenAgent.exe en Chrome.exe toe aan de lijst met Virtual IP Loopback-programma's. Vermeld elk programma op een aparte regel.

       • Installeer ScreenAgent op de Citrix Virtual Apps-server.

   • In een niet-persistente VDI-omgeving:

     • Gebruik ScreenAgent versie 3.0.22 of hoger.

     • Installeer ScreenAgent op de base image van de VDI.

     • Maak een snapshot van de base image.

     • Distribueer deze aan alle VDI-instanties.

   • Voor multi-sessie-omgevingen en VDI-omgevingen van het type terminalserver:

     • Gebruik ScreenAgent versie 3.0.22 of hoger.

     • Configureer ScreenAgent om te werken in de modus inloggen bij besturingssysteem.

     • Gebruikers moeten inloggen op ScreenAgent met de inloggegevens voor inloggen bij besturingssysteem.

     De waarde Inloggen bij besturingssysteem moet voor elk medewerkerprofiel uniek zijn. De waarde Inloggen bij besturingssysteem kan niet worden gebruikt voor meerdere medewerkerprofielen, zelfs niet als enkele van de dubbele medewerkerprofielen inactief zijn. Als meerdere medewerkerprofielen dezelfde waarde hebben voor Inloggen bij het besturingssysteem, wordt ScreenAgent niet uitgevoerd voor een agent die deze waarde voor Inloggen bij besturingssysteem gebruikt.

   Wanneer u werkt in een multi-sessie of niet-persistente VDI-omgeving en u ondervindt problemen, neem dan contact op met NICE-support om te controleren of uw specifieke omgeving wordt ondersteund.

   VMware Horizon en Citrix Virtual Desktop vereisen geen speciale configuratie.

3. Controleer de computerconfiguratie van de agent.

   Vereisten voor agentcomputers

   • Microsoft .NET 4 of hoger moet geïnstalleerd zijn.

   • Een van de softphone-oplossingen voor agents moet geïnstalleerd zijn:

     • CXone Agent.

     • Salesforce Agent-softphone geïnstalleerd op dezelfde computer als ScreenAgent.

     • MAX-softphone.

   • Zie de relevante computerspecificaties in Platformvereisten.

     Let op: als de beeldschermconfiguratie is ingesteld op Full HD of 4K en het CPU-gebruik hoog is, is mogelijk een krachtigere CPU (bijvoorbeeld i5) vereist.

   • Poort 31322 moet open zijn. Deze poort wordt alleen gebruikt voor interne communicatie tussen ScreenAgent en MAX-/CXone Agent-/Salesforce Agent-softphone op de computer van de agent. Niet vereist bij inloggen bij besturingssysteem.

4. Zorg dat de gebruiker die ScreenAgent installeert (bijvoorbeeld de beheerder) beheerdersrechten heeft op de computer van de agent.

5. Zorg dat de gebruiker die ScreenAgent installeert (bijvoorbeeld de beheerder), de volgende CXone-machtigingen heeft:

   • Toegang tot supportdownloads: Aan. Dit geeft toegang tot de pagina Support - Downloads.

   • Toegangssleutel: Maken. Dit is nodig om de toegangssleutels voor uw organisatie te beheren.

6. Genereer een toegangssleutel voor ScreenAgent.

   U kunt dezelfde toegangssleutel gebruiken voor het installeren van ScreenAgent op alle computers van agents in uw tenant.

   De toegangssleutel krijgt alle machtigingen van de CXone-gebruiker die de sleutel genereert. Als deze gebruiker een beheerder is, krijgt iedereen met deze toegangssleutel ook beheerdersrechten. Maak dus om veiligheidsredenen eerst een CXone-gebruiker en -rol aan voor ScreenAgent en genereer vervolgens de sleutel met die ScreenAgent-gebruiker.

   1. Maak een rol aan voor de ScreenAgent-service:

      1. Klik op de app-kiezer en selecteerAdmin.

      2. Ga naar Beveiliging > Rollen en machtigingen.

      3. Klik op Nieuwe rol.

      4. Geef de rol een naam, bijvoorbeeld ScreenAgent-toegangssleutel.

      5. Verwijder alle machtigingen voor de rol, behalve Toegangssleutel en Mijn toegangssleutel.

      6. Het profiel opslaan en activeren.

   2. Maak een medewerker voor de ScreenAgent-service:

      1. Klik op de app-kiezer en selecteerAdmin.

      2. Klik op Medewerkers.

      3. Klik op Nieuwe medewerker.

      4. Geef een naam op voor de medewerker, bijvoorbeeld ScreenAgent.

      5. Selecteer in de vervolgkeuzelijst Primaire rol de rol ScreenAgent-toegangssleutel die u zojuist hebt gemaakt.

      6. Wis alle attributen op het tabblad Algemeen.

      7. Maak de ScreenAgent-medewerker aan. U kunt pas een toegangssleutel genereren wanneer u het account hebt aangemaakt.

   3. Open de ScreenAgent-medewerker opnieuw en ga naar het tabblad Beveiliging. Klik op Toegangssleutel toevoegen om een toegangssleutel te genereren.

   4. Kopieer zowel de Toegangssleutel-ID als de Geheime toegangssleutel en bewaar ze op een veilige plaats. Als u de Geheime toegangssleutel niet bewaart of als u deze later verliest, moet u een nieuwe sleutel maken. Gebruik deze toegangssleutel-ID en geheime toegangssleutel bij het installeren van ScreenAgent op alle computers van agents.

   5. Activeer de ScreenAgent-medewerkersaccount door te klikken op de knop Account activeren in de activeringsmail.

7. Download het ScreenAgent-MSI-bestand:

   1. Ga naar CXone en log in als een gebruiker met de machtiging Toegang tot supportdownloads.

   2. Klik op uw Gebruikersnaam en selecteer Support en downloads.

   3. Download het vereiste MSI-bestand. Noteer waar u de MSI downloadt. U hebt de bestandslocatie later nodig.

8. ScreenAgent ondersteunt vijf methoden voor proxy-authenticatie voor schermopname: Basic, Digest, Kerberos, NTLM en Negotiate. Bij gebruik van de proxy-authenticatiemethode:

   • Zorg dat u de proxy op het niveau van het besturingssysteem configureert in de Proxy-instellingen.

   • Voor de authenticatiemethoden Basic en Digest moet u inloggegevens configureren in Windows Credential Manager.

   • De installatie blijft hetzelfde. Maar als u een proxy voor ScreenAgent wilt gebruiken zonder de proxy op besturingssysteemniveau te wijzigen, kunt u de directe proxy gebruiken in de installatie van ScreenAgent.

   • Houd er rekening mee dat deze authenticatiemethoden alleen bedoeld zijn voor schermopname en niet voor schermmonitoring.

Installeer ScreenAgent voor Windows

U kunt ScreenAgent installeren met behulp van een implementatietool, of handmatig installeren op de computers van alle agents.

Wanneer u een implementatietool gebruikt, kiest u bij de installatie een van de volgende opties:

• Uitvoeren met gebruikersrechten (gebruikersmodus/gebruikerscontext) – u hoeft de computers van de agents niet opnieuw op te starten.

• Uitvoeren met beheerdersrechten – u moet de computers van alle agents opnieuw opstarten.

U kunt een installatielocatie opgeven:

• Standaard wordt ScreenAgent geïnstalleerd op station C in de map \NICE-InContact\ScreenAgent. In de installatieopdracht kunt u een ander installatiepad opgeven.

• Wanneer u upgradet naar een nieuwere versie, kunt u een ander installatiepad opgeven. De vorige versie wordt verwijderd en de nieuwere versie wordt op de opgegeven locatie geïnstalleerd.

• Wanneer dezelfde versie van ScreenAgent opnieuw wordt geïnstalleerd, wordt de bestaande op dezelfde locatie overschreven. Om het installatiepad te wijzigen, maakt u de bestaande installatie ongedaan en geeft u bij het opnieuw installeren ervan de gewenste locatie op.

Sommige ScreenAgent-parameters kunnen na installatie worden gewijzigd. Zie Configuratie van ScreenAgent wijzigen. Om overige installatieparameters bij te werken, moet u de ScreenAgent-client opnieuw installeren.

Om ScreenAgent te upgraden naar een latere versie, moet u ScreenAgent-client installeren. U hoeft de vorige versie niet te verwijderen.

Wanneer u ScreenAgent upgradet of opnieuw installeert, wordt bij het installeren ervan automatisch de bestaande configuratie gebruikt, behalve wanneer u andere parameterinstellingen opgeeft. Zie Opnieuw installeren of upgraden met de huidige configuratie. Wanneer u de installatie van ScreenAgent ongedaan maakt, wordt de configuratie niet bewaard en moet u de installatieparameters opgeven bij upgraden of opnieuw installeren.

Wanneer agents niet worden opgenomen, dient u ScreenAgent te upgraden of opnieuw te installeren. Als een agent tijdens de installatie een oproep afhandelt, wordt de schermopname voor die oproep gestopt. Wanneer de installatie is voltooid, worden oproepen opgenomen volgens het opnamebeleid en Studio-scripts.

Zo installeert u ScreenAgent:

1. Controleer of alle vereisten aanwezig zijn.

2. Open een opdrachtprompt als beheerder. Navigeer naar de map waarin u het MSI-bestand hebt gedownload en voer de installatieopdracht in met de relevante parameters:

   Stap-voor-stap instructies

   1. Ga naar de map waarin u het gedownloade MSI-bestand hebt geplaatst en kopieer het pad van deze map. Dit is meestal de map %UserProfile%\downloads.

   2. Voer de opdrachtprompt uit als beheerder:

      1. Klik in Windows op de Windows-knop en typ cmd.

      2. Klik met de rechtermuisknop op Opdrachtprompt en klik op Uitvoeren als beheerder.

   3. Typ cd/ en druk op Enter.

   4. Typ cd, plak de eerder gekopieerde bestandslocatie en druk op Enter.

      Bijvoorbeeld: cd %UserProfile%\downloads.

   5. Kopieer en plak de opdracht in de opdrachtprompt en bewerk de installatieparameters.

      • Als u geen webproxy hebt, of wanneer de proxy op besturingssysteemniveau is gedefinieerd, gebruikt u deze opdracht:

        msiexec /i ScreenAgent-<32|64>bit-<MSI-versie>.msi INSTALL_PATH=<optioneel: installatiepad> ACCESS_KEY_ID=<toegangssleutel-ID> ACCESS_KEY_SECRET=<geheime toegangssleutel> REGION_TYPE=<subdomein (eerste 3 tekens) van de CXone-URL> RESOLVE_USER=<optioneel: auto|oslogin> FRAME_PER_SECOND=<optioneel: 1, 2, 3, 4 of 5> RESOLUTION_LEVEL=<optioneel: null, laag, medium of hoog> LOAD_CERTIFICATES=<optioneel: true|false> STATISTICS=<optioneel: true|false>/log install.log /quiet

      • Wanneer u proxy-authenticatie gebruikt en de proxy niet is gedefinieerd op besturingssysteemniveau, gebruikt u deze opdracht:

        msiexec /i ScreenAgent-<32|64>bit-<MSI-versie>.msi INSTALL_PATH=<optioneel: installatiepad> ACCESS_KEY_ID=<toegangssleutel-ID> ACCESS_KEY_SECRET=<de geheime toegangssleutel> REGION_TYPE=<subdomein (eerste 3 tekens) van de CXone-URL> WEB_PROXY=<alleen bij gebruik van een proxyserver om verbinding te maken met het internet> RESOLVE_USER=<optioneel: auto|oslogin> FRAME_PER_SECOND=<optioneel: 1, 2, 3, 4 of 5> RESOLUTION_LEVEL=<optioneel: null, laag, medium of hoog> LOAD_CERTIFICATES=<optioneel: true|false> STATISTICS=<optioneel: true|false> /log install.log /quiet

      Voorbeeld van een installatieopdracht (Als u geen webproxy hebt, of wanneer de proxy op besturingssysteemniveau is gedefinieerd):

      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

   Opnieuw installeren of upgraden met de huidige configuratie

   Gebruik deze opdracht:

   msiexec /i ScreenAgent-<32|64>bit-<MSI-versie>.msi KEEP_CURRENT_CONFIG= true

   KEEP_CURRENT_CONFIG= true is optioneel omdat de standaardwaarde voor de parameter true is.

   • Als tijdens de vorige installatie alle instellingen zijn ingesteld, wordt ScreenAgent geïnstalleerd met alle bestaande instellingen.

   • Als tijdens de vorige installatie sommige instellingen ontbraken of niet waren ingesteld, wordt ScreenAgent geïnstalleerd met de bestaande instellingen en standaardwaarden voor de ontbrekende parameters.

   • Het installatiepad wordt na de installatie niet opgeslagen; als het niet in de installatieopdracht wordt opgegeven, wordt ScreenAgent geïnstalleerd op de standaardlocatie, zelfs als KEEP_CURRENT_CONFIG= true.

   Gebruik de bovenstaande opdracht om sommige parameterinstellingen te behouden, andere te wijzigen en overige parameters naar wens toe te voegen. Om bijvoorbeeld alleen frame per seconde en het resolutieniveau te wijzigen, gebruikt u (KEEP_CURRENT_CONFIG=true is optioneel):

   msiexec /i ScreenAgent-64bit-2.2.18.msi KEEP_CURRENT_CONFIG=true FRAME_PER_SECOND=5 RESOLUTION_LEVEL=high

3. Controleer achteraf of de installatie is geslaagd in het logboekbestand. Het bestand install.log bevindt zich in de map waaruit u de MSI hebt geïnstalleerd. Dit is meestal de map %UserProfile%\downloads.

   • Controleer of het installatieprogramma beheerdersrechten heeft.

   • Als de computer van de agent geen Microsoft .NET Framework 4.0 of hoger heeft, moet u dit installeren.

   Het configuratiebestand configFile.ini wordt automatisch verbonden na de installatie. Om het bestand weer te geven en te openen, schakelt u Verborgen items in Windows Verkenner in.

4. Controleer of de agent het attribuut Kan worden opgenomen (scherm) heeft (ga in CXone naar Admin > Medewerkers en klik op de agent). Dit attribuut is nodig om schermopname, schermmonitoring of beide in te schakelen.

5. Neem een gesprek op en controleer het logboekbestand van ScreenAgent. Het bestand ScreenAgent.log bevindt zich op: %appdata%\ScreenAgent\logs\ScreenAgent.log.

   Uw ScreenAgent-logboeken worden ook automatisch geüpload naar de cloud waar deze zo nodig toegankelijk zijn voor het NICE CXonesupportteam.

   Als er fouten zijn, leest u de informatie in Problemen met opnemen oplossen.

Configuratie van Google Chrome-registersleutels voor de afwijzingslijst

Bij gebruik van de Google Chrome-browsers op de machine van de agent wanneer de waarde UiAutomationProviderEnabled niet aanwezig is in de GoogleChrome-registersleutel, worden de URL's in de afwijzingslijst mogelijk niet uitgesloten van opname. Zie Een afwijzingslijst van schermopnames beheren.

De waarde toevoegen aan de registersleutel:

1. Op de machine van de agent moet Chrome-browser 126 of later worden gebruikt.

2. U moet Windows-beheerdersmachtigingen hebben.

3. Controleer of het registerpad HKLM:\SOFTWARE\Policies\Google\Chrome bestaat.

4. Voer de volgende Powershell-scriptregel uit om de waarde toe te voegen aan het Google Chrome-register:

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

Potentiële VDI Remote Apps Workaround

Wanneer agents VDI Remote Apps gebruiken en het proces ScreenAgentWatchDog.exe niet start:

1. Publiceer ScreenAgent.exe naar RemoteApps. Zorg ervoor dat dit alleen toegankelijk is voor beheerders (niet de agents).

2. Maak en publiceer een snelkoppeling naar RemoteApps. Gebruik een script, bijvoorbeeld een van de onderstaande scripts om de browser te openen en ScreenAgentWatchDog.exe uit te voeren. Agents moeten deze snelkoppeling gebruiken om de browser te openen. Als ze dit niet doen, wordt ScreenAgent niet uitgevoerd.

Configuratie van ScreenAgent wijzigen

Na de installatie kunt u enkele ScreenAgent-instellingen nog aanpassen.

1. Open het bestand configFile.ini in de installatiemap van ScreenAgent (meestal C:\Program Files\NICE-InContact\ScreenAgent).

2. Parameterwaarden bewerken:

   • Wijzig de waarde van framePerSecond onder het gedeelte [recordingParameters]. De standaardwaarde voor deze optie is 5.

     Toegestane waarden zijn 1, 2, 3, 4 en 5.

     Als u het aantal frames per seconde vermindert, verminderen de bestandsgrootte, CPU en RAM.

     Frames per seconde	Duur in seconden	Impact op bestandsgrootte/bandbreedte, CPU en RAM (geschat)
     5	Standaard (maximum)	Geen
     4	20% minder	~15% vermindering
     3	40% minder	~30% vermindering
     2	60% minder	~45% vermindering
     1	80% minder	~60% vermindering

   • Wijzig de waarde van resolutionLevelonder het gedeelte [recordingParameters]. Deze waarde is standaard null, de huidige schermresolutie.

     Toegestane waarden zijn null, low, medium en high (niet hoofdlettergevoelig).

     Als u de resolutie vermindert, verminderen de bestandsgrootte, CPU en RAM.

     Resolutieniveau	Vermindering in RESOLUTIE	Impact op bestandsgrootte/bandbreedte, CPU en RAM (geschat)
     Null	Standaard (huidige schermresolutie)	Geen
     Hoog	Schermresolutie / 1,5	~20% vermindering
     Medium	Schermresolutie / 2	~40% vermindering
     Laag	Schermresolutie / 4	~60% vermindering (alleen aanbevolen voor 4K-schermen)

     Als u de schermresolutie wilt resetten, wijzigt u de waarde van resolutionLevel in null.

   • Wijzig de waarde van loadCertificates onder het gedeelte [others]. Standaard is deze waarde true.

     Toegestane waarden zijn true of false.

3. Sla het bestand configFile.ini op.

4. Om de aangepaste instellingen toe te passen, start u de ScreenAgent-applicatie opnieuw:

   1. Beëindig met behulp van Windows Taakbeheer de huidige ScreenAgentWatchDog.exe-taak en beëindig vervolgens de ScreenAgent.exe-processen.

   2. Voer ScreenAgentWatchdog.exe uit vanuit de installatiemap van ScreenAgent.

Verbinding van ScreenAgent controleren

Gebruik het ScreenAgent-hulpprogramma voor controle van connectiviteit voor het uitvoeren van een reeks testen om de netwerktoegang te controleren en zeker te zijn dat ScreenAgent correct zal werken..

• U kunt het hulpprogramma gebruiken vóór of na het installeren van ScreenAgent.

• U kunt de nieuwste versie van het hulpprogramma Verbindingscontrole downloaden vanaf de pagina Downloads.

• Het is raadzaam om deze tool te gebruiken wanneer de netwerkconfiguratie voor een agent is gewijzigd, of wanneer deze afwijkt van de normale configuratie. U hoeft het hulpprogramma niet voor elke agent uit te voeren.

• U kunt het hulpprogramma Controle van connectiviteit meerdere keren uitvoeren met dezelfde opdracht.

• Na elke test wordt succesvol of mislukt weergegeven. Wanneer alle testen zijn uitgevoerd, wordt een overzicht weergegeven met de status van elke test.

• Na het voltooien van de test, maakt de tool voor Controle van connectiviteit een logbestand

• Het hulpprogramma voor Controle van connectiviteit bevat momenteel geen tests voor het controleren van de netwerktoegang voor schermmonitoring in realtime.

1. Download het EXE-bestand voor het hulpprogramma voor Controle van connectiviteit:

   1. Ga naar CXone en log in als een gebruiker met de machtiging Toegang tot supportdownloads.

   2. Klik op uw Gebruikersnaam en selecteer Support en downloads.

   3. Download het vereiste EXE-bestand. Noteer waar u het EXE-bestand downloadt. U hebt de bestandslocatie later nodig.

2. Voer het hulpprogramma Controle van connectiviteit uit.

   1. Voer de opdrachtprompt uit als beheerder.

   2. Kopieer en plak de opdracht in de opdrachtprompt en gebruik de parameters volgens de onderstaande tabel.

      <pad naar exe-bestand> ACCESS_KEY_ID=<ID toegangssleutel> ACCESS_KEY_SECRET=<geheime toegangssleutel> REGION_TYPE=<subdomein (eerste 3 tekens) van de CXone-URL> WEB_PROXY=<optioneel: URL van proxyserver>

      Opdrachtparameters verbindingstool

      Parameter	Beschrijving	Voorbeeld
      pad naar exe. bestand	Locatie van het gedownloade EXE.bestand.	C:%UserProfile%\downloads
      ACCESS_KEY_ID	Plak de toegangssleutel-ID die is gemaakt in de medewerkersaccount. Voor het maken van een toegangssleutel, zie Genereer een toegangssleutel voor ScreenAgent.	ACCESS_KEY_ID=ABCDEF12345====
      ACCESS_KEY_SECRET	Plak de geheime toegangssleutel die is gemaakt in de medewerkersaccount.	ACCESS_KEY_SECRET=12345ABCDEF
      REGION_TYPE	Typ het subdomein (de eerste 3 tekens) van uw CXone URL (bijvoorbeeld: na1, na2, au1, eu1)	REGION_TYPE=na1
      WEB_PROXY	Voeg deze parameter alleen toe als u een proxyserver gebruikt om verbinding te maken met het internet. Host kan een hostnaam of een IP-adres zijn Gebruik http of https volgens uw proxy-instellingen Gebruik gebruikersnaam en wachtwoord van de server als dit is ingesteld in uw proxy-instellingen	WEB_PROXY=http://admin:pwd@168.63.76.32:3128 WEB_PROXY=https://proxyserver:8088

   Voorbeeld van een opdracht:

   C:%UserProfile%\downloads ACCESS_KEY_ID=ABCDEF12345==== ACCESS_KEY_SECRET=12345ABCDEF REGION_TYPE=na1 WEB_PROXY=https://proxyserver:8088

3. Het hulpprogramma voor controle van connectiviteit begint met het uitvoeren van de testen. Na elke test wordt succesvol of mislukt weergegeven. Als een test is mislukt, wordt de reden voor het mislukken weergegeven. Wanneer alle testen zijn uitgevoerd, wordt een overzicht weergegeven waarin voor elke test wordt vermeld of deze is geslaagd, mislukt of niet hoefde te worden uitgevoerd (n.v.t.). Wanneer bijvoorbeeld ScreenAgent niet op de achtergrond werd uitgevoerd op het moment dat het hulpprogramma voor controle van connectiviteit, hoeven de testen om ScreenAgent te sluiten en opnieuw te starten niet te worden uitgevoerd.

   Afbeelding weergeven

   

   Wanneer de testen zijn voltooid, maakt het hulpprogramma voor Controle van connectiviteit een logbestand (SA_Connectivity_tool_log_<runUniqueUUID>) aan in dezelfde map waarin het installatiebestand van het hulpprogramma staat. Het logboekbestand bevat alle informatie die is weergegeven bij de opdrachtprompt.

Verbindingstests

 

Parameters voor de installatieopdracht

Parameter	Beschrijving	Voorbeeld
msiexec /i ScreenAgent-32bit-<MSI version>.msi	32bit of 64bit Als u installeert op een computer met: 32-bits Windows geïnstalleerd, voert u 32bit in 64-bits Windows geïnstalleerd, voert u 64bit in MSI-versie Typ de MSI-versie van het installatiebestand dat u hebt gedownload vanaf de pagina Support en downloads. Bijvoorbeeld 3.0.22.	msiexec /i ScreenAgent-64bit-3.0.22.msi   msiexec /i ScreenAgent-32bit-3.0.22.msi
KEEP_CURRENT_CONFIG	(Optioneel) Standaard wordt bij het opnieuw installeren of upgraden van ScreenAgent de huidige configuratie gebruikt. Zie Opnieuw installeren of upgraden met de huidige configuratie. Wanneer ingesteld op false, wordt bij het installeren van ScreenAgent de bestaande configuratie niet gebruikt. Tijdens het installeren worden alle opgegeven parameters en standaardwaarden voor parameters zonder configuratie gebruikt. De standaardwaarde is true. Voor een schone installatie, worden voor parameters standaardwaarden zonder configuratie gebruikt.	KEEP_CURRENT_CONFIG=true
INSTALL_PATH	(Optioneel) U kunt het installatiepad opgeven. De installatiebestanden worden opgeslagen in de map \NICE-InContact\ScreenAgent onder het opgegeven installatiepad. Wanneer u deze parameter niet toevoegt, wordt ScreenAgent geïnstalleerd met het standaard installatiepad op station C, zelfs als KEEP_CURRENT_CONFIG= true.	INSTALL_PATH=d:\newdir
ACCESS_KEY_ID	Plak de toegangssleutel-ID die is gemaakt in de medewerkersaccount. Voor het maken van een toegangssleutel, zie Genereer een toegangssleutel voor ScreenAgent.	ACCESS_KEY_ID=ABCDEF12345====
ACCESS_KEY_SECRET	Plak de geheime toegangssleutel die is gemaakt in de medewerkersaccount.	ACCESS_KEY_SECRET=12345ABCDEF
REGION_TYPE	Typ het subdomein (de eerste 3 tekens) van uw CXone URL (bijvoorbeeld: na1, na2, au1, eu1)	REGION_TYPE=na1
STATISTICS	(Optioneel) Deze waarde is standaard ingesteld op true en hiermee kan ScreenAgent gegevens verzamelen vanaf de machines van gebruikers (RAM, CPU). Als u niet wilt dat ScreenAgent gegevens verzamelt, kunt u deze waarde wijzigen in false. Toegestane waarden zijn true en false. U kunt deze configuratie nog wijzigen na de installatie.	STATISTICS=true
WEB_PROXY	Voeg deze parameter alleen toe als u een proxyserver gebruikt om verbinding te maken met het internet. Belangrijk: Host kan een hostnaam of een IP-adres zijn Gebruik http of https volgens uw proxy-instellingen Gebruik gebruikersnaam en wachtwoord van de server als dit is ingesteld in uw proxy-instellingen Bijvoorbeeld: http://server_username:server_password@host:port https://server_username:server_password@host:port https://host:port Wanneer u een proxy-URL gebruikt met een proxy PAC-bestand, voegt u de prefix pac+ aan het begin van de proxy-URL toe. Als bijvoorbeeld de proxy-URL https://<proxy server>.pac is, gebruikt u: WEB_PROXY=pac+https://<proxy server>.pac	WEB_PROXY=http://admin:pwd@168.63.76.32:3128     WEB_PROXY=https://proxyserver:8088
RESOLVE_USER	(Optioneel) Configureer RESOLVE_USER=oslogin om inloggen bij besturingssysteem van de agent te gebruiken. In deze modus maakt ScreenAgent verbinding met de server met de informatie voor inloggen bij besturingssysteem van de agent. Dit werkt bij geavanceerde configuraties, zoals CXone Multi-ACD (CXone Open) en multi-sessie systeemomgevingen. Wanneer inloggen bij besturingssysteem wordt gebruikt, gebruikt ScreenAgent poort 31322 niet. Wanneer u deze parameter niet toevoegt, wordt ScreenAgent geïnstalleerd met de standaardwaarde, auto, en wordt er vertrouwd op de CXone-clients (MAX, CXone Agent, enzovoort) om verbinding met de server te maken. In deze modus gebruikt ScreenAgent poort 31322 om verbinding te maken met de CXone-client. Het inloggen bij besturingssysteem van de agent wordt gedefinieerd op het tabblad Algemeen van configuratie Medewerker in de indeling Domein\Gebruikersnaam.	RESOLVE_USER=oslogin
FRAME_PER_SECOND	(Optioneel) U kunt het aantal opgenomen frames per seconde instellen voor het opgenomen MP4-bestand. Als u deze parameter niet toevoegt, wordt ScreenAgent geïnstalleerd met de standaardwaarde, 5 frames per seconde. Toegestane waarden zijn 1, 2, 3, 4 en 5. Als u het aantal frames per seconde vermindert, verminderen de bestandsgrootte, bandbreedte CPU en RAM. U kunt deze configuratie na de installatie nog aanpassen.	FRAME_PER_SECOND=3
RESOLUTION_LEVEL	(Optioneel) U kunt de resolutie van het opgenomen MP4-bestand instellen om het RAM- en CPU-verbruik te optimaliseren. Als u deze parameter niet toevoegt, wordt ScreenAgent geïnstalleerd met de standaardinstelling voor de resolutie, null, de huidige schermresolutie. Toegestane waarden zijn null, low, medium en high (niet hoofdlettergevoelig). Als u de resolutie vermindert, verminderen de bestandsgrootte, CPU en RAM. U kunt deze configuratie na de installatie nog aanpassen.	RESOLUTION_LEVEL=low
LOAD_CERTIFICATES	(Optioneel) Stel deze parameter in op false als ScreenAgent geen toegang mag krijgen en zelfondertekende certificaten moet laden vanaf het certificatenarchief van Windows. Toegestane waarden zijn true of false. Als u deze parameter niet toevoegt, krijgt ScreenAgent toegang tot zelfondertekende certificaten van het Windows-certificatenarchief. U kunt deze configuratie na de installatie nog aanpassen.	LOAD_CERTIFICATES=false
/log install.log	Schrijft de installatieresultaten naar het logbestand.	/log install.log
/quiet	(Optioneel) Voeg dit toe als u popups tijdens de installatie wilt onderdrukken. U kunt de installatieresultaten achteraf bekijken in het logbestand.	/quiet