====== TAPI – Einstellungen ======

untermStrich TAPI startet automatisch, sobald sich ein Benutzer in der 
untermStrich-Software anmeldet. In der Windows-Taskleiste erscheint das 
entsprechende **Infobereich-Symbol** – vorausgesetzt, mindestens eine 
TAPI-Line ist in Windows eingerichtet.

{{:de:tapi:tapi:tapi_01.png?nolink|}}

----

===== Erststart & Nebenstelle auswählen =====

Beim ersten Start erscheint ein Dialogfenster zur Auswahl der Nebenstelle 
für diesen Arbeitsplatz. Die Nebenstelle des angemeldeten untermStrich-Benutzers 
wird automatisch vorgeschlagen, sofern eine passende TAPI-Line in Windows existiert.

{{:de:tapi:tapi:tapi_02.png?nolink|}}

<WRAP center round tip 97%>
Soll auf diesem Arbeitsplatz **keine** TAPI-Funktionalität genutzt werden, 
löschen Sie die Nebenstelle – das Fenster erscheint beim nächsten Start nicht mehr.
</WRAP>

<WRAP center round info 97%>
Dieses Fenster wird nur angezeigt, wenn der angemeldete Mitarbeiter im Modul 
**Team** eine Nebenstelle (Feld **DW**) eingetragen hat **und** mindestens eine 
TAPI-Line in Windows eingerichtet ist.
</WRAP>

Nach Klick auf **Übernehmen** wird die TAPI-Line initialisiert – erkennbar am 
Infobereich-Symbol:

{{:de:tapi:tapi:tapi_03.png?nolink|}}   {{:de:tapi:tapi:tapi_04.png?nolink|}}

Im **Tooltip** des Symbols wird nach der Initialisierung die Nebenstellen-Nummer 
angezeigt – sowie in Klammern, ob die Anrufprotokollierung **aktiv** oder 
**inaktiv** ist:

{{:de:tapi:tapi:tapi_05.png?nolink|}}

----

===== Status & Fehlerbehebung =====

^ Status ^ Ursache ^ Lösung ^
| Protokollierung **inaktiv** (TAPI-Line korrekt initialisiert) | Beim angemeldeten Benutzer ist keine Nebenstelle (DW) hinterlegt. | Nebenstelle im Modul **Team** eintragen. |
| TAPI-Line **nicht initialisiert** | TAPI-Line in Windows nicht korrekt eingerichtet. | TAPI-Line in Windows prüfen und einrichten. |
| **REST-Verbindung** schlägt fehl | SSL-Zertifikat ungültig. | Gültiges Zertifikat einrichten oder Option in [[de:tapi:tapi:preparation|Vorbereitungen]] aktivieren. |

{{:de:tapi:tapi:tapi_12.png?nolink|}}

<WRAP center round important 97%>
  * **TLS 1.1 / TLS 1.2** erfordert **Microsoft .NET Framework 4.5** oder höher.
  * Bei Einsatz eines **Proxyservers** muss die untermStrich-URL in den Proxy-Ausnahmen des Browsers **und** in Windows eingetragen werden.
</WRAP>

Liefert die Anrufprotokollierung einen Fehler, wird im Infobereich-Menü ein 
zusätzlicher Menüpunkt eingeblendet:

{{:de:tapi:tapi:tapi_14.png?nolink|}}

Über **Fehlerbericht** erhalten Sie eine detaillierte Problembeschreibung.

----

===== Einstellungen nachträglich ändern =====

Die Nebenstelle und weitere Einstellungen können jederzeit über den Menüpunkt 
**Einstellungen** im Infobereich-Symbol angepasst werden:

{{:de:tapi:tapi:tapi_06.png?nolink|}}

Im Einstellungsfenster werden angezeigt:
  * die aktuelle **Nebenstelle (TAPI-Line)**
  * der zugeordnete **untermStrich-Benutzer**
  * der **Status der Protokollierung**

{{:de:tapi:tapi:tapi_07.png?nolink|}}

Über **Erweiterte Einstellungen** gelangen Sie zu weiteren Optionen:

<WRAP center round important 97%>
Wurde der **Connector 4VX** mit einem **Port** gestartet, sind die erweiterten 
Einstellungen **nicht zugänglich**.
</WRAP>

{{:de:tapi:tapi:tapi_08.png?nolink|}}

==== Erweiterte Einstellungen ====

^ Einstellung ^ Beschreibung ^
| **TAPI-Modus** | Betrieb über **WinAPI** (Standard) oder **COM**. |
| **TAPI-Line bei Inaktivität neu registrieren** | Nur aktivieren, wenn der TAPI-Treiber dies erfordert – z. B. wenn Anrufe nach mehreren Gesprächen nicht mehr protokolliert werden. |
| **Alle installierten TAPI-Lines initialisieren** | Bei einigen TK-Anlagen notwendig, um alle TAPI-Ereignisse (z. B. Heranholen eines Gesprächs) korrekt auszuwerten. Initialisiert alle in Windows eingerichteten TAPI-Lines. |

<WRAP center round tip 97%>
Über das Eingabefeld **Nebenstelle** (Pfeil-Taste nach unten oder Schaltfläche 
daneben) erhalten Sie eine Auflistung aller auf dem Arbeitsplatz installierten 
TAPI-Leitungen.\\
Mit **Standard** setzen Sie alle erweiterten Einstellungen auf den Originalzustand zurück.
</WRAP>

Mit Klick auf **Übernehmen** wird untermStrich TAPI mit den neuen Einstellungen 
neu initialisiert.