Variabili¶
Utilizza variabili nei moduli di testo, nei trigger e in molti altri posti in Zammad per riflettere dinamicamente le informazioni dagli attributi oggetto.
Nota
Si prega di notare che questa è solo una panoramica delle variabili disponibili. Potrebbe essere incompleta o le variabili potrebbero non essere disponibili in alcune funzioni. Se ti mancano variabili o non sei sicuro che qualcosa non funzioni come previsto, non esitare a chiedere sulla community.
Utilizzo di base¶
Le variabili possono essere chiamate digitando :: (proprio come i moduli di testo nel frontend), purché ti trovi in un campo di testo supportato nelle impostazioni. Zammad visualizzerà tutte le variabili disponibili in questo contesto e aggiungerà la variabile al tuo testo non appena avrai selezionato una voce. Puoi persino cercare e utilizzare variabili per attributi oggetto personalizzati.
Dopo aver selezionato una variabile, viene visualizzata in una struttura come questa: #{object.attribute}
Suggerimento
Hai un campo vuoto a cui hai fatto riferimento e appare come -? Questo funziona come previsto al momento: potresti voler assicurarti che questi campi abbiano sempre un valore.
Categorie di variabili¶
Struttura¶
La prima parte del nome della variabile è costituita dal tipo di oggetto, ad esempio ticket, config, user.
La seconda parte è il nome dell’attributo. Per gli attributi oggetto personalizzati, questo è il nome che hai definito per l’attributo e che può essere trovato nel menu degli attributi oggetto in qualsiasi momento. La prima e la seconda parte di una variabile sono divise da un punto, ad esempio: ticket.number che in totale sarà #{ticket.number}.
Per gli attributi chiave/valore come i campi di selezione, Zammad sostituisce la variabile con il nome della chiave. Nel caso in cui desideri che Zammad sostituisca una variabile con il valore invece della chiave, devi aggiungere una terza parte: #{ticket.select.value}.
Utilizzo di variabili tradotte¶
Se desideri utilizzare una variabile tradotta nei trigger o negli scheduler, puoi estendere il placeholder in questo modo: #{t(ticket.state.name)}. Il t dice a Zammad di cercare stringhe tradotte corrispondenti. La lingua di output utilizzata si basa sulla lingua di sistema di Zammad che puoi impostare nel pannello di amministrazione sotto Branding o in base alla locale selezionata nella finestra di dialogo di modifica del trigger/scheduler.
Un caso d’uso possibile: vuoi inviare ai tuoi clienti aggiornamenti sui ticket tramite trigger o scheduler che dovrebbero includere lo stato del ticket. Utilizzare il valore predefinito #{ticket.state.name} (senza il flag di traduzione t()) porterebbe all’output del nome originale (inglese) dello stato.
Formattazione data e ora¶
La locale e il fuso orario del sistema (trigger/scheduler selezionato) predefiniscono un formato predefinito di data e timestamp. Questo formato è personalizzabile utilizzando il metodo dt().
Gli argomenti del metodo sono i seguenti:
La variabile data o timestamp che desideri formattare.
La stringa di formato di output.
Il fuso orario da applicare (opzionale).
#{dt(ticket.updated_at, "%A %Y-%m-%d %H:%M in ufficio", "Europe/Berlin")}Suggerimento
Se vuoi usare il nostro esempio, assicurati di incollare la stringa sopra senza formattazione (CTRL Shift v), altrimenti non funzionerà.
La seguente tabella elenca le direttive di formato disponibili:
Parametro |
Descrizione |
Nota |
|---|---|---|
|
Anno con 4 cifre |
Usa |
|
Mese dell’anno (come numero con zero iniziale) |
Usa |
|
Giorno del mese (come numero con zero iniziale) |
Usa |
|
Ora del giorno in notazione 24h con zero iniziale |
Usa |
|
Ora del giorno in notazione 12h con zero iniziale |
Usa |
|
Minuto dell’ora |
|
|
Secondo del minuto |
|
|
Nome del giorno della settimana |
Usa |
|
Nome del mese |
Usa |
|
Numero della settimana dell’anno corrente |
Usa |
Suggerimento
Supportiamo le direttive di formato note per il metodo integrato di Ruby strftime della classe DateTime. Per maggiori informazioni, vedi qui.