Acciones

Los paquetes con nombre de etiquetas y reportes que una corrida emite en el Arranque o en la Finalización, sus comandos, las asignaciones de marcador de una etiqueta, y cómo los selecciona un procedimiento.

Ver como Markdown

Una acción es un paquete con nombre de documentos que una corrida emite: dentro de ella, un comando por emisión, cada uno diciendo qué sale (una etiqueta o un reporte), cuándo (en el Arranque o en la Finalización), con qué plantilla de la biblioteca de la estación y, en la Finalización, para qué veredictos. Un procedimiento selecciona acciones enteras, así que un paquete escrito una vez sirve a todo procedimiento que lo emite, y corregir un comando es una sola edición en vez de una por procedimiento. Las acciones viven en Process > Modelos > modelo > Preparación > Acciones. Crearlas, quitarlas y editar el nombre de una acción, sus comandos y sus asignaciones dependen todos del mismo permiso Editar recetas y evaluaciones, y las páginas lo dicen ("Cambiar las acciones exige el permiso “Editar recetas y evaluaciones”.").

La carpeta Acciones

Al seleccionar la fila Acciones se abre una página distinta de las demás carpetas de Preparación: una lista de las acciones del modelo junto a la que esté elegida en ella, porque una acción se lee contra sus hermanas. El orden de la lista es el orden en que todo procedimiento emite las acciones, así que los verbos de fila mueven una acción y nunca un comando. La página carga las dos bibliotecas de la estación (plantillas de etiqueta y diseños de reporte) para juzgar si está lista; cuando una no se puede cargar, un aviso dice "Las plantillas de etiqueta globales no se pudieron cargar: …" o "Los reportes globales no se pudieron cargar: …".

Columna Qué muestra
# El lugar de la acción en la lista.
Nombre Editable en el sitio, confirmado al salir de la celda. Un nombre en blanco se rechaza con "Una acción necesita un nombre operativo."
Comandos Cuántos comandos, y después qué emiten: "0 · Todavía ninguno", o "2 · Etiqueta en el Arranque, Etiqueta y reporte en la Finalización". La información emergente los lista uno por línea, como Label at Completion · <template>.
Estado Lista, o Revisión cuando a la acción o a alguno de sus comandos le falta algo.
Acciones de fila Subir la acción, Bajar la acción, Quitar la acción (tinta de peligro; pregunta "Eliminar la acción": "Esto quita la acción y sus comandos.").

La columna que hay junto a la lista se encabeza Acción y muestra el Nombre de la acción elegida (editable aquí también), sus Comandos como líneas de solo lectura con una píldora Lista / Revisión cada una ("Los comandos se editan en la página propia de esta acción, en la columna, en este orden."), y un aviso Necesita revisión que lista todo lo que falta. Sin ninguna acción, la lista dice "Sin acciones. Agregue una cuando un procedimiento de este modelo deba emitir etiquetas o reportes."; sin ninguna elegida, la columna dice "Seleccione una acción para leer qué emite. Sus comandos se editan en su propia página, en la columna."

Comando Qué hace Atenuado cuando (situación) No se dibuja cuando (rol)
Acción (barra de detalle, con la carpeta seleccionada; botón derecho Agregar acción) Agrega Acción <n> (el primer número que ninguna acción del modelo usa ya), vacía, al final de la lista, y la elige en la columna. Cualquier unidad tiene una corrida, o el runtime está detenido. Sin Editar recetas y evaluaciones.
Subir / Bajar / Quitar la acción (acciones de fila) Reordenar o eliminar. Sin Gestionar Process, bajo el bloqueo de ingeniería, o mientras el runtime está detenido (una presión reporta el motivo en el registro de acciones). Siempre se dibujan.

La página de la acción

Seleccionar una acción en el árbol la abre: el encabezado con el nombre de la acción y una píldora que cuenta sus comandos, los avisos de permiso y de biblioteca, una tarjeta Acción con el campo Nombre (confirmado al salir; en blanco se rechaza), y la lista Comandos junto al comando elegido en ella.

Comando Qué hace Atenuado cuando (situación) No se dibuja cuando (rol)
Comando (barra de detalle, con la acción seleccionada; botón derecho Agregar comando) Agrega un comando nacido como Etiqueta en la Finalización para las corridas OK y todavía sin plantilla, al final de la lista, y lo elige en la columna. Cualquier unidad tiene una corrida, o el runtime está detenido. Sin Editar recetas y evaluaciones.
Quitar la acción (grupo de peligro; botón derecho; la X de la tarjeta de la página de la carpeta) Elimina la acción y sus comandos después de "Eliminar la acción". Todo procedimiento que la seleccionaba deja de emitirla. Lo mismo. Sin Editar recetas y evaluaciones.

La lista de Comandos

Columna Qué muestra
# El lugar del comando en la acción, que es su orden de emisión dentro de ella.
Emite Etiqueta o Reporte.
Disparador Arranque o Finalización.
Plantilla Un selector sobre dos bibliotecas: una fila de etiqueta ofrece las plantillas de etiqueta ("(seleccione una plantilla)"), una fila de reporte los diseños de reporte ("(seleccione un reporte)"). Una referencia que la biblioteca ya no tiene conserva su lugar, desactivada, como "Missing template · <id>" o "Missing report · <id>", así que un comando degradado no se lee como uno sin configurar.
Veredictos "No se usa en el arranque" para un comando de Arranque; si no, los veredictos marcados ("OK, NOK") o "Ninguno seleccionado".
Marcadores "No lo usa un reporte"; para una etiqueta: "Sin plantilla", "Falta la plantilla", "Sin comandos" (la plantilla todavía no tiene comandos de impresora), "Ilegible", "Fija, sin marcadores", o "<bound> de <total> asignados".
Estado Lista o Revisión.
Acciones de fila Subir el comando, Bajar el comando, Quitar el comando ("Eliminar el comando": "Esto quita el comando de la acción.").

Sin ningún comando la lista dice "Sin comandos. Agregue uno cuando esta acción deba emitir una etiqueta o un reporte."; sin ninguno elegido la columna dice "Seleccione un comando para editarlo entero en un solo lugar. Agregue uno desde la barra de arriba cuando esta acción deba emitir una etiqueta o un reporte."

El comando entero

La columna abre el comando elegido, encabezado Comando <n> · <Clase> en <Disparador>. Muestra solo los campos que le pertenecen a la clase elegida.

Campo Qué es Valores / predeterminado Efecto (la línea bajo el campo)
Emite Qué saca el comando. Etiqueta / Reporte; Etiqueta al crearlo. "Imprime una etiqueta a partir de una plantilla de comandos, en la cola que la Unidad elige para las etiquetas de este momento." o "Publica el PDF de la corrida a partir de un reporte de la biblioteca de la estación." Cambiar la clase reasienta el filtro de veredictos en el predeterminado de la clase nueva (Etiqueta: OK; Reporte: todos los veredictos).
Disparador En qué punto de una corrida sale. Arranque / Finalización; Finalización al crearlo. Etiqueta en el Arranque: "Se genera en el momento en que arranca la corrida, antes de que exista ningún resultado."; etiqueta en la Finalización: "Se genera cuando la corrida termina, para los veredictos terminales marcados abajo."; reporte en el Arranque: "Se publica en el momento en que arranca la corrida, así que las secciones sin nada grabado todavía se dejan fuera."; reporte en la Finalización: "Se publica cuando la corrida termina, para los veredictos terminales marcados abajo."
Reporte (comandos de reporte) El diseño de la biblioteca de la estación con el que se publica el PDF. "(seleccione un reporte)" o un diseño; ninguno al crearlo. "No se publica ningún PDF.", "El reporte referenciado no está en la biblioteca.", "Publica un PDF cuando arranca una corrida." / "… cuando termina una corrida.", con "y lo manda a la cola de impresión de este comando en la Unidad." cuando la impresión está encendida.
Impresión del reporte: Imprimir automáticamente (se muestra en cuanto un diseño resuelve) Si el PDF publicado se manda además a la cola de reportes de la unidad para este disparador. Apagado al crearlo. Leyenda: "El PDF se publica de todos modos, en el punto de la corrida de este comando. La impresión decide solo si además se manda a una cola." Encendido: "El PDF va además a la cola de impresión de este comando en la Unidad. Elija esa cola en la pantalla Impresoras." Apagado: "El PDF se publica en la carpeta de reportes y no va más lejos."
Copia del reporte: Conservarla en la corrida (se muestra en cuanto un diseño resuelve) Si el PDF terminado se guarda dentro del archivo de la corrida, para que un reenvío reemita esos bytes exactos después de que el diseño se edite o se elimine. Apagado al crearlo. Leyenda: "Lo que la corrida conserva del documento, que es lo que un reenvío manda después." Encendido: "Cada corrida lleva el PDF terminado, unos cuantos cientos de KB, y un reenvío manda ese documento exacto." Apagado: "Cada corrida apunta al PDF publicado, así que lo que manda un reenvío es un renderizado posterior."
Plantilla global (comandos de etiqueta) La plantilla de etiqueta de la biblioteca de la estación que imprime el comando, cuyos marcadores asigna más abajo. "(seleccione una plantilla)" o una plantilla; ninguna al crearlo. Elegir una crea una fila de asignación para cada marcador que la plantilla declara y que el comando todavía no asigna. "Elija una plantilla: sus marcadores son lo que este comando llena.", "La plantilla referenciada ya no está en la biblioteca.", "Esta plantilla todavía no tiene comandos de impresora, así que no hay nada que mandar.", "Los marcadores de esta plantilla no se pueden leer.", "Sin marcadores: toda corrida coincidente manda los mismos bytes. La Unidad elige la cola de impresión." o "<n> marcadores, cada uno asignado abajo a un valor congelado para esta corrida. La Unidad elige la cola de impresión."
Emitir para el veredicto terminal (solo en la Finalización) Qué veredictos terminales activan el comando. Cuatro casillas: OK, NOK, Indeterminado, Sin veredicto. Una etiqueta empieza solo en OK; un reporte empieza con las cuatro, porque un procedimiento que no juzga nada termina sin veredicto y tiene que producir su documento igual. El comando dispara solo para una corrida que termina en un veredicto marcado. Un comando de Arranque todavía no tiene veredicto y no lee ningún filtro.

Un aviso Necesita revisión bajo los campos lista todo lo que le falta al comando (véase Estar lista, más abajo).

La cola a la que va un documento impreso no es un campo del comando: se resuelve por la clase y el disparador del comando a través de las cuatro ranuras de impresora de la unidad, así que dos comandos de la misma combinación comparten la impresora a propósito. Véase Impresoras.

Marcadores

Los marcadores son los campos {{NAME}} que una plantilla de etiqueta deja para que la corrida los llene, así que esta sección se dibuja para un comando de etiqueta y para nada más. Su estado sigue a la plantilla:

Estado Qué muestra la sección
Sin plantilla elegida "Elija una plantilla para asignar sus marcadores." Con asignaciones guardadas de una plantilla anterior: "Las asignaciones guardadas se conservan mientras falta la plantilla." y sus nombres de marcador.
La plantilla ya no está en la biblioteca "Plantilla no disponible", con la misma lista conservada.
La plantilla no tiene comandos de impresora Un aviso: "“<template>” todavía no tiene comandos de impresora: no hay nada que mandar ni ningún marcador que asignar hasta que se escriban o se importen en Plantillas ▸ Etiquetas."
Los marcadores no se pueden leer Un aviso "Los marcadores de “<template>” no se pueden leer: <error>", y "Asignaciones guardadas conservadas. Repare o reemplace la plantilla antes de cambiar estos vínculos."
La plantilla no tiene ningún marcador "Plantilla fija. Esta plantilla no tiene marcadores y manda los mismos bytes para toda corrida coincidente."
Se encontraron marcadores Una fila por marcador, encabezada por el marcador y una píldora Asignado / Obligatorio, con los campos de abajo.
Campo Qué es Valores / predeterminado
Fuente del valor congelado El único valor de la corrida que se sustituye en el marcador. "(sin asignar)" más las fuentes de la tabla de abajo. Un comando de Arranque lista solo las fuentes disponibles en el Arranque; uno de Finalización las lista todas. "Metadatos · Campo del catálogo" aparece solo cuando el catálogo de metadatos del modelo tiene campos, y las fuentes de criterio solo cuando alguna evaluación del modelo declara un criterio. Una fuente que el disparador actual no puede responder conserva su lugar, desactivada, como "… (no disponible para este comando)". Cambiar la fuente limpia el campo, el ciclo y el formato elegidos para la anterior.
Metadatos del catálogo (fuente Metadatos) Qué campo del catálogo del modelo. "(seleccione metadatos del catálogo)", "Missing field · <id>" para un campo que ya no está, y después cada campo como "<name> · texto / número / secuencial".
Criterio (fuentes de criterio) Qué criterio de qué evaluación del modelo. "(seleccione un criterio)", "Missing criterion · <id>", y después cada criterio como "<evaluation> · <criterion or Criterion n> · <channel>".
Ciclo (base cero) (fuentes de criterio) El resultado de qué ciclo. Nunca se sobreentiende: hay que escribirlo. De 0 hasta el mayor conteo de ciclos que ejecuta cualquier procedimiento del modelo, menos uno; marcador de posición "obligatorio". Un número fuera de ese rango se rechaza bajo el campo.
Formato del valor (fuentes de fecha y hora) Cómo se escribe el instante. Fecha + hora de la estación (predeterminado), Fecha de la estación, Hora de la estación, Fecha + hora de la estación, ISO 8601.
Decimales (fuentes numéricas, y un campo de metadatos numérico) Un número fijo de decimales. De 0 a 9; marcador de posición "automático" (la preferencia propia de la estación).
Limpiar el formato no válido Un botón que se dibuja cuando una asignación lleva un formato que su fuente no puede usar (decimales en una fecha, un formato de fecha en un número, cualquiera de los dos en un texto). Restablece el campo ofensor.

Las fuentes, en el orden en que las lista el selector:

Fuente Disponible en el Arranque Clase
Metadatos · Campo del catálogo Texto, o un número para un campo numérico
Modelo · Nombre, Modelo · Revisión, Unidad · Nombre, Unidad · Código, Procedimiento · Nombre, Procedimiento · Código, Corrida · Identificador Texto
Corrida · Arrancada en Fecha y hora
Corrida · Estado (en el Arranque) / Corrida · Estado terminal (en la Finalización) Texto
Corrida · Terminada en No Fecha y hora
Corrida · Duración (segundos) No Número
Corrida · Veredicto, Corrida · Motivo de terminación No Texto
Criterio · Nombre, Canal, Límites, Gravedad, Resultado, Error, Canales afectados No Texto
Criterio · Ventana abierta en, Ventana cerrada en No Fecha y hora
Criterio · Muestras evaluadas, Muestras fuera, Muestras no disponibles, Muestras no válidas, Peor excursión No Número

Bajo las filas de marcador, Marcadores quitados lista las asignaciones guardadas para marcadores que la plantilla actual ya no declara ("<n> obsoletas"; "Estas asignaciones ya no existen en la plantilla seleccionada y hay que quitarlas."), cada una con Quitar la asignación de marcador obsoleta.

Estar lista

Las píldoras Lista / Revisión de las dos páginas, y las filas que lista la página Validación, salen de un solo juicio. A una acción sin ningún comando le falta uno: "Agregue un comando: esta acción todavía no emite nada." A un comando le falta, en el orden en que se repara:

  • "Seleccione al menos un veredicto de finalización." (un comando de Finalización sin ningún veredicto marcado)
  • "Elija un reporte." / "El reporte seleccionado ya no existe."
  • "Elija una plantilla de etiqueta." / "La plantilla se limpió o se eliminó; las asignaciones guardadas se conservan." / "La plantilla global seleccionada ya no existe."
  • "La plantilla seleccionada todavía no tiene comandos de impresora; escríbalos o impórtelos antes de que una corrida llegue a este comando."
  • "Los marcadores de la plantilla no se pueden leer: <error>"
  • "{{M}} necesita una fuente." / "{{M}} está asignado más de una vez."
  • "{{M}}: elija una fuente", "esta fuente no está disponible en el Arranque", "seleccione un campo del catálogo de metadatos de este modelo", "seleccione un criterio de una de las evaluaciones de este modelo", "fije un ciclo explícito de base cero, de 0 a <n>", "quite los decimales de esta fuente de fecha y hora", "use el formato predeterminado para esta fuente numérica", "los decimales tienen que estar entre 0 y 9", "quite el formato numérico o de fecha de esta fuente de texto"
  • "{{M}} se quitó de la plantilla actual; quite su asignación guardada."

Un comando en revisión se ejecuta igual: en la emisión no se descarta nada, y un marcador que no resuelve hace fallar esa etiqueta, como siempre. La pantalla de configuración es donde esto se aprende, no la etiqueta impresa.

Cómo selecciona acciones un procedimiento

La página de un procedimiento lleva la tarjeta Acciones que emite este procedimiento con una píldora "<n> seleccionadas" y una casilla por acción del modelo, en el orden de la lista. Cada fila muestra la línea de emisión de la acción ("Etiqueta en el Arranque, Etiqueta y reporte en la Finalización", o "Todavía no emite nada: esta acción no tiene comandos.") y, en cuanto se selecciona, una píldora Lista o Revisión. Revisión lista lo que a este procedimiento le falta para los marcadores de la acción, una observación por marcador, porque un marcador que se resuelve por corrida resuelve solo donde el procedimiento tiene lo que nombra:

  • "{{M}} lee un campo de metadatos que este Procedimiento no pide. Márquelo arriba en Metadatos."
  • "{{M}} lee el resultado de un criterio, y este Procedimiento no juzga con ninguna evaluación."
  • "{{M}} lee un criterio que la evaluación de este Procedimiento no declara."
  • "{{M}} lee el ciclo <c>, y este Procedimiento corre un solo ciclo." / "… corre <n>."

La acción ni se oculta ni se rechaza: el procedimiento dice qué le falta, y el remedio está en la misma página. Sin ninguna acción en el modelo la tarjeta dice "Todavía no hay acciones en este modelo. Agregue algunas en las Acciones del modelo."

El orden de emisión

En un límite de la corrida las acciones seleccionadas emiten en el orden de la lista del modelo, y dentro de cada acción en su orden de comandos, filtrado al disparador de ese límite: una sola respuesta para el modelo entero, nunca una por procedimiento. Los comandos de Arranque corren en cuanto la corrida se materializó (después de que se reservaron los metadatos secuenciales), y los comandos de Finalización en cuanto el veredicto terminal quedó sellado. Cada comando está aislado: una falla no publica nada, no cambia nada de la corrida y nunca detiene a los comandos que van detrás. Un reporte se nombra con la corrida y la acción que lo emitió; un renderizado posterior del mismo comando reemplaza el documento de ese comando y nada más. Qué graba cada emisión en la corrida, y cómo se reemite desde Históricos, está en Emitir etiquetas y reportes.

Qué no hace una acción

  • No emite nada por sí sola. Un procedimiento tiene que seleccionarla, y una corrida de ese procedimiento tiene que llegar al límite.
  • No verifica el procedimiento. Si un procedimiento pide el campo o juzga con la evaluación que nombra un marcador se declara en la página del procedimiento, junto a la selección.
  • No elige la impresora. La cola es la de la unidad, por clase y disparador, en Impresoras.
  • No edita plantillas. Los comandos de etiqueta y los diseños de reporte se escriben en Plantillas; la acción solo los nombra.
  • No confirma que se haya impreso físicamente. Que la cola acepte es lo que graba una etiqueta o un reporte impreso, nunca la prueba de que salió papel.