Variables para plantillas: informe de fallo

El informe de fallo de un equipo desmontado en una intervención. Se da de alta con «Aplica a» = Informe de fallo. La plantilla es a la vez formulario y documento: la persona rellena los campos en pantalla, los guarda y, con lo guardado, genera el PDF. La sintaxis común a todas las plantillas (variables, bloques, condiciones y textos traducidos) está en la portada de la serie.

Antes de empezar

  • **Textos traducidos: solo {ydic_clave}.** En esta plantilla {dic_clave} sale vacía. Escribe {ydic_clave}, o {ydics_clave} para el plural, como explica la portada.
  • Tienes que subir tu plantilla. Yunbit no trae una plantilla estándar: sin fichero subido, el informe de fallo no llega a abrirse.
  • Las plantillas se dan de alta en el gestor de plantillas de documentos.
  • Direcciones de CSS e imágenes. Al generar el PDF, una dirección relativa (css/informe.css) puede no encontrarse. Escribe direcciones que empiecen por / o direcciones completas.

Además de las que se explican abajo, la plantilla recibe dos variables:

VariableQué contieneFormato y notas
{pdf_puppeteer}1 si la plataforma genera el PDF con Puppeteer; si no, vacíaPara cargar un CSS de impresión u otro.
{pdf_docraptor}1 si la plataforma genera el PDF con DocRaptor; si no, vacíaIgual que la anterior.

Desde dónde se abre

  • En los artículos de la intervención, columna «Informe de Fallo» de la línea del equipo desmontado. Se abre con {engineering} = 1.
  • En el gestor «Datos informes», columna «Informe de fallo». Se abre con {logistics} = 1.

Se abre sola, sin barra de botones alrededor: los botones de guardar y de generar el PDF los tiene que poner tu plantilla.

Cómo se elige la plantilla

Se usa la marcada por defecto con «Aplica a» = Informe de fallo. Se busca entre todas las plantillas de la plataforma, no solo entre las de tu metagrupo; si hay varias marcadas, se usa la primera que se encuentre. Deja una sola. El «Identificador de plantilla» no cuenta para elegirla.

Sube siempre el fichero: sin él, el informe no se abre.

Qué tiene que hacer la plantilla

  1. Ser un formulario. Un campo por cada dato que la persona rellena. El atributo name de cada campo es el nombre de su variable: el campo name="causa" se pinta con {causa}. Usa solo letras, números, - y _, y un nombre distinto para cada campo (sin []).
  2. Pintar lo guardado. Pon en cada campo su variable: value="{causa}", o el texto entre <textarea> y </textarea>. Al abrir un informe guardado, cada campo sale con su valor.
  3. Guardar. Un botón que envíe el formulario (método POST) a FailureReportSave.php?id={id}&engineering={engineering}&logistics={logistics}. Guarda los campos que tengan valor y vuelve a abrir el informe.
  4. Generar el PDF. Un botón que envíe el formulario (método POST) a la misma página con download=1. Antes de hacer el PDF se guardan los datos enviados. El PDF se archiva en los documentos del equipo desmontado como documento interno, y cada vez se guarda una versión nueva. Se llama FR- + fecha (aaaa.mm.dd) + serie + part number + nombre + identificador del equipo.
  5. Guardar los datos automáticos en campos ocultos. Los datos que Yunbit saca de la intervención (número de intervención, número de serie, part number…) solo llegan mientras el informe no se ha guardado nunca. Desde el primer guardado, el informe solo enseña lo que hay en el formulario guardado. Para que sigan saliendo, guarda cada dato automático que uses en un campo, aunque sea oculto: <input type="hidden" name="serialnumber" value="{serialnumber}">.
  6. Quitar los botones del PDF. Añade printing=1 a la dirección del botón de PDF y envuelve los botones en <!-- IF printing != '1' -->.

Ejemplo mínimo:

<form method="post" action="FailureReportSave.php?id={id}&engineering={engineering}&logistics={logistics}">
  <input type="hidden" name="workorder" value="{workorder}">
  <input type="hidden" name="partNumber" value="{partNumber}">
  <input type="hidden" name="serialnumber" value="{serialnumber}">

  <h1>Informe de fallo</h1>
  <p>Intervención {workorder}. Equipo {partNumber}, número de serie {serialnumber}.</p>

  <p>Fecha de revisión: <input type="date" name="fecha_revision" value="{fecha_revision}"></p>
  <p>Causa del fallo:</p>
  <textarea name="causa">{causa}</textarea>

  <!-- IF printing != '1' -->
  <button type="submit">Guardar</button>
  <button type="submit" formaction="?id={id}&engineering={engineering}&logistics={logistics}&download=1&printing=1">Generar PDF</button>
  <!-- ENDIF -->
</form>

Variables

Siempre:

VariableQué contieneFormato y notas
{id}ID interno de la línea del equipo desmontadoTexto. Ponlo en las direcciones de los botones.
{engineering}1 si se abrió desde los artículos de la intervenciónTexto.
{logistics}1 si se abrió desde «Datos informes»Texto.
{printing}El valor de printing en la direcciónLo pone tu plantilla, para quitar los botones del PDF.
{TEMPLATEID}El «Identificador de plantilla» de la plantillaTexto.

Solo mientras el informe no se ha guardado nunca (guárdalos en campos ocultos):

VariableQué contieneFormato y notas
{workorder}Número de la intervenciónTexto.
{ORDER_NAME}Nombre de la intervenciónTexto.
{department}Almacén o taller de mantenimiento de la intervenciónTexto.
{ADDRESS_TITLE}Título de la dirección de ese almacénTexto.
{failure_date}Fecha de entrega de la intervenciónaaaa-mm-dd.
{DONE_DATE}Fecha de terminación de la orden de trabajoaaaa-mm-dd hh:mm:ss.
{TASK_DESCRIPTION}Descripción de la primera tarea de la intervenciónTexto.
{article_description}Nombre del artículo desmontadoTexto.
{partNumber}Part number del artículo desmontadoTexto.
{sap_code}Código de integración 1 del artículo (código SAP)Texto.
{serialnumber}Número de serie del equipo desmontadoTexto.
{identifier}ID interno del equipo desmontadoTexto.
{DRIVING_MOTOR}ID interno del equipo de nivel superior (la motriz)Texto. No es un número de serie.
{motriz_sn}Número de serie de la motrizTexto.
{train_sn}Número de serie del tren (el equipo del que cuelga la motriz)Texto.
{engine}Tren y motriz juntos: <tren> / <motriz>, solo los que tengan valorTexto.
{project}Serie del vehículo. Las series S130 y S730 salen como HST250; S102 y S112, como HST350; S446, como UT446; las demás, con su código.Texto.

Estos datos llegan sin HTML.

Los campos de tu formulario: una variable por cada campo guardado, con el mismo nombre que su name. Al generar el PDF llegan los campos enviados, sin ningún cambio.

No tiene bloques.

Preguntas frecuentes

¿Cómo sé en la plantilla desde dónde se ha abierto?

{engineering} y {logistics} dicen desde qué columna se abrió.

¿Por qué el informe de fallo ya no enseña el número de serie después de guardarlo?

Porque los datos automáticos solo llegan hasta el primer guardado. Guárdalos en campos ocultos del formulario, como explica Qué tiene que hacer la plantilla.

¿Dónde queda guardado el PDF?

En los documentos del equipo desmontado, como documento interno.

Esta plantilla no tiene variable de logo. Escribe la imagen en la propia plantilla con una dirección completa: <img src="https://…/logo.png">.

Nombres que no debes usar

No usesUsaPor qué
{dic_clave}{ydic_clave}En esta plantilla sale siempre vacía.
Campos de formulario con [] en el nombre (name="defectos[]")Un nombre distinto para cada campo (defecto_1, defecto_2)No se pueden pintar al abrir el informe, y en el PDF salen como Array.

Cuidado con

  • Datos que se pintan tal cual. Los campos del formulario llegan sin ningún cambio. Un < se toma como HTML, y unas comillas dobles en un texto cortan un value="{campo}". Para textos largos, usa <textarea name="campo">{campo}</textarea> en lugar de value="…".
  • Un campo vaciado se pierde. En el informe de fallo solo se guardan los campos con valor. Si alguien vacía un campo con un dato automático, ese dato ya no vuelve.
  • IDs internos frente a números de serie. {identifier} y {DRIVING_MOTOR} son identificadores internos. Para el número de serie usa {serialnumber} y {motriz_sn}.
  • Llaves en CSS y JavaScript. Una palabra sola entre llaves ({detail}, {}) se toma como variable y desaparece. Deja espacios dentro de las llaves o lleva el JavaScript a un fichero aparte; lo explica la portada de la serie.
  • Comentarios HTML. Un comentario que empieza por IF, ELSE, BEGIN, END, INCLUDE o DEFINE se toma como una orden de la plantilla. Escribe los comentarios con otra palabra delante.

La serie «Variables para plantillas»

Artículo perteneciente a la/s categoría/s: Fecha de publicación: 13 de noviembre del 2026, 19:57h
« Volver atrás Sugerencias Imprimir

    Sugerencias

    Envíenos sus sugerencias para esta sección, ya sean mejoras en su funcionalidad, usabilidad o contenido. Valoraremos su opinión y comentarios e intentaremos mejorar en la medida de lo posible. Gracias por utilizar nuestros servicios.

    Nota: Todos los campos son obligatorios.

    Información básica sobre protección de datos

    La entidad responsable del tratamiento es YUNBIT, S.L. La finalidad para la cual se recaban los datos es recabar información para mejorar esta wiki. La legitimación para captar la información es el propio consentimiento del interesado al enviar la sugerencia. Los datos no serán cedidos a terceros, salvo obligación legal. Los usuarios disponen del derecho a acceder, rectificar y suprimir los datos, así como otros derechos, como se explica en la información adicional. Puede consultar la información adicional y detallada sobre Protección de Datos aquí: Política de privacidad

    Otros artículos de la categoría Configuración EAM - GMAO

    Out1