Référence des jetons de modèle Word

La liste complète des chemins de données (liaisons) utilisables dans un modèle Word. Elle reflète le panneau de référence des jetons du produit et le catalogue de liaisons appliqué par le validateur : si un chemin ne figure pas ici, l'éditeur le signale. Pour la grammaire et les formateurs, voir Mode modèle Word.

Comment lire cette page

Une liaison scalaire s'utilise dans un jeton de valeur : ${issue.summary}.
Une liaison de collection s'utilise dans une boucle : ${#each issue.subtasks as sub}…${/each}. Dans la boucle, accédez à un champ via la variable de boucle : ${sub.key}.
Niveaux — A est généralement disponible ; B n'est fourni que parce que le paquet de ticket contient déjà la donnée ; C est visible mais non liable, listé pour que le périmètre reste honnête.
Les racines disponibles dépendent du contexte d'export.

Contextes d'export et leurs racines

Un modèle Word s'exécute dans l'un des sept contextes, chacun exposant un jeu de racines différent.

Contexte	Racines disponibles
`single-issue`	`issue`, `generatedAt`
`automation` (action Jira Automation)	`issue`, `generatedAt`
`multi-issue` (JQL / tableau)	`issues`, `issueGroups`, `generatedAt`
`scheduled`	`issues`, `issueGroups`, `generatedAt`
`sprint`	`issues`, `issueGroups`, `sprint`, `generatedAt`
`release`	`issues`, `issueGroups`, `release`, `generatedAt`
`backlog`	`issues`, `issueGroups`, `backlog`, `generatedAt`

generatedAt (date et heure) est disponible dans tous les contextes.

Niveau A — la surface de ticket (`issue.*`)

Disponible dans single-issue et automation. Ces mêmes champs constituent la forme par élément de la collection issues : dans ${#each issues as it}, utilisez ${it.key}, ${it.summary}, etc.

Scalaires

Chemin	Type
`issue.key`	chaîne
`issue.summary`	chaîne
`issue.description`	texte enrichi (ADF)
`issue.status`	statut
`issue.status.category`	chaîne
`issue.priority`	priorité
`issue.assignee`	utilisateur
`issue.assignee.displayName`	chaîne
`issue.reporter`	utilisateur
`issue.reporter.displayName`	chaîne
`issue.created`	date et heure
`issue.updated`	date et heure
`issue.dueDate`	date
`issue.parent.key`	chaîne
`issue.parent.summary`	chaîne
`issue.parent.status`	chaîne

Une valeur de type utilisateur affiche le nom d'affichage par défaut ; le formateur user permet d'en choisir une partie, p. ex. ${issue.assignee | user("displayName")}. Une valeur de texte enrichi est rendue mise en forme ; | plain() retire la mise en forme.

Collections

Collection	Champs de l'élément (relatifs à la variable de boucle)
`issue.labels`	liste primitive — la variable de boucle est l'étiquette
`issue.components`	`name`
`issue.fixVersions`	`name`, `released` (booléen)
`issue.affectsVersions`	`name`
`issue.subtasks`	`key`, `summary`, `status`, `priority`, `assignee`, `dueDate`
`issue.comments`	`author` (utilisateur), `author.displayName`, `body` (ADF), `created`, `updated`
`issue.attachments`	`filename`, `mimeType`, `size`, `isImage`, `created`, `author.displayName` — métadonnées uniquement, sans binaire ni URL
`issue.issueLinks`	`typeName`, `direction`, `linkedIssue.key`, `linkedIssue.summary`, `linkedIssue.status`
`issue.worklogs`	`author.displayName`, `timeSpent`, `timeSpentSeconds`, `created`, `started`

Exemple :

${#each issue.worklogs as wl}
${wl.author.displayName} : ${wl.timeSpentSeconds | duration("hm")} le ${wl.started | date("yyyy-MM-dd")}
${/each}

Niveau A — racines multi-tickets

Disponibles dans multi-issue, scheduled, sprint, release et backlog.

Chemin	Nature	Champs de l'élément
`issues`	collection	la surface de ticket complète, relative à la variable de boucle
`issueGroups.fixVersions`	collection	`key`, `title`, `issues`
`issueGroups.sprints`	collection	`key`, `title`, `issues`
`issueGroups.assignees`	collection	`key`, `title`, `issues`
`issueGroups.worklogAssignees`	collection	`key`, `title`, `issues`

Exemple — regrouper, puis parcourir les tickets de chaque groupe :

${#each issueGroups.assignees as group}
## ${group.title}
${#each group.issues as it}
- ${it.key} : ${it.summary}
${/each}
${/each}

Niveau A — racines de contexte

Disponibles uniquement dans leur propre contexte.

`sprint`

Chemin	Type
`sprint.sprint.name`	chaîne
`sprint.sprint.goal`	chaîne
`sprint.sprint.state`	option
`sprint.stats.issueCount`	nombre
`sprint.stats.percentDone`	nombre

`release`

Chemin	Type
`release.release.name`	chaîne
`release.release.releaseDate`	date
`release.release.released`	booléen
`release.stats.issueCount`	nombre
`release.stats.percentDone`	nombre

`backlog`

Chemin	Type / champs de l'élément
`backlog.board.boardName`	chaîne
`backlog.board.boardType`	option
`backlog.stats.totalIssueCount`	nombre
`backlog.groups`	collection — `kind`, `name`, `issueCount`, `issues`

Niveau A — métadonnées

Chemin	Type	Contextes
`generatedAt`	date et heure	tous

Niveau B — journal des modifications

Chemin	Nature	Champs de l'élément
`issue.changeHistory`	collection	`author.displayName`, `created`, `items`

Niveau C — visible mais non liable

Ces éléments existent conceptuellement mais ne sont pas résolus ; ils sont listés pour que l'éditeur et la validation reflètent honnêtement le périmètre.

Capacité	Remarque
`issue.jsm`	Surface demande, SLA et approbation de Jira Service Management — reportée.
JQL dans le modèle	Détecté et diagnostiqué par l'analyseur de migration, jamais exécuté.
Tempo	Un miroir Tempo peut exister sur un journal de travail, mais n'est pas lié.
Xray / Zephyr	Les champs de gestion des tests requièrent une application tierce.
Assets / Insight	Les champs objet sont reportés.

Champs personnalisés

Les champs personnalisés sont liables sous un espace de noms unique :

${ issue.customFields.<idDuChamp>.<…> }

Les identifiants inconnus sont souples : l'éditeur affiche un avertissement et la valeur peut rester vide, sans jamais bloquer — un modèle peut donc référencer un champ absent de ce site sans échouer.
Le chemin nu issue.customFields (la carte complète) n'est jamais liable.
Seuls les caractères d'identifiant sûrs sont admis ; les segments __proto__, prototype et constructor sont rejetés.

Précautions lors d'une migration depuis Xporter

L'analyseur de migration suggère des chemins Exportelier pour les noms de champs Xporter courants. Deux points à connaître pour qu'une suggestion se résolve réellement :

La conversion automatique corrige la syntaxe, pas l'existence d'un chemin. La réécriture a la bonne forme, mais la cible doit rester une liaison réelle de cette page, faute de quoi un avertissement unknown-binding apparaît :
- Absents du catalogue : Creator → issue.creator, Resolution → issue.resolution, Project → issue.project, IssueType/Type → issue.issuetype.
- Différence de casse : DueDate est suggéré comme issue.duedate, alors que la liaison est issue.dueDate.
- Type incorrect : Labels est suggéré comme scalaire, mais issue.labels est une collection — utilisez une boucle.
Liens de tickets. L'alias Links est suggéré comme links, mais la liaison réelle est issue.issueLinks.

Voir Syntaxe Xporter : ce qui fonctionne pour la carte de migration complète.

Chemins jamais autorisés

Par sécurité, certains chemins sont rejetés avec une erreur unsafe-template quel que soit le contexte — champs internes, d'identification ou porteurs d'URL. Cela inclut des racines telles que auth, context, forge, internal, secrets, storage et token, ainsi que tout chemin se terminant par accountId, apiToken, avatarUrl, baseUrl, contentUrl, thumbnailUrl, cookie, session, headers, private ou storageRef. En vous en tenant aux liaisons de cette page, vous ne les rencontrerez pas.

Comment lire cette page​

Contextes d'export et leurs racines​

Niveau A — la surface de ticket (issue.*)​

Scalaires​

Collections​

Niveau A — racines multi-tickets​

Niveau A — racines de contexte​

sprint​

release​

backlog​

Niveau A — métadonnées​

Niveau B — journal des modifications​

Niveau C — visible mais non liable​

Champs personnalisés​

Précautions lors d'une migration depuis Xporter​

Chemins jamais autorisés​