Features

TAPI#

Der XPhone Connect TAPI Client ist ein TAPI Service Provider (TSP), der die Leitungen des XPhone Connect Servers für TAPI-fähige Windows-Anwendungen zur Verfügung stellt. Unterstützt werden die Einsatzszenarien Einzelarbeitsplatz, Terminal Server und Anwendungs-Server.

Hinweise#

  • Konfiguration

    Die CTI Konfiguration muss in allen Einsatzszenarien bereits abgeschlossen sein.

  • Telefon- und Modemoptionen

    Für die Funktion des TSP ist es erforderlich, dass die Standortinformationen in den Windows-Optionen für Telefon und Modem korrekt hinterlegt sind. Diese Einstellungen erreichen Sie über die Systemsteuerung oder im Menü der XPhone Connect TAPI Konfiguration unter Datei > Telefon- und Modemoptionen.

  • Lizenzierung

    Die Lizenzvergabe erfolgt leitungsgebunden. Jede vom TAPI Client genutzte Leitung verbraucht auf dem XPhone Connect Server eine eigene TAPI-Lizenz. Die Bindung der Lizenz an die Leitung erfolgt dauerhaft bei der ersten Verwendung. In der Web-Administration unter Systemeinstellungen > Lizenzen > Leitungen sind alle bereits belegten TAPI-Lizenzen einsehbar.

  • Berechtigung

    Benutzer haben stets volle Rechte auf ihre eigenen Leitungen. Der Zugriff auf Leitungen anderer Benutzer richtet sich nach den bestehenden Beziehungen.

Installation#

  • Laden Sie das Installationspaket von der C4B Download Homepage herunter.

    Für alle Einsatzszenarien wird dieselbe Software installiert.

  • Entpacken Sie das Archiv und starten Sie das Setup aus folgendem Verzeichnis:

    \XPhoneConnect_V10_X_XXX\Software\TAPI Service Provider\SetupConnectTAPI.exe

  • Voraussetzung für das Setup ist Microsoft .NET Framework 4.8.

    Falls es nicht installiert ist, kann es von der Microsoft-Website heruntergeladen werden.

  • Es stehen separate Setups für 32- und 64-Bit-Windows zur Verfügung.

    Auf 64-Bit-Systemen ist der Betrieb mit 32- und 64-Bit-TAPI-Anwendungen möglich.

  • Für die Installation sind Administratorrechte erforderlich.

  • Das Setup führt Sie durch den Installationsprozess.

    Nach Abschluss wird die Konfigurationsoberfläche des TSP automatisch geöffnet.

Einzelarbeitsplatz#

In diesem Szenario wird der XPhone Connect TAPI Client auf einem Arbeitsplatzrechner installiert und steht jeweils einem Benutzer zur Verfügung.

Konfiguration

  • Installieren Sie den XPhone Connect TAPI Client auf dem Zielrechner.

  • Öffnen Sie die Konfiguration über:

    **Windows Start > XPhone Connect TAPI > XPhone Connect TAPI Konfiguration**

    Hinweis

    Alternativ kann die Konfiguration auch über Telefon und Modem > Erweitert in der Systemsteuerung aufgerufen werden.

  • Tragen Sie die IP-Adresse oder den Hostnamen des XPhone Connect Servers, sowie den Port (der Standardport ist 2230) ein.

    Stellen Sie sicher, dass die Firewall Verbindungen zu diesem Port zulässt.

  • Wählen Sie den Modus Benutzer auf Einzelarbeitsplatz.

  • Die Anmeldung am XPhone Connect Server kann auf zwei Arten erfolgen. Die gewählte Methode muss serverseitig vom Administrator eingerichtet sein:

    • Windows-Anmeldung

      Leitungen werden abhängig vom aktuell angemeldeten Benutzer angezeigt. Beim Fast User Switching werden die sichtbaren Leitungen dynamisch dem aktiven Benutzer angepasst. Leitungen mit eingeschränkten Rechten sind sichtbar, können aber nicht verwendet werden.

    • XPhone Connect Server Anmeldung

      Alle Benutzer arbeiten mit den Leitungen des hier konfigurierten Benutzers. Es gibt dann kein dynamisches Umschalten der sichtbaren Leitungen. Diese Methode eignet sich nur für Systeme mit einem festen Benutzer.

    Hinweis

    Wenn der Computer von mehreren Benutzern verwendet wird, empfehlen wir die Windows-Anmeldung zu verwenden.

  • Auch dynamische Leitungen werden in der Betriebsart Benutzer auf Einzelarbeitsplatz unterstützt.

  • Der XPhone Connect TAPI Client stellt alle Leitungen zur Verfügung, für die der angemeldete Benutzer berechtigt ist. Dazu gehören die eigenen Leitungen des Benutzers mit vollen Rechten und die Leitungen von Teammitgliedern mit Rechten, die abhängig von der Teambeziehung sind.

Terminal Server#

Der XPhone Connect TAPI Service Provider (TSP) kann auch auf einem Terminal Server eingesetzt werden. Dadurch ist es möglich, mehreren Benutzern auf demselben Server individuelle TAPI-Leitungen zur Verfügung zu stellen - auch in Verbindung mit unterschiedlichen XPhone Connect Servern.

Installation und Konfiguration auf dem Terminal Server

  • Installieren Sie XPhone Connect TAPI auf einem Terminal Server, auf dem mehrere Benutzer parallel arbeiten.

  • Nach der Installation erscheint der TSP unter:

    Systemsteuerung > Telefon und Modem

  • Über den Button Hinzufügen… kann der XPhone Connect TAPI Service Provider mehrfach zur Liste der Anbieter hinzugefügt und jeweils separat konfiguriert werden.

  • Tragen Sie die IP-Adresse oder den Hostnamen des XPhone Connect Servers sowie den Port (Standard: 2230) ein.

    Achten Sie darauf, dass die Firewall Verbindungen zulässt.

  • Wählen Sie den Modus Benutzer auf Terminal Server:

    Hinweis

    Dieser Modus wird nur angezeigt, wenn der TSP tatsächlich auf einem Terminal Server installiert wurde.

  • Deaktivieren Sie die Option Wählen, Auflegen und Rückfrage nur für berechtigte Benutzer, wenn keine Rechteprüfung erfolgen soll.

  • Es können mehrere XPhone Connect Server als TAPI Service Provider konfiguriert werden.

  • Die gespeicherten Konfigurationen lassen sich über Start > Programme > XPhone Connect TAPI > XPhone Connect TAPI Konfiguration einsehen und verwalten.

    In der Übersicht erscheint jede Konfiguration unter dem Namen XPhone Connect TAPI Service Provider.

Ohne weitere Konfiguration stehen alle Leitungen allen XPhone Connect Benutzern ohne Berechtigungsprüfung zur Verfügung. Für gezielte Zuweisung siehe: Terminal Server als Telefonie Server.

Terminal Server als Telefonie Server
  • Öffnen Sie die Management-Konsole mit tapimgmt.msc (als Administrator starten).

    Es erscheint eine Übersicht aller installierten TAPI Service Provider.

  • Wählen Sie im Kontextmenü des XPhone TSPs Eigenschaften.

    Fügen Sie einen oder mehrere Benutzer als Telefonie-Administratoren hinzu und aktivieren Sie die Option Telefonie Server-Funktion.

  • Melden Sie sich mit einem dieser Administrator-Konten an und öffnen Sie die Konsole erneut.

  • Jetzt können Sie gezielt Leitungen bestimmten Benutzern zuweisen:

    Benutzer auswählen > Kontextmenü (Rechtsklick) > Benutzer bearbeiten > Hinzufügen.

  • Nur zugewiesene Benutzer können die Leitungen in TAPI-Anwendungen verwenden.

    In der Leitungsauflistung der TAPI Service Provider sieht man hinter dem Leitungsnamen die zugeordneten Benutzer.

Hinweis in Verbindung mit SAP

Kann der SAPPhone Server die Leitungen vom TAPI bei der SAPPhone Integration nicht zuweisen, so ist folgender Registry Eintrag notwendig. Wichtig für SAPPhone ist, dass bei der Adresse der Leitung nur die Durchwahl steht. Das muss über die Registry vom XPhone Connect TAPI eingestellt werden.

  1. Der Eintrag in der Registry muss nach Konfiguration des TSPs erfolgen.

  2. Der Registry-Eintrag muss auf dem Server erfolgen, auf dem XPhone TSP installiert ist, also auf dem SAPPhone-Server:

HKEY_LOCAL_MACHINE\SOFTWARE\C4B\Telephony\XPhoneServerTAPI\Provider<ID>

bzw.

HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\C4B\Telephony\XPhoneServerTAPI\Provider<ID>

  • Name:

flags

  • Typ:

DWORD

  • Wert:

Den hexadezimalen Wert 1000 zum vorhandenen Wert von flags addieren um das Feature zu aktivieren. Der Wert bleibt auch bei Einstellungsänderungen des TSP erhalten. Wenn also der Wert 0 wäre, tragen Sie (hexadezimal) den Wert 1000 ein.

Hinweis

Berechtigungsprüfung

Ist die zusätzliche Rechteeinschränkung Wählen, Auflegen und Rückfrage nur für berechtigte Benutzer aktiviert, dann findet bei allen aktiven Aufrufen für Leitungs- oder Anrufsteuerung eine Rechteprüfung statt. Voraussetzung dafür ist, dass für jeden Benutzer die Windows-Anmeldung auf dem XPhone Connect Server entsprechend eingerichtet ist. Nur so können die Benutzer über ihre Windows-Anmeldung authentifiziert werden. Eine Übersicht gibt die Rechteübersicht für Teams im Serverhandbuch.

Server-Anwendung#

In diesem Szenario wird der XPhone Connect TAPI Client auf einem Server installiert, auf dem eine TAPI-fähige Anwendung betrieben wird. Die Server-Anwendung agiert als TAPI-Client und verwendet alle Benutzerleitungen des XPhone Connect Servers - ohne Rechteprüfung. Es liegt in der Verantwortung der Serveranwendung, auf welche Weise und mit welchen Berechtigungen die Telefoniefunktionen an die eigenen Clients weitergegeben werden.

Konfiguration

  • Installieren Sie den XPhone Connect TAPI Client auf dem Server, auf dem die TAPI-Anwendung läuft.

  • Öffnen Sie die Konfiguration über:

    Windows Start > XPhone Connect TAPI > XPhone Connect TAPI Konfiguration

    Hinweis

    Alternativ ist die Konfiguration unter Systemsteuerung > Telefon und Modem > Erweitert möglich.

  • Tragen Sie die IP-Adresse oder den Hostnamen des XPhone Connect Servers sowie den Port (Standard: 2230) ein.

    Die Firewall muss Verbindungen auf diesem Port erlauben.

  • Wählen Sie den Modus Server-Anwendung.

    In diesem Betriebsmodus ist nur die Anmeldeart XPhone Connect Server-Anmeldung verfügbar.

  • Geben Sie die Zugangsdaten des Kontos zur Abfrage aller Leitungen ein.

  • Es werden alle Benutzerleitungen des Servers zur Verfügung gestellt - ohne Prüfung von Benutzerrechten.

Hinweis

Mit der Option Benutzer- und Systemleitungen ist es ausreichend die Leitungen unter Systemeinstellungen > Telephony & Meetings > Telefonie > Leitungen anzulegen.

Konto zur Abfrage aller Leitungen#

Das Konto zur Abfrage aller Leitungen wird in den Betriebsmodi Server Anwendung und Benutzer auf Terminal Server verwendet.

Konfiguration

  • Öffnen Sie die Web-Administration und navigieren Sie zu:

    Systemeinstellungen > Telefonie & Meetings > Telefonie > TAPI

  • Deaktivieren Sie die Checkbox Deaktiviert.

  • Vergeben Sie einen Anmeldenamen.

  • Legen Sie ein Kennwort und bestätigen Sie es.

    Hinweis

    Das Kennwort muss folgende Anforderungen erfüllen:

    • Mindestens 8 Zeichen

    • Groß- und Kleinbuchstaben

    • Zwei Ziffern

    • Zwei Sonderzeichen

    Sobald das Kennwort die Richtlinie erfüllt, erscheint ein grünes Häkchen. Ein rotes Minus zeigt an, dass die Anforderungen noch nicht erfüllt sind. Das eingegebene Kennwort wird automatisch maskiert. Klicken Sie auf das Symbol im Eingabefeld, um es sichtbar zu machen (nur einmalig bei Eingabe möglich).

  • Über die Schaltfläche Aktuelles Kennwort anzeigen kann das Kennwort später erneut eingeblendet werden.

AnyDevice und Softphone Leitungen#

Auch AnyDevice und Softphone Leitungen können im XPhone Connect TAPI Client verwendet werden. Um diese Leitungen freizuschalten, klicken Sie doppelt auf die Versionsangabe im Konfigurationsfenster. Daraufhin erscheint die Option AnyDevice Leitungen, die Sie aktivieren können.

TAPI-XCC

Protokollierung#

Die Protokollierung kann in der XPhone Connect TAPI Konfiguration aktiviert und in verschiedenen Stufen eingestellt werden. Beachten Sie dabei:

  • Änderungen an der Protokollierung werden erst übernommen, wenn Sie auf OK klicken.

  • Mit der Schaltfläche Protokoll anzeigen öffnen Sie den Ordner mit den Log-Dateien im Windows Explorer.

Test#

Zur Überprüfung, ob TAPI-Leitungen korrekt bereitgestellt werden, können Sie TAPI-Testtools verwenden z.B. tphone.exe oder dialer.exe.

TPhone befindet sich auf dem XPhone Connect-Image unter:

\XPhoneConnect_V10_X_XXX\Tools\tphone\

Funktionsübersicht#

XPhone Connect TAPI stellt eine fest definierte Teilmenge der Microsoft TAPI Schnittstelle zur Verfügung:

Unterstützte TAPI Funktionen

lineAddProvider

lineAnswer

lineBlindTransfer

lineCallbackFunc

lineClose

lineCompleteTransfer

lineConfigProvider

lineDeallocateCall

lineDevSpecific

lineDevSpecificFeature

lineDial

lineDrop

lineForward

lineGenerateDigits

lineGetAddressCaps

lineGetAddressStatus

lineGetAppPriority

lineGetCallInfo

lineGetCallStatus

lineGetConfRelatedCalls

lineGetCountry

lineGetDevCaps

lineGetIcon

lineGetID

lineGetLineDevStatus

lineGetMessage

lineGetNewCalls

lineGetNumRings

lineGetProviderList

lineGetStatusMessages

lineGetTranslateCaps

lineHold

lineInitialize

lineInitializeEx

lineMakeCall

lineNegotiateAPIVersion

lineNegotiateExtVersion

lineOpen

lineRedirect

lineRegisterRequestRecipient

lineRemoveFromConference

lineRemoveProvider

lineSetAppPriority

lineSetAppSpecific

lineSetCallData

lineSetCallPrivilege

lineSetCallQualityOfService

lineSetCallTreatment

lineSetCurrentLocation

lineSetStatusMessages

lineSetupConference

lineSetupTransfer

lineShutdown

lineSwapHold

lineTranslateAddress

lineTranslateDialog

lineUnhold

Ihre Meinung zählt!

Ob Lob, hilfreiche Ideen oder ein Hinweis auf einen Fehler - wir freuen uns über jede Nachricht.
Schreiben Sie uns einfach an doku@c4b.de und helfen Sie mit, diese Dokumentation noch besser zu machen.
Vielen Dank für Ihre Unterstützung!