Referencia de parámetros y etiquetas

Actualizado

Azumuta le permite insertar datos en vivo en instrucciones de trabajo, informes docx y webhooks. Esto puede ser un parámetro que usted definió o un valor que Azumuta ya rastrea. La sintaxis difiere según la ubicación; este artículo la enumera para cada caso. Cubre sus propios parámetros y las etiquetas integradas principales de Azumuta. Las etiquetas de docx específicas de módulos, como ticket, answer, variant, image y recap, se tratan en sus propios artículos, enlazados en Artículos relacionados más abajo.

Dos tipos de valores

  • Su propio parámetro: datos que usted define y vincula a un artículo o a una orden de producto, como Color o Material del cuerpo. Consulte Introducción a los parámetros para más información.
  • Valores integrados: datos que Azumuta ya dispone, como una Product Order, el nombre del operario o una fecha de vencimiento. Consulte Referencia de valores integrados para la lista completa.

Dónde puede usarlos, y la sintaxis exacta

El formato de referencia depende de dónde lo esté utilizando.

Where Syntax (your own parameter / built-in value)
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

Instrucciones de trabajo: páginas visuales, cálculos y comprobaciones

Utilice ${...} siempre que inserte un valor en vivo en una instrucción de trabajo: un cuadro de texto en una página visual, la descripción de un paso o un cálculo.

  • Su propio parámetro: ${Parameter_key}
  • Un valor integrado: ${=identifier}
  • Un cálculo: ${=Parameter_key + 3}

Consulte Usar parámetros en un paso de una Work Instruction, Usar parámetros en una imagen en una Work Instruction y Realizar cálculos con parámetros para los recorridos completos, incluidos los operadores matemáticos disponibles.

Excepción: campos de fórmula dedicados. La condición Formula evaluates to true (advanced) de una regla es en sí misma un campo de fórmula, no texto libre con un valor incrustado, por lo que debe escribir la expresión directamente sin ningún envoltorio ${...}: dateTime("12/05/2026 14:30", "dd/MM/yyyy HH:mm"), por ejemplo. dateTime() lee una fecha desde texto, por lo que su patrón usa tokens de fecha simples sin el prefijo FORMAT:. Consulte Rules: Advanced.

Plantillas de informe Docx / PDF

Utilice llaves normales, sin el signo de dólar, y un = inicial para un valor integrado:

  • Su propio parámetro: {p_Parameter_key} (el prefijo p_ marca un parámetro)
  • Un valor integrado: {=identifier}, {=dueDate}, etc.
  • Mostrar un parámetro solo si tiene un valor: {#p_Parameter_key}{p_Parameter_key}{/p_Parameter_key}, con {^p_Parameter_key}texto alternativo{/p_Parameter_key} para cuando esté vacío

Esto se aplica por igual a los informes docx de Product Order, Work Instruction, recording/audit e issue. Consulte Basic Tags on a Docx Report, Parameter Tags y Conditional Parameter Tags.

Excepción: bucles de etiquetas answer y recap. Dentro de un bucle {#answers}...{/answers} o una sección de recap, varios valores integrados omiten el = inicial y aparecen como una etiqueta simple, por ejemplo {workinstructionName}. Consulte Answer Tags (Basic) para la lista de etiquetas de ese bucle.

Webhooks y nombres de archivos/carpetas de exportación

Utilice ${...}, igual que en las instrucciones de trabajo, ya que ambos pasan por el mismo motor:

  • Su propio parámetro: ${Parameter_key}
  • Un valor integrado: ${=identifier}

Esto se aplica a la carga útil y la URL del webhook de un trigger, al webhook de una integración periférica y al nombre de archivo o ruta de carpeta de destino de un informe exportado. Consulte Calling a Webhook from a Trigger.

Referencia de valores integrados

Estos son suministrados automáticamente por Azumuta. Escríbalos como {=tag} en informes docx y ${=tag} en instrucciones de trabajo y webhooks.

La disponibilidad depende del contexto. En todos los contextos significa instrucciones de trabajo, informes docx y webhooks. Los otros valores solo se resuelven al generar una exportación específica (un PDF de instrucción de trabajo o un informe de recording/audit), no en un webhook ni en un paso de instrucción de trabajo en vivo.

Product order

Tag Value Available in
identifier The product order number En todos los contextos
amount The product order’s target amount En todos los contextos
amountComplete The amount completed so far En todos los contextos
dueDate The product order’s deadline En todos los contextos
executionDate The planned start date En todos los contextos
finishDate The date the product order was finished En todos los contextos

Fechas

Tag Value Available in
today The current date En todos los contextos

Formatos de fecha

today, dueDate, executionDate y finishDate aceptan un formato opcional entre paréntesis. En un informe docx, puede iniciar un patrón personalizado con FORMAT:, por ejemplo {=dueDate(FORMAT:dd/MM/yyyy)}, o usar un nombre predefinido, por ejemplo {=dueDate(DATE_SHORT)}. Sin formato, la fecha usa el predeterminado para el idioma del informe.

Tokens de patrones personalizados

Los tokens distinguen mayúsculas y minúsculas. Los ejemplos usan el 6 de agosto de 2014 a las 14:05:09.

Token Value Example
d, dd Day of the month 6, 06
L, LL Month number 8, 08
LLL, LLLL Month name Aug, August
yy, yyyy Year 14, 2014
ccc, cccc Weekday Wed, Wednesday
HH, mm, ss Hours (24-hour), minutes, seconds 14, 05, 09

Nombres predefinidos

Los preajustes siguen el idioma y la zona horaria del informe. Use el nombre exactamente como está escrito.

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

Usuario y dispositivo

Tag Value Available in
userId The operator’s user ID En todos los contextos
userFullName The operator’s full name En todos los contextos
userEmail The operator’s email address En todos los contextos
deviceId The device’s ID En todos los contextos
deviceName The device’s name En todos los contextos

Instrucción de trabajo y exportación

Tag Value Available in
instructionUuid The instruction step’s ID En todos los contextos
instructionDescription The instruction step’s description En todos los contextos
stepNumber The instruction step’s number En todos los contextos
workinstructionName The work instruction’s name Exportación
workinstructionVersion The approved version number Exportación a PDF de la instrucción de trabajo
issueNumber The linked issue’s number Exportación a PDF de la instrucción de trabajo
auditNumber The audit number Exportación de recording/audit
treePath The folder path containing the work instruction, joined by / Exportación

treePath acepta un slice opcional, por ejemplo {=treePath(-2)} para solo la última carpeta, de la misma manera que lo haría Array.slice.

issueNumber y auditNumber también se envían automáticamente como campos del evento en la carga útil del webhook de un trigger, aparte de insertarlos usted mismo con ${=...}. Consulte What Azumuta Sends.

Artículos relacionados

Parámetros

Informes Docx

Webhooks y reglas

En esta página