Espressione
Le funzioni di espressione sono widget non visivi che è possibile utilizzare per valutare un'espressione JavaScript. È possibile scrivere espressioni JavaScript per convalidare, calcolare, convertire e confrontare i dati nel mashup.
Utilizzare l'opzione Parametro per creare nuovi parametri per la funzione. È possibile impostare il tipo di dati e il valore di default per ciascun parametro. I parametri vengono utilizzati dalla funzione per archiviare i valori dei dati. È possibile creare parametri per associare dati da origini quali i campi delle proprietà e i servizi dati nel mashup. Tutti i parametri sono elencati come proprietà associabili nella sezione Parametri della funzione.
È possibile selezionare il tipo di dati di output per i parametri utilizzando l'opzione Tipo di base di output. Le espressioni di confronto dei dati restituiscono un output BOOLEANO. I calcoli o le manipolazioni di stringhe restituiscono un tipo di dati NUMBER o STRING. Assicurarsi che il widget di destinazione per la proprietà Output supporti il tipo di base di output.
Il campo Espressione consente di definire il codice JavaScript. È possibile definire espressioni aritmetiche, di confronto e regolari.
Espressioni aritmetiche
• Espressioni semplici - Utilizzo di operatori semplici per eseguire addizioni, sottrazioni, moltiplicazioni e divisioni. Ad esempio:
(Parameter1 + Parameter2) / Parameter3 restituisce la somma di Parameter1 e Parameter2 divisi per Parameter3.
• Espressioni complesse - Utilizzo di funzioni per eseguire calcoli quali elevamenti a potenza, radici quadrate e logaritmi naturali.
Math.pow(Parameter1, Parameter2) restituisce Parameter1 elevato alla potenza di Parameter2.
Espressioni di confronto
È possibile utilizzare tutti gli operatori di confronto JavaScript per confrontare i dati dei parametri di input.
Espressioni regolari
La funzione Espressione supporta la notazione JavaScript per le espressioni regolari. È possibile utilizzare le espressioni regolari per convalidare e filtrare i dati di input utilizzando la sintassi riportata di seguito.
• /<expression>/.test(<parameter>)
◦ <expression> - L'espressione regolare da valutare.
◦ test() - Metodo che confronta il parametro di dati specificato con l'espressione.
◦ <parameter> - Il nome del parametro con i dati da valutare.
• /^(?:\d{3}\-){2}\d{4}$/.test(phoneNumber)
◦ ^ - L'inizio della stringa.
◦ (?:\d{3}\-){2} - Corrisponde a tre cifre numeriche seguite da un trattino e si ripete due volte: (###-###-).
◦ \d{4} - Corrisponde a una singola cifra e si ripete quattro volte: (####).
◦ $ - La fine della stringa.
Registrazione di eccezioni JavaScript
Le eccezioni si verificano quando l'espressione JavaScript restituisce un errore. È possibile registrare le eccezioni utilizzando il metodo TW.log.error. Nell'esempio riportato di seguito, si verifica un'eccezione perché la funzione non è definita:
try {
undefinedFunction();
}
catch (e){
TW.log.error("The function does not exist: " + e);
}
undefinedFunction();
}
catch (e){
TW.log.error("The function does not exist: " + e);
}
 |
Gli errori vengono registrati in fase di esecuzione. Fare clic su Mostra/Nascondi log nella barra degli strumenti superiore per mostrare o nascondere i log di Mashup Builder.
|
Opzioni della funzione Espressione
È possibile impostare le opzioni di configurazione seguenti:
• Descrizione - Imposta una descrizione per la funzione.
• Parametri - Specifica parametri personalizzati per la funzione.
• Espressione - L'espressione JavaScript da valutare.
• Valutazione automatica - Valuta automaticamente le espressioni quando vengono modificati i dati dei parametri di input.
• Attiva con il primo valore - Valuta l'espressione JavaScript quando viene trasmesso il primo valore. L'espressione non viene valutata quando viene trasmesso un secondo valore.
• Tipo di modifica dati - Controlla quando viene attivato l'evento modificato.
• Tipo di base di output - Il tipo di dati dell'output dell'espressione.
• Disattiva output iniziale - Impedisce alla funzione di assegnare un valore iniziale non definito alla proprietà Output prima che l'espressione venga valutata.
Creazione di una funzione di espressione
1. Nel pannello Funzioni, fare clic su 
. Viene visualizzata la finestra di dialogo Nuova funzione.
. Viene visualizzata la finestra di dialogo Nuova funzione.2. Selezionare Espressione dall'elenco a discesa.
3. Immettere un nome per la funzione, quindi fare clic su Avanti.
4. In Espressione, immettere un'espressione JavaScript da valutare.
5. Aggiungere i parametri di input dei dati:
a. Fare clic su Aggiungi parametro.
b. Immettere un nome per il parametro.
c. Immettere un valore di default e una descrizione comando, quindi selezionare un tipo di base del parametro.
6. Selezionare un tipo di dati dall'elenco a discesa Tipo di base di output.
7. Fare clic su Fine.
La funzione viene aggiunta al pannello Funzioni nella categoria Espressioni.
Proprietà
La funzione di espressione contiene le proprietà riportate di seguito.
Proprietà | Descrizione | Tipo di base | Valore di default | Associabile? (Y/N) | Localizzabile? (Y/N) |
|---|---|---|---|---|---|
Evaluate | Servizio associabile che valuta l'espressione. | n/d | n/d | Y | N |
Changed | Proprietà associabile che attiva un evento quando i dati vengono modificati. | n/d | n/d | Y | N |
Output | Output dell'espressione valutata. È possibile impostare l'associazione per questa proprietà direttamente nel campo Espressione. Per impostare un'associazione, digitare output=<> Per impedire a questa proprietà di inviare un valore iniziale non definito, selezionare la casella di controllo Disattiva output iniziale. | n/d | n/d | Y | N |