1. XPhone CTI vtapi 1. Virtuelle TAPI- Schnittstelle (vtapi)

Transkript

1 1. XPhone CTI vtapi 1 Virtuelle TAPI- Schnittstelle (vtapi)

2 2 1. XPhone CTI vtapi Inhalt 1 XPhone CTI vtapi 3 2 Systemvoraussetzungen Systemvoraussetzungen von Server und Client Unterstützte TAPI-Versionen Einschränkungen 4 3 Inbetriebnahme TAPI TAPI Funktionsumfang 6 5 Funktionsweise 7 6 Problembehandlung Registry Rufnummernformate Logging Tools 8 7 Assisted TAPI 9 8 Anhang: Erstellen einer *.local Datei 9 9 Anhang: Funktionsübersicht TAPI-Funktionen 9

3 1. XPhone CTI vtapi 3 1 XPhone CTI vtapi XPhone CTI vtapi stellt TAPI-kompatiblen Anwendungen einen virtuellen TAPI-Link bereit, der die direkte Kommunikation der Anwendung mit dem XPhone Server ermöglicht. Vorteile: Es ist keine Windows Domäne erforderlich, die Konfiguration des Microsoft Remote TSP entfällt Es sind keine benutzerspezifischen TAPI-Einstellungen wie Länder-/Ortsvorwahl etc. am Client erforderlich Jeder Benutzer kann nur genau die Leitungen sehen, die für ihn am Server eingerichtet wurden Der XPhone Server ist Multi-PBX- und mehrstandortfähig, somit auch der XPhone TAPI-Link XPhone CTI vtapi ist terminalserverfähig Single-Sign-On und XPhone Server Anmeldung werden unterstützt Es wird nur eine vtapi Lizenz je Benutzer benötigt, selbst wenn mehrere Anwendungen vtapi verwenden oder mehrere Terminal-Server im Einsatz sind 2 Systemvoraussetzungen 2.1 Systemvoraussetzungen von Server und Client Server: Betriebsbereiter XPhone Server Pro Benutzer wird eine Lizenz XPhone CTI vtapi benötigt (im Lieferumfang von XPhone CTI Team V2 enthalten) Client: Windows-Betriebssystem Windows 2000 Workstation SP4, Windows XP Professional SP2, Windows Vista, Windows Terminal-Server, Citrix Metaframe. Installiertes Produkt XPhone CTI vtapi vtapi kompatibler Client Wenden Sie sich an den Produktsupport, wenn Sie nicht wissen, ob Ihre TAPI-Anwendung kompatibel zu vtapi ist

4 4 2. Systemvoraussetzungen 2.2 Unterstützte TAPI-Versionen C4B vtapi unterstützt Anwendungen, die folgende TAPI-Versionen voraussetzen: TAPI 1.4 TAPI 2.0 TAPI 2.1 TAPI 2.2 TAPI 3.0 TAPI Einschränkungen vtapi ist kein TAPI-Service-Provider. Somit ist der Einsatz in bestimmten Fällen prinzipbedingt nicht möglich. Die Voraussetzung, dass vtapi funktioniert ist, dass die Ladereihenfolge von Programmbibliotheken für eine Applikation so verändert werden kann, dass die mit vtapi gelieferte TAPI32.DLL, statt der mit dem Betriebssystem gelieferten TAPI32.DLL, geladen wird. Anwendungen, die vtapi verwenden, können ausser interaktiven Telefoniefunktionen keine weiteren TAPI-Funktionen (z.b. DFÜ) nutzen. Prüfen Sie, ob die vorhandenen Anwendungen auch nach der Inbetriebnahme von vtapi ordnungsgemäß funktionieren

5 3. Inbetriebnahme 5 3 Inbetriebnahme Voraussetzung für die Funktion von vtapi ist, dass die mit vtapi gelieferte tapi32.dll bzw. tapi3.dll von der TAPI-Client-Anwendung geladen wird. Bestimmte TAPI-Aufrufe werden von der mit vtapi gelieferten tapi32.dll bzw. tapi3.dll L in die originale tapi32.dll bzw. tapi3.dll weitergeleitet. Bitte stellen Sie sicher, dass die Wahlparameter unter Systemsteuerung->Telefon- und Modemoptionen korrekt konfiguriert sind. Nach der Installation von vtapi befinden sich die installierten Dateien im Verzeichnis C:\Programme\Gemeinsame Dateien\C4B\vTAPI. Für die Inbetriebnahme von XPhone CTI vtapi wird unterschieden, ob TAPI32 oder TAPI3 verwendet werden soll. 3.1 TAPI 32 Es gibt 2 Möglichkeiten zur Inbetriebnahme von TAPI32 a) tapi32.dll ins Anwendungsverzeichnis kopieren Dies ist in der Regel ausreichend. Andernfalls hilft die zusätzliche Erstellung einer *.local-datei im relevanten Anwendungsverzeichnis (<application>.exe.local). Nähere Informationen zur Erstellung einer.local Datei finden Sie unter Erstellen einer *.local Datei Siehe "Anhang: Erstellen einer *.local Datei" b) Manifest erstellen Benennen Sie die sich unter C:\Programme\Gemeinsame Dateien\C4B\vTAPI befindliche Manifest- Datei your_tapi32_application.exe.manifest in <application>.exe.manifest um und kopieren Sie sie in das Anwendungsverzeichnis 3.2 TAPI 3 Es gibt 3 Möglichkeiten zur Inbetriebnahme von TAPI3 a).local Datei erzeugen Diese Möglichkeit funktioniert möglicherweise nicht bei allen Anwendungen. tapi3.dll in das Anwendungsverzeichnis kopieren +.local Datei für die Anwendung erstellen (<application>.exe.local). Nähere Informationen zur Erstellung einer.local Datei finden Sie unter Erstellen einer *.local Datei Siehe "Anhang: Erstellen einer *.local Datei" b) Manifest erstellen Diese Möglichkeit funktioniert möglicherweise nicht bei allen Anwendungen Benennen Sie die sich unter C:\Programme\Gemeinsame Dateien\C4B\vTAPI befindliche Manifest- Datei your_tapi3_application.exe.manifest in <application>.exe.manifest um und kopieren Sie sie in das Anwendungsverzeichnis c) vtapi global für alle Anwendungen aktivieren (für TAPI3) Diese Möglichkeit funktioniert immer, wirkt aber systemweit. Nach der vtapi-installation befinden sich unter C:\Programme\Gemeinsame Dateien\C4B\vTAPI die Dateien TAPI3_install.bat/ TAPI3_uninstall.bat, mit denen man die Aktivierung als lokaler Admin (Schreibrechte in der Windowsregistrierung auf HKEY_LOCAL_MACHINE) vornehmen kann.

6 6 4. Funktionsumfang Hinweis: TAPI 3 besteht im Kern aus zwei Objekten, RequestMakeCall (für Anwendungen, die nur wählen möchten, kein Monitoring) und TAPI (alle anderen Anwendungen). Die globale Aktivierung für ersteren erfolgt mit /i:r, für die letzteren mit /i:t. Die im vtapi Installationsverzeichnis enthaltenen Batchfiles aktivieren stets beide Typen, aber möglicherweise will/darf man nur einen Typ verwenden. Durch Uninstall werden stets beide Typen deaktiviert. 4 Funktionsumfang Zur Steuerung und Überwachung können alle eigenen Leitungen eines Benutzers verwendet werden. Unterstützte Telefoniefunktionen sind: Wählen Annehmen Auflegen Anzeige aller Calls und deren Zustände, Rufnummer (CalledID, CallerID, RedirectingID, RedirectionID) Anzeige des Anrufernamens, wenn dieser durch das zentrale Adressbuch des XPhone Server aufgelöst wird. Anzeige der Anrufumleitung Eine genaue Funktionsübersicht befindet sich im Anhang.

7 5. Funktionsweise 7 5 Funktionsweise Die virtuelle TAPI-Schnittstelle ersetzt die tapi32.dll bzw. tapi3.dll des Betriebssystems. Aufrufe bleiben innerhalb des User-Kontexts. Auf diese Weise stehen auch im Terminal-Server-Umfeld alle Security- Funktionen des XPhone Server zur Verfügung. 6 Problembehandlung 6.1 Registry Der Schlüssel [HKEY_LOCAL_MACHINE\Software\C4B\Telephony\XpTel<vTAPI>\<application key>] enthält zwei variable Parameter: <vtapi> steht für den Typ der vtapi-variante, d.h. entweder TAPI32 oder TAPI3. Für jede Clientapplikation verwendet vtapi einen eigenen Registrierungsschlüssel, der durch den Parameter <application key> unterschieden wird. Dieser Anwendungsschlüssel ist der vollständige Pfad auf die Anwendung. Beispiel: [HKEY_CURRENT_USER\Software\C4B\Telephony\XpTelTAPI32\c:/Programme/Microsoft Office/Office11/outlook.exe] Unter [HKEY_LOCAL_MACHINE\Software\C4B\Telephony\XpTel<vTAPI>\<application key>] können ebenfalls Einstellungen für vtapi vorgenommen werden. Da der Schlüssel dort nicht existiert muss er zuerst angelegt werden. Es empfiehlt sich, dazu den <application key> aus HKEY_CURRENT_USER zu kopieren. Der Key existiert dort, sobald der Benutzer schon einmal vtapi mit der Ziel-Anwendung verwendet hat.

8 8 6. Problembehandlung 6.2 Rufnummernformate Die mit XPhone CTI vtapivtapi gewählten Rufnummern werden per Default so behandelt wie TAPI wählt, d.h. sie werden ohne weitere Konvertierung an die Telefonanlage geschickt. Das korrekte Format wird dabei vom Client bestimmt, entweder aufgrund der Wahlparameter unter Systemsteuerung->Telefonund Modemoptionen oder aufgrund eigener Einstellungen des Clients. Dieses Verhalten läßt sich über den untenstehenden Registry-Key verändern: [HKEY_LOCAL_MACHINE\Software\C4B\Telephony\XpTel<vTAPI>\<application>] Name: "InternalAddressTranslation" Typ: String Wert: "-1" wobei die folgenden Werte zulässig sind: -1 (default): Auto: Nur Rufnummern die vom Client offensichtlich NICHT konvertiert wurden werden gemäß der XPhone-Regeln konvertiert 0: Aus: Die Rufnummern werden NIE gemäß der XPhone-Regeln konvertiert 1: Ein: Die Rufnummern werden IMMER gemäß der XPhone-Regeln konvertiert 6.3 Logging Unter [HKEY_CURRENT_USER\Software\C4B\Telephony\XpTel<vTAPI>\<application key>] werden pro User bestimmte Einstellungen und Aktivitäten automatisch mitprotokolliert. Zu sehen ist hier u.a. die zuletzt gewählte Nummer, wie sie vom Client an die TAPI-Schnittstelle übergeben wurde ("LastTranslateAddress"). Zur detaillierten Analyse von Problemen kann hier die Erstellung einer Protokolldatei aktiviert werden. Erstellen Sie hierzu den folgenden Registrierungseintrag: [HKEY_CURRENT_USER\Software\C4B\Log\vTAPI] Name: "EnableFileLog" Typ: dword Wert: "1" Die generierten Protokolldateien befinden sich als Textdateien (Log_vTapi_<vTAPI>_<Anwendung>_<Datum Zeit>.txt) anschließend im Verzeichnis C:\Dokumente und Einstellungen\<Benutzer>\Lokale Einstellungen\Anwendungsdaten\C4B\Log. 6.4 Tools Im Setup von XPhone CTI vtapi gibt es die Möglichkeit, eine Simulationsanwendung für XPhone CTI vtapi mitzuinstallieren. Dadurch werden u.a. Demotel und Phone.exe installiert. Bitte beachten Sie hierzu die separate Anleitung zur Verwendung von Demotel.

9 7. Assisted TAPI 9 7 Assisted TAPI vtapi fängt die "Assisted TAPI"-Aufrufe (tapirequestmakecall) der Applikation ab und führt sie sofort aus. Dies bedeuted, dass die für "Assisted TAPI" registrierte Anwendung (standardmäßig ist das die Window- Wählhilfe) nicht verwendet wird. 8 Anhang: Erstellen einer *.local Datei Um eine *.local Datei zu erzeugen, erstellen Sie zunächst eine leere Textdatei. Benennen Sie anschließend die Datei um in <application>.exe.local, wobei <application> durch den Namen der Anwendung ersetzt wird, die vtapi verwenden soll. Beispiel: Outlook.exe.local Hinweis: Bitte beachten Sie, dass im Windows-Explorer die Dateiendungen angezeigt werden müssen. Stellen Sie dies sonst ggf. im Window-Explorer ein über Extras->Ordneroptionen->Ansicht. 9 Anhang: Funktionsübersicht TAPI- Funktionen XPhone CTI vtapi Version 3.1 Build = wird unterstützt, - = wird nicht unterstützt, (+) = wird teilweise unterstützt Basic Line Device Services lineanswer + lineclose + lineconfigdialog - lineconfigdialogedit - linedeallocatecall + linedial - linedrop + linegetaddresscaps +

10 10 9. Anhang: Funktionsübersicht TAPI-Funktionen linegetaddressid - linegetaddressstatus + linegetcallinfo + linegetcallstatus + linegetconfrelatedcalls - linegetcountry + linegetdevcaps + linegetdevconfig - linegeticon + linegetid + linegetlinedevstatus + linegetmessage + linegetnewcalls (+) linegetnumrings - linegetrequest + linegetstatusmessages + linegettranslatecaps + linehandoff - lineinitialize + lineinitializeex + linemakecall + linenegotiateapiversion + lineopen + lineregisterrequestrecipient - linesetappspecific - linesetcallprivilege + linesetcurrentlocation - linesetdevconfig - linesetnumrings - linesetstatusmessages + linesettolllist - lineshutdown +

11 9. Anhang: Funktionsübersicht TAPI-Funktionen 11 linetranslateaddress + linetranslatedialog + Supplementary Line Device Services lineaccept (+) lineaddprovider - lineaddtoconference - lineagentspecific - lineblindtransfer + linecompletecall - linecompletetransfer - lineconfigprovider - lineforward - linegatherdigits - linegeneratedigits - linegeneratetone - linegetagentactivitylist - linegetagentcaps - linegetagentgrouplist - linegetagentstatus - linegetapppriority - linegetproviderlist - linehold - linemonitordigits - linemonitormedia - linemonitortones - linepark - linepickup - lineprepareaddtoconference - lineproxymessage - lineproxyresponse - lineredirect +

12 12 9. Anhang: Funktionsübersicht TAPI-Funktionen linereleaseuseruserinfo - lineremovefromconference - lineremoveprovider - linesecurecall - linesenduseruserinfo - linesetagentactivity - linesetagentgroup - linesetagentstate - linesetapppriority - linesetcalldata - linesetcallparams - linesetcallqualityofservice - linesetcalltreatment - linesetlinedevstatus - linesetmediacontrol - linesetmediamode - linesetterminal - linesetupconference - linesetuptransfer - lineswaphold - lineuncompletecall - lineunhold - lineunpark - Phone Device Services phoneclose - phoneconfigdialog - phonegetbuttoninfo - phonegetdata - phonegetdevcaps - phonegetdisplay - phonegetgain -

13 9. Anhang: Funktionsübersicht TAPI-Funktionen 13 phonegethookswitch - phonegeticon - phonegetid - phonegetlamp - phonegetmessage + phonegetring - phonegetstatus - phonegetstatusmessages - phonegetvolume - phoneinitialize + phoneinitializeex + phonenegotiateapiversion - phoneopen - phonesetbuttoninfo - phonesetdata - phonesetdisplay - phonesetgain - phonesethookswitch - phonesetlamp - phonesetring - phonesetstatusmessages - phonesetvolume - phoneshutdown + Extended Telephony Services linedevspecific - linedevspecificfeature - linenegotiateextversion - phonedevspecific - phonenegotiateextversion -

14 14 9. Anhang: Funktionsübersicht TAPI-Funktionen Line Device Messages LINE_ADDRESSSTATE + LINE_AGENTSPECIFIC - LINE_AGENTSTATUS - LINE_APPNEWCALL + LINE_CALLINFO + LINE_CALLSTATE + LINE_CLOSE + LINE_CREATE - LINE_DEVSPECIFIC - LINE_DEVSPECIFICFEATURE - LINE_GATHERDIGITS - LINE_GENERATE - LINE_LINEDEVSTATE + LINE_MONITORDIGITS - LINE_MONITORMEDIA - LINE_MONITORTONE - LINE_PROXYREQUEST - LINE_REMOVE - LINE_REPLY + LINE_REQUEST - Phone Device Messages PHONE_BUTTON - PHONE_CLOSE - PHONE_REPLY - PHONE_STATE - PHONE_CREATE - PHONE_REMOVE -