Gestione Configurazioni

Le configurazioni sono tutte inserite come file .json nella cartella static/config/, ogni file corrisponde alla configurazione di un template o un elemento. In ogni file sono contenuti i parametri per la configurazione di quel template (che possono essere sovrascritti inserendoli nella chiamata CONFIG.openConfig()) ed i vari campi di input che devono apparire all'interno del popup di configurazione.
Se il file di configurazione non è presente, non verrà aperto popup di configurazione.
Ogni file di configurazione può avere i seguenti parametri:

• target: Stringa, nome del parametro contenente gli input da inserire. (Default: “config”).
• showString: Booleano, determina se mostrare i valori in formato stringa, se callback esiste verrà restituita la stringa formata. (Default: false)
• closable: Booleano, determina se il popup può essere chiuso, scartando le modifiche apportate. (Default: false)
• barcodeHeader: Stringa, usato come titolo del documento quando si stampano i barcode (usato se esiste il campo barcode in un input, Default: “Barcodes”).
• localStorage: Booleano, determina se usare il localStorage per salvare i dati. Se true, verranno cercati i valori salvati in localStorage.<nomeTemplate> (se presenti) per inizializzare i valori dei campi input. Al click del pulsante di conferma i valori degli input verranno salvati in localStorage.<nomeTemplate> (eg. localstorage.monitorEventi, Default: false).
• callback: Stringa, contiene il nome di una funzione globale (non innestata) da richiamare al click del pulsante di conferma. Se showString == true la stringa risultante verrà data come parametro alla callback, altrimenti verrà dato l'oggetto contenente i valori degli input. (Default: null)

La funzione CONFIG.openConfig() può essere chiamata dando alcuni (o tutti) questi parametri in ingresso, in tal caso i parametri presenti nella chiamata di funzione avranno priorità superiore rispetto a quelli presenti nel file .json.
Gli oggetti contenenti vengono inseriti in un oggetto (invece di un array), in modo da inserire altri parametri specifici per il set di input in questione (in caso un file di configurazione venga usato in punti diversi dello stesso template, eg: configurazone layout).
L'oggetto può contenere, oltre agli input, i seguenti parametri:

• popupTitle: Stringa, Il titolo del popup di configurazione mostrato (Default: “Configurazione Parametri”).
• separator: Stringa(singolo carattere), Il separatore da usare per differenziare i valori di input, usato se showstring == true (Default: “;”).

Ogni input può contenere i seguenti parametri:

• title: Stringa, Il titolo da mostrare per il parametro.
• desc: Stringa, la descrizione del parametro.
• type: Stringa, il tipo di input da creare, da scegliere tra i seguenti (se non presente in lista, verrà inserito un “text”):
  • text: Form per inserire stringhe, se showString == true non è possibile usare il catattere in separator nell'input.
  • number: Form per inserire numeri, è possibile usare min e max per limitare i valori inseribili.
  • boolean: Checkbox per booleani, se showString == true il nome dell'input è inserito nella stringa quando == true.
  • batch: Input di batch, è possibile inserirlo manualmente come stringa o premere il pulsante “BATCH” per aprire la gestione comandi batch.
  • select: Select tra stringhe, i valori disponibili vanno specificati nel campo values.
  • selectInputs: Select tra stringhe che consente di aggiungere campi input aggiuntivi, i valori disponibili, specificati nel campo values, sono i nomi dei parametri specificati nel campo inputs (se presenti).

• param: Stringa, usato quando showString == true, viene inserita nella stringa prodotta prima del valore dell'input, dev'essere nel formato “<testo>=” eg: “param”: “Batch=”.
• barcode: Stringa, contiene un barcode associato a questo parametro, se presente verrà mostrato un pulsante per stampare i barcode degli input valorizzati.
• barcodeTitle: Stringa, da usare assieme al campo barcode per aggiungere un titolo per il barcode, può contenere il nome di un parametro di input, il valore di quel parametro verrà usato come titolo.
• values: Array di Stringhe, usato per valorizzare gli input di tipo select e selectInputs.
• inputs: Oggetto, strutturato come l'oggetto contenente input, per specificare gli input da mostrare per diversi valori del selectInputs, non può essere inserito un altro input di tipo selectInputs all'interno.
• default: Qualsiasi, valore di default per l'input.
• min: Stringa o Integer, valore minimo inseribile (usato solo su input number)
• max: Stringa o Integer, valore massimo inseribile (usato solo su input number)

{
	"callback": "handleConfig",
	"closable": true,
	"localStorage": true,
	"config" : {
		"popupTitle": "Monitor Eventi",
		"interval" : {
			"title": "Intervallo",
			"desc": "Intervallo in secondi tra refresh automatici (0 per disabilitare)",
			"type": "number",
			"default": 0,
			"min": 0,
			"max": 60
		}
	}
}