Variabili ripetute
Le variabili ripetitive (moltiplicative) si usano con i campi che possono contenere più valori (come gli assegnati, i file e così via). Consentono di inserire automaticamente i dati di questi campi nei modelli di documento, nei testi con variabili e nei campi calcolati: è possibile generare una riga separata per ogni valore oppure riunire tutti i valori in un'unica riga separata da virgole.
I campi che possono contenere più valori nelle attività, nei contatti, nei progetti e nei 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}} {{Task.All task files}} |
Campi personalizzati
Campi personalizzati
- Elenco
- Insieme di attività
- Insieme di valori dell'elenco
- Elenco di utenti
- Insieme di valori
- File
Visualizzare tutti i valori in un'unica riga
Se usi una variabile ripetitiva in un modello Word o in un testo con variabili, tutti i valori del campo vengono elencati su 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 ripetitive 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 i costrutti FOREACH o TABLE.
Ad esempio, puoi usare FOREACH con una variabile ripetitiva in un blocco dinamico:
Dopo aver salvato il blocco, i dati verranno visualizzati in una colonna:
Importante
- Nei costrutti FOREACH e TABLE, il primo argomento deve essere il nome del campo su cui vuoi eseguire l'iterazione:
- Nel corpo di ciascun costrutto, devi aggiungere il nome della variabile e specificare da quale campo devono essere estratti i dati:
Variabili e JSON nelle richieste POST
In una richiesta in formato JSON, una variabile ripetitiva viene rappresentata come un array:
La richiesta genererà un JSON valido:
{
phone: [
"1 (234) 567-89-01",
"2 (345) 678-91-23",
"+5 (6789) 12-34-56"
]
}
Se l'endpoint prevede una singola stringa anziché 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"
}