Parameter- und Tags-Referenz

Aktualisiert

Azumuta ermöglicht es Ihnen, Live-Daten einzufügen — entweder einen Parameter, den Sie selbst definiert haben, oder einen Wert, den Azumuta bereits nachverfolgt — in Arbeitsanweisungen, Docx-Berichte und Webhooks. Die Syntax für diese Verweise unterscheidet sich je nach Einsatzort. Dieser Artikel behandelt Ihre eigenen Parameter und Azumutas zentrale, integrierte Tags. Modulspezifische Docx-Tags, wie ticket-, answer-, variant-, image- und recap-Tags, werden in eigenen Artikeln behandelt, die unten unter Verwandte Artikel verlinkt sind.

Zwei Arten von Werten

  • Ihr eigener Parameter: Daten, die Sie definieren und an einen Artikel oder einen Produktauftrag verknüpfen, z. B. Color oder Body Material. Siehe Introduction to parameters
  • Vordefinierte Werte: Daten, die Azumuta bereits hat, wie die Nummer eines Produktauftrags, der Name eines Werkers oder ein Fälligkeitsdatum. Diese legen Sie nicht an; Sie verweisen nur darauf. Die vollständige Liste steht weiter unten.

Wo Sie sie verwenden können und die genaue Syntax

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

Arbeitsschrittabfolgen in Arbeitsanweisungen: visuelle Seiten, Berechnungen und Prüfungen

Verwenden Sie ${...}, mit Dollarzeichen, ü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}
  • 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 Freitextfeld 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. Siehe Rules: Advanced.

Docx-/PDF-Berichtsvorlagen

Verwenden Sie einfache geschweifte Klammern, ohne Dollarzeichen, und ein führendes = für vordefinierte Werte:

  • Ihr eigener Parameter: {p_Parameter_key}
  • Ein vordefinierter Wert: {=identifier}, {=dueDate} usw.
  • Zeigen Sie einen Parameter nur an, 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 Produktauftrags-, Arbeitsanweisungs-, Aufzeichnungs-/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 mehrere vordefinierte Werte das führende = weg und erscheinen stattdessen als nacktes Tag, zum Beispiel {workinstructionName}. Siehe Answer Tags (Basic) für die eigene Tag-Liste dieser Schleife.

Webhooks und Benennung exportierter Dateien/Ordner

Verwenden Sie ${...}, mit Dollarzeichen, dieselbe Konvention wie bei Arbeitsanweisungen, da beides durch die gleiche Engine läuft:

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

Dies gilt für den Webhook-Payload und die URL eines Triggers, für den Webhook einer Peripherie-Integration sowie für den Dateinamen oder den Zielordnerpfad eines exportierten Berichts. Siehe 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

Referenz vordefinierter Werte

Diese werden von Azumuta automatisch bereitgestellt. Die Verfügbarkeit hängt vom Kontext ab: Werte aus der Export-Spalte lösen sich nur beim Erzeugen dieses spezifischen Exports (z. B. einem Arbeitsanweisungs-PDF oder einem Aufzeichnungs-/Audit-Bericht) auf, nicht in einem Webhook oder einem Live-Arbeitsschritt.

Produktauftrag

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

Daten

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

today, dueDate, executionDate und finishDate akzeptieren ein optionales Datumsformat, zum Beispiel {=dueDate(dd/MM/yyyy)} in einem Docx-Bericht.

Benutzer und Gerät

Tag Wert Verfügbar in
userId Die Benutzer-ID des Werkers Überall
userFullName Der vollständige Name des Werkers Überall
userEmail Die E-Mail-Adresse des Werkers Überall
deviceId Die Geräte-ID Überall
deviceName Der Gerätename Überall

Arbeitsanweisung und Export

Tag Wert Verfügbar in
instructionUuid Die ID des Arbeitsschritts Überall
instructionDescription Die Beschreibung des Arbeitsschritts Überall
stepNumber Die Nummer des Arbeitsschritts Überall
workinstructionName Der Name der Arbeitsanweisung Export
workinstructionVersion Die freigegebene Versionsnummer Arbeitsanweisungs-PDF-Export
issueNumber Die verknüpfte Issue-Nummer Arbeitsanweisungs-PDF-Export
auditNumber Die Audit-Nummer Aufzeichnungs-/Audit-Export
treePath Der Ordnerpfad, der die Arbeitsanweisung enthält, verbunden durch / Export

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

issueNumber und auditNumber werden außerdem automatisch als Event-Felder im Webhook-Payload eines Triggers gesendet, zusätzlich zur Möglichkeit, sie selbst mit ${=...} einzufügen. Siehe What Azumuta Sends.

Verwandte Artikel

Auf dieser Seite