kClient HTML Help: MAKRA

Pomoc zawiera:

• Uwagi ogólne
• Widok okna edycji makr
• Kanał specjalny wykonania makra
• Plik wsadowy programu kClient
• Przykład makra - konferencja dla dyspozytora
• Przykład makra - szybka konferencja z telefonu

Uwagi ogólne

• Począwszy od wersji X.15 w oprogramowaniu KKO wprowadzono możliwość stosowania makr. W mikroprogramie karty możliwe jest zadeklarowanie i uruchomienie makra wewnętrznego.
• Makra wewnętrzne buduje się w oparciu o rekordy harmonogramu.
• Możliwe jest zadeklarowanie do 9 makr wewnętrznych.
• Zadania marka wprowadzane są jako rekordy harmonogramu w zakładce 'harmonogram' i wykonywane w kolejności zgodnej z numeracją rekordów.
• Dla każdego makra można wprowadzić do 10 rekordów (przy czym suma rekordów w zakładce 'harmonogram' nie może przekroczyć 40).
• Każdy rekord zawiera niezbędne informacje do wykonania oraz parametr przesunięcia czasu w celu opóźnienia wykonania rekordu.
• Zadaniami makra mogą być wszystkie dostępne rodzaje rekordów takie jak powiadomienia, wywołanie pościgu oraz wszystkie rekordy dla dowolnej konferencji. Do makra nie można przypisywać rekordów związanych z dzierżawionymi konferencjami.
• Każde makro może zostać wywołane na 3 sposoby : poleceniem z programu kClient, poprzez wybranie kanału specjalnego PCM, przez system menu głosowego karty oraz jako element makra zewnętrznego czyli pliku wsadowego programu kClient.
• Zakładka 'makra' umożliwia edycję i tworzenie plików wsadowych makr zewnętrznych.
• Pliki wsadowe pozwalają na skonfigurowanie najczęściej używanych opcji takich jak np. konferencje z określonymi grupami predefiniowanymi jako pliki wsadowe makr i umieszczenie ich na pulpicie. Następnie jest możliwe uruchomienie programu kClient i automatyczne wykonanie makra jednym kliknięciem.

Na zakładce makr znajdują się następujące elementy:

• Lista rekordów danego makra. Użycie przycisku "Czytaj" powoduje wyczytanie wszystkich rekordów harmonogramu dotyczących makr. Spośród wszystkich rekordów wybierane są te, które dotyczą danego makra. Tak więc widoczna tutaj lista jest wynikiem filtrowania wszystkich przeczytanych rekordów. Makro powinno posiadać do 10 wpisów (rekordów składowych). Jeżeli wpisów dla danego makra jest więcej, wówczas tylko pierwszych 10 jest pokazywanych w tabelce dla danego makra.
• Parametry bieżącego makra. W zależności od typu rekordu (wołanie abonenta, konferencji itp) niektóre pozycje na liście takie jak np numer abonenta, numer grupy są wprowadzone. Są to te same parametry które wprowadzono w danym rekordzie.
• Czasy opóźnień dla każdego rekordu. Rekordy zawierają parametr 'czas wykonania' liczony w sekundach który oznacza przesuniecie czasu wykonania rekordu w stosunku do poprzedniego rekordu na liście. Wprowadzjąc rekord dla makra w zakładce 'harmonogram' należy pamiętać, że wprowadzany tam czas jest liczony względem poprzedniego rekordu. W tabelce rekordów dla danego makra w zakładce 'makra' podano czas skalkulowany względem momentu wydania polecenia wykonania makra.
• Klawisz odczytu stanu. Ostatnią rubryką w tabeli makr jest stan rekordu. W chwili wykonywania się makra jest możliwe sprawdzenie stanu (który rekord jest aktualnie wykonywany) dla celów diagnostycznych. Klikając powyższy klawisz otrzymujemy zwrotnie informację który z rekordów jest w stanie 'aktywnym'. Przyjęto, że rekord oczekujący na wykonanie jest aktywny.
• Wybór makra. Na górze okienka istnieje możliwość wybrania 1 z 9 dostepnych makr. Wybierać można tylko wśród makr zdefiniowanych i tylko takie przyciski wyboru są dostępne.
• Klawisz wykonania makra. Na zakładce makr umieszczono też klawisz wykonania makra. Jego naćiśnięcie jest tożsame z z innymi sposobami wykonania makra takimi jak wybranie kanału specjalnego, wykonanie makra z menu lub z pliku wsadowego.
• Kanal specjalny. W dolnej prawej części okienka umieszczono klawisze i okienka edycyjne umożliwiające ustawienie i edytowanie kanałów specjalnych dla wybranego makra.
• Plik wsadowy. W dolnej lewej części okienka umieszczono klawisze i okienka edycyjne umożliwiające ustawienie i edytowanie plików wsadowych programu kClient.

Koncepcja kanałów specjalnych makr:

• Kanały specjalne służą do szybkiego wykonania makra na karcie KKO.
• Samo zajęcie kanału uruchamia makro w programie karty a abonent zajmujący kanał otrzymuje informację głosową "Komenda wykonana "i zostaje rozłączony.
• Dla jednego makra można przypisać więcej niż jeden kanał specjalny, trzeba jednak pamiętać że kanały specjalne zmniejszają pulę ogólną kanałów na karcie KKO. Jeżeli kanał zostanie zadeklarowany jako specjalny, nie jest on brany pod uwagę przy wybieraniu abonentów do konferencji przez KKO.
• Uruchamianie makr przez telefon jest także możliwe poprzez menu głosowe przez kod '0'. Jednak działają tutaj wszystkie mechanizmy menu głosowego takie jak np wchodzenie z hasłem itp. Jeżeli zależy nam na szybkim uruchamianiu makra bez dodatkowych czynności i potwierdzeń, wówczas właśnie możemy użyć kanału specjalnego.

Koncepcja plików wsadowych programu kCLient:

• Nazwa pliku wsadowego może zostać podana jako parametr wejściowy dla programu kClient.
• Plik wsadowy uruchamia program dla wybranego poziomu dostepu i łączy się z kartą o wybranym adresie.
• Plik musi mieć określona syntaktykę i może zostać utworzony przez program kClient.
• Plik zawiera numer makra wewnętrznego które zostanie uruchomione po zalogowaniu.
• Numer makra może być zerowy, wówczas nastąpi jedynie szybkie zalogowanie do karty.
• Dzięki odpowiedniemu zdefiniowaniu makr, możliwe jest utworzenie kilku ikon na pulpicie i zarządzanie konferencjami poprzez jedno kliknięcie.
• Nazwa pliku wsadowego może być z pełną ścieżką dostępu lub skrócona. W przypadku nazwy skróconej zakłada się że plik znajduje się w katalogu instalacyjnym '//macros'. Jeżeli nie jest podane rozszerzenie, przyjmowane jest domyślnie '.kcs'

Poniżej przedstawiono widok przykładowego pliku wsadowego:

Widać że zawiera on jedynie parametry potrzebne do zalogowania oraz numer makra.

Przykład 1 - Konferencja dla dyspozytora.

Opisane w tym przykładzie makro umożliwia szybkie wywołanie konferencji z grupą 1 oraz prowadzącym nr=204 przez dyspozytora programu kClient oraz plik wsadowy.

Przykład 1 - Krok 1 - Tworzenie rekordów makra

W pierwszym kroku musimy zadeklarować rekordy makra. Zostaną zadeklarowane następujące rekordy :

Wywołanie grupy. Nie jest potrzebne wcześniejsze zajmowanie konferencji bowiem zakładamy że makro będzie wołane przez dyspozytora który logując się poprosi o jedną konferencję. Wobec tego rekordy makra dotyczące 'dowolnej konferencji' będą dotyczyć konferencji rezerwowanej dla dyspozytora na etapie logowania. Wobec tego pierwszym działaniem makra może być wołanie grupy. Podobnie zresztą nie musimy (nie możemy) wprowadzać rozkazu rozłączenia konferencji na końcu sekwencji makra gdyż właścicielem tej konferencji będzie dyspozytor i od zwolni konferencję po wylogowaniu się z programu. Parametr przesuniecia czasu dla tego rekordu może być zerowy bowiem nie zamierzamy opóźniać momentu wystartowania makra.

Uwaga! Gdyby pierwszym rekordem tego makra było zajęcie konferencji, wówczas powstałaby konferencja dla harmonogramu i rozkazy dotyczące grup i abonentów dotyczyłyby tej właśnie konferencji (do której użytkownik - dyspozytor nie ma dostępu).

Wywołanie abonenta. Wprowadzamy żadany numer abonenta (204) oraz czas opóźnienia 10 sekund. Dzięki temu abonent prowadzący konferencję (np szef) nie bedzie uczestniczył w etapie wywoływania poszczególnych członków grupy predefiniowanej nr 1. Jeżeli zwykle czas zestawiania połączenia grupowego jest dłuższy, możemy wydłużyć czas opóźnienia dla tego rekordu (maksymalnie do 90 sekund).

Następnie musimy wysłać rekordy do karty KKO

Na zakładce 'makra' można sprawdzić czy wprowadzone makro znalazło się na karcie. W tym celu należy odczytać dane z karty i przejść do zakładki 'makra'.

Przykład 1 - Krok 2 - Tworzenie pliku wsadowego

Teraz zostanie określony i utworzony plik wsadowy dla wprowadzonego wyżej makra. Musimy wykonać następujące czynności:

Utworzenie pliku. Jeśli tworzymy nowy plik, musimy najpierw podać jego nazwę (najlepiej w katalogu \\macros). W naszym przykladzie wprowadzamy nazwę 'przyklad1.kcs' i po zatwierdzeniu rozpoczynamy edycję odpowiednich pól makra.

Wprowadzenie parametrów. Wprowadzamy wywołanie makra numer 1. W procedurze logowania wybieramy poziom 'dyspozytora' , brak konieczności podawania hasła przy logowaniu (aby przyspieszyć proces zestawiania konferencji) oraz adres karty. Jeżeli mamy jedną kartę i makro ma być realizowane na bieżącej (zalogowanej) karcie KKO, mozemy się posłużyć przyciskiem 'Adres domyślny'. W polu 'liczba konferencji' wprowadzamy jedną konferencję aby rozkazy wołania grup czy abonentów były jednoznacznie odniesione do tej właśnie konferencji. Po wprowadzeniu parametrów naciskamy przycisk 'Zapisz plik' i otrzymujemy potwierdzenie utworzenia pliku wsadowego programu kClient.

Przykład 1 - Krok 3 - Utworzenie ikony z plikiem wsadowym

Tworzymy na pulpicie nowy skrót do programu kClient i prawym klawiszem myszy otwieramy okienko właściwości tego skrótu. Następnie dopisujemy nazwę makra (w naszym przykładzie 'przyklad1') i możemy zmienić nazwę skrótu przykładowo na 'Makro1' albo 'Grupa1_abonent204'.

Teraz wystarczy kliknąć tak przygotowaną ikonę aby zaszły następujące zdarzenia:

• Uruchomienie programu kClient.
• Automatyczne zalogowanie dyspozytora.
• Wywołanie makra 1 czyli wywołanie grupy nr 1 a następnie abonenta 204. To działanie potwierdzane jest komunikatem na ekranie informującym o wykonaniu makra.
• Automatyczne wejście dyspozytora do konferencji.
• W trakcie trwania konferencji dyspozytor może nią zarządzać, może także ją zakończyć.
• Po wylogowaniu się dyspozytora konferencja zostanie automatycznie zwolniona.

Przykład 2 - Szybka konferencja z telefonu.

Opisane tu przykładowe makro umożliwia szybkie wywołanie konferencji z grupą 1 oraz prowadzącym nr=203 przez telefon z wykorzystaniem kanału specjalnego.

Przykład 2 - Krok 1 - Tworzenie rekordów makra

W pierwszym kroku musimy zadeklarować rekordy makra. Zostaną zadeklarowane następujące rekordy :

Rezerwacja konferencji. W tym wypadku makro będzie wołane z telefonu przez kanał specjalny. Aby nie było trzeba rezerwować konferencji kodem 7 z telefonu można wykorzystać konferencję harmonogramową (której właścicielem będzie harmonogram). Trzeba więc zająć (zarezerwować) konferencję specjalnym rekordem harmonogramu. Wobec tego wszystkie następne rekordy makra dotyczące 'dowolnej konferencji' będą dotyczyć konferencji której właścicielem jest harmonogram. Telefon z którego uruchamiane jest makro może być członkiem wywoływanej grupy 1. Można więc wykorzystać parametr przesuniecia czasu aby abonent wywołujący zdążył wysłuchać informacji o tym czy jego komenda powiodła się i żeby był wywoływany od razu z całą grupą.

Wywołanie grupy. Parametr przesuniecia czasu dla tego rekordu może być zerowy bowiem nie zamierzamy opóźniać momentu wystartowania makra.

Wywołanie dodatkowego abonenta. Wprowadzamy żadany numer abonenta (203) oraz czas opóźnienia 10 sekund. Dzięki temu abonent prowadzący konferencję (np szef) nie bedzie uczestniczył w etapie wywoływania poszczególnych członków grupy predefiniowanej nr 1. Jeżeli zwykle czas zestawiania połączenia grupowego jest dłuższy, możemy wydłużyć czas opóźnienia dla tego rekordu (maksymalnie do 90 sekund).

Następnie musimy wysłać rekordy do karty KKO

Na zakładce 'makra' można sprawdzić czy wprowadzone makro znalazło się na karcie. W tym celu należy odczytać dane z karty i przejść do zakłądki 'makra'.

Przykład 2 - Krok 2 - Ustawianie kanału specjalnego

Teraz zostanie zdefiniowany i wprowadzony do karty numer kanału specjalnego uruchamiający to makro. Musimy wykonać następujące czynności:

Wybranie kanału. Kanał jest wybierany z puli 60 dostępnych kanałów dla KKO60. Oczywiście w przypadku KKO30 nie ma sensu definiowanie kanału z drugiego traktu.

Wysłanie danych do karty. Po wybraniu kanału należy odesłać dane do karty naciskając klawisz 'Wyslij'. Jeśli kanał zostanie poprawnie zapisany, pojawi się niżej na liście kanałów skojarzonych z makrem.