Overslaan en naar hoofdcontent gaan

Parameters en tags referentie

Azumuta laat je live data invoegen, ofwel een parameter die je zelf hebt gedefinieerd, ofwel een waarde die Azumuta al bijhoudt, in werkinstructies, docx rapporten en webhooks. De syntaxis voor het schrijven van die referentie verschilt op elke plaats. Dit artikel behandelt je eigen parameters en de kerngebouwde tags van Azumuta. Module-specifieke docx tags, zoals ticket, answer, variant, image en recap tags, worden behandeld in hun eigen artikels, gekoppeld vanuit Gerelateerde artikels hieronder.

Twee soorten waarden

  • Je eigen parameter: gegevens die je definieert en koppelt aan een artikel of productorder, zoals Kleur of Body Material. Zie Introductie tot parameters
  • Gebouwde waarden: gegevens die Azumuta al heeft, zoals het nummer van een productorder, de naam van een operator of een deadline. Je maakt deze niet; je verwijst er alleen naar. De volledige lijst staat hieronder.

Waar je ze kunt gebruiken en de exacte syntaxis

De referentieindeling hangt af van waar je het schrijft.

Werkinstructiestappen: visuele pagina's, berekeningen en controles

Gebruik ${...}, met het dollarteken, overal waar je een live waarde in een werkinstructie toevoegt: een tekstvak op een visuele pagina, de beschrijving van een stap of een berekening.

  • Je eigen parameter: ${Parameter_key}
  • Een berekening: ${=Parameter_key + 3}

Zie Parameters gebruiken in een werkinstructiestap, Parameters gebruiken op een afbeelding in een werkinstructie en Berekeningen uitvoeren met parameters voor de volledige walkthroughs, inclusief de beschikbare wiskundige operatoren.

Uitzondering: toegewezen formulevelden. De voorwaarde Formule evalueert naar true van een regel is zelf een formuleveld, geen vrije tekst met een waarde erin, dus je typt de expressie rechtstreeks zonder helemaal geen ${...} wrapper: dateTime("12/05/2026 14:30", "dd/MM/yyyy HH:mm"), bijvoorbeeld. Zie Regels: Geavanceerd.

Docx / PDF rapportsjablonen

Gebruik gewone accolades, zonder het dollarteken, en een voorloopse = voor een gebouwde waarde:

  • Je eigen parameter: {p_Parameter_key}
  • Een gebouwde waarde: {=identifier}, {=dueDate}, enzovoort
  • Toon een parameter alleen als deze een waarde heeft: {#p_Parameter_key}{p_Parameter_key}{/p_Parameter_key}, met {^p_Parameter_key}fallback text{/p_Parameter_key} voor wanneer het leeg is

Dit geldt voor productorder, werkinstructie, recording/audit en issue docx rapporten. Zie Basic Tags op een Docx Report, Parameter Tags en Voorwaardelijke Parameter Tags.

Uitzondering: answer en recap tag loops. Binnen een {#answers}...{/answers} loop of een recap sectie, laten verschillende gebouwde waarden de voorloopse = vallen en verschijnen als een blote tag, bijvoorbeeld {workinstructionName}. Zie Answer Tags (Basic) voor de eigen tag lijst van die loop.

Webhooks en export bestandsnaam/mapnaam

Gebruik ${...}, met het dollarteken, dezelfde conventie als werkinstructies omdat beide dezelfde engine gebruiken:

  • Je eigen parameter: ${Parameter_key}
  • Een gebouwde waarde: ${=identifier}

Dit geldt voor de webhook payload en URL van een trigger, de webhook van een randapparaat integratie en de bestandsnaam of doelmap pad van een geëxporteerd rapport. Zie Een Webhook aanroepen vanuit een Trigger.

Waar Syntaxis
Werkinstructiestappen (visuele pagina's, berekeningen, controles) ${Parameter_key} / ${=expression}
Docx / PDF rapportsjablonen {p_Parameter_key} / {=identifier}
Webhooks en export bestandsnaam/mapnaam ${Parameter_key} / ${=expression}
Het geavanceerde formuleveld van een regel de expressie zelf, geen wrapper

Referentie voor gebouwde waarden

Deze worden automatisch door Azumuta geleverd. Beschikbaarheid hangt af van context: waarden uit de Exporteer kolom worden alleen opgelost bij het genereren van die specifieke export (een werkinstructie PDF of een recording/audit rapport), niet in een webhook of een live werkinstructiestap.

Productorder

Tag Waarde Beschikbaar in
identifier Het productordernummer Overal
amount De doelhoeveelheid van de productorder Overal
amountComplete De tot nu toe voltooide hoeveelheid Overal
dueDate De deadline van de productorder Overal
executionDate De geplande startdatum Overal
finishDate De datum waarop de productorder werd afgewerkt Overal

Datums

Tag Waarde Beschikbaar in
today De huidige datum Overal

today, dueDate, executionDate en finishDate accepteren een optioneel datumformaat, bijvoorbeeld {=dueDate(dd/MM/yyyy)} in een docx rapport.

Gebruiker en device

Tag Waarde Beschikbaar in
userId De gebruikers-ID van de operator Overal
userFullName De volledige naam van de operator Overal
userEmail Het e-mailadres van de operator Overal
deviceId De ID van het device Overal
deviceName De naam van het device Overal

Werkinstructie en export

Tag Waarde Beschikbaar in
instructionUuid De ID van de instructiestap Overal
instructionDescription De beschrijving van de instructiestap Overal
stepNumber Het nummer van de instructiestap Overal
workinstructionName De naam van de werkinstructie Exporteer
workinstructionVersion Het goedgekeurde versienummer Werkinstructie PDF export
issueNumber Het nummer van de gekoppelde issue Werkinstructie PDF export
auditNumber Het auditnummer Recording/audit export
treePath Het mappad met de werkinstructie, samengevoegd met / Exporteer

treePath accepteert een optionele slice, bijvoorbeeld {=treePath(-2)} voor alleen de laatste map, op dezelfde manier als Array.slice zou doen.

issueNumber en auditNumber worden ook automatisch als event velden in de webhook payload van een trigger verzonden, gescheiden van het zelf invoegen met ${=...}. Zie Wat Azumuta Verzendt.

Gerelateerde artikels