parAkcja

Wybrana akcja:
G/GET - odnalezienie par

P/POSITION - pozycja w parze
C/COUNT - zliczanie par
S/SET - dodanie/aktualizacja pary
U/UNSET - usuwanie par

parParametry

Parametry dla wybranej akcji.

Parametry podajemy po średniku ";", przypisanie znakiem równości "=".

Poniżej opis akcji i zestawów parametrów.

- G/GET - odnajduje parę dla zadanego ID

  - IDT  - identyfikator tabeli (Pole IDBazy)

  - ID   - ID pierwszego elementu pary (Pole Element_1 lub Element_2)

  - Data - pusty - data nieistotna

         - niepusty - wybiera tylko pary, dla których Data zawiera

           się pomiedzy DataOd a DataDo (o ile ustalone)

  Jeżeli funkcja odnajdzie więcej, niż jedną pasującą parę, zwróci IDentyfikatory po przecinku.

  Prócz tego funkcja zostawia tabelę Pairs na recordzie ostatniej odnalezionej pary.

  Jeżeli funkcja nie odnajdzie pary lub wystąpi błąd, zwracany ciąg jest pusty.

- P/POSITION - odnajduje parę i zwraca pozycję w parze: 1 - Element_1, 2 - Element_2

  - IDT  - identyfikator tabeli (Pole IDBazy)

  - ID   - ID pierwszego elementu pary (Pole Element_1 lub Element_2)

  - Data - pusty - data nieistotna

         - niepusty - wybiera tylko pary, dla których Data zawiera

           się pomiędzy DataOd a DataDo (o ile ustalone)

  Jeżeli funkcja odnajdzie więcej, niż jedną pasującą parę, zwróci Pozycje po przecinku.

  Prócz tego funkcja zostawia tabelę Pairs na recordzie ostatniej odnalezionej pary.

- C/COUNT - odnajduje pary i zwraca liczbę par

  - IDT  - identyfikator tabeli (Pole IDBazy)

  - ID   - ID pierwszego elementu pary (Pole Element_1 lub Element_2)

  - Data - pusty - data nieistotna

         - niepusty - wybiera tylko pary, dla których Data zawiera

           się pomiędzy DataOd a DataDo (o ile ustalone)

  Prócz tego funkcja zostawia tabelę Pairs na recordzie ostatniej odnalezionej pary.

- S/SET - dodaje lub aktualizuje parę

  - IDT  - identyfikator tabeli (Pole IDBazy)

  - ID1  - ID pierwszego elementu pary (odczyt z 1 lub 2, zapis do 1)

  - ID2  - ID drugiego elementu pary (odczyt z 2 lub 1, zapis do 2)

  - DataOd - początek okresu obowiązywania pary

  - DataDo - koniec okresu obowiązywania pary

  Funkcja najpierw wyszukuje podanej pary na podstawie IDT, ID1, ID2 i DataOd.

  Jeżeli nie znajdzie, to dodaje parę.

  Jeżeli znajdzie, to aktualizuje:

  - jeżeli kolejność ID1 i ID2 jest odwrotna, to zmieniana jest kolejność,

  - jeżeli parametr DataOd jest pusty, to DataOd nie jest aktualizowana w parze,

  - jeżeli parametr DataDo jest pusty, to DataDo nie jest aktualizowana w parze.

  W przypadku powodzenia funkcja zwraca pusty ciąg znaków.

  W przypadku niepowodzenia funkcja zwraca ciąg znaków formatu "KodBłędu - OpisBłędu"

- U/UNSET - usuwa daną parę

  - IDT, ID1, ID2, DataOd - identyfikacja pary

  Jeżeli DataOd puste, to usuwa wszystkie pary pasujące do IDT, ID1, ID2.

  Jeżeli ID2 puste, ID1 nie puste lub na odwrót, to usuwa wszystkie pary pasujące do niepustego ID1/ID2.

  Jeżeli ID1 puste i ID2 puste, to usuwa wszystkie pary dla wybranej tabeli IDT.

  W przypadku powodzenia funkcja zwraca pusty ciąg znaków.

  W przypadku niepowodzenia funkcja zwraca ciąg znaków formatu "KodBłędu - OpisBłędu"

Dodatkowe parametry:

- ERROR

  - 1 - krzycz o błędzie za pomocą MESSAGE

  - 2 - dodaj błąd do WMS

Uwaga - w przypadku parametrów typu 'data' pusty oznacza pusty ciąg znaków i nie jest tym samym, czym jest wartość zerowa - funkcja rozróżnia '' i '0'

zwraca

Wartość zależna od parametru.