TableStore jest tekstową strukturą danych w formacie JSON reprezentującą stan tabeli dynamicznej osadzanej na formularzu systemu PlusWorkflow. Wraz z dostarczonymi funkcjami umożliwia łatwe manipulowanie danymi w obrębie tabeli oraz przenoszenie danych pomiędzy tabelami.
Zapis TableStore w zmiennych
Z uwagi na duży rozmiar obiektów "TableStore" (często przekraczający 4000 znaków) zalecamy przechowywanie TableStore w parametrach formalnych, które posiadając nieograniczony rozmiar w stosunku do "zwykłych" zmiennych formularza.
Struktura TableStore
Poprawny obiekt TableStore musi zawierać dwa pola:
- variableType - JSON Object (obiekt typu klucz-wartość), zawierający definicję pól obiektu TableStore. Kluczami są ID, a wartościami typy zmiennych tworzących tabelę, której stan ma odzwierciedlać obiekt TableStore,
- data - JSON Array (tablica obiektów typu klucz-wartość), zawierająca obiekty JSON reprezentujące poszczególne wiersze tabeli, gdzie kluczem jest ID zmiennej, a wartością wartość danej zmiennej w danym wierszu tabeli.
Typy pól
Pola obiektu TableStore przyjmują te same typy co zmienne tworzące tabelę, której stan jest reprezentowany. Możliwe typy to: date, float, integer, string.
Domyślne wartości zmiennych
| Typ zmiennej | Domyślna wartość |
|---|---|
| date | null |
| float | 0.0 |
| integer | 0 |
| string | "" (pusty string) |
Przykład
powyższa tabela zostanie zaprezentowana jako:
TableStore
{"variableType":{"tekstowy":"string","datowy":"date","zmiennoprzecinkowy":"float","calkowity":"integer"},"data":[{"tekstowy":"przykładowy tekest","datowy":"2021-03-01","zmiennoprzecinkowy":123.13,"calkowity":123},{"tekstowy":"","datowy":null,"zmiennoprzecinkowy":0.0,"calkowity":0},{"tekstowy":"przykładowy tekst 2","datowy":"2021-03-15","zmiennoprzecinkowy":321.12,"calkowity":321}]}