TAPI: Różnice pomiędzy wersjami

Z Wiki
Skocz do: nawigacja, szukaj
(Ustawienia przy braku cyfry wyjścia na miasto z centrali)
(Ustawienia przy braku cyfry wyjścia na miasto z centrali)
Linia 59: Linia 59:
 
<center>[[Grafika:TAPI pusta reguła.png]]</center>
 
<center>[[Grafika:TAPI pusta reguła.png]]</center>
  
 
+
Przykładowe wyniki działania wpisów w Opcjach Telefonu i Modemu
 +
<center>
 +
{|{{Prettytable}}
 +
|-
 +
!{{tlo|lightgray}} Numer zapisany w MS Outlook !!{{tlo|lightgray}} Rezultat !!{{tlo|lightgray}} Numer przekazany do SlicanTAPI
 +
|-
 +
| 138||OK  ||138
 +
|-
 +
| (52) 3251138||Error  ||0523251138
 +
|-
 +
| (052) 3251138||Error ||0523251138
 +
|-
 +
| +48 887678542||OK  ||887678542
 +
|-
 +
| +49 887678542||OK  ||0049887678542
 +
|-
 +
| +48 523251138||OK ||523251138
 +
|-
 +
| 0523251138||Error  ||0523251138
 +
|-
 +
| 664789911||OK  ||664789911
 +
|-
 +
|0664789911||Error ||0664789911
 +
|-
 +
| (56) 3251138||Error  ||01033563251138
 +
|-
 +
| +48 (56) 3251138||Error  ||01033563251138
 +
|-
 +
| +48 563251138||OK  ||563251138
 +
|-
 +
| 563251138||OK ||563251138
 +
|-
 +
| 523251138||OK ||523251138
 +
|-
 +
| 3251100||ERROR ||3251100
 +
|-
 +
| +48 0 523251138||ERROR ||0523251138
 +
|-
 +
| +48 0887678542||ERROR ||0887678542
 +
|-
 +
| +49 0887678542||ERROR ||00490887678542
 +
|}
 +
</center>
  
 
[[Grafika:TAPI_Ustawienia_reguł_wybierania_numeru.jpg]]
 
[[Grafika:TAPI_Ustawienia_reguł_wybierania_numeru.jpg]]

Wersja z 10:45, 27 gru 2010

Informacje ogólne

TAPI (Telephony Application Programming Interface) jest to interfejs współpracy pomiędzy urządzeniami telekomunikacyjnymi takimi jak centrale i serwery telekomunikacyjne a aplikacjami komputerowymi.Dla użytkowników serwerów Slican opracowany został driver TAPI o nazwie "TAPI.worksation". Jest to driver jednostanowiskowy, czyli uruchamiany indywidualnie dla każdego numeru wewnętrznego w centrali. Ilość komputerów które mogą połączyć się z centralą korzystając z TAPI.workstation ograniczona jest wykupioną licencją. W każdym serwerze bez licencji możliwe jest uruchomienie jednego stanowiska TAPI.workstation w pełnej funkcjonalności, pod warunkiem że wyposażony jest on w moduł LAN lub VoIP. Po zainstalowaniu divera możliwe jest zainstalowanie specjalnej "wtyczki" do programu Microsoft Outlook, dzięki której wykorzystując kontakty zawarte w tym programie będzie można wykonywać połączenia, wyszukiwać kontakty na podstawie odebranej prezentacji numeru osoby dzwoniącej, zapisywać pliki logów itp.

TAPI OutLook Plug In small.png

Okno instalacji Plug-In'a.


Następnie konieczne jest ustawienie swojego konta w serwerze Slican. Należy podać numer telefonu z którego korzysta użytkownik aplikacji Microsoft Outlook, PIN który jest tym samym czterocyfrowym PIN-em który wykorzystywany jest przy wywoływaniu niektórych usług centrali, oraz adres IP serwera Slican pod którym znajduje się w sieci lokalnej. Można użyć opcji "Wyszukaj serwer" ale w przypadku niepowodzenia należy go wprowadzić ręcznie. Adres IP serwera można uzyskać od administratora sieci. Aplikacja może być również używana poza obrębem sieci LAN firmy. Wówczas adresem serwera będzie publiczny adres IP z którego odpowiednie porty administrator skierował do serwera Slican.

TAPI konfiguracja konta.png

Okno konfiguracji Plug-In'a.


Konfiguracja MS Outlook

Po skonfigurowaniu konta nastąpi sprawdzenie poprawności połączenia z serwerem, i jeśli zakończy się ono sukcesem można rozpocząć korzystanie z aplikacji. Aby jednak korzystanie było wygodne i prawidłowe należy poświęcić nieco czasu na konfigurację programu Mikrosoft Outlook. Po zainstalowaniu wtyczki w programie Microsoft Outlook pojawi się nowa zakładka menu o nazwie Slican. W zakładce tej definiujemy jak ma zachować się aplikacja Microsoft Outlook dla połączeń przychodzących.

TAPI konfiguracja Slican.png

Okno konfiguracji Outlook.


Następnie należy zdefiniować jakiej linii chcemy używać do wykonywania połączeń. Należy najpierw wybrać opcję "Nowa rozmowa" (Ctl+Shift+D) lub też mając wybrany kontakt do którego chcemy zadzwonić wybrać prawym przyciskiem myszy opcję "Zatelefonuj do kontaktu".
W otwartym oknie "Nowa rozmowa" wybrać "Opcje wybierania numeru" i w zakładce "Połącz używając linii" wskazać linię opisaną jako Slican xxx gdzie xxx to numer telefonu z którego korzysta użytkownik MS Outlook.

TAPI wybór linii.png

Okno konfiguracji Outlook.


Konfiguracja wybierania numerów

Ustawienie sposobu telefonowania może być różne i zależy między innymi od:

  • Sposobu wprowadzenia numerów telefonów w Kontaktach MS Outlook ( z zerem lub bez, z +48 lub bez)
  • Sposobu telefonowania z centrali ( czy jest i jak cyfra wyjścia na miasto, czy też jest to Analiza Numeru)
  • Od ogólnego sposobu telefonowania w danej lokalizacji ( używanie prefiksów operatorów pośrednich, używanie lub nie numeru kierunkowego miasta itp)

W systemie Windows w Panelu sterowania istnieje skrót "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.

Opis interpretacji numeru telefonicznego przez program MS Office Outlook

  • +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. Przykład:

Wprowadzony numer Wynik
+48523251100 Błąd
+48 523251100 OK
+48 (52)3251100 OK

Ustawienia przy braku cyfry wyjścia na miasto z centrali

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.

TAPI Opcje telefonu i modemu.jpg

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

TAPI Ustawienia lokalizacji - gorąca linia.jpg

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

TAPI pusta reguła.png

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

Numer zapisany w MS Outlook Rezultat Numer przekazany do SlicanTAPI
138 OK 138
(52) 3251138 Error 0523251138
(052) 3251138 Error 0523251138
+48 887678542 OK 887678542
+49 887678542 OK 0049887678542
+48 523251138 OK 523251138
0523251138 Error 0523251138
664789911 OK 664789911
0664789911 Error 0664789911
(56) 3251138 Error 01033563251138
+48 (56) 3251138 Error 01033563251138
+48 563251138 OK 563251138
563251138 OK 563251138
523251138 OK 523251138
3251100 ERROR 3251100
+48 0 523251138 ERROR 0523251138
+48 0887678542 ERROR 0887678542
+49 0887678542 ERROR 00490887678542

TAPI Ustawienia reguł wybierania numeru.jpg

  • Testy
Numer zapisany w MS Outlook Rezultat Numer przekazany do SlicanTAPI
138 OK 138
(52) 3251138 OK 0523251138
(052) 3251138 OK 0523251138
+48 887678542 OK 0887678542
+49 887678542 OK 0049887678542
+48523251138 OK 0523251138
0523251138 OK 0523251138
664789911 OK 0664789911
0664789911 OK 0664789911
+48 (0) 523251138 OK 01033523251138
+48 (0) 563251138 OK 01033563251138
(56) 3251138 OK 01033563251138
+48 (56) 3251138 OK 01033563251138
+48 563251138 OK 0563251138
563251138 ERROR 563251138
523251138 OK 0523251138
3251138 ERROR 3251138
+48 0 523251138 ERROR 00523251138
+48 0887678542 ERROR 00887678542
+49 0887678542 ERROR 0490887678542

Ustawienia - wyjście na miasto przez siedem

  • Parametry jakie należy ustawić w systemie przy wyjściu na miasto przez siedem dla miasta Bydgoszcz.
Zamiast liczby siedem może być wpisana dowolna liczba np. 0. 
Liczba siedem został w tym przykładzie użyta aby wyróżniała się w testach (aby rzucała się w oczy).

TAPI Opcje telefonu i modemu.jpg TAPI Ustawienia lokalizacji - wyjście na miasto przez 7.jpg TAPI Ustawienia reguł wybierania numeru.jpg

  • Testy
Numer zapisany w MS Outlook Rezultat Numer przekazany do SlicanTAPI
138 OK 138
(52) 3251138 OK 70523251138
(052) 3251138 OK 70523251138
+48 887678542 OK 70887678542
+49 887678542 OK 70049887678542
+48523251138 OK 70523251138
0523251138 OK 0523251138
+48 (0) 523251138 OK 701033523251138
+48 (0) 563251138 OK 701033563251138
(56) 3251138 OK 701033563251138
+48 (56) 3251138 OK 701033563251138
+48 563251138 OK 70563251138
563251138 ERROR 563251138
523251138 OK 0523251138
3251138 ERROR 3251138
+48 0 523251138 ERROR 700523251138
+48 0887678542 ERROR 700887678542
+49 0887678542 ERROR 700490887678542

Opis interpretacji numeru telefonicznego przez program MS Office Outlook

  • +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 zamieniany jest na 0 i w takiej formie przekazywany do TAPI.
  • (52), (052), (56), (..) - numer telefonu zawierający wpis w nawiasach jest interpretowany jako numer kierunkowy
  • 523251138 - jest interpretowane jako numer wewnętrzny.