Edycja modelu danych

Edytor modelu danych

Do edytora modelu danych przechodzimy wybierając "Model danych" na ekranie głównym aplikacji w Eximee Designer

Ilustracja 1. Zakładka "Model danych" aplikacji low-code

Edytor modelu danych podzielony jest na trzy zakładki:

• Struktura, gdzie zarządzamy strukturą modelu oraz uzupełniamy parametry węzłów,

• Źródła danych, gdzie definiujemy i parametryzujemy źródła danych,

• Źródło, gdzie edytujemy JSON będący źródłową reprezentacją modelu - funkcjonalność dla zaawansowanych użytkowników.

Jeżeli Twoja aplikacja nie posiada jeszcze modelu danych możesz go utworzyć klikając przycisk "Inicjalizuj model danych".

Struktura

Struktura modelu danych prezentowana jest w formie drzewa na lewym panelu edytora. Gałęzie drzewa można zwijać i rozwijać.

Ilustracja 2. Prezentacja struktury modelu danych

Zaznaczenie węzła drzewa powoduje automatyczne filtrowanie węzłów na liście po prawej stronie.

Ilustracja 3. Zaznaczenie węzła w edytorze modelu danych

Na górze listy węzłów wypisany jest klucz stanowiący aktualny filtr widoku: "client.surname" w tym przypadku.

Parametryzacja elementów modelu

Węzeł

Ilustracja 3. Edycja węzła modelu

W sekcji edycji węzła modelu można edytować klucz oraz dokumentację ("opis") obiektu. Można również oznaczyć obiekt jako tablica.

Przy kluczu obiektu znajduje się przycisk kopiujący klucz do schowka systemowego.

W menu kontekstowym znajduje się opcja usuwania węzła razem z jego potomkami.

Aby dodać pole do węzła należy kliknąć przycisk "Dodaj pole".

Pole

Sekcja pola w modelu danych posiada dodatkowo możliwość podania domyślnej wartości dla pola.

Ilustracja 4. Pole w modelu

Źródło danych

Kliknięcie na chips źródła danych lub ikonę ołówka obok otwiera szufladę z listą źródeł danych i możliwością edycji użycia (kolejność źródeł, parametry źródła, mapowanie wartości).

Ilustracja 5. Użycie źródła danych

Domyślnie, dla każdego liścia drzewa modelu danych (czyli pola które nie posiada dalszych pod-pól) platforma automatycznie dodaje specjalne źródło danych typu ValueMap. Jest to wbudowane źródło, które przechowuje wartość pola w strukturze pamięci aplikacji (w tzw. mapie wartości wniosku) – można to traktować jako odpowiednik zmiennej sesyjnej przechowującej dane w kontekście całej aplikacji (formularza). Domyślne mapowanie ValueMap wykorzystuje pełną ścieżkę kluczy danego pola jako klucz w tej wewnętrznej mapie (np. dla pola kraj znajdującego się wewnątrz obiektu daneOsobowe klucz w mapie wartości będzie daneOsobowe.kraj). Dzięki temu po związaniu pól formularza z modelem, nie jest wymagane pisanie dodatkowego kodu do zapisywania wprowadzonych danych – wartość wprowadzona przez użytkownika zostanie automatycznie umieszczona pod odpowiednim kluczem w pamięci modelu.

Źródło danych - defensywna logika i puste wartości

Źródła modelu danych nie mogą zakładać deterministycznej kolejności wywołań ani tego, że wszystkie dane wejściowe są już dostępne. Platforma może wywołać źródło wcześniej (np. przy ustalaniu krotności dynamicznych sekcji formularza lub modelu), nawet jeśli dane pole nie jest jeszcze używane wprost w formularzu czy procesie.

Dlatego źródła danych muszą być projektowane defensywnie: w sytuacji braku danych, danych niekompletnych lub „jeszcze niegotowych” powinny zwracać bezpieczne, puste wartości (null, pustą listę, pusty obiekt) i nie zgłaszać wyjątków. Pusta wartość oznacza: na tym etapie nie potrafię określić wartości i pozwala zadziałać kolejnym źródłom w kaskadzie, w szczególności źródłom domyślnym (np. ValueMap lub domyślne wartości na definicji pola).

Wyjątki należy rezerwować wyłącznie dla rzeczywistych błędów technicznych (np. błędów komunikacji lub niepoprawnej konfiguracji), które powinny przerywać działanie systemu (przerwanie formularza, wycofanie transakcji procesu itp.), a nie dla stanów przejściowych procesu.