kClient HTML Help: PLIKI ROZKAZÓW

Pomoc zawiera:

• Uwagi ogólne
• Syntaktyka plików CMD
• Konfiguracja mechanizmu plików CMD
• Przykładowe pliki CMD

Uwagi ogólne

• Aby umożliwić wprowadzanie danych do systemu KKO z zewnętrznych źrodeł, program kClient wyposażono w funkcję skanowania katalogu i poszukiwania plików interpretowanych jako rozkazy. Umożliwia to zarządzanie konferencjami w oparciu o konferencje dzierżawione oferowane przez system KKO.
• Program kClient przegląda okresowo podany katalog i w przypadku wykrycia pliku tekstowego o dowolnej nazwie i rozszerzeniu ".cmd" traktuje taki plik jak źródło danych dla sterowania konferencją (zwany dalej "Plikiem Rozkazu").
• Pliki naturalnie muszą mieć określoną składnię i muszą zawierać określone parametry. W rozdziale syntaktyka plików umieszczono szczegóły dotyczące składni i wymaganych parametrów pliku CMD a poniżej widać treść przykładowego pliku w którym zakodowano rozkaz rozpoczęcie i zakończenie konferencji nr 1 w określonym czasie z hasłem dostępu 1234.
  
  
  
• Po wykryciu pliku rozkazu CMD plik taki zostaje zdekodowany i określone rozkazy zostają automatycznie wysłane do karty KKO. Zapisują się jako rekordy harmonogramu (patrz zakładka: Plan) i zostają wykonane zgodnie z regułami dotyczącymi rekordów harmonogramu.
• Poprzez pliki CMD możliwe jest wykonanie następujących zleceń:
  • Zarezerwowanie określonej konferencji w określonym czasie.
  • Zwolnienie zarezerwowanej konferencji w określonym czasie.
  • Zmiana hasła dostepu do konferencji w określonym czasie.
  • Wywołanie/usunięcie abonenta do istniejącej konferencji.
  • Wywołanie/usunięcie zapowiedzi słownej do istniejącej konferencji.
• Poprzez odpowiednie wartości parametrów zawartych w pliku możliwe jest wykonywanie powyższych zadań w następujących reżimach czasowych:
  • Jednorazowe wykonanie danego zadania w określonym dniu i czasie.
  • Programowanie zadań cyklicznych (np codziennie, raz w tygodniu itd).
  • Wykonywanie zadań w określone dni tygodnia.
  • Programowanie zadań w dni wolne i robocze.
  • Programowanie zadań co określny odstęp czasu (co kilka dni/godzin/minut).
• W szczególności system taki zapewnia możliwość świadczenia usług konferencyjnych wg określonego harmonogramu generowany przez odrębny scheduler użytkownika.
• Jedynym wymaganym stykiem w tym przypadku jest wspólny katalog z danymi do którego mają dostęp zarówno program kClient jak i oprogramowanie użytkownika.
• Po wykonaniu rozkazów zawartych w pliku, plik taki zostaje przemianowany lub skasowany.
• W programie kClient umieszczono szereg opcji umożliwiających konfigurację parametrów działania mechanizmu plików CMD. Szczegółowo wszystkie opcje opisano w punkcie konfiguracja mechanizmu plików CMD niniejszego dokumentu.
• Mechanizm skanowania katalogu w poszukiwaniu plików CMD można włączyć lub wyłączyć. Domyślnie po zainstalowaniu programu kClient mechanizm ten jest wyłączony.

Syntaktyka plików CMD

Syntaktykę plików CMD opisano dokładnie także w dokumencie: Pliki rozkazów CMD. Każdy wiersz w pliku stanowi zadanie dla jednego rekordu harmonogramu (Harmonogram). Jest możliwe wpisanie każdego polecenia do odrębnego pliku albo kilku poleceń w osobnych liniach do jednego pliku. Każda linia musi być zakończona znakami CR,LF. Rozkazy znajdujące się w jednym pliku będą wykonywane chronologicznie czyli w kolejności zamieszczenia linii w pliku. Pliki będą wykrywane w katalogu zgodnie z ustawieniami systemu i nie można mieć pewności że plik wysłany wcześniej ale jeszcze niewykonany będzie wykonany przed plikiem wysłanym nieco później. Jeśli więc zależy nam na tym aby mieć kontrolę nad kolejnością wykonywania rozkazów, zalecaną metodą jest umieszczanie ich w jednym pliku jako osobne linie.

Plik rozkazu jest plikiem tekstowym, może mieć dowolną nazwę i musi mieć rozszerzenie "cmd". W katalogu przeszukiwania może być więcej niż jeden plik CMD. Każdorazowo w okresie przeszukiwania pobierany jest jeden plik CMD i wykonywany.

W każdym wierszu wystepują parametry wymagane (obligatoryjne) jak i dodatkowe.

Parametry obligatoryjne muszą znaleźć sie w każdej linii rozkazu i są następujące:

• "CONF" - numer konferencji
• "FREQ" - parametr częstości wykonania rozkazu
• "EVENT" - rodzaj żądanego zdarzenia

Parametry opcjonalne są następujące:

• "DATE" - data kalendarzowa wykonania zadania
• "TIME" - oczekiwany czas wykonania rozkazu.
• "DIR" - numer telefonu abonenta w rozkazach zawierających numery
• "ANN" - numer zapowiedzi słownej w rozkazach z zapowiedziami
• "PASS" - hasło dostępu do konferencji
• "PAR" - dodatkowy parametr
• "GRP" - numer grupy predefiniowanej

Parametry w linii oddzielone są od siebie znakiem średnika lub przecinka.

CONF

Parametr określa numer konferencji 1 do 5 której dotyczy rozkaz.

Poprawny format : CONF=n;
gdzie n=1,2,3,4 lub 5

FREQ

Parametr określa cykliczność (czas lub okresowość) według której będzie wykonywany dany rozkaz rozkaz.

Poprawny format : FREQ=n;
gdzie n=1 do 15

Wartość tego parametru musi mieścic sie w granicach 1..15 i poszczególne wartości oznaczają nastepujące akcje:

• FREQ=1 - Zdarzenie jednorazowe. Wykonywane tylko raz w określonym dniu i okreslonym czasie. Dodatkowe parametry TIME i DATE określają czas wykonania zdarzaenia. Jeśli parametry dodatkowe nie wystepują, przyjmowana jest bieżąca data i godzina
• FREQ=2 - Raz w miesiącu. Wykonywane zawsze tego samego dnia miesiąca o okreslonej godzinie. Dodatkowe parametry TIME i DATE określają czas wykonania zdarzenia. Na potrzeby tego rekordu potrzebny jest jedynie dzień a miesiąc i rok są ignorowane. Jednak dla zachowania spójności syntaktycznej jeśli wprowadzana jest data należy podać pełną datę.
• FREQ=3 - Codziennie. Wykonywane codziennie o tej samej godzinie. Dodatkowy parametr: TIME określa czas wykonania zdarzenia. W przypadku braku parametru TIME zdarzenie realizowane o godzinie w której wykonano plik rozkazu.
• FREQ=4 - Co n dni. Wykonywane co n dni począwszy od dnia bieżacego. Wymagany parametr : PAR=n gdzie n=1..31 dni. Dodatkowy parametr: TIME określa czas wykonania zdarzenia. W przypadku braku parametru TIME - czas bieżący.
• FREQ=5 - Co n godzin. Wykonywane co n godzin począwszy od czasu zadanego w TIME. W przypadku braku parametru TIME - czas bieżący. Wymagany parametr : PAR=n gdzie n=1..72 godzin.
• FREQ=6 - Co n minut. Wykonywane co n minut począwszy od czasu zadanego w TIME. W przypadku braku parametru TIME - czas bieżący. Wymagany parametr : PAR=n gdzie n=5..180 minut.
• FREQ=7 - W dni robocze. Zdarzenie będzie powtarzane cyklicznie we wszystkie dni tygodnia od poniedziałku do piątku z pominięciem dni okreslonych w zakładce Plan jako "Dni dodatkowo wolne".
• FREQ=8 - W dni wolne. Zdarzenie będzie powtarzane cyklicznie w soboty i niedziele oraz wszystkie dni okreslonych w zakładce Plan jako "Dni dodatkowo wolne".
• FREQ=9 - W poniedziałki. Zdarzenie będzie powtarzane cyklicznie w każdy poniedziałek o godzinie określonej w TIME. W przypadku braku parametru TIME - czas bieżący.
• FREQ=10 - We wtorki. Zdarzenie będzie powtarzane cyklicznie w każdy wtorek o godzinie określonej w TIME. W przypadku braku parametru TIME - czas bieżący.
• FREQ=11 - W środy. Zdarzenie będzie powtarzane cyklicznie w każdą środę o godzinie określonej w TIME. W przypadku braku parametru TIME - czas bieżący.
• FREQ=12 - W czwartki. Zdarzenie będzie powtarzane cyklicznie w każdy czwartek o godzinie określonej w TIME. W przypadku braku parametru TIME - czas bieżący.
• FREQ=13 - W piątki. Zdarzenie będzie powtarzane cyklicznie w każdy piątek o godzinie określonej w TIME. W przypadku braku parametru TIME - czas bieżący.
• FREQ=14 - W soboty. Zdarzenie będzie powtarzane cyklicznie w każdą sobotę o godzinie określonej w TIME. W przypadku braku parametru TIME - czas bieżący.
• FREQ=15 - W niedziele. Zdarzenie będzie powtarzane cyklicznie w każdą niedzielę o godzinie określonej w TIME. W przypadku braku parametru TIME - czas bieżący.

EVENT

Parametr określa jakie zdarzenie ma zostać zrealizowane - jaki rozkaz zawarty w pliku CMD ma zostać wykonany. Parametr ten musi wystąpić w każdej linii pliku rozkazu.

Poprawny format : EVENT=n;
gdzie n=1 do 8

Wartość tego parametru musi mieścic sie w granicach 1..8 i poszczególne wartości oznaczają nastepujące akcje:

• EVENT=1 - Rezerwacja konferencji. Parametr CONF określa numer konferencji dzierżawionej która zostanie użyta dla plików rozkazu. Dodatkowo, obligatoryjnie żąda się aby konferencja dla osób samodzielnie wchodzących była zabezpieczona hasłem (parametr PASS). Pamiętać należy że konferencja zestawiona tym rozkazem nigdy nie rozłączy się sama (i nie straci właściciela) automatycznie (może nikogo w niej nie być ale będzie istniała i hasło dostępowe będzie obowiązywało). Wobec tego wymagany jest więc zawsze rozkaz komplementarny "Rozłączenie konferencji" czyli EVENT=7. Możliwe jest także "nadpisanie" istniejącej konferencji nową z nowym hasłem i od stanu parametru "Nowa konferencja rozłącza starą" zależy czy stara konferencja zostanie rozlączona. Możliwe jest także trwanie raz zestawionej konferencji (bez rozkazu jej zakończenia) i wówczas konferencja trwa dopóki karta KKO nie zostanie elektrycznie wyresetowana. Konferencja ma "właściciela" typu "LEASING".
• EVENT=2 - Wywołanie grupy. Rozkaz wywołuje grupę abonencką predefiniowaną do konferencji wcześniej zarezerwowanej. Grupy predefiniowane pamiętane są na karcie KKO i wywoływane jednym rozkazem. Wymagany parametr dodatkowy w tym przypadku to GRP=n gdzie n=1..32.
• EVENT=3 - Wywołanie abonenta do konferencji. Rozkaz wywołuje pojedynczego abonenta do konferencji wcześniej zarezerwowanej. Numer abonenta jest w typ przypadku obligatoryjny (parametr DIR) i może to być ciąg cyfr o maksymalnej długości 20 znaków.
• EVENT=4 - Usunięcie abonenta z konferencji. Rozkaz zwalnia pojedynczego abonenta z konferencji. Numer abonenta jest w typ przypadku obligatoryjny (parametr DIR).
• EVENT=5 - Włączenie zapowiedzi słownej. Rozkaz włącza zapowiedź słowną do konferencji wcześniej zarezerwowanej. Numer zapowiedzi jest obligatoryjny (parametr ANN=n gdzie n=1..60). Zapowiedź musi być wcześniej nagrana. Do konferencji można włączyć w jednym czasie tylko jedną zapowiedź słowną. Funkcja ta może być użyteczna w przypadku gdy traktujemy zapowiedzi jako komunikaty ostrzegawcze (np: "Proszę czekać, będzie konferencja") przed właściwą konferencją albo (np: "Uwaga! Konferencja zostanie rozłączona za 5 minut") lub w skrajnym wypadku treść zapowiedzi może stanowić wyłączną treść komunikatu słownego przekazywanego drogą połączenia konferencyjnego (rozgłaszanie).
• EVENT=6 - Usunięcie zapowiedzi słownej z konferencji. Rozkaz usuwa zapowiedź z konferencji. Numer zapowiedzi jest obligatoryjny (parametr ANN) przy czym oczywiście ta sama zapowiedź musi być uprzednio włączona do konferencji.
• EVENT=7 - Zakończenie konferencji. Rozkaz komplementarny do rozkazu rezerwacji konferencji (EVENT=1). Abonenci zostają rozłączeni a konferencja staje się wolna (bez właściciela).
• EVENT=8 - Zmiana hasła w konferencji. Rozkaz może zostać użyty po to żeby w istniejącej konferencji zmienić hasło (o wymaganej porze) bez jej rozłączania. Podobny efekt można uzyskać jeśli zostanie wyłaczona opcja "Nowa konferencja rozłącza starą" i wydamy polecenie zajęcia konferencji. Niemniej zaleca się włączenie na stałe tej opcji a ewentualną zmianę hasła w konferencji zaleca się realizować rozkazem EVENT=8.
• EVENT=9 - Wywołanie polowania. Rozkaz wywołuje polowanie z grupą predefiniowaną (w trybie zająca) i pojedynczym abonentem (w trybie myśliwego). Wymagane parametry to : GRP=n gdzie n=1..32 oraz DIR.

DATE

Parametr określa datę kalendarzową w rozkazach.

Poprawny format : DATE=YYYY-MM-DD;
gdzie YYYY=rok MM-dzień i DD-dzień

W każdym rozkazie brak parametru DATE oznacza polecenie przyjęcia tej wartości w chwili wykrycia i realizacji pliku CMD (a właściwie w chwili wysłania rozkazu do karty KKO). Format daty musi być tak jak określono wyżej, separatorem pól musi być znak '-' a dni i miesiące poniżej 10 muszą być poprzedzone nieznaczącymi zerami.

TIME

Parametr określa czas w rozkazach.

Poprawny format : TIME=GG:MM;
gdzie MM-godzina i MM-minuta

W każdym rozkazie brak parametru TIME oznacza polecenie przyjęcia tej wartości w chwili wykrycia i realizacji pliku CMD (a właściwie w chwili wysłania rozkazu do karty KKO). Format czasu musi być tak jak określono wyżej, 24-godzinny separatorem pól musi być znak ':' a godziny i minuty poniżej 10 muszą być poprzedzone nieznaczącymi zerami.

DIR

Parametr służy do wprowadzenia numeru abonenta w rozkazach dołączenia i usunięcia abonenta z konferencji.

Poprawny format : DIR=nn..n;
gdzie nn..n-numer abonenta

W rozkazach o EVENT=3 i EVENT=4 parametr jest obligatoryjny. Maksymalna długośc numeru wynosi 20 cyfr, dopuszczalne znaki to cyfry '0'..'9'.

ANN

Parametr służy do wprowadzenia numeru zapowiedzi słownej w rozkazach dołączenia i usunięcia zapowiedzi z konferencji.

Poprawny format : ANN=n;
gdzie n=1 do 60

W rozkazach o EVENT=5 i EVENT=6 parametr jest obligatoryjny. Zapowiedź musi być nagrana, w jednym czasie w konferencji może być tylko jedna zapowiedź. Więcej o zapowiedziach słownych można znaleźć w opisie zapowiedzi słownych karty KKO.

PASS

Parametr służy do wprowadzenia hasła w rozkazie rezerwacji konferencji.

Poprawny format : PASS=nn..n;
gdzie nn..n-znaki hasła

W rozkazie z EVENT=1 parametr jest obligatoryjny. Maksymalna długośc hasła wynosi 5 cyfr, dopuszczalne znaki to cyfry '0'..'9'.

GRP

Parametr służy do wprowadzenia grupy predefiniowanej.

Poprawny format : GRP=n;
gdzie n=1 do 32

W rozkazie z EVENT=2 i EVENT=9 parametr jest obligatoryjny.

PAR

Parametr dodatkowy PAR służy do wprowadzenia rozdzielczości czasu w rozkazah z FREQ=4, FREQ=5 i FREQ=6.

Poprawny format : PAR=n;
gdzie n-wartość parametru zależna od FREQ.

Dla częstości "co n dni" n może wynosić 1..31 dni. Dla częstości "co n godzin" n może wynosić 1..72 godzin. Dla częstości "co n minut" n moze wynosić 5..180 minut.

Konfiguracja mechanizmu plików CMD

W programie kClient i na karcie KKO przewidziano szereg opcji konfiguracyjnych ułatwiających posługiwanie się mechanizmem plików CMD. Ustawione tutaj opcje są automatycznie zapisywane w odpowiednim pliku konfiguracyjnym w chwili zamknięcia zakładki Harmonogramowanie konferencji. W chwili wywołania tej opcji dane z pliku konfiguracyjnego są automatycznie odczytywane i respektowane.

Poniższy rysunek przedstawia okienko konfiguracyjne (zakładka Pliki poleceń w opcji Harmonogramowanie konferencji - klawisz "Plan"):

W okienku umieszczono następujące opcje:

• Włączanie mechanizmu obsługi plików. Jeśli opcja jest wyłączona, folder nie jest skanowany i pliki rozkazów nie są obsługiwane a konfiguracja jest nieaktywna.





• Pola wyboru dysku i katalogu. Nalezy wybrać katalog i zatwierdzić go podwójnym kliknięciem klub klawiszem Enter. Wybrany tutaj katalog staje się folderem plików rozkazów CMD i tylko ten katalog jest przeszukiwany. Widoczne obok okienko pokazuje bieżący katalog (w naszym przykładzie G:\AeRJoT\kClient\command).





• Okres (częstotliwość) skanowania katalogu . Można regulować czas między kolejnymi próbami odczytu pliku w folderze przeszukiwania. Czas ten reguluje się w zakresie 2..60 sekund z rozdzielczością 2 sekund. Wartość domyślna wynosi 10 sekund. W każdym cyklu przeszukiwania pobierany jest jeden plik z rozszerzeniem CMD, następuje analiza poprawności składni tego pliku a następnie po zakodowaniu poszczególne rozkazy odpowiadające liniom pliku wysyłane są do karty KKO jako rekordy harmonogramu. Kiedy skanowanie działa (opcja właczona, kClient w stanie zalogowania) obok okienka wyboru okresu pojawia się okienko bieżącej wartości licznika wskazujące ile sekund pozostaje do najbliższego przeskanowania katalogu. Nie należy ustawiać zbyt dużej częstotliwości (mały czas) skanowania gdyż pojawianie się plików CMD nie jest szybkozmiennym procesem a częste skanowanie niepotrzebnie obciąża zasoby komputera. Duży czas skanowania oznacza jednak duże (dochodzące do minuty przy ustawieniu liczby 60) opóźnienie między wysłaniem pliku do katalogu a jego obsłużeniem.





• Reakcja na pliki rozkazów poprawnie wykonane. Po wykonaniu pliku, jeżeli jego składnia jest poprawna a karta KKO nie odrzuca wysłanej komendy plik może zmienić nazwę lub zostać skasowany. Poniższe okienko pokazuje możliwe do ustawienia dwie opcje. W przypadku ustawienia opcji kasowania pliki znikają i nie trzeba zajmować się ich usuwaniem z katalogu. W przypadku zmiany nazwy pliku wykonane pliki dalej znajdują się w katalogu ale dzięki temu mamy możliwość stwierdzenia (dokumentowania) wykonywanych operacji z kartą KKO. W takim przypadku użytkownik może określać nazwę (rozszerzenie) na jaką zamieniane będą pliki po wykonaniu. Domyślne rozszerzenie to "old". Okienko z listą plików pokazuje bieżący stan katalogu dla plików wykonanych.





• Reakcja na pliki rozkazów niewykonanych. Pliki rozkazów moga zawierać błędy syntaktyczne lub mimo poprawności nie zostaną zrealizowane ze względu na brak zasobów karty (np: próba właczenia nienagranej zapowiedzi słownej, próba wywołania pustej grupy predefiniowanej albo nieistniejącego abonenta). W takim przypadku plik nie zostaje poprawnie wykonany, i podobnie jak w poprzednim przypadku może zmienić nazwę lub zostać skasowany. Poniższe okienko pokazuje możliwe do ustawienia dwie opcje. W przypadku ustawienia opcji kasowania pliki znikają i nie trzeba ich usuwać z katalogu. W przypadku zmiany nazwy pliki dalej znajdują się w katalogu ale dzięki temu mamy możliwości dokumentacyjne źle wykonywanych operacji. W takim przypadku użytkownik może także określić nazwę (rozszerzenię) na jaką zamieniane będą pliki. Domyślne rozszerzenie to "err". Okienko z listą plików pokazuje bieżący stan katalogu dla plików błędnych.





• Dane pamietane w KKO. Generalnie większość opcji widocznych w okienku plików rozkazów jest zapisywana w odpowiednim pliku konfiguracyjnym automatycznie w chwili zamykania okienka Harmonogramu zadań. Jednak niektóre opcje nie dotyczą działania programu kClient tylko karty KKO, muszą więc być zapisane na karcie i tylko stamtąd mogą zostać odczytane. Do tego celu służą przyciski Czytaj i Wyślij widoczne w tej części okna. Można ustawiać tutaj 2 parametry :
  • Nowa konferencja rozłącza starą. Ustawienie tego parametru powoduje że rozkaz rezerwacji konferencji (EVENT=1) w chwili realizacji najpierw rozłącza starą konferencję (jeśli taka istnieje) a nastepnie rezerwuje nową w trybie LEASING z określonym hasłem. Jeśli opcja jest wyłączona, następuje tylko zarezerwowanie konferencji i nadanie nowego hasła a istniejąca ewentualnie konferencja dalej pracuje i nowi abonenci posługując się nowym hasłem mogą sie do niej dołączać. De facto więc następuje wówczas jedynie nadpisanie nowego hasła. Generalnie zalecamy włączenie tej opcji na stałe a zmianę hasła w trakcie trwania konferencji można realizować rozkazem z EVENT=8;
  • Autokasowanie wykonanych rekordów. Jak wspomniano wcześniej każda linia pliku rozkazu wykonuje się poprzez rekord harmonogramu. Rekordy te (max 40) można zobaczyć w zakładce Harmonogram. Jeżeli używamy parametru czasu cyklicznego (FREQ>1) wówczas zawsze po wykonaniu się rekordu następuje przeliczenie czasu i czas rekordu wskazuje następne wykonanie się tego zadania (np codziennie albo raz w miesiącu). Rekord taki nigdy nie uzyskuje statusu "wykonany" bowiem tuż po realizacji jego czas jest przeliczany. Inaczej jest z rekordami z parametrem FREQ=1. Są to zadania jednorazowe, wykonywane tylko raz w zadanym czasie. Po wykonaniu takiego rekordu może on zostać zachowany albo automatycznie skasowany aby zwolnić rekord dla następnych zadań. Do tego właśnie służy niniejsza opcja. Zalecamy ustawienie autokasowania gdyż w przypadku zaniedbania ręcznego usuwania wykonanych rekordów może dojść do zapełnienia wszystkich 40 rekordów i następne zadania nie będą wykonywane.
  Poniższy obrazek pokazuje opisywane opcje.





• Bieżące hasła. Każdorazowo w trakcie rezerwowania konferencji konieczne jest wpisanie hasła dostępu (konferencje dzierżawione nigdy nie pracują bez hasła). Jednak możliwa jest także zmiana hasła odpowiednim rozkazem (EVENT=8). Wówczas hasła ulegają zmianie a w przypadku automatycznego kasowania rekordów (poprzednia opcja włączona) oraz automatycznego kasowania plików CMD po wykonaniu, nie ma już żadnego śladu wprowadzenia hasła. Niemożliwe więc byłoby odczytanie lub przypomnienie sobie hasła. W tym celu wprowadzono niniejsze okienko i możliwość przeczytania bezpośrednio z karty jakie hasło obowiązuje obecnie w danej konferencji. Nadmienić tutaj należy są to jedynie hasła do konferencji dzierżawionych rezerwowanych w opcji Harmonogram lub poprzez pliki rozkazów. Hasła do konferencji ogólnodostępnych są to inne hasła i można je wprowadzać, czytać i edytować w okienku Ustawienia->Konferenje. Tutaj możemy przeczytać jedynie hasła dla konferencji dzierżawionych (właściciel: Leasing). Opcja dostępna tylko dla Administratora i Nadzorcy. Dyspozytor nie może czytać haseł. W sytyacji gdy konferencja dzierżawiona nie pracuje albo zakończyła już pracę hasło jest usuwane i przeczytamy wtedy "BRAK".





• Właściciele konferencji. Dla wygody obsługi programu, wprowadzono tutaj możliwość sprawdzenia stanu zajęcia - właściciela każdej konferencji. Jak wspomniano w innych częściach opisu właścicielem konferencji na karcie KKO może być:
  • Brak - konferencja jest wolna, nie ma właściciela.
  • Dyspozytor czyli użytkownik programu kClient który logując się zażądał chociaż jednej konferencji.
  • Telefon czyli sytuacja gdy zarezerwowano konferencję przez telefon rozkazem '7' DTMF (lub przez stałe zajęcie dla telefonu Ustawienia ->Konferencje).
  • Harmonogram czyli zarezerwowano konferencję przez zadanie harmonogramu jako "Dowolną" (a nie określoną nr 1 lub 2 - czyli dzierżawioną).
  • Leasing czyli zarezerwowano konferencję przez zadanie harmonogramu jako dzierżawioną lub poprzez plik rozkazu CMD.
  
  Okienko to może być przydatne przed wysłaniem pliku rozkazu gdy nie chcemy rozłączyć innej konferencji (zawsze konferencja dzierżawiona ma priorytet) a także po to aby skontrolować czy przez plik rozkazu albo zadanie harmonogramu poprawnie dokonano zarezerwacji konferencji.

Przykładowe pliki

• Przykład 1: natychmiastowa rezerwacja konferencji.
  
  
  
  
W tym przykładzie wykonają się nastepujące czynności:
• Rezerwacja konferencji - konferencja nr 1, z hasłem 1234.

Proszę zauważyć że nie określono parametrów DATE i TIME, zostanie więc przyjęty bieżący czas i data. Konferencja zarezerwuje się więc w chwili wysłania rozkazu do karty KKO. Taki rozkaz można wysłać plikiem o każdej porze, nie wystąpi nigdy błąd czasu a trwająca ewentualnie inna konferencja zostanie rozłączona jeśli zaznaczono odpowiednią opcję.




• Przykład 2: natychmiastowe zwolnienie konferencji.
  
  
  
  
W tym przykładzie wykonają się nastepujące czynności:
• Zwolnienie konferencji - konferencja nr 1.

Proszę zauważyć że nie określono parametrów DATE i TIME, zostanie więc przyjęty bieżący czas i data. Konferencja zwolni się więc natychmiast. Taki rozkaz można wysłać plikiem o każdej porze, nie wystąpi nigdy błąd czasu.




• Przykład 3: konferencja o określonym czasie trwania
  
  
  
  
W tym przykładzie wykonają się nastepujące czynności:
• Rezerwacja konferencji - konferencja nr 1, o godzinie 12:00 z hasłem 1234.
• Zwolnienie konferencji - konferencja nr 1, o godzinie 14:00.

Proszę zauważyć że określono tylko TIME, nie określono prametru DATE. Zostanie więc przyjęta bieżąca data ("Dziś")zaś czas zostanie wymuszony przez parametr TIME. Jeżeli taki rozkaz byłby wysłany po godzinie 12:00, już na etapie analizy pliku program kClient stwierdziłby że rozkaz nie ma szans na wykonanie (gdyż "dziś" jest już po godzinie 12:00) i plik zostałby odrzucony jako błedny.




• Przykład 4: konferencja o dokładnie określonym czasie trwania
  
  
  
  
W tym przykładzie wykonają się nastepujące czynności:
• Rezerwacja konferencji - konferencja nr 1, dnia 15 stycznia 2008 o godzinie 12:00 z hasłem 1234.
• Zwolnienie konferencji - konferencja nr 1, dnia 15 stycznia o godzinie 14:30.

Proszę zauważyć że tutaj określono oba parametry czasowe, dokładnie więc zdeterminowano czas wykonania zadania. Plik taki nie mógłby zatem zostać przyjęty do realizacji po dacie 15 stycznia 2008 godz 12:00 gdyż zostałby wykryty błąd czasu.




• Przykład 5: konferencja ze zmiennym hasłem w czasie trwania
  
  
  
  
W tym przykładzie wykonają się nastepujące czynności:
• Rezerwacja konferencji - konferencja nr 2, codziennie o godzinie 9:00 z hasłem "900".
• Zmiana hasła o godzinie 10 - konferencja nr 2, codziennie o godzinie 10:00 zmiana hasła na "1000".
• Zmiana hasła o godzinie 11 - konferencja nr 2, codziennie o godzinie 11:30 zmiana hasła na "1130".
• Zmiana hasła o godzinie 13 - konferencja nr 2, codziennie o godzinie 13:00 zmiana hasła na "1300".
• Zwolnienie konferencji - konferencja nr 2, codziennie o godzinie 15:00.

Proszę zauważyć że tutaj wykorzystano parametr FREQ=3; Oznacza on zdarzenie generowane codziennie o tej samej porze. Jeśli mamy więc takie cykliczne konferencje, wystarczy raz zrealizować taki rekord (bezpośrednio w zakładce Harmonogram) albo poprzez plik rozkazu CMD aby codziennie uzyskiwać konferencję. Rekord taki nie skasuje się bowiem jest cykliczny.

Proszę zauważyć także że możliwe jest zmienianie hasła wiele razy w czasie trwania konferencji bez jej rozłączania. W naszym przykładzie w określonych przedziałach czasowych obowiązują różne hasła i o różnej długości (tu 3 lub 4 znaki).




• Przykład 6: rozbudowana konferencja cykliczna z zapowiedziami słownymi i abonentem prowadzącym
  
  
  
  
W tym przykładzie wykonają się następujące czynności:
• Rezerwacja konferencji - konferencja nr 1 co 8 godzin, z hasłem "11111".
• Dołączenie zapowiedzi słownej - konferencja nr 1, co 8 godzin w chwili startu konferencji, zapowiedź nr 14.
• Usunięcie zapowiedzi słownej - konferencja nr 1, co 8 godzin 5 minut po starcie konferencji, zapowiedź 14.
• Wywołanie abonenta prowadzącego - konferencja nr 1, co 8 godzin 5 minut po starcie konferencji, abonent nr 1001.
• Dołączenie zapowiedzi słownej - konferencja nr 1, co 8 godzin 55 minut po starcie konferencji, zapowiedź nr 15.
• Zakończenie i zwolnienie konferencji - konferencja nr 1, co 8 godzin, godzinę po starcie konferencji.

Proszę zauważyć że tutaj wykorzystano parametr FREQ=5; Oznacza on zdarzenie generowane co n godzin. Tutaj PAR=8 czyli co 8 godzin. Konferencja będzie odbywać się codziennie w godzinach: 6:00-7:00, nastepnie 14:00-15:00 oraz w godzinach 22:00-23:00. Jest to dobre rozwiązanie np w zakładach o pracy 3-zmianowej gdzie codziennie na każdej zmianie realizowana jest konferencja.

Ponadto proszę zauważyć że funkcjonalnie czynności w takiej konferencji są nastepujące:
• Start konferencji.
• Zapowiedź "Proszę czekać na konferencję" - w tym czasie powinni zgłaszać się abonenci, mają 5 minut na wejście przed kierownikiem. Tutaj można jeszcze bardziej usprawnić system, wpisując tych abonentów do grupy predefiniownej i wołać ich kolejnym rozkazem z EVENT=2.
• Usunięcie zapowiedzi słownej - wywołanie kierownika/prowadzącego o numerze 1001. Kierownik wchodzi po 5 minutach, jest wołany przez kartę KKO i w chwili wejścia ma już zestawioną konferencję.
• Dołączenie ostrzegawczej zapowiedzi słownej np."Proszę kończyć, za 5 minut rozłączenie" - komunikat słowny (wykorzystano wolną zapowiedź nr 15 aby skonstruować ostrzeżenie o zbliżającym się momencie rozłączenia).
• Zakończenie i zwolnienie konferencji.


Gdyby ten rozkaz został wysłany do karty bez parametru TIME, wówczas byłby przyjęty czas domyślny (chwila wykonania rozkazu). Wprawdzie syntaktycznie rozkaz byłby poprawny ale nie miałby sensu, bowiem czas każdego zdarzenia byłby taki sam i nie mielibyśmy możliwości wprowadzenia przesunięć czasu dla poszczególnych zadań.

Druga uwaga jest taka, że przed wykonaniem takiego pliku należy zapewnić istnienie odpowiednich zapowiedzi. W tym przypadku należałoby nagrać zapowiedzi słowne o następującej treści:
• Zapowiedź 14: ""Proszę czekać na konferencję"
• Zapowiedź 15: ""Konferencja zostanie rozłączona za 5 minut"