Riferimento dei token per modelli Word
L'elenco completo dei percorsi dati (associazioni) utilizzabili in un modello Word. Rispecchia il pannello di riferimento dei token nel prodotto e il catalogo di associazioni applicato dal validatore: se un percorso non è elencato qui, l'editor lo segnala. Per grammatica e formattatori vedi Modalità modello Word.
Come leggere questa pagina
- Un'associazione scalare si usa in un token di valore:
${issue.summary}. - Un'associazione di raccolta si usa in un ciclo:
${#each issue.subtasks as sub}…${/each}. Dentro il ciclo raggiungi un campo tramite la variabile di ciclo:${sub.key}. - Livelli — A è generalmente disponibile; B è incluso solo perché il pacchetto ticket contiene già il dato; C è visibile ma non associabile, elencato perché l'ambito resti onesto.
- Le radici disponibili dipendono dal contesto di esportazione.
Contesti di esportazione e relative radici
Un modello Word viene eseguito in uno di sette contesti, ciascuno con un diverso insieme di radici.
| Contesto | Radici disponibili |
|---|---|
single-issue | issue, generatedAt |
automation (azione Jira Automation) | issue, generatedAt |
multi-issue (JQL / bacheca) | issues, issueGroups, generatedAt |
scheduled | issues, issueGroups, generatedAt |
sprint | issues, issueGroups, sprint, generatedAt |
release | issues, issueGroups, release, generatedAt |
backlog | issues, issueGroups, backlog, generatedAt |
generatedAt (data e ora) è disponibile in ogni contesto.
Livello A — la superficie del ticket (issue.*)
Disponibile in single-issue e automation. Gli stessi campi costituiscono la forma per elemento della raccolta issues: dentro ${#each issues as it} usa ${it.key}, ${it.summary} e così via.
Scalari
| Percorso | Tipo |
|---|---|
issue.key | stringa |
issue.summary | stringa |
issue.description | testo formattato (ADF) |
issue.status | stato |
issue.status.category | stringa |
issue.priority | priorità |
issue.assignee | utente |
issue.assignee.displayName | stringa |
issue.reporter | utente |
issue.reporter.displayName | stringa |
issue.created | data e ora |
issue.updated | data e ora |
issue.dueDate | data |
issue.parent.key | stringa |
issue.parent.summary | stringa |
issue.parent.status | stringa |
Un valore di tipo utente mostra per impostazione predefinita il nome visualizzato; con il formattatore user ne scegli una parte, ad es. ${issue.assignee | user("displayName")}. Un valore di testo formattato viene reso con la formattazione; | plain() la rimuove.
Raccolte
| Raccolta | Campi dell'elemento (relativi alla variabile di ciclo) |
|---|---|
issue.labels | elenco primitivo — la variabile di ciclo è l'etichetta |
issue.components | name |
issue.fixVersions | name, released (booleano) |
issue.affectsVersions | name |
issue.subtasks | key, summary, status, priority, assignee, dueDate |
issue.comments | author (utente), author.displayName, body (ADF), created, updated |
issue.attachments | filename, mimeType, size, isImage, created, author.displayName — solo metadati, senza binari né URL |
issue.issueLinks | typeName, direction, linkedIssue.key, linkedIssue.summary, linkedIssue.status |
issue.worklogs | author.displayName, timeSpent, timeSpentSeconds, created, started |
Esempio:
${#each issue.worklogs as wl}
${wl.author.displayName}: ${wl.timeSpentSeconds | duration("hm")} il ${wl.started | date("yyyy-MM-dd")}
${/each}
Livello A — radici multi-ticket
Disponibili in multi-issue, scheduled, sprint, release e backlog.
| Percorso | Tipo | Campi dell'elemento |
|---|---|---|
issues | raccolta | l'intera superficie del ticket, relativa alla variabile di ciclo |
issueGroups.fixVersions | raccolta | key, title, issues |
issueGroups.sprints | raccolta | key, title, issues |
issueGroups.assignees | raccolta | key, title, issues |
issueGroups.worklogAssignees | raccolta | key, title, issues |
Esempio — raggruppa, poi scorri i ticket di ciascun gruppo:
${#each issueGroups.assignees as group}
## ${group.title}
${#each group.issues as it}
- ${it.key}: ${it.summary}
${/each}
${/each}
Livello A — radici di contesto
Disponibili solo nel rispettivo contesto.
sprint
| Percorso | Tipo |
|---|---|
sprint.sprint.name | stringa |
sprint.sprint.goal | stringa |
sprint.sprint.state | opzione |
sprint.stats.issueCount | numero |
sprint.stats.percentDone | numero |
release
| Percorso | Tipo |
|---|---|
release.release.name | stringa |
release.release.releaseDate | data |
release.release.released | booleano |
release.stats.issueCount | numero |
release.stats.percentDone | numero |
backlog
| Percorso | Tipo / campi dell'elemento |
|---|---|
backlog.board.boardName | stringa |
backlog.board.boardType | opzione |
backlog.stats.totalIssueCount | numero |
backlog.groups | raccolta — kind, name, issueCount, issues |
Livello A — metadati
| Percorso | Tipo | Contesti |
|---|---|---|
generatedAt | data e ora | tutti |
Livello B — registro modifiche
| Percorso | Tipo | Campi dell'elemento |
|---|---|---|
issue.changeHistory | raccolta | author.displayName, created, items |
Livello C — visibile ma non associabile
Questi esistono concettualmente ma non sono risolvibili; sono elencati perché editor e convalida rappresentino l'ambito con onestà.
| Funzionalità | Nota |
|---|---|
issue.jsm | Superficie richiesta, SLA e approvazioni di Jira Service Management — rinviata. |
| JQL nel modello | Rilevato e diagnosticato dallo scanner di migrazione, mai eseguito. |
| Tempo | Un mirror Tempo può esistere su un log di lavoro, ma non è associato. |
| Xray / Zephyr | I campi di test management richiedono un'app di terze parti. |
| Assets / Insight | I campi oggetto sono rinviati. |
Campi personalizzati
I campi personalizzati sono associabili sotto un unico spazio dei nomi:
${ issue.customFields.<idCampo>.<…> }
- Gli id sconosciuti sono morbidi: l'editor mostra un avviso e il valore può risultare vuoto, ma non blocca mai in modo netto — così un modello può riferirsi a un campo che questo sito non possiede senza fallire.
- Il percorso nudo
issue.customFields(l'intera mappa) non è mai associabile. - Sono ammessi solo caratteri identificatore sicuri; i segmenti
__proto__,prototypeeconstructorvengono rifiutati.
Avvertenze nella migrazione da Xporter
Lo scanner di migrazione suggerisce percorsi Exportelier per i nomi di campo Xporter più comuni. Due cose da sapere perché un suggerimento si risolva davvero:
- La conversione automatica corregge la sintassi, non l'esistenza di un percorso. La riscrittura ha la forma giusta, ma la destinazione deve comunque essere un'associazione reale di questa pagina, altrimenti compare un avviso
unknown-binding:- Assenti dal catalogo:
Creator→issue.creator,Resolution→issue.resolution,Project→issue.project,IssueType/Type→issue.issuetype. - Differenza di maiuscole:
DueDateviene suggerito comeissue.duedate, mentre l'associazione èissue.dueDate. - Tipo errato:
Labelsviene suggerito come scalare, maissue.labelsè una raccolta — usa un ciclo.
- Assenti dal catalogo:
- Collegamenti tra ticket. L'alias
Linksviene suggerito comelinks, ma l'associazione reale èissue.issueLinks.
Vedi Sintassi Xporter: cosa funziona per la mappa completa di migrazione.
Percorsi mai consentiti
Per sicurezza alcuni percorsi vengono rifiutati con un errore unsafe-template indipendentemente dal contesto — campi interni, di credenziali o che contengono URL. Comprendono radici come auth, context, forge, internal, secrets, storage e token, e qualsiasi percorso che termini con accountId, apiToken, avatarUrl, baseUrl, contentUrl, thumbnailUrl, cookie, session, headers, private o storageRef. Attenendoti alle associazioni di questa pagina non li incontrerai.