Struttura e creazione di un form
L'oggetto Form permette all'utente di inserire i dati di un item in una specifica sezione DataWeb.
Ciascun form è definito da un nome e da una collezione di controlli (Control) altamente personalizzabili.
Creazione di un form in DataWeb
Per creare un form si accedere alla relativa sezione DataWeb e si imposta un nuovo Item.
Il form, come molti oggetti DataWeb, non è altro che un item specializzato per il caricamento dati.
È interessante notare che per creare nuovi form se ne utilizzano alcuni di sistema come Form_Form e Form_Control.
In pratica la struttura di DataWeb permette di creare nuovi form attraverso quelli esistenti.
Regole di naming per il form
Il nome del form deve essere univoco e deve iniziare con il prefisso "Form_" (ad esempio "Form_Product").
Il nome dell'item di riferimento va messo al singolare (Form_Category), quindi Form_Categories è errato.
I nomi (Name) in DataWeb sono sempre PascalCase senza spazi o caratteri speciali.
Aggiunta di controlli
Per aggiungere un controllo va specificato il tipo scegliendolo tra quelli predefiniti. Ogni tipo attiva o disattiva le proprietà pertinenti. Ad esempio il tipo TextBox permette di impostare il campo dati di riferimenti mentre quello Title, essendo di sola lettura, non lo propone.
Ogni controllo viene salvato in formato Json all'interno del campo Controls dell'oggetto Form.
Il salvataggio di questo controllo genera la seguente struttura dati Json:
[
{
"name": "Title",
"title": [
{
"culture": "en-US",
"value": "Title"
},
{
"culture": "it-IT",
"value": "Titolo"
}
],
"type": "TextBox",
"dataField": "Title",
"dataType": "String",
"isVisible": true,
"isVersionLinked": false,
"isReadOnly": false,
"isRequired": false,
"isLateDataBinding": false,
"isVisibleRoles": false,
"isModified": false
}
]È possibile copiare e incollare strutture controlli tra form per semplificare la procedura di creazione. L'unico accorgimento da adottare è quello di copiare e incollare Json tra form DataWeb tra campi database ma mai tra form e database: le due strutture sono leggermente diverse e si potrebbero presentare dei problemi.
Regole di naming per il controllo
Il nome (Name) del controllo deve essere PascalCase e univoco nel form.
Se è agganciato a un campo nel database, ha lo stesso nome (ad esempio "Title").
Come per i campi nel database, è singolare se contiene un solo valore ("Category") e plurale se ne contiene molti in formato Csv o Json ("RelatedCategories").
Una volta salvato, è possibile associare il form a una sezione per attivare il caricamento dei contenuti.
