Référence des paramètres et des balises
Azumuta vous permet d’insérer des données en direct dans des instructions de travail, des rapports docx et des webhooks. Il peut s’agir d’un paramètre que vous avez défini ou d’une valeur qu’Azumuta suit déjà. La syntaxe diffère selon l’emplacement, et cet article la liste pour chacun. Il couvre vos propres paramètres et les balises intégrées principales d’Azumuta. Les balises docx spécifiques aux modules, telles que ticket, answer, variant, image et recap, sont traitées dans leurs propres articles, liés depuis Related articles ci‑dessous.
Deux types de valeurs
- Votre propre paramètre : des données que vous définissez et liez à un article ou à un ordre de production, comme Color ou Body Material. Voir Introduction to parameters pour plus d’informations.
- Valeurs intégrées : des données qu’Azumuta possède déjà, comme un ordre de production, le nom de l’opérateur, ou une date d’échéance. Voir Built-in values reference pour la liste complète.
Où vous pouvez les utiliser, et la syntaxe exacte
Le format de référence dépend de l’endroit où vous l’utilisez.
| Where | Syntax (your own parameter / built-in value) |
|---|---|
| Work instructions (visual pages, calculations, checks) | ${Parameter_key} / ${=identifier} |
| Docx / PDF report templates | {p_Parameter_key} / {=identifier} |
| Webhooks and export file/folder naming | ${Parameter_key} / ${=identifier} |
| A rule’s advanced formula field | the expression itself, no wrapper |
Instructions de travail : pages visuelles, calculs et contrôles
Utilisez ${...} partout où vous ajoutez une valeur en direct dans une instruction de travail : une zone de texte sur une page visuelle, la description d’une étape, ou un calcul.
- Votre propre paramètre :
${Parameter_key} - Une valeur intégrée :
${=identifier} - Un calcul :
${=Parameter_key + 3}
Voir Use parameters in a Work Instruction step, Use parameters on an image in a Work Instruction, et Performing calculations with Parameters pour les tutoriels complets, y compris les opérateurs mathématiques disponibles.
Exception : champs de formule dédiés. La condition Formula evaluates to true (advanced) d’une règle est elle‑même un champ de formule, pas du texte libre avec une valeur intégrée, vous saisissez donc l’expression directement sans aucun wrapper ${...} : dateTime("12/05/2026 14:30", "dd/MM/yyyy HH:mm"), par exemple. dateTime() lit une date depuis du texte, donc son modèle utilise des jetons de date simples sans le préfixe FORMAT:. Voir Rules: Advanced.
Modèles Docx / PDF
Utilisez des accolades simples, sans le signe dollar, et un = initial pour une valeur intégrée :
- Votre propre paramètre :
{p_Parameter_key}(le préfixep_identifie un paramètre) - Une valeur intégrée :
{=identifier},{=dueDate}, etc. - Afficher un paramètre seulement s’il a une valeur :
{#p_Parameter_key}{p_Parameter_key}{/p_Parameter_key}, avec{^p_Parameter_key}texte de secours{/p_Parameter_key}pour le cas où il est vide
Cela s’applique aux rapports docx d’un ordre de production, d’une instruction de travail, d’un enregistrement/audit, et d’un incident. Voir Basic Tags on a Docx Report, Parameter Tags, et Conditional Parameter Tags.
Exception : boucles answer et recap. À l’intérieur d’une boucle {#answers}...{/answers} ou d’une section récapitulative, plusieurs valeurs intégrées suppriment le = initial et apparaissent comme une balise nue, par exemple {workinstructionName}. Voir Answer Tags (Basic) pour la liste des balises de cette boucle.
Webhooks et nommage des fichiers/dossiers d’export
Utilisez ${...}, identique aux instructions de travail, puisque les deux passent par le même moteur :
- Votre propre paramètre :
${Parameter_key} - Une valeur intégrée :
${=identifier}
Cela s’applique au payload et à l’URL d’un webhook déclenché par un trigger, au webhook d’une intégration périphérique, et au nom de fichier ou chemin du dossier de destination d’un rapport exporté. Voir Calling a Webhook from a Trigger.
Référence des valeurs intégrées
Celles‑ci sont fournies automatiquement par Azumuta. Écrivez‑les comme {=tag} dans les rapports docx et ${=tag} dans les instructions de travail et les webhooks.
La disponibilité dépend du contexte. Everywhere signifie instructions de travail, rapports docx et webhooks. Les autres valeurs ne se résolvent que lors de la génération d’un export spécifique (un PDF d’instruction de travail ou un rapport d’enregistrement/audit), pas dans un webhook ni dans une étape d’instruction de travail en direct.
Ordre de production
| Tag | Value | Available in |
|---|---|---|
identifier |
Le numéro de l’ordre de production | Everywhere |
amount |
La quantité cible de l’ordre de production | Everywhere |
amountComplete |
La quantité complétée à ce jour | Everywhere |
dueDate |
La date limite de l’ordre de production | Everywhere |
executionDate |
La date de début prévue | Everywhere |
finishDate |
La date de fin de l’ordre de production | Everywhere |
Dates
| Tag | Value | Available in |
|---|---|---|
today |
La date courante | Everywhere |
Formats de date
today, dueDate, executionDate et finishDate acceptent un format optionnel entre parenthèses. Dans un rapport docx, commencez soit un modèle personnalisé par FORMAT:, par exemple {=dueDate(FORMAT:dd/MM/yyyy)}, soit utilisez un nom prédéfini, par exemple {=dueDate(DATE_SHORT)}. Sans format, la date utilise le format par défaut pour la langue du rapport.
Jetons de modèle personnalisés
Les jetons sont sensibles à la casse. Les exemples utilisent le 6 août 2014 à 14:05:09.
| Token | Value | Example |
|---|---|---|
d, dd |
Jour du mois | 6, 06 |
L, LL |
Numéro du mois | 8, 08 |
LLL, LLLL |
Nom du mois | Aug, August |
yy, yyyy |
Année | 14, 2014 |
ccc, cccc |
Jour de la semaine | Wed, Wednesday |
HH, mm, ss |
Heures (24h), minutes, secondes | 14, 05, 09 |
Noms prédéfinis
Les presets suivent la langue et le fuseau horaire du rapport. Utilisez le nom exactement tel qu’écrit.
| Type | Presets |
|---|---|
| Date | DATE_SHORT, DATE_MED, DATE_MED_WITH_WEEKDAY, DATE_FULL, DATE_HUGE |
| Time | TIME_SIMPLE, TIME_WITH_SECONDS, TIME_WITH_SHORT_OFFSET, TIME_WITH_LONG_OFFSET |
| 24-hour time | TIME_24_SIMPLE, TIME_24_WITH_SECONDS, TIME_24_WITH_SHORT_OFFSET, TIME_24_WITH_LONG_OFFSET |
| Date and time | DATETIME_SHORT, DATETIME_MED, DATETIME_FULL, DATETIME_HUGE, DATETIME_SHORT_WITH_SECONDS, DATETIME_MED_WITH_SECONDS, DATETIME_MED_WITH_WEEKDAY, DATETIME_FULL_WITH_SECONDS, DATETIME_HUGE_WITH_SECONDS |
| ISO | ISO, ISO_DATE |
Utilisateur et appareil
| Tag | Value | Available in |
|---|---|---|
userId |
L’ID utilisateur de l’opérateur | Everywhere |
userFullName |
Le nom complet de l’opérateur | Everywhere |
userEmail |
L’adresse e‑mail de l’opérateur | Everywhere |
deviceId |
L’ID de l’appareil | Everywhere |
deviceName |
Le nom de l’appareil | Everywhere |
Instruction de travail et export
| Tag | Value | Available in |
|---|---|---|
instructionUuid |
L’ID de l’étape d’instruction | Everywhere |
instructionDescription |
La description de l’étape d’instruction | Everywhere |
stepNumber |
Le numéro de l’étape d’instruction | Everywhere |
workinstructionName |
Le nom de l’instruction de travail | Export |
workinstructionVersion |
Le numéro de version approuvé | Work instruction PDF export |
issueNumber |
Le numéro de l’incident lié | Work instruction PDF export |
auditNumber |
Le numéro d’audit | Recording/audit export |
treePath |
Le chemin du dossier contenant l’instruction de travail, séparé par / |
Export |
treePath accepte une tranche optionnelle, par exemple {=treePath(-2)} pour ne récupérer que le dernier dossier, de la même manière que Array.slice.
issueNumber et auditNumber sont également envoyés automatiquement comme champs d’événement dans le payload d’un webhook déclenché par un trigger, séparés de leur insertion via ${=...}. Voir What Azumuta Sends.
Related articles
Parameters
- Introduction to parameters
- Use parameters in a Work Instruction step
- Performing calculations with parameters
Docx reports
- Basic Tags on a Docx Report
- Parameter Tags
- Conditional Parameter Tags
- Answer Tags (Basic)
- Answer Tags (Advanced)
- Variant Tags
- Displaying Images on a Docx Report
- Ticket Tag
- Recap Tags