Parameter- und Tags-Referenz

Aktualisiert 2026-10-09

Azumuta ermöglicht es Ihnen, Live-Daten in Arbeitsanweisungen, Docx-Berichte und Webhooks einzufügen. Dies kann ein parameter sein, den Sie definiert haben, oder ein Wert, den Azumuta bereits verfolgt. Die Syntax unterscheidet sich je nach Einsatzort; dieser Artikel listet sie für jede Stelle auf. Er behandelt Ihre eigenen Parameter und Azumutas eingebaute Kern‑Tags. Modulspezifische docx‑Tags, wie ticket-, answer-, variant-, image- und recap‑Tags, werden in eigenen Artikeln behandelt, die unten unter Related articles verlinkt sind.

Zwei Arten von Werten

Ihr eigener Parameter: Daten, die Sie definieren und mit einem Artikel oder Produktauftrag verknüpfen, wie Color oder Body Material. Siehe Introduction to parameters für mehr Informationen.
Built-in values: Daten, die Azumuta bereits hat, wie ein Product Order, der Name des Bedieners oder ein Fälligkeitsdatum. Siehe Built-in values reference für die vollständige Liste.

Wo Sie sie verwenden können und die genaue Syntax

Das Referenzformat hängt davon ab, wo Sie es verwenden.

Wo	Syntax (Ihr eigener Parameter / eingebauter Wert)
Work instructions (visual pages, calculations, checks)	`${Parameter_key}` / `${=identifier}`
Docx / PDF report templates	`{p_Parameter_key}` / `{=identifier}`
Webhooks and export file/folder naming	`${Parameter_key}` / `${=identifier}`
A rule’s advanced formula field	the expression itself, no wrapper

Arbeitsanweisungen: visuelle Seiten, Berechnungen und Prüfungen

Verwenden Sie ${...}, überall dort, wo Sie einen Live‑Wert in eine Arbeitsanweisung einfügen: ein Textfeld auf einer visuellen Seite, die Beschreibung eines Schritts oder eine Berechnung.

Ihr eigener Parameter: ${Parameter_key}
Ein eingebauter Wert: ${=identifier}
Eine Berechnung: ${=Parameter_key + 3}

Siehe Use parameters in a Work Instruction step, Use parameters on an image in a Work Instruction, und Performing calculations with Parameters für die vollständigen Anleitungen, einschließlich der verfügbaren mathematischen Operatoren.

Ausnahme: dedizierte Formel‑Felder. Die Bedingung Formula evaluates to true (advanced) einer Regel ist selbst ein Formelfeld, kein Freitext mit eingebettetem Wert, daher geben Sie den Ausdruck direkt ohne ${...}‑Wrapper ein: dateTime(\"12/05/2026 14:30\", \"dd/MM/yyyy HH:mm\"), zum Beispiel. dateTime() liest ein Datum aus Text, daher verwendet sein Muster einfache Datentoken ohne das FORMAT:‑Präfix. Siehe Rules: Advanced.

Docx / PDF report templates

Verwenden Sie einfache geschweifte Klammern, ohne Dollarzeichen, und ein führendes = für einen eingebauten Wert:

Ihr eigener Parameter: {p_Parameter_key} (das Präfix p_ kennzeichnet einen Parameter)
Ein eingebauter Wert: {=identifier}, {=dueDate} und so weiter
Einen Parameter nur anzeigen, wenn er einen Wert hat: {#p_Parameter_key}{p_Parameter_key}{/p_Parameter_key}, mit {^p_Parameter_key}fallback text{/p_Parameter_key} für den Fall, dass er leer ist

Dies gilt gleichermaßen für Product Order-, Work Instruction-, recording/audit- und issue‑docx‑Berichte. Siehe Basic Tags on a Docx Report, Parameter Tags und Conditional Parameter Tags.

Ausnahme: answer und recap Tag‑Schleifen. Innerhalb einer {#answers}...{/answers}‑Schleife oder eines Recap‑Abschnitts fallen bei mehreren eingebauten Werten das führende = weg und sie erscheinen als einfacher Tag, z. B. {workinstructionName}. Siehe Answer Tags (Basic) für die eigene Tag‑Liste dieser Schleife.

Webhooks und Benennung von Export‑Dateien/‑Ordnern

Verwenden Sie ${...}, wie in Arbeitsanweisungen, da beides durch dieselbe Engine läuft:

Ihr eigener Parameter: ${Parameter_key}
Ein eingebauter Wert: ${=identifier}

Dies gilt für den Webhook‑Payload und die URL eines Triggers, den Webhook einer Peripherie‑Integration sowie den Dateinamen oder Zielordnerpfad eines exportierten Berichts. Siehe Calling a Webhook from a Trigger.

Built-in values reference

Diese Werte werden von Azumuta automatisch bereitgestellt. Schreiben Sie sie als {=tag} in Docx‑Berichten und ${=tag} in Arbeitsanweisungen und Webhooks.

Die Verfügbarkeit hängt vom Kontext ab. Überall bedeutet Arbeitsanweisungen, Docx‑Berichte und Webhooks. Die anderen Werte lösen sich nur während der Erstellung eines bestimmten Exports (eines Work Instruction‑PDFs oder eines recording/audit‑Berichts) auf, nicht in einem Webhook oder einem Live‑Arbeitsanweisungs‑Schritt.

Product order

Tag	Wert	Verfügbar in
`identifier`	Die Nummer des Produktauftrags	Überall
`amount`	Die Zielmenge des Produktauftrags	Überall
`amountComplete`	Die bisher abgeschlossene Menge	Überall
`dueDate`	Das Fälligkeitsdatum des Produktauftrags	Überall
`executionDate`	Das geplante Startdatum	Überall
`finishDate`	Das Datum, an dem der Produktauftrag abgeschlossen wurde	Überall

Dates

Tag	Wert	Verfügbar in
`today`	Das aktuelle Datum	Überall

Date formats

today, dueDate, executionDate und finishDate akzeptieren ein optionales Format in Klammern. In einem Docx‑Bericht beginnen Sie entweder ein benutzerdefiniertes Muster mit FORMAT:, zum Beispiel {=dueDate(FORMAT:dd/MM/yyyy)}, oder verwenden einen vordefinierten Namen, zum Beispiel {=dueDate(DATE_SHORT)}. Ohne Format verwendet das Datum das Standardformat für die Berichtssprache.

Benutzerdefinierte Mustertoken

Token sind case‑sensitive. Die Beispiele verwenden den 6. August 2014 um 14:05:09.

Token	Wert	Beispiel
`d`, `dd`	Tag des Monats	6, 06
`L`, `LL`	Monatsnummer	8, 08
`LLL`, `LLLL`	Monatsname	Aug, August
`yy`, `yyyy`	Jahr	14, 2014
`ccc`, `cccc`	Wochentag	Wed, Wednesday
`HH`, `mm`, `ss`	Stunden (24‑Stunden), Minuten, Sekunden	14, 05, 09

Vordefinierte Namen

Voreinstellungen folgen der Berichtssprache und Zeitzone. Verwenden Sie den Namen genau wie angegeben.

Typ	Voreinstellungen
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	Wert	Verfügbar in
`userId`	Die Benutzer‑ID des Bedieners	Überall
`userFullName`	Der vollständige Name des Bedieners	Überall
`userEmail`	Die E‑Mail‑Adresse des Bedieners	Überall
`deviceId`	Die Geräte‑ID	Überall
`deviceName`	Der Name des Geräts	Überall

Work instruction und Export

Tag	Wert	Verfügbar in
`instructionUuid`	Die ID des Anweisungsschritts	Überall
`instructionDescription`	Die Beschreibung des Anweisungsschritts	Überall
`stepNumber`	Die Schrittnummer	Überall
`workinstructionName`	Der Name der Work Instruction	Export
`workinstructionVersion`	Die freigegebene Versionsnummer	Work instruction PDF export
`issueNumber`	Die Nummer des verknüpften Issue	Work instruction PDF export
`auditNumber`	Die Audit‑Nummer	Recording/audit export
`treePath`	Der Ordnerpfad, der die Work Instruction enthält, durch `/` verbunden	Export

treePath akzeptiert einen optionalen Slice, zum Beispiel {=treePath(-2)} für nur den letzten Ordner, auf dieselbe Weise wie Array.slice.

issueNumber und auditNumber werden außerdem automatisch als Ereignisfelder im Webhook‑Payload eines Triggers gesendet, unabhängig davon, ob Sie sie selbst mit ${=...} einsetzen. Siehe What Azumuta Sends.