Referencia de parámetros y etiquetas

Actualizado

Azumuta le permite insertar datos en vivo, ya sea un parámetro que usted defina o un valor que Azumuta ya rastrea, dentro de instrucciones de trabajo, informes docx y webhooks. La sintaxis para escribir esa referencia es diferente en cada lugar. Este artículo cubre sus propios parámetros y las etiquetas integradas principales de Azumuta. Las etiquetas específicas de módulo para docx, 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 enlaza a un artículo o a una orden de producción, como Color o Material del cuerpo. Véase Introducción a los parámetros
  • Valores integrados: datos que Azumuta ya tiene, como el número de una orden de producción, el nombre de un operario o una fecha de vencimiento. Usted no los crea; solo los referencia. La lista completa está a continuación.

Dónde puede usarlos y la sintaxis exacta

El formato de referencia depende de dónde lo escriba.

Pasos de una instrucción de trabajo: páginas visuales, cálculos y comprobaciones

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

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

Véanse Usar parámetros en un paso de instrucción de trabajo, Usar parámetros en una imagen de una instrucción de trabajo 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 de una regla Formula evaluates to true (advanced) es en sí un campo de fórmula, no texto libre con un valor incrustado, por lo que escribe la expresión directamente sin ningún envoltorio ${...}: dateTime("12/05/2026 14:30", "dd/MM/yyyy HH:mm"), por ejemplo. Véase Reglas: Avanzadas.

Plantillas de informe Docx / PDF

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

  • Su propio parámetro: {p_Parameter_key}
  • Un valor integrado: {=identifier}, {=dueDate}, y así sucesivamente
  • 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 orden de producción, instrucción de trabajo, registro/auditoría y de incidencias. Véanse Etiquetas básicas en un informe docx, Etiquetas de parámetro y Etiquetas condicionales de parámetro.

Excepción: bucles de etiquetas answer y recap. Dentro de un bucle {#answers}...{/answers} o una sección de resumen, varios valores integrados eliminan el = inicial y aparecen como una etiqueta simple, por ejemplo {workinstructionName}. Véase Etiquetas de respuesta (básicas) para la lista de etiquetas de ese bucle.

Webhooks y nombres de archivo/carpeta de exportación

Use ${...}, con el signo de dólar, la misma convención 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 al payload y a la URL del webhook de un trigger, al webhook de una integración periférica y al nombre de archivo o la ruta de carpeta destino de un informe exportado. Véase Llamar a un webhook desde un trigger.

Where Syntax
Pasos de instrucción de trabajo (páginas visuales, cálculos, comprobaciones) ${Parameter_key} / ${=expression}
Plantillas Docx / PDF {p_Parameter_key} / {=identifier}
Webhooks y nombres de archivo/carpeta de exportación ${Parameter_key} / ${=expression}
Campo de fórmula avanzada de una regla la propia expresión, sin envoltorio

Referencia de valores integrados

Estos los suministra Azumuta automáticamente. La disponibilidad depende del contexto: los valores de la columna Exportación solo se resuelven al generar esa exportación específica (un PDF de instrucción de trabajo o un informe de registro/auditoría), no en un webhook ni en un paso de instrucción de trabajo en vivo.

Orden de producción

Tag Value Disponible en
identifier El número de la orden de producción En todas partes
amount La cantidad objetivo de la orden de producción En todas partes
amountComplete La cantidad completada hasta ahora En todas partes
dueDate La fecha límite de la orden de producción En todas partes
executionDate La fecha prevista de inicio En todas partes
finishDate La fecha en que se finalizó la orden de producción En todas partes

Fechas

Tag Value Disponible en
today La fecha actual En todas partes

today, dueDate, executionDate y finishDate aceptan un formato de fecha opcional, por ejemplo {=dueDate(dd/MM/yyyy)} en un informe docx.

Usuario y dispositivo

Tag Value Disponible en
userId El ID de usuario del operario En todas partes
userFullName El nombre completo del operario En todas partes
userEmail El correo electrónico del operario En todas partes
deviceId El ID del dispositivo En todas partes
deviceName El nombre del dispositivo En todas partes

Instrucción de trabajo y exportación

Tag Value Disponible en
instructionUuid El ID del paso de la instrucción En todas partes
instructionDescription La descripción del paso de la instrucción En todas partes
stepNumber El número del paso En todas partes
workinstructionName El nombre de la instrucción de trabajo Exportación
workinstructionVersion El número de versión aprobado Exportación PDF de instrucción de trabajo
issueNumber El número de la incidencia vinculada Exportación PDF de instrucción de trabajo
auditNumber El número de auditoría Exportación de registro/auditoría
treePath La ruta de la carpeta que contiene la instrucción de trabajo, unida por / 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 de evento en el payload del webhook de un trigger, aparte de insertarlos usted mismo con ${=...}. Véase Qué envía Azumuta.

Artículos relacionados

En esta página