Documente Academic
Documente Profesional
Documente Cultură
Formulare
(Forms)*
Notă: Conținutul acestui document a fost preluat din manualul platformei JobRouter
(Workflow Design – Create Processes – Forms) și a fost modificat conform viziunii autorilor.
Conţinutul acestui document nu reprezintă în mod obligatoriu poziţia oficială a JobRouter
AG
ROMÂNIA
UNIVERSITATEA BABEŞ-BOLYAI DIN CLUJ-NAPOCA
Universitatea Babeș-Bolyai Tel.: (00) 40 - 740 – 077521
din Cluj-Napoca
Cuprins
Introducere .......................................................................................... 3
Interfața de prezentarea a formularelor (Forms overview) ................. 4
Crearea unui formular (Create a form)................................................. 5
Ștergerea unui formular (Delete a form).............................................. 8
Editorul interfeței unui formular (Form Dialog Editor) ......................... 9
Butoane cu simboluri în editorul interfeței unui formular (Symbol buttons în
Form Dialog Editor) ........................................................................... 11
Adăugarea unei pagini (Add page) ....................................................... 13
Inserarea unei secțiunii (Insert section) ............................................... 15
Inserare unui rând (Insert row) .......................................................... 18
Inserarea unei coloane (Insert column) ................................................ 20
Adăugarea unui element de fomular (Add form element) ........................ 22
Modificarea tipului unui element de formular (Change element type) ....... 27
Particularități ale editorului pentru o interfață de tip desktop – clipboard-ul
...................................................................................................... 29
Tipuri de elemente de formular pentru o interfață de tip desktop (Form
element types for desktop view) ........................................................ 34
ATTACHMENT – afișare fișier anexat .................................................... 34
BLANK - câmp spațiu ......................................................................... 37
BUTTON - buton ................................................................................ 37
CHECKBOX - casetă de validare .......................................................... 39
DATE - câmp de editare de tip dată calendaristică ................................. 41
DECIMAL - câmp de editare de tip număr real ....................................... 45
DESCRIPTION - descriere ................................................................... 47
FILE - fişier anexat ............................................................................ 49
HIDDEN - câmp ascuns ...................................................................... 53
IFRAME – cadru integrat .................................................................... 53
IMAGE - imagine ............................................................................... 54
JOBFUNCTIONS - listă de selecție roluri ............................................... 55
LINK – referință ................................................................................ 58
LIST - listă de selecție ....................................................................... 59
PASSWORD - câmp de editare de tip parolă .......................................... 62
RADIO –buton radio .......................................................................... 66
1
SQL_CHECKBOX - casetă de validare SQL ............................................ 68
SQL_LIST - listă de selecție SQL ......................................................... 70
SQL_TABLE - tabel SQL...................................................................... 82
SQL_TEXTBOX - câmp de editare de tip text SQL .................................. 86
SUBTABLE_VIEW - vizualizare subtabel ................................................ 89
TEXT - câmp de tip text ..................................................................... 95
TEXTAREA - câmp de editare multi-linie ............................................... 96
TEXTBOX - câmp de editare de tip text ................................................ 99
USERS - listă de selecție utilizatori .................................................... 104
2
Introducere
Un formular are:
O interfață are o anumită structură: ea conține una sau mai multe pagini, o
pagină conține una sau mai multe secțiuni, o secțiune conține unul sau mai multe
rânduri, un rând conține una sau mai multe coloane iar o coloană conține unul
sau mai multe elemente de formular.
3
Interfața de prezentarea a formularelor
(Forms overview)
4
Crearea unui formular (Create a form)
5
Crearea și editarea proprietăților unui formular
6
Indică denumirea unui formular
anterior creat pe baza căruia se poate
realiza formularul actual.
Dacă se alege din lista de selecție
denumirea unui formular existent
Template Șablon atunci formular actual se va crea ca o
copie a formularului selectat. Cele
două formulare (cel actual care se
creaza și cel cel existent selectat) vor
fi independente, nefiind corelate între
ele.
Secțiunea Scripturi (Scripts Section)
Pentru mai multe detalii referitoare la evenimentele generate de un
formular și la funcțiile script asociate evenimentelor respective (script
event) se recomandă consultarea manualului JobRouter JavaScript API.
De reținut: Nu toate evenimentele generate de o interfață de tip desktop
sunt generate și de o interfață de tip mobile.
Acționând butonul având simbolul pentru un eveniment din secțiunea Scripts
(Scripturi) se va afișa o fereastră pop-up care va prezenta toate funcțiile script
asociate local formularului sau asociate global procesului. Selectând o funcție
script din această listă ea va fi adăugată evenimentului respectiv pentru a fi
apelată în momentul generarii evenimentului de către formular (în urma unei
acțiuni a utilizatorului).
7
Ștergerea unui formular (Delete a form)
8
Editorul interfeței unui formular (Form
Dialog Editor)
Accesarea editorului interfeței unui formular se poate realiza fie folosind editorul
de diagrame (flowchart editor) fie folosind interfața de prezentare a formularelor
(forms overview).
Notă: Dacă formularul asociat pasului respective nu a fost creat anterior atunci
se creează mai întâi formularul și apoi se accesează editorul interfeței pentru
formularul respectiv.
9
Editorul interfetei de tip desktop view al unui formular
Comutarea între cele 2 tipuri interfețe asociate unui formular se realizează ușor
prin acționarea butonului având simbolul situat in parte dreaptă jos a
editorului interfeței unui formular, mai exact în partea dreaptă a etichetei
Desktop View (interfață de tip desktop) sau în partea stângă a etichetei Mobile
View (interfață de tip mobile).
10
Butoane cu simboluri în editorul interfeței unui formular
(Symbol buttons în Form Dialog Editor)
Buton - Explicaţie
Name Nume
simbol
Butoane cu simboluri din cadrul unui formular
Acționând butonul cu acest
simbol se poate insera o nouă
Insert Inserare secțiune, un rând nou, o nouă
coloană sau un nou element de
formular.
11
Buton - Explicaţie
Name Nume
simbol
Acționând butonul cu acest
simbol se ascunde sau se
Hide Ascundere afișează o pagină, o secțiune, un
rând, o coloană sau un element
de formular.
12
Buton - Explicaţie
Name Nume
simbol
activează un element de
formular.
Un formular poate conține mai multe pagini. Paginile unui formular sunt vizibile
în partea de sus a formularului. Pentru a adăuga o nouă pagină unui formular se
acționează butonul Add page (Adăugare pagină) din bara de acțiuni.
13
Proprietățile specifice unei pagini
14
Property Proprietate Explicaţie
O pagină poate conține mai multe secțiuni. Secțiunile unei pagini permit o
organizare mai clară a datelor afișate în cadrul paginii unui formular. Pentru a
adăuga o nouă secțiune unei pagini se acționează butonul având simbolul ,
situat în partea dreaptă-sus a paginii - când cursorul mouse-ului este situat
deasupra butonului având simbolul va apărea o casetă de text contextuală
care va afișa mesajul Insert Section (Inserare secțiune).
15
Inserarea unei secțiuni
16
Property Proprietate Explicaţie
17
Property Proprietate Explicaţie
O secțiune poate conține mai multe rânduri. Pentru a adăuga un rând nou unei
secțiuni se acționează butonul având simbolul , situat în partea dreaptă-sus a
secțiunii - când cursorul mouse-ului este situat deasupra butonului având
simbolul va apărea o casetă de text contextuală care va afișa mesajul Insert
Row (Inserare rând).
18
Inserarea unui rând
Proprietățile unui rând vor putea fi editate ulterior prin acționarea butonul având
simbolul situat în partea dreaptă-sus a rândului - - când cursorul mouse-ului
este situat deasupra butonului având simbolul va apărea o casetă de text
contextuală care va afișa mesajul Edit Row (Editare rând). În urma acestei
acțiuni se va deschide o fereastră care va permite editarea proprietăților
specifice unui rând.
19
Property Proprietate Explicaţie
Un rând poate conține mai multe coloane. Pentru a adăuga o coloană nouă unui
rând se acționează butonul având simbolul , situat în partea dreaptă-sus a
rândului - când cursorul mouse-ului este situat deasupra butonului având
simbolul va apărea o casetă de text contextuală care va afișa mesajul Insert
Column (Inserare coloană).
Proprietățile unei coloane vor putea fi editate ulterior prin acționarea butonul
având simbolul situat în partea dreaptă-sus a coloanei - - când cursorul
mouse-ului este situat deasupra butonului având simbolul va apărea o casetă
de text contextuală care va afișa mesajul Edit Column (Editare coloană). În urma
acestei acțiuni se va deschide o fereastră care va permite editarea proprietăților
specifice unei coloane.
21
Property Proprietate Explicaţie
O coloană poate conține unul sau mai multe elemente de formular, prin
intermediul cărora un utilizator interacționează cu formularul. Există mai multe
tipuri de elemente. Pentru mai multe detalii referitoare la tipurile de elemente și
a proprietăților acestora se recomandă consultarea secțiunii Tipuri de elemente
de formular (Form element types).
22
Adăugarea unui element
Tip de
Element type Explicaţie
element
24
Tip de
Element type Explicaţie
element
Permite afișarea unui tabel cu date,
SQL_TABLE Tabel SQL datele reprezentând rezultatul unei
interogări SQL.
Vizualizare
SUBTABLE_VIEW
subtabel
Selectarea unui tip de element are ca și rezultat deschiderea unei interfațe care
permite editarea proprietăților specifice tipului de element selectat.
25
Proprietățile specifice unui element de tip Textbox (câmp de editare de tip text)
26
Proprietățile specifice unui element de tip Textbox (câmp de editare de tip text)
sunt detaliate în cadrul secțiunii Tipuri de elemente de formular (Form element
types).
27
Spre exemplificare prezentăm interfața care permite editarea proprietăților
specifice unui element de tip TEXTBOX (câmp de editare de tip text).
Proprietățile specifice unui element de tip Textbox (câmp de editare de tip text)
Din lista de selecție Select Element Type (Selectare tip element) se alege tipul
de element dorit. Valorile tuturor proprietăților comune între cele 2 tipuri de
element se păstreză.
Dacă spre exemplificare dorim să modificăm tipul unui element din Textbox in
SQL_Textbox atunci va apărea interfața care permite editarea proprietăților
specifice unui element de tip SQL_Textbox (câmp de editare de tip text SQL).
28
Proprietățile specifice unui element de tip SQL_Textbox (câmp de editare de tip text SQL)
29
Pentru salvarea unei componente a unui formular (pagina, secțiune, rând,
coloană, element) se va selecta componenta respectivă (prin bifarea casetei de
validare situată în partea stângă a denumirii componentei respective) și se va
acționa butonul Copy To Clipboard (copiere în clipboard) din bara de acțiuni a
editorului interfeței de tip desktop a unui formular.
30
Actualizarea unei componente din clipboard
32
• dacă se dorește inserarea într-o secțiune în fereastră vor fi disponibile
componenetele de tip secțiune (dialogsections) și rând (dialogrows).
33
Tipuri de elemente de formular pentru o
interfață de tip desktop (Form element
types for desktop view)
Acest tip de element este utilizat pentru a afișa, în interfața unui formular, un
buton care permite afișarea unui fișier anexat la o (încărcat într-o) bază de date.
Atunci când butonul este acționat are ca efect deschiderea fișierul anexat
(încărcat) într-o fereastră nouă, a cărei poziție și/sau dimensiune pot fi
specificate.
34
Property Proprietate Descriere
35
Property Proprietate Descriere
36
Property Proprietate Descriere
Acest tip de element este utilizat pentru a afișa, în interfața unui formular, o linie vidă
(placeholder).
BUTTON - buton
Acest tip de element este utilizat pentru a afișa, în interfața unui formular, un
buton prin intermediul căruia să execute un script atunci când este acționat.
37
Property Proprietate Descriere
38
CHECKBOX - casetă de validare
Acest tip de element este utilizat pentru a afișa, în interfața unui formular, o
casetă de validare.
39
Property Proprietate Descriere
40
DATE - câmp de editare de tip dată calendaristică
41
Property Proprietate Descriere
43
Property Proprietate Descriere
44
Property Proprietate Descriere
45
Property Proprietate Descriere
46
Property Proprietate Descriere
DESCRIPTION - descriere
Acest tip de element este utilizat pentru a afișa, în interfața formularului, un text
care reprezintă o descriere și care poate fi formatat prin intermediu etichetelor
(tag-urilor) HTML. Textul poate fi specificat manual sau poate fi preluat dintr-un
câmp al bazei de date.
47
Dacă proprietatea Strip tags (lista etichete) din setările platformei JobRouter
(submeniul Admin Tools, secțiunea System, opțiunea Configuration, pagina
General, grupul JobRouter Security, opțiunea Security Settings, pagina Filter)
este activată atunci etichetele (tag-urile) HTML folosite pentru formatarea
textului descriere trebuie specificate în câmpul Allowed tags (etichete permise).
48
FILE - fişier anexat
Acest tip de element este utilizat pentru a afișa, în interfața unui formular, un
buton care permite anexarea (încărcarea) unui fișier la o (într-o) bază de date.
Atunci când butonul este acționat are ca efect deschiderea unei interfețe care
permite selectarea fișierului dorit.
După selectarea fișierului dorit acesta este copiat imediat pe server într-un
director temporar - în timpul transferului nu se pot face modificări în interfața
formularului. După încărcarea fișierului pe server vor apărea două butoane: un
buton care va permite deschiderea fișierul într-o o fereastră nouă, a cărei poziție
și/sau dimensiune pot fi specificate, și un buton care va permite ștergerea
fișierului. Fișierul dorit este preluat din directorul temporar ca și anexă la baza
de date doar după salvarea (save) sau trimiterea (send) pasului căruia îi este
asociat formular.
• JobViewer 2
Acesta proprietate trebuie să fie specificată în
mod obligatoriu.
50
Property Proprietate Descriere
51
Property Proprietate Descriere
52
Property Proprietate Descriere
53
Property Proprietate Descriere
IMAGE - imagine
54
Property Proprietate Descriere
Acest tip de element este utilizat pentru a afișa, în interfața formularului, o listă de selecție
a rolurilor, care permite alegerea unui singur rol. Pentru mai multe detalii referitoare la
roluri se recomandă consultarea capitolului Roluri (Job Functions).
55
Property Proprietate Descriere
57
LINK – referință
Acest tip de element este utilizat pentru a afișa, în interfața formularului, o referință (link)
prin intermediul căreia se poate accesa un site web sau un fișier stocat la nivel de web
server.
Referința (link-ul) poate fi specificată manual sau poate fi preluată dintr-un câmp
al bazei de date.
58
Property Proprietate Descriere
Acest tip de element este utilizat pentru a afișa, în interfața formularului, o listă de
selecție, care permite alegerea unei singure opțiuni.
59
Property Proprietate Descriere
60
Property Proprietate Descriere
61
Property Proprietate Descriere
62
Property Proprietate Descriere
63
Property Proprietate Descriere
64
Property Proprietate Descriere
65
Property Proprietate Descriere
Acest tip de element este utilizat pentru a afișa, în interfața unui formular, un
buton radio care poate fi selectat.
66
Property Proprietate Descriere
Acest tip de element este utilizat pentru a afișa, în interfața unui formular, o
casetă de validare care reflectă (va fi bifată sau nu) rezultatul unei interogări
SQL. Astfel dacă o interogare SQL returnează ca și rezultat o valoare 0 sau un
șir de caractere vid (“”) atunci caseta de validare nu va fi bifată altfel caseta de
validare va fi bifată.
68
Property Proprietate Descriere
69
Property Proprietate Descriere
Acest tip de element este utilizat pentru a afișa, în interfața formularului, o listă de
selecție, care permite alegerea unei singure opțiuni, opțiunile reprezentând rezultatul unei
interogări SQL.
70
Sunt dispobile 3 tipuri de afișare a unei liste de selecție:
71
De reținut: Deoarece lista de opțiuni este ordonată crescător în raport
cu coloana etichetă a rezultatului returnat de interogarea SQL nu este
permisă utilizarea clauzei ORDER BY (sortare după) în cadrul interogarea
SQL (dăcă se utilizează clauza ORDER BY în cadrul interogării SQL atunci
nu se va afișa nici o listă de opțiuni).
73
Property Proprietate Descriere
75
Property Proprietate Descriere
76
Property Proprietate Descriere
78
Property Proprietate Descriere
79
Property Proprietate Descriere
80
Property Proprietate Descriere
81
SQL_TABLE - tabel SQL
Acest tip de element este utilizat pentru a afișa, în interfața formularului, un tabel cu date,
datele reprezentând rezultatul unei interogări SQL.
Pentru interogarea bazei de date este necesară stabilirea unei coenxiuni cu baza de date
respectivă.
82
Property Proprietate Descriere
83
Property Proprietate Descriere
85
Property Proprietate Descriere
86
Property Proprietate Descriere
87
Property Proprietate Descriere
88
Property Proprietate Descriere
Acest tip de element (subtabel view, form’s element) este utilizat pentru a afișa
(într-o formă tabelară) și pentru a actualiza, în interfața formularului, datele unui
89
subtabel (subtable) a cărui structură de vizualizare a subtabelului (subtabel
view, Workflow submenu's option) a fost definită în prealabil.
90
Property Proprietate Descriere
91
Property Proprietate Descriere
92
Property Proprietate Descriere
94
• primul parametru: obiectul DOM structura de vizualizare a unui subta-
bel (subtabel view, Workflow submenu's option).
Pentru mai multe detalii referitoare la funcțiile de tip callback function (funcții
care se apelează după) se recomandă consultarea manualului JobRouter JavaS-
cript API.
Acest tip de element este utilizat pentru a afișa, în interfața formularului, un text
care reprezintă o descriere și care poate fi formatat prin intermediu etichetelor
(tag-urilor) HTML. Textul poate fi specificat manual sau poate fi preluat dintr-un
câmp al bazei de date.
Dacă proprietatea Strip tags (lista etichete) din setările platformei JobRouter
(submeniul Admin Tools, secțiunea System, opțiunea Configuration, pagina
General, grupul JobRouter Security, opțiunea Security Settings, pagina Filter)
este activată atunci etichetele (tag-urile) HTML folosite pentru formatarea
textului descriere trebuie specificate în câmpul Allowed tags (etichete permise).
95
Property Proprietate Descriere
96
Property Proprietate Descriere
97
Property Proprietate Descriere
98
Property Proprietate Descriere
99
Property Proprietate Descriere
100
Property Proprietate Descriere
102
Validarea datelor
[a-zA-Z0-9\-\.]{1,}[@]{1}[a-zA-Z0-9\-]{1,}[\.]{1}[a-zA-
Z]{2,6}
Acest tip de element este utilizat pentru a afișa, în interfața formularului, o listă de selecție
a utilizatorilor, care permite alegerea unui singur utilizator. Pentru mai multe detalii
referitoare la utilizatori se recomandă consultarea capitolului Utilizatori (Users).
1
https://profs.info.uaic.ro/~bd/wiki/index.php/Expresii_regulate
104
Property Proprietate Descriere
105
Property Proprietate Descriere
106
Property Proprietate Descriere
107
Property Proprietate Descriere
108