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.

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

PlusWorkflow > TableStore > image2021-3-15 17:3:54.png

powyższa tabela zostanie zaprezentowana jako:

{"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}]}

FAQ

Nie.

{"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}]}

oraz

{"variableType":{"datowy":"date","calkowity":"integer","tekstowy":"string","zmiennoprzecinkowy":"float"},"data":[{"tekstowy":"przykładowy tekest","datowy":"2021-03-01","zmiennoprzecinkowy":123.13,"calkowity":123},{"calkowity":"0","zmiennoprzecinkowy":0.0,"datowy":null,"tekstowy":""},{"zmiennoprzecinkowy":"321.12","calkowity":321,"tekstowy":"przykładowy tekest","datowy":"2021-03-15"}]}

są równoważnymi reprezentacjami tego samego obiektu TableStore (są sobie równe). Wynika to ze standardu JSON.

Oczekiwany przez TableStore format float musi zawierać kropkę oddzielającą niezerową cześć ułamkową, np. 16.8 itp. Zerowa część dziesiętna może być pominięta czyli przykładowy zapis - 0.0 oraz 0 jest równoznaczny.