Parameters en tags - referentie

Bijgewerkt

Azumuta stelt u in staat live data in te voegen, dat kan een parameter zijn die u zelf hebt gedefinieerd of een waarde die Azumuta al bijhoudt, in werkinstructies, docx-rapporten en webhooks. De syntaxis om naar die referentie te verwijzen verschilt per plaats. Dit artikel behandelt uw eigen parameters en Azumuta's kern ingebouwde tags. Modulespecifieke docx-tags, zoals ticket-, answer-, variant-, image- en recap-tags, worden in aparte artikelen behandeld, gelinkt onder Gerelateerde artikelen hieronder.

Twee soorten waarden

  • Uw eigen parameter: gegevens die u definieert en koppelt aan een artikel of productopdracht, zoals Color of Body Material. Zie Inleiding tot parameters
  • Ingebouwde waarden: gegevens die Azumuta al heeft, zoals het nummer van een productopdracht, de naam van een operator of een deadline. U maakt deze niet aan; u verwijst er alleen naar. De volledige lijst staat hieronder.

Waar u ze kunt gebruiken en de exacte syntaxis

Het referentieformaat hangt af van waar u het schrijft.

Werkinstructiestappen: visuele pagina's, berekeningen en controles

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

  • Uw 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 stappenplannen, inclusief de beschikbare rekenoperators.

Uitzondering: toegewijde formulierenvelden. Een regelvoorwaarde Formula evaluates to true (advanced) is zelf een formuleveld, geen vrije tekst met een ingesloten waarde, dus u typt de expressie direct zonder ${...}-omslag: dateTime(\"12/05/2026 14:30\", \"dd/MM/yyyy HH:mm\"), bijvoorbeeld. Zie Rules: Advanced.

Docx / PDF-rapporttemplates

Gebruik gewone accolades, zonder het dollarteken, en een voorafgaand = voor een ingebouwde waarde:

  • Uw eigen parameter: {p_Parameter_key}
  • Een ingebouwde 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 deze leeg is

Dit geldt voor productopdracht-, werkinstructie-, recording/audit- en issue-docx-rapporten. Zie Basic Tags on a Docx Report, Parameter Tags en Conditional Parameter Tags.

Uitzondering: answer- en recap-tag-lussen. Binnen een {#answers}...{/answers}-lus of een recapsectie laten verschillende ingebouwde waarden het voorafgaande = weg en verschijnen als een blote tag, bijvoorbeeld {workinstructionName}. Zie Answer Tags (Basic) voor de eigen taglijst van die lus.

Webhooks en bestands-/mapnamen voor export

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

  • Uw eigen parameter: ${Parameter_key}
  • Een ingebouwde waarde: ${=identifier}

Dit geldt voor de payload en URL van een trigger-webhook, de webhook van een randapparaat-integratie en de bestandsnaam of bestemmingsmappad van een geëxporteerd rapport. Zie Calling a Webhook from a Trigger.

Where Syntax
Work instruction steps (visual pages, calculations, checks) ${Parameter_key} / ${=expression}
Docx / PDF report templates {p_Parameter_key} / {=identifier}
Webhooks and export file/folder naming ${Parameter_key} / ${=expression}
A rule's advanced formula field the expression itself, no wrapper

Referentie ingebouwde waarden

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

Productopdracht

Tag Value Available in
identifier The product order number Everywhere
amount The product order's target amount Everywhere
amountComplete The amount completed so far Everywhere
dueDate The product order's deadline Everywhere
executionDate The planned start date Everywhere
finishDate The date the product order was finished Everywhere

Datums

Tag Value Available in
today The current date Everywhere

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

Gebruiker en apparaat

Tag Value Available in
userId The operator's user ID Everywhere
userFullName The operator's full name Everywhere
userEmail The operator's email address Everywhere
deviceId The device's ID Everywhere
deviceName The device's name Everywhere

Werkinstructie en export

Tag Value Available in
instructionUuid The instruction step's ID Everywhere
instructionDescription The instruction step's description Everywhere
stepNumber The instruction step's number Everywhere
workinstructionName The work instruction's name Export
workinstructionVersion The approved version number Work instruction PDF export
issueNumber The linked issue's number Work instruction PDF export
auditNumber The audit number Recording/audit export
treePath The folder path containing the work instruction, joined by / Export

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

issueNumber en auditNumber worden ook automatisch verzonden als eventvelden in de payload van een trigger-webhook, los van het zelf invoegen met ${=...}. Zie What Azumuta Sends.

Gerelateerde artikelen

Op deze pagina