Azumuta vous permet d'insérer des données en direct dans les instructions de travail, les rapports docx et les 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 varie selon l'emplacement, et cet article la liste pour chacun. Il couvre vos propres paramètres et les tags intégrés principaux d'Azumuta. Les tags docx spécifiques aux modules, tels que les tags de ticket, de réponse, de variante, d'image et de récapitulatif, sont couverts 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, comme la couleur ou le matériau du corps. Voir Introduction aux paramètres pour plus d'informations.
- Valeurs intégrées : données qu'Azumuta possède déjà, comme une commande de produit, le nom de l'opérateur ou une date d'échéance. Voir Référence des valeurs intégrées 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.
| Emplacement | Syntaxe (votre propre paramètre / valeur intégrée) |
|---|---|
| Instructions de travail (pages visuelles, calculs, vérifications) |
${Parameter_key} / ${=identifier}
|
| Modèles de rapport Docx / PDF |
{p_Parameter_key} / {=identifier}
|
| Webhooks et nommage de fichiers/dossiers d'exportation |
${Parameter_key} / ${=identifier}
|
| Champ de formule avancée d'une règle | l'expression elle-même, sans wrapper |
Instructions de travail : pages visuelles, calculs et vérifications
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 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 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. dateTime() lit une date à partir du texte, donc son modèle utilise des tokens de date simples sans le préfixe FORMAT:. 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}(le préfixep_marque un paramètre) - 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
Ceci s'applique aux rapports Docx de commande de produit, d'instruction de travail, d'enregistrement/audit et de problème. Voir Tags de base sur un rapport Docx, Tags de paramètre, et Tags de paramètre conditionnel.
Exception : boucles de tags 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 un tag nu à la place, par exemple {workinstructionName}. Voir Tags de réponse (Basic) pour la liste de tags propre à cette boucle.
Webhooks et nommage de fichiers/dossiers d'exportation
Utilisez ${...}, comme dans les instructions de travail, car les deux passent par le même moteur :
- Votre propre paramètre :
${Parameter_key} - Une valeur intégrée :
${=identifier}
Ceci 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 de fichier ou au chemin du dossier de destination d'un rapport exporté. Voir Appeler un webhook à partir d'un déclencheur.
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. Partout signifie instructions de travail, rapports docx et webhooks. Les autres valeurs ne se résolvent que lors de la génération d'une exportation 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
| Tag | 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
| Tag | Valeur | Disponible dans |
|---|---|---|
today |
La date actuelle | Partout |
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éréglé, par exemple {=dueDate(DATE_SHORT)}. Sans format, la date utilise la valeur par défaut pour la langue du rapport.
Tokens de modèle personnalisé
Les tokens sont sensibles à la casse. Les exemples utilisent le 6 août 2014 à 14:05:09.
| Token | Valeur | Exemple |
|---|---|---|
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 (24 heures), minutes, secondes | 14, 05, 09 |
Noms préréglés
Les préréglages suivent la langue et le fuseau horaire du rapport. Utilisez le nom exactement comme écrit.
| Type | Préréglages |
|---|---|
| Date |
DATE_SHORT, DATE_MED, DATE_MED_WITH_WEEKDAY, DATE_FULL, DATE_HUGE
|
| Heure |
TIME_SIMPLE, TIME_WITH_SECONDS, TIME_WITH_SHORT_OFFSET, TIME_WITH_LONG_OFFSET
|
| Heure 24 heures |
TIME_24_SIMPLE, TIME_24_WITH_SECONDS, TIME_24_WITH_SHORT_OFFSET, TIME_24_WITH_LONG_OFFSET
|
| Date et heure |
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 | 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 exportation
| Tag | 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 la version approuvée | Exportation PDF d'instruction de travail |
issueNumber |
Le numéro du problème lié | Exportation PDF d'instruction de travail |
auditNumber |
Le numéro d'audit | Exportation 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
Paramètres
- Introduction aux paramètres
- Utiliser les paramètres dans une étape d'instruction de travail
- Effectuer des calculs avec des paramètres
Rapports Docx
- Tags de base sur un rapport Docx
- Tags de paramètre
- Tags de paramètre conditionnel
- Tags de réponse (Basic)
- Tags de réponse (Avancé)
- Tags de variante
- Affichage des images sur un rapport Docx
- Tag de ticket
- Tags de récapitulatif