Référence des paramètres et des balises

Mis à jour

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éfixe p_ 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.

Parameters

Docx reports

Webhooks and rules