Czym jest formularz i co powstaje, gdy go tworzymy

Przez cały kurs budujemy jeden formularz: wniosek o nieobecność. Zanim cokolwiek zbudujemy, poznajesz mapę — z czego składa się każdy formularz.

Najważniejsze

• Dla użytkownika formularz to jedno okienko z polami i przyciskiem „Zapisz”. W modelerze stoją za nim cztery współpracujące elementy:

  1. Typedef (kontrakt) — opis danych, które formularz dostaje na wejściu i oddaje na wyjściu. Każde pole ma nazwę i typ.

  2. Proces formularza — logika na serwerze. Ma dwie ścieżki:

     • init — uruchamia się przy otwarciu formularza (wczytanie danych),
     • put — uruchamia się po kliknięciu „Zapisz” (zapis danych).

     Do dyspozycji masz wszystkie aktywności procesów, więc możesz tu zbudować dowolną logikę.

  3. Layout (wygląd) — pola, ich układ i zachowanie; tu ustawiasz np. wymagalność pól i walidacje działające od razu na ekranie.

  4. Ekran — osadza formularz w aplikacji i pozwala użytkownikowi z nim pracować.

• Nowy formularz tworzysz w folderze przez ⋯ → Nowy formularz. Nazwa z prefiksem F_ (od form): F_Absence.

• Typedef, proces i layout powstają automatycznie razem z formularzem i należą do niego. Na starcie są puste, a proces ma już obie ścieżki: init i put.

• Proces formularza ma zmienne narzucone przez platformę:

  • wejściowe: input, mode, uploadedFileIds,
  • wyjściowa: data.

  input i data są tego samego typu co typedef formularza — to on określa, co trafia na formularz i co z niego wraca.

Zapamiętaj

Formularz = wygląd + kontrakt (dane) + proces (logika na serwerze), spięte w jedną całość, a ekran wyświetla go w aplikacji. W następnej lekcji budujemy wygląd.