Variabili ripetute
Variabili ripetute (moltiplicative) vengono utilizzate con i campi che possono contenere più valori (come assegnati, file, ecc.). Consentono di inserire automaticamente i dati di questi campi nei modelli di documento, nei testi con variabili e nei campi calcolati — sia generando una riga separata per ogni valore sia combinando tutti i valori in un'unica riga separata da virgole. I campi che possono contenere insiemi di valori in compiti, contatti, progetti e dipendenti includono:
Campi di sistema
| Campo | Variabile |
|---|---|
| Assegnati | {{Task.Assignee}} |
| Partecipanti | {{Task.Participant}} |
| Revisori dei conti | {Task.Task auditors}} |
| Tag dati | {{Data tag.Actual working time}} |
| File | {{{Task.Attached files}} {{Task.Task file}} |
Campi personalizzati
Campi personalizzati
- Lista
- Insieme di attività
- Valori elenco
- Elenco utenti
- Insieme di valori
- File
Visualizzare tutti i valori in un'unica riga
Se usi una variabile ripetuta in un modello Word o in un testo con variabili, tutti i valori del campo verranno elencati in un'unica riga, separati da virgole. Ecco come appare la variabile nel modello:
Nel documento generato:
Visualizzare i valori su righe separate
Nei modelli Excel o nelle tabelle Word, le variabili ripetute duplicano automaticamente le righe e inseriscono ogni valore presente nel campo.
Ecco come appare la variabile nel modello:
Nel documento generato:
Opzioni aggiuntive
Per una formattazione più avanzata nei testi con variabili, puoi usare le costruzioni FOREACH o TABLE.
Ad esempio, usando FOREACH con una variabile ripetuta in un blocco dinamico:
Dopo aver salvato il blocco, i dati verranno visualizzati come una colonna:
Importante
- Nelle costruzioni FOREACH e TABLE, il primo argomento deve essere il nome del campo su cui vuoi iterare:
- All'interno del corpo di ogni costruzione, devi inserire il nome della variabile e specificare da quale campo devono essere presi i dati:
Variabili e JSON nelle richieste POST
Per una richiesta in formato JSON, una variabile ripetuta è rappresentata come un array:
La richiesta genererà JSON valido:
{
phone: [
"1 (234) 567-89-01",
"2 (345) 678-91-23",
"+5 (6789) 12-34-56"
]
}
Se l'endpoint si aspetta una singola stringa invece di un array, usa la variabile “Phones as a string”:
{
phone: "{{Task.Counterparty.Phones as string}}"
}
Risultato:
{
phone: "1 (234) 567-89-01,2 (345) 678-91-23,+5 (6789) 12-34-56"
}