Revision as of 07:44, 3 January 2011

General information

TAPI (Telephony Application Programming Interface) it is an interface for cooperation between telecommunication devices (PABXes, telecommunication servers) and computer applications. For Slican server users TAPI driver was developed, named "TAPI.worksation". It is single station driver, launched individually for every extension number in PABX. Number of PCs which can connect with PABX using TAPI.workstation is limited by license code. For every PABX, without license code, it is possible to launch one station of TAPI.workstation with full functionality, only one condition is to equip PABX with LAN or VoIP module. After driver installation, special plug-in to Microsoft Outlook application can be installed, due to this plug-in it is possible to establish calls using contacts stored in application, as well as find contacts according caller CLIP, etc.

Plug-in installation window.

Next it is necessarily to configure an account in Slican PABX. To do this following information should be entered:

• extension number used to integrate with Microsoft Outlook application,
• PIN code used to authenticate some services in PABX and,
• IP address of Slican PABX in LAN network.

Option "Find server" can be used but if registration of account is unsuccessful with this option, IP address should be entered manually. IP address can be obtained from LAN admin. Application can be also used in WAN network. In this situation public IP address should be used in configuration, but port 5524 should be forwarded to Slican PABX.

Plug-in configuration window.

MS Outlook configuration

Due to lot of option using TAPI.workstation, below some application examples are presented, these examples should present windows, where PC configuration for dialing phone numbers can be done. They also presents results of such configuration of dialing rules. Using of presented fields can be quite different depending on user needs.

After account configuration, setting propriety is checked and if this check is successful application using can be started. For comfortable using application some time should be spent to configure Microsoft Outlook application. After installing plug-in in Microsoft Outlook new menu named Slican appears. In this menu can be defined how Microsoft Outlook application should react on incoming calls.

Outlook configuration window

Next line used to establishing outgoing calls should be defined. First option "New call" (Ctl+Shift+D) should be selected - the same can be obtained by selecting option "Call contact" from context menu appears after clicking right mouse button in open contact window.
In window "New Call" click button "Dialing Properties..." and in section "Connect using line" select line specified as Slican xxx, where xxx it is an extension number assigned to MS Outlook user.

Dialing configuration window

Dialing numbers configuration

Dialing method can be different and depends on (among others):

• Method of entering phone numbers in MS Outlook Contacts (with or without 0, with or without +48)
• PABX outgoing calls configuring (there is outgoing digit (and what) or there is Number Analysis)
• General dialing method used in specified location (using provider prefixes, using or not area code, etc)

In Windows operating system, in Control Panel there is shortcut "Opcje telefonu i modemu" które umożliwiają zarządzanie bibliotekami TAPI (dodawanie, usuwanie, konfiguracja), oraz umożliwia konfigurowanie reguł wybierania numerów telefonu.
Reguły te należy ustawić w celu umożliwienia programom korzystającym z TAPI np. MS Office Outlook, konwersje numerów zapisanych w swoich bazach kontaktów w taki sposób aby biblioteka TAPI zawsze wybierała prawidłowo numer (aby doszło do połączenia).
Do opcji tych oprócz Panelu Sterownia można również dostać się klikając "Właściwości wybierania numeru" w tym samym oknie w którym dokonuje się wyboru linii dla MS Outlook.

Phone number interpretation executed by MS Office Outlook application

• +48, +49, +.. - numer telefonu rozpoczynający się od znaku plus jest interpretowany jako numer kierunkowy kraju. Jeżeli pokrywa się on z ustawieniami "Opcje telefonu i modemu" np. Polska +48 to jest pomijany w sygnalizacji przekazanej do Slican TAPI
• (52), (052), (56), (..) - numer telefonu zawierający wpis w nawiasach jest interpretowany jako numer kierunkowy
• 523251138 - jest interpretowane jako numer wewnętrzny.

Ważny jest również sposób wprowadzenia numerów do kontaktów.Numer kierunkowy kraju musi być oddzielony od reszty numeru spacją. Jej brak powoduje, że numer nie jest prawidłowo interpretowany i system zwraca błąd. Example:

Settings while no outgoing digit in PABX

Parametry jakie należy ustawić w systemie przy bezpośrednim wyjściu na miasto. Podany numer kierunkowy jest dla miasta Bydgoszcz, lecz w związku z faktem, że w Krajowym Planie Numeracyjnym zarówno w rozmowach lokalnych jak i międzymiastowych posługujemy się numerem kierunkowym, to nie ma znaczenia jaki numer kierunkowy został tu podany. Pole to może mieć znaczenie jedynie w przypadku gdy zajdzie potrzeba zróżnicowania sposobu telefonowania na numery lokalne i międzymiastowe.
Najpierw więc tworzymy w Opcjach Telefonu i Modemu nową lokalizacje ( jeśli jeszcze jej nie ma) i podajemy własny numer kierunkowy.

Następnie należy wyedytować utworzoną lokalizację

Windows będzie się domagał od nas prowadzenia numeru dla połączeń międzystrefowych, lecz przy zachowaniu prawidłowości wpisów w kontaktach, to co zostanie zapisane w tym polu nie będzie miało znaczenia. Ważne jest jedynie wtedy kiedy samodzielnie chcemy modyfikować numer, np dodając prefiks operatora niezależnego. Należy jednak pamiętać, że taka modyfikacja może nie być dozwolona w centrali. Za wybór operatora dla poszczególnych połączeń odpowiada centrala,tam są zapisane reguły telefonowania, i nie jest wskazana ich samodzielna modyfikacja w Outlook

Następnie należy przejść do zakładki "Reguły wybierania numerów kierunkowych". Należy sprawdzić czy są jakiekolwiek reguły. Przy założeniu że wszelkie modyfikacje numerów będą realizowane przez centralę, a nie przez Outlook, oraz że sposób telefonowania na numery lokalne jak i zamiejscowe jest taki sam, nie powinno być wpisanych żadnych reguł wybierania

Przykładowe wyniki działania wpisów w Opcjach Telefonu i Modemu

Settings - zero as outgoing digit

Gdy w centrali zadeklarowane jest wyjście na miasto przez cyfrę (w naszym przykładzie przez cyfrę zero) wówczas konfiguracja komputera powinna wyglądać w sposób następujący:
Z panelu sterowania lub z Opcji wybierania numerów w Outlook otwieramy główne menu

Następnie edytujemy właściwości lokalizacji i ustawiamy parametry w podany poniżej sposób:

Analogicznie jak przy wyjściu bezpośrednim z centrali ( bez żadnej cyfry wyjścia) nie ma potrzeby tworzenia żadnych reguł wybierania. Prawidłowość działania zapewni odpowiedni sposób wprowadzania numerów do kontaktów.

Nie należy w takiej konfiguracji posługiwać się numerami kierunkowymi podawanymi w nawiasie gdyż w związku z brakiem wpisanych reguł zostanie on pominięty w wybieraniu.
Przykładowe wyniki działania powyższych wpisów w Opcjach Telefonu i Modemu

Warto tu zwrócić uwagę na fakt, że system Windows samoczynnie dodaje cyfrę zero do każdego numeru kierunkowego zapisanego w nawiasie.

Settings - adding provider prefix

Pamiętać należy o tym, że opcja ta będzie działać jedynie wówczas gdy administrator centrali ustawi zezwolenie na samodzielne wybieranie prefiksu operatora. Ale zasada wybierania numerów przez Outlook może zostać wykorzystana również do innych celów niekoniecznie związanych z operatorem międzystrefowym.
Z panelu sterowania lub z Opcji wybierania numerów w Outlook otwieramy główne menu

Następnie edytujemy właściwości lokalizacji i ustawiamy parametry w podany poniżej sposób:

Następnie przechodzimy do zakładki "Reguły wybierania numerów kierunkowych" gdzie dodajemy regułę wybierania numerów lokalnych np w sposób przedstawiony na poniższej ilustracji:

Przykładowa konfiguracja takiej reguły może wyglądać następująco:

Przy takich zapisach uzyskamy następujące działanie wybierania numerów przez MS Outlook: