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

Mis à jour

Azumuta vous permet d'insérer des données en direct, soit un paramètre que vous avez défini vous‑même, soit une valeur qu'Azumuta suit déjà, dans des instructions de travail, des rapports docx et des webhooks. La syntaxe pour écrire cette référence diffère selon l'endroit. Cet article couvre vos paramètres personnalisés et les balises intégrées de base d'Azumuta. Les balises docx spécifiques aux modules, comme ticket, answer, variant, image et recap, sont traitées dans leurs propres articles, liés depuis Articles connexes ci‑dessous.

Deux types de valeurs

  • Votre propre paramètre : données que vous définissez et liez à un article ou à un ordre de production, comme Color ou Body Material. Voir Introduction to parameters
  • Valeurs intégrées : données qu'Azumuta possède déjà, comme le numéro d'un ordre de production, le nom d'un opérateur ou une date d'échéance. Vous ne les créez pas ; vous vous contentez de les référencer. La liste complète se trouve ci‑dessous.

Où vous pouvez les utiliser, et la syntaxe exacte

Le format de référence dépend de l'endroit où vous l'écrivez.

Étapes d'une instruction de travail : pages visuelles, calculs et contrôles

Utilisez ${...}, avec le signe dollar, chaque fois que 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}
  • 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 guides 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, et non du texte libre contenant une valeur intégrée, donc vous tapez l'expression directement sans aucun wrapper ${...} : dateTime("12/05/2026 14:30", "dd/MM/yyyy HH:mm"), par exemple. Voir Rules: Advanced.

Modèles de rapport 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}
  • Une valeur intégrée : {=identifier}, {=dueDate}, etc.
  • Afficher un paramètre uniquement s'il a une valeur : {#p_Parameter_key}{p_Parameter_key}{/p_Parameter_key}, avec {^p_Parameter_key}texte de remplacement{/p_Parameter_key} pour le cas où il est vide

Cela s'applique de la même manière aux rapports docx d'ordre de production, d'instruction de travail, d'enregistrement/audit et d'incident. Voir Basic Tags on a Docx Report, Parameter Tags, et Conditional Parameter Tags.

Exception : boucles de balises answer et recap. À l'intérieur d'une boucle {#answers}...{/answers} ou d'une section de recap, plusieurs valeurs intégrées perdent 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 ${...}, avec le signe dollar, même convention que pour les 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é, au webhook d'une intégration périphérique, et au nom de fichier ou au chemin du dossier de destination d'un rapport exporté. Voir Calling a Webhook from a Trigger.

Où Syntaxe
Étapes d'instruction de travail (pages visuelles, calculs, contrôles) ${Parameter_key} / ${=expression}
Modèles de rapport Docx / PDF {p_Parameter_key} / {=identifier}
Webhooks et nommage de fichiers/dossiers d'export ${Parameter_key} / ${=expression}
Champ de formule avancée d'une règle l'expression elle‑même, sans wrapper

Référence des valeurs intégrées

Ces valeurs sont fournies automatiquement par Azumuta. Leur disponibilité dépend du contexte : les valeurs de la colonne Export ne se résolvent que lors de la génération de cet 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

Balise Valeur Disponible dans
identifier Le numéro de l'ordre de production Partout
amount La quantité cible de l'ordre de production Partout
amountComplete La quantité réalisée à ce jour Partout
dueDate La date d'échéance de l'ordre de production Partout
executionDate La date de début prévue Partout
finishDate La date à laquelle l'ordre de production a été terminé Partout

Dates

Balise Valeur Disponible dans
today La date actuelle Partout

today, dueDate, executionDate et finishDate acceptent un format de date optionnel, par exemple {=dueDate(dd/MM/yyyy)} dans un rapport docx.

Utilisateur et appareil

Balise Valeur Disponible dans
userId L'identifiant utilisateur de l'opérateur Partout
userFullName Le nom complet de l'opérateur Partout
userEmail L'adresse e‑mail de l'opérateur Partout
deviceId L'identifiant de l'appareil Partout
deviceName Le nom de l'appareil Partout

Instruction de travail et export

Balise Valeur Disponible dans
instructionUuid L'identifiant de l'étape d'instruction Partout
instructionDescription La description de l'étape d'instruction Partout
stepNumber Le numéro de l'étape Partout
workinstructionName Le nom de l'instruction de travail Export
workinstructionVersion Le numéro de version approuvé Export PDF de l'instruction de travail
issueNumber Le numéro de l'incident lié Export PDF de l'instruction de travail
auditNumber Le numéro d'audit Export d'enregistrement/audit
treePath Le chemin du dossier contenant l'instruction de travail, séparé par / Export

treePath accepte une découpe optionnelle, par exemple {=treePath(-2)} pour n'obtenir que le dernier dossier, de la même manière que le ferait Array.slice.

issueNumber et auditNumber sont également envoyés automatiquement comme champs d'événement dans le payload du webhook d'un déclencheur, indépendamment de l'insertion manuelle via ${=...}. Voir Ce qu'Azumuta envoie.

Articles connexes

Sur cette page