Variabili e modelli

Con le variabili crei testi che cambiano da caso a caso. Scrivi una variabile tra parentesi graffe e Tillor inserisce il valore reale quando l'automazione viene eseguita.

Un esempio di titolo di un'attività:

Controleer {occupation.terrain.name}

Se l'occupazione termina sul terreno 12, l'attività si chiama Controleer 12.

Inserire una variabileCopia il link a questa sezione

Sopra ogni campo di testo in cui le variabili funzionano c'è il pulsante Variabile. Fai clic e vedi un elenco di tutti i dati disponibili, raggruppati per record. Digita per cercare (Cerca variabili) e fai clic su una riga. Tillor inserisce la variabile nel punto del cursore.

Puoi anche digitare tu stesso una variabile. Sotto il campo un riquadro grigio mostra come appare il testo con dati di esempio, così vedi subito se è corretto.

Le variabili funzionano in campi di testo come titoli, descrizioni, sottoattività, messaggi, l'ID di un cliente, di una fattura o di un altro record, il percorso o l'URL di una richiesta API, il corpo, il payload di un webhook, il nome dell'evento del webhook e i valori delle intestazioni. Negli ultimi due manca il pulsante Variabile, ma una variabile che digiti tu viene comunque compilata. Tillor non controlla questi due campi alla ricerca di errori e non mostra un esempio.

Nei campi in cui scegli un dato con cui confrontare, scrivi la variabile senza parentesi graffe. Vale per Solo quando, Se / altrimenti e Finché in Attendi finché (per esempio invoice.status), per il Campo di uno Smista e per la Data di un Ritardo.

Quali variabili esistonoCopia il link a questa sezione

Quali campi ha esattamente un record lo vedi nell'elenco dietro il pulsante Variabile. Nel trigger c'è anche il riepilogo Dati forniti da questo evento.

Solo ciò che viene prima nel flussoCopia il link a questa sezione

Un passaggio può usare solo variabili del trigger che lo raggiunge e dei passaggi che lo precedono sullo stesso percorso. Se più trigger raggiungono lo stesso passaggio, sono disponibili solo le variabili che ognuno di questi trigger fornisce. Un campo di un passaggio precedente conta se ognuno di questi trigger passa anche da quel passaggio. Se usi una variabile che in quel punto non esiste, Tillor segnala [Campo]: [variabile] non è disponibile in questo passaggio. Un flusso con un messaggio del genere non può essere attivato.

Alcuni record conservano dati aggiuntivi in un solo campo, come i dati del documento in userMetadata. Ogni chiave al suo interno è una variabile: {document.userMetadata.documentType}, {document.userMetadata.insuranceExpiryDate} o un'altra chiave. Le chiavi note, come il tipo e la scadenza di un documento, sono anche nell'elenco e puoi confrontarle come data. Una data senza ora, come 2026-10-07, compare in un messaggio come 07-10-2026.

Le variabili di Per ogni ({item.…}) esistono solo nei passaggi dopo l'uscita Per ogni, non dopo Completato. Anche le variabili di un'uscita che non hai preso non esistono: {paymentLink.url} c'è solo se il passaggio è passato da Fatto, e {foundTask.id} solo dopo Trovata.

Con eventi di cui i dati non sono descritti, Tillor non può verificare quali variabili esistono. In quel caso non ricevi questo messaggio. Controlla quindi questi flussi con particolare attenzione con un'esecuzione di prova.

Un nuovo valore sostituisce il vecchioCopia il link a questa sezione

Una seconda Richiesta API nello stesso flusso sostituisce la response della prima. Lo stesso vale per createdTask dopo una seconda Crea attività, per foundTask dopo un secondo Cerca attività o Cerca un record su Attività, e per error dopo un secondo passaggio non riuscito. Usa quindi i dati di una risposta nel passaggio che segue subito.

Come vengono compilati i valoriCopia il link a questa sezione

Tillor adatta la notazione al tipo di campo.

Nel testo normale (titoli, descrizioni, sottoattività):

• Le date sono nel fuso orario della tua organizzazione, per esempio 05-10-2026. Se l'orario non cade esattamente a mezzanotte, c'è anche un'ora, come 05-10-2026 14:30
• Un campo vuoto dà un testo vuoto
• Una variabile che Tillor non conosce resta come l'hai scritta, per esempio {occupation.terain.name}. Un errore di battitura si nota così subito nell'attività o nel messaggio
• Se un record collegato non c'è, la variabile resta vuota. Un'occupazione senza prenotazione non dà quindi nulla per {occupation.reservation.displayId}, e un evento causato dal sistema non dà nulla per {triggeredBy.name}. Se in quel caso vuoi un altro testo, metti prima un Se / altrimenti con è vuoto

In JSON (il Payload di un webhook e il Corpo di una richiesta API):

• Il testo viene inserito in modo sicuro. Virgolette, a capo e altri caratteri speciali nel valore non possono rompere il JSON
• Numeri e valori sì/no vengono inseriti senza virgolette, quindi non metterle intorno. Il testo invece va tra virgolette
• Le date passano come data e ora internazionali, come 2026-10-05T08:00:00.000Z, così il sistema ricevente le gestisce bene

{
  "reservation": "{reservation.displayId}",
  "adults": {reservation.numberOfAdults}
}

Se dopo la compilazione il JSON non è valido, per esempio perché un numero è vuoto, l'esecuzione si ferma con un messaggio di errore.

In un percorso o URL (in una richiesta API):

• I valori vengono convertiti in modo da starci in un indirizzo. Un nome con uno spazio non dà quindi un indirizzo rotto
• Anche qui le date passano come data e ora internazionali
• Ciò che digiti tu resta come lo digiti. Se vuoi uno spazio in un termine di ricerca, digita tu %20

Spostare una dataCopia il link a questa sezione

Dopo una variabile data può esserci uno spostamento: {reservation.checkOut + 1 day}, {today - 2 weeks}, {invoice.dueDate + 3 hours|date}. Le unità sono minutes, hours, days, weeks e months (va bene anche il singolare). Giorni e settimane hanno durata fissa, così una validità resta della stessa lunghezza anche attraverso l'ora legale e solare; i mesi seguono il calendario, quindi il 31 gennaio più un mese è il 28 o 29 febbraio. Su un valore che non è una data lo spostamento non fa nulla, e un'unità che non esiste è un errore del passaggio. I campi data come Valido fino a accettano la stessa scrittura.

Formattare un valoreCopia il link a questa sezione

Dopo la variabile metti un | e un formato, per esempio {invoice.amountOutstanding|currency}. Senza formato un importo appare nudo, come 1295.3. Con |currency diventa € 1.295,30.

• Numeri e importi sono sempre in notazione belga: un punto per le migliaia e una virgola per i decimali
• Date e orari sono nel fuso orario della tua organizzazione
• Se il formato non riesce a leggere il valore, per esempio |currency su un testo, il valore compare semplicemente senza formato
• Un formato che Tillor non conosce resta come l'hai scritto, e l'editor mostra un avviso
• In JSON e in un URL il valore formattato viene inserito come testo. In JSON metti quindi le virgolette intorno

Usare una risposta APICopia il link a questa sezione

Dopo una Richiesta API puoi usare i campi della risposta con {response.data.…}. La risposta di una ricerca di attività è per esempio fatta così:

{
  "items": [
    { "id": "task_1", "priority": "LOW" }
  ]
}

Allora {response.data.items.0.id} dà l'ID della prima attività (il primo di un elenco è il numero 0) e {response.data.items.0.priority} la sua priorità.

Tillor può offrire i campi di una risposta come variabili solo se sa com'è fatta la risposta. Ci sono due modi:

• Fai girare davvero l'automazione una volta. Tillor usa allora la risposta dell'ultima esecuzione
• Incolla un esempio nella scheda Esecuzione di prova, nel campo Esempio di risposta API. Il campo compare non appena il flusso contiene una Richiesta API. Sotto ci sono i Campi di questa risposta. Fai clic su un campo per copiarlo, parentesi graffe incluse

Poi i campi compaiono nell'elenco dietro il pulsante Variabile e nell'elenco di Campo di uno Smista.

Se digiti tu un percorso sotto response.data, viene sempre accettato, anche senza esempio. Inoltre:

• {response.body} contiene i primi 4000 caratteri della risposta. Se la risposta è più lunga, il resto viene tagliato
• {response.data} è vuoto se la risposta non è JSON o se la risposta è molto grande (oltre 100.000 caratteri)
• Con una ricerca senza risultati {response.data.items.0.id} non esiste. Uno Smista su un campo del genere passa allora da Predefinito

Cosa succede poi?Copia il link a questa sezione

• Non appena l'automazione viene eseguita, Tillor sostituisce ogni variabile con il valore reale. Una variabile che Tillor non conosce resta come l'hai scritta.
• Se un dato è vuoto, il posto resta vuoto. Se allora vuoi un altro testo, metti prima un Se / altrimenti con è vuoto.

Problemi?Copia il link a questa sezione