6.1. Akcja operatorska ASBASE

 

ASBASE - pozwala na zdalne sterowanie pracą programu AsBase.

 

Parametry akcji definiowane przy użyciu edytora akcji:

 

Typ operacji:

 

start - operacja powoduje uruchomienie modułu AsBase z przekazaniem mu parametrów; Jeżeli AsBase był już wcześniej uruchomiony, to operacja start jest równoważna operacji pokaż bez parametrów. Dodatkowym efektem użycia operacji start jest to, że w momencie końca pracy głównego modułu programu asix zostanie również zakończona praca modułu Asbase. Struktura parametrów jest następująca:

 

nazwa_pliku_xml [/single][/minimize] /user:<id_uzytkownika>/password:<hasło>

 

gdzie:

nazwa_pliku_xml - plik XML przechowuje podstawowe informacje konfiguracyjne, takie jak lokalizacja i sposób dostępu do bazy danych aplikacji AsBase’a; w pliku XML zapisywane są także definicje warunków archiwizacji i automatycznych receptur;

 

/single - powoduje, że w przypadku próby uruchomienia AsBase’a w sytuacji, gdy jest on już uruchomiony, nowa instancja programu nie zostanie utworzona; na pierwszy plan zostanie wyciągnięte okno wcześniej uruchomionego AsBase’a;

 

/minimize - powoduje uruchomienie AsBase’a z automatyczną minimalizacją okna;

 

/user:<id_uzytkownika>/password:<hasło> - powoduje automatyczne logowanie wskazanego uzytkownika na starcie programu;

 

pokaż - operacja powoduje uaktywnienie okna modułu AsBase (wyciągnięcie go na wierzch).

Dodatkowe parametry pozwalają określić informację, która ma zostać pokazana w oknie:

 

Typ obszaru: RCP - wartości receptury, RLD - historia ładowań receptur, ARC - archiwum;

ID obiektu - identyfikator zestawu rejestracji lub grupy receptur;

Pokaż obszar - wyświetla zdefiniowany obszar;

Pokaż zestaw - wyświetla zdefiniowany obszar dla zestawu zmiennych, identyfikowanych identyfikatorem wpisywanym do pola Identyfikator zestawu;

Widok - wyświetla zdefiniowany obszar zgodnie z parametrami definiującymi sposób wyświetlania zawartości danej tabeli; widok identyfikowany jest za pomocą identyfikatora wpisywanego do pola Identyfikator widoku;

 

załaduj - operacja pozwala na załadowanie przeliczonych wartości receptury zgodnie z parametrami:

ID grupy - określa grupę receptur, której operacja dotyczy;

ID zestawu - określa zestaw zmiennych, gdzie receptura ma być załadowana;

Nazwa receptury - jeżeli parametr ten nie zostanie podany, to wyświetlone zostanie okno z listą wszystkich receptur zdefiniowanych w grupie, z której operator będzie mógł wybrać recepturę, która ma być załadowana

 

nawiguj - operacja pozwala na przeglądanie zawartości tabel bazy danych modułu AsBase na maskach aplikacji systemu asix. Parametry wymagane:

ID połączenia - identyfikator połączenia zdefiniowany w czasie parametryzacji obiektu ASBASE;

Komenda - nazwa komendy, jaka ma zostać wykonana; można podać następujące komendy: FIRST - pierwszy zapis tabeli,

NEXT - kolejny zapis tabeli,

PREVIOUS - poprzedni zapis tabeli,

LAST - ostatni zapis tabeli,

FILTER - nowy filtr: zdefiniowanie nowego filtru oraz wyświetlenie ostatniego zapisu z tabeli zgodnego z nowym filtrem,

COUNT - liczba wierszy: powoduje przypisanie do określonej zmiennej zestawu zmiennych liczby, która jest ilością zapisów w tabeli zgodnych z aktualnym filtrem;

LOAD - receptura: komenda powoduje załadowanie wskazanej receptury (definicji receptury) do zestawu zmiennych; działanie tego wariantu akcji zbliżone jest do wariantu ASBASE, załaduj; zwyczajowo wartości receptury ładowane są do zmiennych wirtualnych, wykorzystywanych do przeglądania zmiennych. (uwaga: komenda ta nie uwzględnia pola wsad niezbędnego dla receptur przeliczalnych).

DOWNLOAD - receptura: komenda powoduje załadowanie bieżącej receptury do wskazanego identyfikatorem zestawu zmiennych (z kanału fizycznego). Każda operacja załadowania receptury posiada automatycznie nadany unikalny numer, który może być wysłany razem z recepturą. Komenda ta pozwala wyliczyć wartości pól dla receptur przeliczalnych - wówczas przed wykonaniem komendy należy ustawić wartość pola określającego wielkość wsadu dla danej receptury (na masce aplikacji asixa powinno znajdować się pole umożliwiające wprowadzenie wielkości wsadu do zmiennej podpiętej do pola WSAD wysyłanej receptury).

 

drukuj - operacja pozwala na wydrukowanie zawartości tabel bazy danych modułu AsBase; parametryzacja operacji obejmuje:

Typ obiektu: RCP - wartości receptur, RLD - historia ładowań receptur, ARC - archiwum zestawu rejestracji;

ID obiektu - identyfikator zestawu rejestracji lub grupy receptur;

ID widoku - jest identyfikatorem jednego z widoków skojarzonych z daną tabelą;

 

dodaj - operacja pozwala na dodanie nowego rekordu do zawartości tabeli bazy danych modułu AsBase; parametr operacji:

ID połączenia - identyfikator połączenia zdefiniowany w czasie parametryzacji obiektu ASBASE;

 

usuń - operacja pozwala na usunięcie rekordu z zawartości tabeli bazy danych modułu AsBase; parametr operacji:

ID połączenia - identyfikator połączenia zdefiniowany w czasie parametryzacji obiektu ASBASE;

 

zmień - operacja pozwala na zmianę bieżącego rekordu w tabeli bazy danych modułu AsBase;parametr operacji:

ID połączenia - identyfikator połączenia zdefiniowany w czasie parametryzacji obiektu ASBASE;

 

 

 

 

 

Składnia akcji definiowana ręcznie:

 

ASBASE typ_operacji [parametry_operacji]

gdzie:

 

ASBASE - stały element deklaracji; można go zastąpić skrótem ASB; typ_operacji:

STart

Znaczenie - operacja powoduje uruchomienie modułu AsBase z przekazaniem mu parametrów podanych w parametry_operacji (z reguły nazwa pliku xml aplikacji). Jeżeli AsBase był już wcześniej uruchomiony, to operacja Start jest równoważna operacji Pokaż bez parametrów. Dodatkowym efektem

użycia operacji Start jest to, że w momencie końca pracy programu AS zostanie również zakończona praca modułu Asbase. Struktura parametrów jest następująca:

nazwa_pliku_xml [/single][/minimize]

/user:<id_uzytkownika>/password:<hasło>

gdzie:

nazwa_pliku_xml - plik XML przechowuje podstawowe informacje konfiguracyjne, takie jak lokalizacja i sposób dostępu do bazy danych aplikacji AsBase’a; w pliku XML zapisywane są także definicje warunków archiwizacji i automatycznych receptur;

/single - powoduje, że w przypadku próby uruchomienia AsBase’a w sytuacji, gdy jest on już uruchomiony, nowa instancja programu nie zostanie utworzona; na pierwszy plan zostanie wyciągnięte okno wcześniej uruchomionego AsBase’a;

/minimize - powoduje uruchomienie AsBase’a z automatyczną minimalizacją okna;

/user:<id_uzytkownika>/password:<hasło> - powoduje automatyczne logowanie wskazanego uzytkownika na starcie programu;

POkaż

Znaczenie - operacja powoduje uaktywnienie okna modułu AsBase (wyciągnięcie go na wierzch). W parametry_aplikacji można opcjonalnie dodać opis informacji, która ma zostać pokazana w oknie. Struktura parametrów jest następująca:

typ_obiektu\identyfikator_obiektu[\identyfikator_zestawu]

gdzie:

typ_obiektu może być równy:

RCP - żadanie wyświetlenia tabeli wartości receptur lub podglądu zestawu zmiennych związanych z grupą receptur;

RLD - żądanie wyświetlenia tabeli historii ładowań receptur; ARC - żądanie wyświetlenia tabeli archiwum zestawu rejestracji lub podglądu zestawu zmiennych związanych z zestawem rejestracji;

identyfikator_obiektu - jest identyfikatorem zestawu rejestracji lub grupy receptur;

identyfikator_zestawu - jest opcjonalny, jest on identyfikatorem zestawu

zmiennych.

Komenda Pokaż pozwala również na wybór widoku. Struktura parametrów jest następująca:

typ_obiektu\identyfikator_obiektu\\identyfikator_widoku

identyfikator_widoku - jest identyfikatorem widoku - czyli zestawu parametrów określających, w jaki sposób wyświetlana jest zawartość danej tabeli.

ZAładuj (LOad) Znaczenie - operacja pozwala na załadownie receptury. Struktura parametry_operacji jest następująca:

identyfikator_grupy\identyfikator_zestawu[\nazwa_receptury]

gdzie:

identyfikator_grupy i identyfikator_zestawu określają odpowiednio grupę

receptur, której operacja dotyczy oraz zestaw zmiennych, gdzie receptura

ma być załadowana. Jeżeli nazwa_receptury zostanie podana, to akcja załaduje wskazaną recepturę do zestawu zmiennych. Jeżeli nazwa_receptury nie zostanie podana, to wyświetlone zostanie okno z listą wszystkich receptur zdefiniowanych w grupie, z której operator będzie mógł wybrać recepturę, która ma być załadowana.

Nawiguj (NAvigate)

Znaczenie - operacja pozwala na przeglądanie zawartości tabel bazy danych modułu AsBase na maskach aplikacji systemu asix. Struktura parametry_operacji jest następująca:

identyfikator_połączenia\komenda[\definicja_filtru]

gdzie: identyfikator_połączenia - identyfikator połączenia zdefiniowany w czasie parametryzacji obiektu ASBASE;

komenda - nazwa komendy, jaka ma zostać wykonana; można podać następujące komendy:

FIRST - powoduje wyświetlenie pierwszego zapisu tabeli,

NEXT - powoduje wyświetlenie kolejnego zapisu tabeli,

PREVIOUS - powoduje wyświetlenie poprzedniego zapisu tabeli,

LAST - powoduje wyświetlenie ostatniego zapisu tabeli,

FILTER - powoduje zdefiniowanie nowego filtru oraz wyświetlenie ostatniego zapisu z tabeli zgodnego z nowym filtrem,

COUNT - powoduje przypisanie do określonej zmiennej zestawu zmiennych liczby, która jest ilością zapisów w tabeli zgodnych z aktualnym filtrem;

LOAD - receptura: komenda powoduje załadowanie wskazanej receptury (definicji receptury) do zestawu zmiennych; działanie tego wariantu akcji zbliżone jest do wariantu ASBASE, załaduj; zwyczajowo wartości receptury ładowane są do zmiennych wirtualnych, wykorzystywanych do przeglądania zmiennych. (uwaga:

komenda ta nie uwzględnia pola wsad niezbędnego dla receptur przeliczalnych).

DOWNLOAD - receptura: komenda powoduje załadowanie bieżącej receptury do wskazanego identyfikatorem zestawu zmiennych (z kanału fizycznego). Każda operacja załadowania receptury posiada automatycznie nadany unikalny numer, który może być wysłany razem z recepturą. Komenda ta pozwala wyliczyć wartości pól dla receptur przeliczalnych - wówczas przed wykonaniem komendy należy ustawić wartość pola określającego wielkość wsadu dla danej receptury (na masce aplikacji asixa powinno znajdować się pole umożliwiające wprowadzenie wielkości wsadu do zmiennej podpiętej do pola WSAD wysyłanej receptury).

definicja_filtru - definicja nowego filtru; ten parametr podaje się tylko dla komendy FILTER; zasady konstruowania definicji filtru zostały opisane w części asix.chm, 19.4.1. Obiekt ASBASE.

Drukuj (PRint)

Znaczenie - operacja pozwala na wydrukowanie zawartości tabel bazy danych modułu AsBase. Struktura parametry_operacji jest następująca:

typ_obiektu\identyfikator_obiektu[\identyfikator_widoku]

gdzie: typ_obiektu - może przyjąć postać:

RCP - tabela wartości receptur;

RLD - tabela historii ładowań receptur;

ARC - tabela archiwum zestawu rejestracji;

identyfikator_obiektu - jest identyfikatorem zestawu rejestracji lub grupy receptur;

identyfikator_widoku - parametr opcjonalny; jest identyfikatorem jednego z widoków skojarzonych z daną tabelą.

 

DOdaj

Znaczenie - operacja pozwala na dodanie nowego rekordu do zawartości tabeli bazy danych modułu AsBase. Struktura parametry_operacji jest następująca: identyfikator_połączenia

gdzie: identyfikator_połączenia - identyfikator połączenia zdefiniowany w czasie parametryzacji obiektu ASBASE (patrz: asix.chm, 19.4.1. Obiekt

ASBASE);

 

USuń

Znaczenie - operacja pozwala na usunięcie rekordu z zawartości tabeli bazy danych modułu AsBase. Struktura parametry_operacji jest następująca:

identyfikator_połączenia

gdzie: identyfikator_połączenia - identyfikator połączenia zdefiniowany w czasie parametryzacji obiektu ASBASE (patrz: asix.chm, 19.4.1. Obiekt

ASBASE);

 

ZMień

Znaczenie - operacja pozwala na zmianę bieżącego rekordu w tabeli bazy danych modułu AsBase. Struktura parametry_operacji jest następująca:

identyfikator_połączenia

gdzie: identyfikator_połączenia - identyfikator połączenia zdefiniowany w czasie parametryzacji obiektu ASBASE (patrz: asix.chm, 19.4.1. Obiekt

ASBASE);