Expression Editor
L'Expression Editor è un editor di testo avanzato, integrato nell'interfaccia di configurazione dei Task. Il suo scopo è fornire un ambiente di sviluppo dedicato e più agevole per la scrittura e la formattazione di contenuti complessi, come payload JSON, script o query SQL, che risulterebbero difficili da gestire nei campi di input standard.
Fornisce funzionalità come la syntax highlighting (evidenziazione della sintassi) e la formattazione automatica, che migliorano significativamente la leggibilità del codice e aiutano a prevenire errori di sintassi.
Accesso all'Editor
L'Expression Editor può essere invocato da qualsiasi campo di input multi-linea all'interno della configurazione di un Task tramite due metodi:
- Menu Contestuale: Cliccando con il tasto destro del mouse all'interno del campo di testo desiderato.
- Scorciatoia da Tastiera: Selezionando il campo di testo e utilizzando la combinazione di tasti Ctrl + E.
Interfaccia e Funzionalità Principali
L’interfaccia dell’editor è composta dai seguenti elementi:
- Area di testo principale: Area di editing multilinea con numerazione delle righe, utilizzata per l’inserimento e la modifica del contenuto testuale.
- Selettore di modalità: Menu che consente di impostare il linguaggio o il formato del testo. In base alla modalità selezionata, viene applicata l’evidenziazione della sintassi corrispondente.
- Formattazione codice: Comando che applica automaticamente l’indentazione e la formattazione del testo in base alla modalità attiva, rendendo il contenuto conforme alle regole sintattiche previste.
- Salva: conferma le modifiche e inserisce il contenuto nell’input del Task.
- Annulla: chiude l’editor senza applicare le modifiche.
Modalità dell'Editor
La modalità selezionata determina il tipo di sintassi applicata dall’editor. In base alla modalità scelta, l’editor adatta l’evidenziazione e lo stile del testo al linguaggio o formato selezionato, migliorando la leggibilità del contenuto.
| Modalità | Scopo e Utilizzo |
| Text | La modalità predefinita, per testo semplice senza alcuna formattazione sintattica. |
| JSON | Essenziale per scrivere il Body JSON nei Task Chiamata REST. Evidenzia chiavi, valori (stringhe, numeri, booleani) e la struttura di oggetti e array. |
| XML | Utile per preparare payload per chiamate SOAP o per manipolare dati XML. Evidenzia tag, attributi e valori. |
| JavaScript | Per la scrittura di script da utilizzare in Task specifici. Evidenzia parole chiave, funzioni, stringhe e commenti. |
| Python | Per la scrittura di script da utilizzare nel Task Run Script Python. Evidenzia la sintassi standard di Python. |
| Bash | Per la scrittura di comandi e script da utilizzare nei Task della famiglia Unix Shell. Evidenzia comandi, opzioni, variabili e stringhe. |
| SQL | Per la scrittura di query complesse nel campo Statement del Task Database. Evidenzia parole chiave come SELECT, FROM, WHERE, JOIN, etc. |
Aspetti Operativi
L’uso dell’Expression Editor introduce alcune differenze funzionali rispetto alla modifica diretta nei campi di input:
- Leggibilità: L’evidenziazione della sintassi e la formattazione automatica migliorano la leggibilità di codice e dati strutturati.
- Gestione di contenuti complessi: L’editor è adatto alla scrittura e alla manutenzione di contenuti articolati, come payload JSON o script su più righe.
- Supporto alla riduzione degli errori: La distinzione visiva degli elementi sintattici facilita l’individuazione di errori comuni (ad esempio virgolette non chiuse, parentesi mancanti o separatori errati) prima dell’esecuzione del Workflow.