ESTOS ProCall: Unterschied zwischen den Versionen

Aus SiteparkWiki
Zur Navigation springen Zur Suche springen
(Die Seite wurde neu angelegt: „= Installation und Einrichtung der ENetTSC Bibliothek = == ProCall Client Installation == Für die Kommunikation vom Arbeitsplatzrechner zum ProCall-Server mus…“)
 
Zeile 1: Zeile 1:
= Installation und Einrichtung der ENetTSC Bibliothek  =
+
= Anmerkung =
 +
<div class="note">
 +
Ab der <b>Version 1.1</b> des CTI-Moduls sollte die ENetTSC durch die IWebTSC ersetzt werden. Für eine Umstellung müssen aktualisierte XIP-Pakete eingespielt werden. Bitte kontaktieren Sie unseren Support diesbezüglich.
 +
</div>
 +
 
 +
= Installation und Einrichtung der IWebTSC Bibliothek  =
 +
 
 +
== Funktionsweise ==
 +
Ab der Version 1.1 des CTI-Moduls wird die, für die CTI-Kommunikation, benötigte ActiveX-Komponente automatisch aus dem Modul installiert. Dies geschieht mit Hilfe des [http://msdn.microsoft.com/en-us/library/ie/ms533576(v=vs.85).aspx codeBase]-Attributs.
 +
 
 
== ProCall Client Installation ==
 
== ProCall Client Installation ==
  
Für die Kommunikation vom Arbeitsplatzrechner zum  ProCall-Server muss im ersten Schritt der ProCall Client der Firma ESTOS installiert werden. Die Version des Clients muss der Server-Version entsprechen. Getestet wurde die Version 4.0.2.1033 des ProCall-Client. Die Client-Installations-Pakete befinden sich innerhalb des Server-Installations-Pfades und heißen 'UCClient_de.msi'
+
Die Installation des ProCall-Clients ist für die IWebTSC-Schnittstelle nur noch optional. Sie dient lediglich zu Konfiguration des Arbeitsplatzes.
 +
 
 +
Die Version des Clients muss der Server-Version entsprechen. Getestet wurde die Version 4.1, 5.0.1, 5.0.2 des ProCall-Client. Die Client-Installations-Pakete befinden sich innerhalb des Server-Installations-Pfades und heißen 'UCClient_de.msi'
  
 
Im Anschluss muss die Setup-Datei „UCClient_de.msi“ ausgeführt werden. Das Setup ist sowohl für 32-Bit als auch 64-Bit Systeme geeignet. Nachdem das Setup initialisiert wurde und  den Lizenzbestimmungen zugestimmt wurde, muss ausgewählt werden welcher TAPI-Treiber installiert werden soll. Welcher Treiber  installiert werden muss, muss am besten mit dem verantwortlichen Administrator geklärt werden (ggf die Standardeinstellungen verwenden).
 
Im Anschluss muss die Setup-Datei „UCClient_de.msi“ ausgeführt werden. Das Setup ist sowohl für 32-Bit als auch 64-Bit Systeme geeignet. Nachdem das Setup initialisiert wurde und  den Lizenzbestimmungen zugestimmt wurde, muss ausgewählt werden welcher TAPI-Treiber installiert werden soll. Welcher Treiber  installiert werden muss, muss am besten mit dem verantwortlichen Administrator geklärt werden (ggf die Standardeinstellungen verwenden).
Zeile 8: Zeile 19:
 
Im nächsten Installationsschritt wird die Serveradresse des ProCall Servers über die „Server
 
Im nächsten Installationsschritt wird die Serveradresse des ProCall Servers über die „Server
 
suchen…“ – Schaltfäche ermittelt und gespeichert.
 
suchen…“ – Schaltfäche ermittelt und gespeichert.
 
== SDK Installieren  ==
 
Für eine funktionsfähige Anbindung an den ProCall Server über ActiveX muss zunächst das ProCall-SDK (in der Version des Server ) von [http://www.estos.de/] heruntergeladen werden.
 
 
Nach dem Download müssen folgende Dateien aus dem Archiv entpackt werden:
 
 
*für 32Bit Systeme:
 
/ENetTSC/Win32/Release/ENetTSC.dll -&gt; C:\Windows\System32
 
 
*für 64Bit Systeme:
 
/ENetTSC/x64/Release/ENetTSC.dll -&gt; C:\Windows\SysWOW64
 
 
Die ENetTSC.dll muss für den Zugriff aus dem Internet Explorer nun noch am System angemeldet werden. Hierzu in einer Eingeabeaufforderung mit '''Administrator-Rechten''' folgende Kommandos ausführen:
 
 
*für 32Bit Systeme:
 
<source lang="dos">
 
cd C:\Windows\System32
 
regsvr32 ENetTSC.dll
 
</source>
 
 
*für 64Bit Systeme:
 
<source lang="dos">
 
cd C:\Windows\SysWOW64
 
regsvr32 ENetTSC.dll
 
</source>
 
 
Nachdem die Bibliothek nun am System angemeldet ist, kann der Internet Explorer auf die Klassen der Bibliothek zugreifen.
 
  
 
== Internet Explorer Einstellungen  ==
 
== Internet Explorer Einstellungen  ==
Zeile 54: Zeile 38:
 
'''Die ActiveX-Einstellungen müssen wie folgt gesetzt sein:'''<br>
 
'''Die ActiveX-Einstellungen müssen wie folgt gesetzt sein:'''<br>
 
[[Image:Sicherheitseinstellungen.jpg]]<br>  
 
[[Image:Sicherheitseinstellungen.jpg]]<br>  
 +
 +
== Problemanalyse ==
 +
=== Installation überprüfen ===
 +
Durch die Vielfältigkeit der Einstellung von Nutzer-Rechten unter Windows kann es sein, dass eine automatische Installation der ActiveX-Komponente fehl schlägt.
 +
Ein weiterer Grund für eine nicht korrekte Installation können veraltete Templates sein.
 +
Um zu überprüfen, ob die Installation erfolgreich war kann folgender JavaScript Code in der Entwicklerkonsole ausgeführt werden:
 +
 +
<syntaxhighlight lang="javascript">
 +
if (idIWebTSC.hasOwnProperty('lastLoginResult')) {
 +
  alert("Installation war erfolgreich");
 +
} else {
 +
  alert("Installation war nicht erfolgreich");
 +
}
 +
</syntaxhighlight>
 +
 +
=== Deinstallation ===
 +
Eine Deinstallation kann wie folgt durchgeführt werden:
 +
 +
=== Anlagenstatus überprüfen ===
 +
Sollte die Installation funktioniert haben, aber eine Bedienung der CTI weiterhin nicht möglich ist, kann es sein, dass bei der Kommunikation der ActiveX-Komponente und dem ProCall-Server Fehler aufgetreten sind.
 +
Um den Status besser auszuwerten zu können, kann folgender JavaScript Code in der Entwicklerkonsole ausgeführt werden:
 +
 +
<syntaxhighlight lang="javascript">
 +
var codes = {
 +
  0  : "OK",
 +
  100: "INTERNAL_SERVER_ERROR",
 +
  101: "INVALID_USERNAME",
 +
  102: "INVALID_PASS",
 +
  103: "NO_MORE_USERS",
 +
  104: "INVALID_VERSION",
 +
  105: "NEGOTIATION_REQUIRED",
 +
  106: "INVALID_AUTHENTICATION_METHOD",
 +
  107: "USER_NOT_ENABLED",
 +
  108: "INVALID_COMPUTERNAME",
 +
  109: "DOMAIN_AUTH_FAILED",
 +
  110: "MISSING_RIGHTS",
 +
  111: "MISSING_RIGHTS_TS",
 +
  112: "SERVER_NOT_COMPATIBLE",
 +
  113: "ALREADY_AUTHENTICATED",
 +
  114: "TLS_REQUIRED",
 +
  115: "TLS_EXPIRED",
 +
  116: "TLS_VALIDITY_PERIOD_NESTING",
 +
  117: "TLS_PURPOSE",
 +
  118: "TLS_UNTRUSTED_ROOT",
 +
  119: "TLS_CHAINING",
 +
  120: "TLS_REVOKED",
 +
  121: "TLS_UNTRUSTED_TEST_ROOT",
 +
  122: "TLS_CN_NO_MATCH",
 +
  123: "TLS_WRONG_USAGE",
 +
  124: "SERVER_CONNECTION_OK",
 +
  125: "NOT_CONNECTED",
 +
  126: "SERVER_BUSY_TIMEOUT",
 +
  127: "DOMAIN_AUTH_NOT_ENABLED"
 +
}
 +
alert(codes[idIWebTSC.lastLoginResult]);
 +
</syntaxhighlight>
 +
 +
=== Event-Binding überprüfen ===
 +
Sollte die CTI grundsätzlich funktionieren, allerdings keine Status-Änderungen visualisiert werden, kann das EventBinding mit folgender JavaScript Funktion überprüft werden:
 +
 +
<syntaxhighlight lang="javascript">
 +
var status = false;
 +
  if (idIWebTSC.attachEvent) {
 +
    alert("Using attachEvent. Everything ok.");
 +
    status = true;
 +
  } else if (document.querySelectorAll('script[for="idIWebTSC"]').length > 0) {
 +
    alert("Using script-tag events. Everything ok.");
 +
    status = true;
 +
  }
 +
  if (status === false) {
 +
    alert("EventBinding failed!");
 +
  }
 +
</syntaxhighlight>
  
 
<noinclude>
 
<noinclude>
 
[[Kategorie:Telefonie]]
 
[[Kategorie:Telefonie]]
 
</noinclude>
 
</noinclude>

Version vom 14. Oktober 2014, 16:24 Uhr

Anmerkung

Ab der Version 1.1 des CTI-Moduls sollte die ENetTSC durch die IWebTSC ersetzt werden. Für eine Umstellung müssen aktualisierte XIP-Pakete eingespielt werden. Bitte kontaktieren Sie unseren Support diesbezüglich.

Installation und Einrichtung der IWebTSC Bibliothek

Funktionsweise

Ab der Version 1.1 des CTI-Moduls wird die, für die CTI-Kommunikation, benötigte ActiveX-Komponente automatisch aus dem Modul installiert. Dies geschieht mit Hilfe des codeBase-Attributs.

ProCall Client Installation

Die Installation des ProCall-Clients ist für die IWebTSC-Schnittstelle nur noch optional. Sie dient lediglich zu Konfiguration des Arbeitsplatzes.

Die Version des Clients muss der Server-Version entsprechen. Getestet wurde die Version 4.1, 5.0.1, 5.0.2 des ProCall-Client. Die Client-Installations-Pakete befinden sich innerhalb des Server-Installations-Pfades und heißen 'UCClient_de.msi'

Im Anschluss muss die Setup-Datei „UCClient_de.msi“ ausgeführt werden. Das Setup ist sowohl für 32-Bit als auch 64-Bit Systeme geeignet. Nachdem das Setup initialisiert wurde und den Lizenzbestimmungen zugestimmt wurde, muss ausgewählt werden welcher TAPI-Treiber installiert werden soll. Welcher Treiber installiert werden muss, muss am besten mit dem verantwortlichen Administrator geklärt werden (ggf die Standardeinstellungen verwenden).

Im nächsten Installationsschritt wird die Serveradresse des ProCall Servers über die „Server suchen…“ – Schaltfäche ermittelt und gespeichert.

Internet Explorer Einstellungen

Damit eine reibungslose Kommunikation zwischen ProCall Server und ActiveX Komponente im Browser funktionieren kann, müssen einige Einstellungen am Internet Explorer vorgenommen werden. Die Rechtekonfiguration für ActiveX Komponenten kann an verschiedenen stellen stattfinden. Hier der präferierte Weg:

Die Konfiguration der Sicherheitseinstellungen erfolgt über die Zoneneinstellungen. Dafür muss zunächst die Domain auf der die ActiveX-Komponente aufgerufen wird, in die Liste der vertrauenswürdigen Sites eingetragen werden.

Im Internet Explorer Einstellungsfenster unter Sicherheit. Menüpunkt "Vertrauenwürdige Sites".
Zoneneinstellungen.jpg

Domain auf der die ActiveX-Komponente aufgerufen wird, in die Liste der vertrauenswürdigen Sites eingetragen
Domain hinzufuegen.jpg

Danach müssen noch die Sicherheitseinstellungen für diese Zone vorgenommen werden.
Stufe anpassen.jpg

Die ActiveX-Einstellungen müssen wie folgt gesetzt sein:
Sicherheitseinstellungen.jpg

Problemanalyse

Installation überprüfen

Durch die Vielfältigkeit der Einstellung von Nutzer-Rechten unter Windows kann es sein, dass eine automatische Installation der ActiveX-Komponente fehl schlägt. Ein weiterer Grund für eine nicht korrekte Installation können veraltete Templates sein. Um zu überprüfen, ob die Installation erfolgreich war kann folgender JavaScript Code in der Entwicklerkonsole ausgeführt werden:

if (idIWebTSC.hasOwnProperty('lastLoginResult')) {
  alert("Installation war erfolgreich");
} else {
  alert("Installation war nicht erfolgreich");
}

Deinstallation

Eine Deinstallation kann wie folgt durchgeführt werden:

Anlagenstatus überprüfen

Sollte die Installation funktioniert haben, aber eine Bedienung der CTI weiterhin nicht möglich ist, kann es sein, dass bei der Kommunikation der ActiveX-Komponente und dem ProCall-Server Fehler aufgetreten sind. Um den Status besser auszuwerten zu können, kann folgender JavaScript Code in der Entwicklerkonsole ausgeführt werden:

var codes = {
  0  : "OK",
  100: "INTERNAL_SERVER_ERROR",
  101: "INVALID_USERNAME",
  102: "INVALID_PASS",
  103: "NO_MORE_USERS",
  104: "INVALID_VERSION",
  105: "NEGOTIATION_REQUIRED",
  106: "INVALID_AUTHENTICATION_METHOD",
  107: "USER_NOT_ENABLED",
  108: "INVALID_COMPUTERNAME",
  109: "DOMAIN_AUTH_FAILED",
  110: "MISSING_RIGHTS",
  111: "MISSING_RIGHTS_TS",
  112: "SERVER_NOT_COMPATIBLE",
  113: "ALREADY_AUTHENTICATED",
  114: "TLS_REQUIRED",
  115: "TLS_EXPIRED",
  116: "TLS_VALIDITY_PERIOD_NESTING",
  117: "TLS_PURPOSE",
  118: "TLS_UNTRUSTED_ROOT",
  119: "TLS_CHAINING",
  120: "TLS_REVOKED",
  121: "TLS_UNTRUSTED_TEST_ROOT",
  122: "TLS_CN_NO_MATCH",
  123: "TLS_WRONG_USAGE",
  124: "SERVER_CONNECTION_OK",
  125: "NOT_CONNECTED",
  126: "SERVER_BUSY_TIMEOUT",
  127: "DOMAIN_AUTH_NOT_ENABLED"
}
alert(codes[idIWebTSC.lastLoginResult]);

Event-Binding überprüfen

Sollte die CTI grundsätzlich funktionieren, allerdings keine Status-Änderungen visualisiert werden, kann das EventBinding mit folgender JavaScript Funktion überprüft werden:

 var status = false;
  if (idIWebTSC.attachEvent) {
    alert("Using attachEvent. Everything ok.");
    status = true;
  } else if (document.querySelectorAll('script[for="idIWebTSC"]').length > 0) {
    alert("Using script-tag events. Everything ok.");
    status = true;
  }
  if (status === false) {
    alert("EventBinding failed!");
  }