Referentie: parameters en tags

Bijgewerkt

Azumuta laat u livegegevens invoegen in werkinstructies, docx-rapporten en webhooks. Dit kan een parameter zijn die u hebt gedefinieerd, of een waarde die Azumuta al bijhoudt. De syntaxis verschilt per locatie; dit artikel somt de notatie per geval op. Het behandelt uw eigen parameters en Azumuta’s ingebouwde tags. Modulespecifieke docx-tags, zoals ticket-, answer-, variant-, image- en recap-tags, worden in aparte artikelen behandeld, gelinkt vanuit Gerelateerde artikelen hieronder.

Twee soorten waarden

  • Uw eigen parameter: gegevens die u definieert en koppelt aan een artikel of productorder, zoals Color of Body Material. Zie Introduction to parameters voor meer informatie.
  • Ingebouwde waarden: gegevens die Azumuta al heeft, zoals een productorder, de naam van de operator of een deadline. Zie Built-in values reference voor de volledige lijst.

Waar u ze kunt gebruiken en de exacte syntaxis

Het referentieformaat hangt af van waar u het gebruikt.

Waar Syntaxis (uw eigen parameter / ingebouwde waarde)
Werkinstructies (visuele pagina's, berekeningen, controles) ${Parameter_key} / ${=identifier}
Docx / PDF-rapporttemplates {p_Parameter_key} / {=identifier}
Webhooks en bestands-/mapnaam van exports ${Parameter_key} / ${=identifier}
Het geavanceerde formuleveld van een regel de expressie zelf, zonder wrapper

Work instructions: visual pages, calculations, and checks

Gebruik ${...} overal waar u een livewaarde toevoegt aan een werkinstructie: een tekstvak op een visuele pagina, de beschrijving van een stap of een berekening.

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

Zie Use parameters in a Work Instruction step, Use parameters on an image in a Work Instruction, en Performing calculations with Parameters voor volledige walkthroughs, inclusief de beschikbare rekenoperators.

Uitzondering: toegewijde formulevelden. De voorwaarde Formula evaluates to true (advanced) van een regel is zelf een formuleveld, geen vrije tekst met een waarde erin, dus u typt de expressie direct zonder ${...}-wrapper: dateTime("12/05/2026 14:30", "dd/MM/yyyy HH:mm"), bijvoorbeeld. dateTime() leest een datum uit tekst, dus het patroon gebruikt gewone datumtokens zonder de FORMAT:-prefix. Zie Rules: Advanced.

Docx / PDF report templates

Gebruik gewone accolades, zonder dollarteken, en een voorloop-= voor een ingebouwde waarde:

  • Uw eigen parameter: {p_Parameter_key} (de p_-prefix geeft een parameter aan)
  • Een ingebouwde waarde: {=identifier}, {=dueDate}, enz.
  • 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-, registratie-/audit- en issue-docx-rapporten. Zie Basic Tags on a Docx Report, Parameter Tags en Conditional Parameter Tags.

Uitzondering: answer- en recap-tagloops. Binnen een {#answers}...{/answers}-loop of een recap-sectie laten enkele ingebouwde waarden de voorloop-= vallen en verschijnen als een bare tag, bijvoorbeeld {workinstructionName}. Zie Answer Tags (Basic) voor de taglijst van die loop.

Webhooks and export file/folder naming

Gebruik ${...}, hetzelfde als in werkinstructies, aangezien beide door dezelfde engine gaan:

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

Dit geldt voor de webhookpayload en URL van een trigger, de webhook van een perifere integratie en de bestandsnaam of doelmappad van een geëxporteerd rapport. Zie Calling a Webhook from a Trigger.

Built-in values reference

Deze worden automatisch door Azumuta geleverd. Schrijf ze als {=tag} in docx-rapporten en ${=tag} in werkinstructies en webhooks.

Beschikbaarheid hangt af van de context. Everywhere betekent werkinstructies, docx-rapporten en webhooks. De andere waarden lossen alleen op tijdens het genereren van een specifieke export (bijvoorbeeld een werkinstructie-PDF of een registratie-/auditrapport), niet in een webhook of een live werkinstructiestap.

Product order

Tag Value Available in
identifier Het nummer van de productorder Everywhere
amount De doelhoeveelheid van de productorder Everywhere
amountComplete De tot nu toe voltooide hoeveelheid Everywhere
dueDate De deadline van de productorder Everywhere
executionDate De geplande startdatum Everywhere
finishDate De datum waarop de productorder is afgerond Everywhere

Dates

Tag Value Available in
today De huidige datum Everywhere

Date formats

today, dueDate, executionDate, en finishDate accepteren een optioneel format tussen haakjes. In een docx-rapport begint u een aangepast patroon met FORMAT:, bijvoorbeeld {=dueDate(FORMAT:dd/MM/yyyy)}, of u gebruikt een voorinstelling, bijvoorbeeld {=dueDate(DATE_SHORT)}. Zonder format gebruikt de datum de standaardinstelling voor de rapporttaal.

Custom pattern tokens

Tokens zijn hoofdlettergevoelig. De voorbeelden gebruiken 6 augustus 2014 om 14:05:09.

Token Value Example
d, dd Dag van de maand 6, 06
L, LL Maandnummer 8, 08
LLL, LLLL Maandnaam Aug, August
yy, yyyy Jaar 14, 2014
ccc, cccc Weekdag Wed, Wednesday
HH, mm, ss Uren (24-uurs), minuten, seconden 14, 05, 09

Preset names

Voorinstellingen volgen de rapporttaal en tijdzone. Gebruik de naam exact zoals geschreven.

Type Presets
Date DATE_SHORT, DATE_MED, DATE_MED_WITH_WEEKDAY, DATE_FULL, DATE_HUGE
Time TIME_SIMPLE, TIME_WITH_SECONDS, TIME_WITH_SHORT_OFFSET, TIME_WITH_LONG_OFFSET
24-hour time TIME_24_SIMPLE, TIME_24_WITH_SECONDS, TIME_24_WITH_SHORT_OFFSET, TIME_24_WITH_LONG_OFFSET
Date and time 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

User and device

Tag Value Available in
userId De gebruikers-ID van de operator Everywhere
userFullName De volledige naam van de operator Everywhere
userEmail Het e-mailadres van de operator Everywhere
deviceId De ID van het apparaat Everywhere
deviceName De naam van het apparaat Everywhere

Work instruction and export

Tag Value Available in
instructionUuid De ID van de instructiestap Everywhere
instructionDescription De beschrijving van de instructiestap Everywhere
stepNumber Het stapnummer van de instructie Everywhere
workinstructionName De naam van de werkinstructie Export
workinstructionVersion Het goedgekeurde versienummer Work instruction PDF export
issueNumber Het nummer van de gekoppelde issue Work instruction PDF export
auditNumber Het auditnummer Recording/audit export
treePath Het mappad dat de werkinstructie bevat, samengevoegd met / Export

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

issueNumber en auditNumber worden ook automatisch als eventvelden meegestuurd in de webhookpayload van een trigger, naast het zelf invoegen met ${=...}. Zie What Azumuta Sends.

Parameters

Docx reports

Webhooks and rules

Op deze pagina