Aller au contenu principal

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

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 les instructions de travail, les rapports docx et les webhooks. La syntaxe pour écrire cette référence est différente à chaque endroit. Cet article couvre vos propres paramètres et les balises intégrées principales d'Azumuta. Les balises docx spécifiques aux modules, telles que les balises de ticket, de réponse, de variante, d'image et de récapitulatif, sont couvertes dans leurs propres articles, liés à partir de Articles connexes ci-dessous.

Deux types de valeurs

  • Votre propre paramètre : données que vous définissez et liez à un article ou une commande de produit, telles que Couleur ou Matériau du corps. Voir Introduction aux paramètres
  • Valeurs intégrées : données qu'Azumuta possède déjà, comme le numéro d'une commande de produit, le nom d'un opérateur ou une date d'échéance. Vous ne les créez pas ; vous les référencez simplement. La liste complète est 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'instruction : pages visuelles, calculs et vérifications

Utilisez ${...}, avec le signe dollar, 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}
  • Un calcul : ${=Parameter_key + 3}

Voir Utiliser les paramètres dans une étape d'instruction de travail, Utiliser les paramètres sur une image dans une instruction de travail et Effectuer des calculs avec des paramètres pour les procédures pas à pas complètes, y compris les opérateurs mathématiques disponibles.

Exception : champs de formule dédiés. La condition La formule est évaluée comme vraie (avancé) d'une règle est elle-même un champ de formule, et non du texte libre avec une valeur intégrée, vous tapez donc l'expression directement sans wrapper ${...} du tout : dateTime("12/05/2026 14:30", "dd/MM/yyyy HH:mm"), par exemple. Voir Règles : Avancé.

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}, et ainsi de suite
  • 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 secours{/p_Parameter_key} pour quand il est vide

Cela s'applique aux rapports docx de commande de produit, d'instruction de travail, d'enregistrement/audit et de problème. Voir Balises de base sur un rapport Docx, Balises de paramètre et Balises de paramètre conditionnel.

Exception : boucles de balises de réponse et de récapitulatif. À l'intérieur d'une boucle {#answers}...{/answers} ou d'une section de récapitulatif, plusieurs valeurs intégrées suppriment le = initial et apparaissent comme une balise simple à la place, par exemple {workinstructionName}. Voir Balises de réponse (Basic) pour la liste des balises propre à cette boucle.

Webhooks et dénomination des fichiers/dossiers d'exportation

Utilisez ${...}, avec le signe dollar, la même convention que 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 à la charge utile et à l'URL du webhook d'un déclencheur, au webhook d'une intégration périphérique et au nom du fichier ou au chemin du dossier de destination d'un rapport exporté. Voir Appeler un webhook à partir d'un déclencheur.

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

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

Celles-ci sont fournies automatiquement par Azumuta. La disponibilité dépend du contexte : les valeurs de la colonne Exporter 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), et non dans un webhook ou une étape d'instruction de travail en direct.

Commande de produit

Balise Valeur Disponible dans
identifier Le numéro de commande du produit Partout
amount La quantité cible de la commande de produit Partout
amountComplete La quantité terminée jusqu'à présent Partout
dueDate La date d'échéance de la commande de produit Partout
executionDate La date de début prévue Partout
finishDate La date à laquelle la commande de produit a été terminée 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'ID 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'ID de l'appareil Partout
deviceName Le nom de l'appareil Partout

Instruction de travail et export

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

treePath accepte une tranche optionnelle, par exemple {=treePath(-2)} pour juste le dernier dossier, de la même manière que Array.slice le ferait.

issueNumber et auditNumber sont également envoyés automatiquement en tant que champs d'événement dans la charge utile du webhook d'un déclencheur, séparément de leur insertion vous-même avec ${=...}. Voir Ce qu'Azumuta envoie.

Articles connexes