<\/p>\n
Telefonnummern findet man praktisch in jeder Datenbank. Lästig und fehleranfällig ist aber – gerade bei langen internationalen Nummern – das Ablesen und Eintippen ins Telefon, wenn etwa ein Kunde angerufen werden soll, der noch nicht in den Nummernspeicher des Telefons aufgenommen wurde. Unter der Voraussetzung, dass eine Telefonanlage vorhanden ist, die die so genannte TAPI-Schnittstelle unterstützt, lässt sich mit nur wenigen Zeilen VBA-Code ein Verbindungsaufbau aus Access heraus auf Knopfdruck realisieren.<\/b><\/p>\n
TAPI – Die Voraussetzung<\/b><\/p>\n
Windows offeriert eine Systemschnittstelle, die sich TAPI nennt: Telephony Application Programming Interfaces. Das ist eine Zwischenschicht, die Anwendungen mit Treibern eines Telefondienstanbieters verbindet. Solche Treiber werden mit TK-Anlagen ausgeliefert und bestehen selbst oft aus einem umfangreichen Set von Konfigurationsanwendungen.<\/p>\n
Sie sind manchmal aber auch recht spartanisch ausgelegt, wie etwa der TAPI-Dienst der AVM Fritz!Box, von der später noch die Rede sein wird. Diese Treiber kommunizieren unmittelbar mit der Telefonanlage – sei es über ein serielles Kabel, einen USB-Anschluss oder das Netzwerk.<\/p>\n
Diese TAPI Service Provider (TSP) genannten Treiber – normalerweise DLLs – stellen zwar einen Satz genormter Funktionen zur Verfügung, mit denen man sich als Programmierer indessen aber genauso wenig beschäftigen muss wie zum Beispiel mit Grafikkartentreibern. Denn diese Arbeit nimmt Ihnen die Windows-TAPI-Schnittstelle ab, die sich ihrerseits per VBA über zwei Methoden ansprechen lässt: Entweder über API-Aufrufe, also Deklarationen auf die tapi32.dll<\/b>, oder über einen Verweis auf die Microsoft Telephony 3.0 Library<\/b>. Wichtig ist zunächst nur dies: Sollten Sie oder Ihr Kunde über eine TK-Anlage verfügen, die einen TAPI-Treiber besitzt, dann steht einem Verbindungsaufbau zwischen Access und der Anlage nichts im Wege.<\/p>\n
Ob ein solcher Treiber installiert ist, lässt sich in der Systemsteuerung mit dem Applet „Telefon- und Modemoptionen“ ermitteln. Unter dem Reiter Erweitert <\/b>sind dort alle installierten TSPs aufgelistet, wie in Bild 1 zu erkennen ist.<\/p>\n
![\"telefonoptionen1.tif\"](\"..\/fileadmin\/_temp_\/2006_06\/TAPI-web-images\/telefonoptionen1_opt.jpeg\")
<\/p>\n
Bild 1: TAPI-Telefondienstanbieter in der Windows Systemsteuerung<\/span><\/b><\/p>\n Wenn Sie einen Eintrag der Liste markieren, dann wird unter Umständen die Schaltfläche Konfigurieren…<\/b> aktiv, mit der Sie Einstellungen für die Kommunikation zwischen Anlage und TAPI vornehmen können.<\/p>\n Bei ausgewachsenen Telefonanlagen gleicht die Konfigurationsseite, die der Hersteller hier bereitstellt, oft selbst einer umfangreichen Anwendung, die ohne Lektüre von Unterlagen oder der Online-Hilfe kaum zu durchschauen ist. Dies soll an dieser Stelle nur deshalb erwähnt werden, weil eine korrekte Einrichtung der Anlage erst die Voraussetzung dafür ist, dass unsere Beispieldatenbank dann auch so reibungslos läuft, wie sie sollte.<\/p>\n Access-Beispiel: Adressformular<\/b><\/p>\n In der Beispieldatenbank Waehlenmitaccess.mdb <\/b>öffnet sich beim Start ein Mini-Adressformular, dargestellt in Bild 2. Neben den Anschriftdaten enthält es drei Felder zur Eingabe von Telefonnummern. Dahinter sind jeweils Schaltflächen mit Telefonsymbolen angebracht. Wenn alles gut geht, dann verbindet ein Klick auf eine der Schaltflächen Ihr Telefon mit der Nummer des Teilnehmers.<\/p>\n Bild 2: Beispielformular mit über Button wählbaren Telefonnummern<\/span><\/b><\/p>\n Dabei kommt erstaunlicherweise nur eine einzige API-Funktion zum Einsatz, die Sie im Modul mdlTAPICALL <\/b>der Datenbank finden. Erstaunlich deshalb, weil TAPI eigentlich Hunderte von Funktionen und Objekten enthält.<\/p>\n Tatsächlich handelt es sich in diesem Beitrag nur um die Beschreibung einer sehr rudimentären Telefonieschnittstelle, die sich die in Windows gut versteckte Wählhilfe zunutze macht. Die API-Funktion tapiRequestMakeCall <\/b>ruft nämlich genau diese Wählhilfe auf, weil sie in Windows als Standardanwendung für TAPI eingestellt ist. Sie muss, damit das Wählen über das Formular funktioniert, zusätzlich zur oben erwähnten Einrichtung des TAPI-Treibers erst konfiguriert werden. <\/p>\n Wählhilfe<\/b><\/p>\n Wenn Sie unter Windows XP arbeiten, dann werden Sie im Startmenü vergeblich nach der Wählhilfe suchen. Windows XP legt bei Installation keine Verknüpfung zu dieser Anwendung an – aus welchen Gründen auch immer.<\/p>\n Sie können sie einfach aufrufen, indem Sie per Startmenü\/Ausführen <\/b>den Dialog zum Eingeben von Befehlen öffnen und über das dortige Eingabefeld die Anwendung dialer.exe <\/b>starten. Die Wählhilfe ist eine komplette kleine Telefon-Anwendung mit Nummernliste, Protokollierung und Konferenzraum, die nicht nur wählen, sondern auch Anrufe entgegennehmen kann und sogar Bildschirmtelefonie ermöglicht. Das alles ist an dieser Stelle aber nicht interessant, denn wichtig sind für unseren Zweck lediglich die Einstellungen der Wählhilfe, die beim Aufruf der API-Funktion zum Tragen kommen.<\/p>\n <\/p>\n Wenn Sie den Menübefehl Bearbeiten\/Optionen… <\/b>ausführen, sollte der Dialog aus Bild 3 erscheinen.<\/p>\n Bild 3: Erforderliche Einstellungen der Wählhilfe, Teil 1<\/span><\/b><\/p>\n Aktivieren Sie hier in der Optionsgruppe grundsätzlich den Eintrag Telefon <\/b>– das bedeutet telefonieren über TAPI. Im Kombinationsfeld für Telefonanrufe wählen Sie den TAPI-Provider aus, den Sie für Ihre Telefonanlage installiert haben. Manchmal stehen hier mehrere gleichlautende Einträge zur Auswahl, das sind dann im Allgemeinen die unterschiedlichen ISDN-Kanäle, die über den Provider anwählbar sind.<\/p>\n Bild 4 zeigt die zweite Registerkarte des Dialogs.<\/p>\n Bild 4: Einstellungen der Wählhilfe, Teil 2<\/span><\/b><\/p>\n Hier ist nur wichtig, dass Sie für Leitung<\/b> den Eintrag Telefonanrufe<\/b> auswählen. Die anderen Einstellmöglichkeiten beziehen sich nur auf den Fall, dass Sie über die Soundkarte des Rechners und ein Headset telefonieren oder gar über Internet-Videotelefonie eine Webcam einsetzen möchten.<\/p>\n Nachdem Sie die Einstellungen übernommen haben, können Sie die Wählhilfe wieder schließen.<\/p>\n Nun wird es spannend: Geben Sie in das Beispielformular eine Telefonnummer ein und klicken Sie auf die nebenstehende Schaltfläche. Nun sollte sich abermals die Wählhilfe öffnen, aber in anderem Gewand. Auf dem Bildschirm blenden sich links oben Dialogflächen ein, die im Vordergrund bleiben und sich etwa wie in Bild 5 präsentieren.<\/p>\n Bild 5: Ansicht der Wählhilfe bei Anruf aus Access über tapiRequestMakeCall<\/span><\/b><\/p>\n Während der obere Teil der Dialoge unwichtig ist, weil Sie ja nicht über die Soundkarte telefonieren wollen, gibt der untere Teil Informationen über die Verbindung wieder. Bild 5 zeigt, dass die Nummer (999) 128886 gewählt wurde, und zwar über die Anwendung AiU Demodatenbank<\/b>, und dass die Verbindung sich im Status des Anwählens befindet („Gegenseite wird gesucht…“).<\/p>\n Wenn der Teilnehmer abnimmt, ändert sich der Status in „Online“. Gleichzeitig sollte Ihre eingerichtete Nebenstelle klingeln, mit der Sie dann das Gespräch mit Ihrem Gegenüber führen können.<\/p>\n Wenn der Gesprächspartner wieder auflegt, steht dort „Anruf beendet“. Die Verbindung können Sie zu jedem Zeitpunkt über die Schaltfläche Trennen <\/b>abbrechen. Nach getätigtem Anruf schließen Sie die Dialoge mit der Schließen<\/b>-Schaltfläche.<\/p>\n Was Sie noch wissen sollten: Die Telefondienste unterscheiden sich in ihrem Verhalten. Bei machen Treibern klingelt zuerst das Telefon des Teilnehmers und erst beim Abnehmen Ihre Nebenstelle. In der kurzen Zeitspanne dazwischen hört der Teilnehmer dann „Ihre Verbindung wird gehalten“. Das sollten Sie ihm nicht allzu lange zumuten … Bei anderen Anlagen hingegen klingelt sinnvollerweise zuerst Ihre Nebenstelle und erst, wenn sie abnehmen, die Nummer des Teilnehmers. Diesem bleibt damit die irritierende Ansage erspart.<\/p>\n Der VBA-Code<\/b><\/p>\n Es wurde schon mehrmals erwähnt, dass nur eine einzige API-Funktion für das ganze Prozedere verantwortlich ist. Im Modul mdlTAPICALL <\/b>der Demodatenbank finden Sie die Deklaration:<\/p>\n Mit lpszDestAddress<\/b> wird ein String übergeben, der die anzuwählende Telefonnummer enthält. Mit lpszAppName<\/b> können Sie TAPI optional mitteilen, wie die Anwendung heißt, aus der Sie wählen. In lpszCalledParty<\/b> setzen Sie einfach wieder die zu wählende Nummer ein. Und lpszComment<\/b> ist schlicht überflüssig. Der Rückgabewert der Funktion ist ein Long<\/b>-Wert, der einen TAPI-Status repräsentiert – bei Erfolg eine 0<\/b>.<\/p>\n Aufgerufen wird diese Funktion in der Prozedur CallPhone<\/b> des Moduls. Ihr übergeben Sie ledig-lich die Telefonnummer. Das Modul enthält noch ein bisschen mehr Funktionalität. So ermittelt es etwa aus dem Statuswert von tapiRequestMakeCall<\/b> einen Fehlertext mithilfe der Funktion Oder es formatiert die zu wählende Telefonnummer so, dass sie keine Leerzeichen oder Schrägstriche mehr enthält.<\/p>\n Womit wir bei einem bedeutenden Punkt wären: TAPI versucht zwar, den Nummerstring möglichst sinnvoll zu interpretieren und in eine für den TSP verständliche Zielwahl zu übersetzen.<\/p>\n Das gelingt indes nur, wenn der String keine seltsamen Zeichen enthält. Leerzeichen, Klammern, Pluszeichen haben spezifische Bedeutung in einer Telefonnummer. Nähere Erläuterungen würden hier zu weit führen.<\/p>\n Am sichersten fahren Sie, wenn die Nummerneingabe im so genannten „Canonical Format“ erfolgt, das unter anderem unter [1] beschrieben wird. Unterstützen können Sie den Anwender in einer sinnvollen Eingabe, wenn Sie für die Telefon-Textboxen ein Eingabeformat vorsehen. Der Eingabeformat-Assistent von Access enthält Beispiele zu Telefonnummern.<\/p>\n TAPI mit der Fritz!Box<\/b><\/p>\n Nein, das ist keine Schleichwerbung für die Firma AVM. Der Siegeszug von VoIP (Voice over IP, Internettelefonie) hat jedoch dazu geführt, dass ein großer Teil der Router in Deutschland von dieser Firma gestellt wird, weil die einschlägigen VoIP-Provider diese Hardware häufig mit einem Zugang bundeln.<\/p>\n Seit diesem Sommer stellt AVM nun einen TAPI-Treiber für die Fritz!Boxen bereit, der das Anrufen über VoIP aus verschiedenen Programmen heraus gestattet, unter anderem über die Windows-Wählhilfe. Wegen der weiten Verbreitung dieser Geräte soll die Konfiguration hier kurz beschrieben werden.<\/p>\n Laden Sie zunächst den TAPI-Treiber unter [2] herunter, indem Sie einfach in das Suchfeld der Seite den Begriff „TAPI“ eingeben. In der Ergebnisliste findet sich dann der Eintrag „Treiber für TAPI Services for FRITZ!Box“, der Sie zum Download des Installationspakets leitet. <\/p>\n Nachdem Sie das Setup gestartet haben, überprüft es die Verfügbarkeit einer Fritz!Box und fragt nach der Nummer Ihrer Nebenstelle, die später die TAPI-Telefonate abwickeln soll.<\/p>\n Falls Sie in der Browser-Konfiguration Ihrer Fritz!Box noch keine Nebenstellen eingerichtet haben sollten, dann wählen Sie am besten den Wert 51 <\/b>aus dem Kombinationsfeld aus. Nach dem Abschluss des Setups muss der Rechner neu gestartet werden, weil TAPI-Treiber nicht „live“ eingerichtet werden können.<\/p>\n Damit das Ganze funktioniert, muss gegebenenfalls noch die Nebenstelle in der Online-Konfiguration der Fritz!Box eingerichtet werden. Starten Sie einen Browser und geben Sie in seine Adresszeile folgende Adresse ein:<\/p>\n http:\/\/fritz.box<\/b><\/p>\n Möglicherweise müssen Sie hier statt fritz.box <\/b>die IP eingeben, die Sie Ihrer Box vergeben haben.<\/p>\n über das Menü Einstellungen\/Telefonie\/ISDN-Endgeräte <\/b>können Sie nach Klick auf den Button Neue Nummer <\/b>auf der Seite Interne Nummern <\/b>eine neue Nebenstellennummer mit einer Ihrer MSN-Telefonnummern verknüpfen. Die Nebenstellennummer selbst lässt sich dabei nicht auswählen, sondern ist vorgegeben. Nach einem Klick auf übernehmen<\/b> sieht die Seite etwa so wie in Bild 6 aus.<\/p>\n Bild 6: Konfiguration einer Nebenstelle 51 in der Fritz!Box<\/span><\/b><\/p>\n Nach der Einrichtung muss dann lediglich noch die Windows-Wählhilfe entsprechend Bild 3 und Abb. 4 konfiguriert werden und schon steht der Telefonie über VoIP aus Access heraus nichts mehr im Wege.<\/p>\n Falls Sie im Setup des TAPI-Treibers eine andere Nebenstellennummer ausgewählt haben als sie in der Fritz!Box-Konfiguration zur Verfügung gestellt wird, lassen Sie einfach das Setup des Treibers erneut durchlaufen. Eine änderung der Nummer ist leider immer mit einem Neustart des Systems verbunden.<\/p>\n Fazit<\/p>\n Dieser Beitrag zeigt, wie Sie mit wenig Programmierung Telefonverbindungen aus Access heraus aufbauen.<\/p>\n Dabei kommen TAPI-Treiber von TK-Anlagen, die Telefonie-Schnittstelle von Windows selbst und die Wählhilfe zum Einsatz. Auf die Konfiguration der verbreiteten AVM Fritz!Box-VoIP-Router wurde zusätzlich eingegangen.<\/p>\n Eine ausgewachsene TAPI-Anwendung haben Sie damit allerdings noch nicht vor sich. Die Programmierung der TAPI-Schnittstelle ist das Metier von Spezialisten, die meist Zusatztools wie ActiveX-Elemente gegen nicht gerade geringes Entgelt zur Verfügung stellen.<\/p>\n Wer die erweiterte Funktionalität von TAPI wie programmgesteuerte Rufweiterleitung, Konferenzen oder Halten benötigt oder auch nur das Aufpoppen der Wählhilfe vermeiden möchte, kommt um die Anschaffung dieser Programmierhilfen und einige Einarbeitungszeit nicht herum.<\/p>\n Quellen<\/p>\n [1] Eingabeformat für Telefonnummern: http:\/\/msdn.microsoft.com\/library\/default.aspurl=\/library\/en-us\/tapi\/tapi3\/address_ovr.asp<\/p>\n [2] Homepage von AVM: http:\/\/www.avm.de\/de<\/p>\n Enthaltene Beispieldateien:<\/p>\n WaehlenMitAccess97.mdb<\/p>\n WaehlenMitAccess.mdb<\/p>\n![\"dialer1.tif\"](\"..\/fileadmin\/_temp_\/2006_06\/TAPI-web-images\/dialer1_opt.jpeg\")
<\/p>\n<\/p>\n![\"dialer2.tif\"](\"..\/fileadmin\/_temp_\/2006_06\/TAPI-web-images\/dialer2_opt.jpeg\")
<\/p>\n![\"waehlhilfe.tif\"](\"..\/fileadmin\/_temp_\/2006_06\/TAPI-web-images\/waehlhilfe_opt.jpeg\")
<\/p>\nPublic Declare Function tapiRequestMakeCall Lib \"tapi32\" _\r\n (ByVal lpszDestAddress As String, _\r\n ByVal lpszAppName As String, _\r\n ByVal lpszCalledParty As String, _\r\n ByVal lpszComment As String) As Long<\/pre>\n
TAPIStatus<\/b>.<\/p>\n![\"fritzbox.tif\"](\"..\/fileadmin\/_temp_\/2006_06\/TAPI-web-images\/fritzbox_opt.jpeg\")
<\/p>\nDownloads zu diesem Beitrag<\/h3>\n