Variables para plantillas: aptitud RAS

El certificado de aptitud para el servicio (RAS) de una o varias intervenciones del mismo tipo de vehículo, ya en estado útil. Se da de alta con «Aplica a» = Aptitud RAS. Igual que el informe de fallo, la plantilla es a la vez formulario y documento. 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, la aptitud RAS 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

Desde la pantalla de intervenciones: marcas una o varias intervenciones de la misma serie de vehículo, todas en estado útil, y la aptitud se abre en una ventana nueva. Si alguna es de otra serie o no está en estado útil, no se abre.

Cómo se elige la plantilla: por el título

Se usa la plantilla marcada por defecto con «Aplica a» = Aptitud RAS cuyo título contiene la serie del vehículo de la primera intervención marcada, por ejemplo S102.

  • Para que una plantilla sirva para varias series, escribe todas en el título: «Plantilla RAS S102, S112, S130 y S730».
  • El título se compara por texto contenido: una plantilla con «S102» en el título vale también para una serie llamada «S10». Si tienes series cuyo código está dentro del de otra, revisa los títulos.
  • Si varias plantillas cumplen, se usa la primera que se encuentre. Se busca entre todas las plantillas de la plataforma, no solo entre las de tu metagrupo.
  • El «Identificador de plantilla» no cuenta para elegirla, pero llega a la plantilla como {TEMPLATEID}.
  • Sube siempre el fichero: sin él, la aptitud no se abre.

Qué tiene que hacer la plantilla

  1. Generar el PDF. Como en el informe de fallo: un botón que envíe el formulario (método POST) a la misma página con download=1, por ejemplo con formaction="?id={id}&download=1&printing=1", y los botones dentro de <!-- IF printing != '1' -->. Los campos enviados llegan a la plantilla como variables con el nombre de su name. El PDF se llama ServiceAptitude_ seguido de los identificadores de las intervenciones. No se archiva en ningún sitio: guárdalo tú.
  2. Avisar al terminar. La pantalla de intervenciones que abrió la aptitud espera un aviso de la plantilla. Si el aviso dice STATUS = OK, recarga el listado; si no, enseña el texto de msg. La plantilla lo manda con un evento custom a la ventana que la abrió:
<script>
function avisarPantalla(correcto, mensaje) {
  if (window.opener) {
    window.opener.dispatchEvent(new CustomEvent('custom', { detail: { STATUS: correcto ? 'OK' : 'ERROR', msg: mensaje } }));
  }
}
</script>

Deja los espacios dentro de las llaves del JavaScript: {detail} sin espacios se tomaría como una variable y desaparecería.

Variables

Si marcas varias intervenciones, los datos de una sola intervención (número, nombre, fechas) son los de una de ellas, sin un orden fijo. Todos llegan sin HTML, salvo los campos del formulario.

VariableQué contieneFormato y notas
{id}IDs internos de las intervencionesTexto, separados por comas. Ponlo en la dirección del botón de PDF.
{ORDER_NUMBER}Número de intervenciónTexto. De una de ellas.
{ORDER_NAME}Nombre de la intervenciónTexto. De una de ellas.
{TYPE_NAME}Tipo de pedidoTexto.
{STORE}Almacén o taller de mantenimientoTexto.
{ORDER_DAY}Fecha de reparacióndd/mm/aaaa.
{ORDER_TIME}Hora de reparaciónhh:mm.
{NOTIFICATION_DATE}Fecha de entregadd/mm/aaaa.
{NOTIFICATION_HOUR}Hora de entregahh:mm.
{ORDER_DATE}Fecha de la intervenciónaaaa-mm-dd.
{DELIVERY_FULL_DATE}Fecha y hora de entregaaaaa-mm-dd hh:mm:ss.
{SERIALNUMBER}Número de serie del tren (el equipo del que cuelga el de la intervención); si no cuelga de ninguno, el del propio equipoTexto.
{UICS}UIC de cada equipo (o del equipo del que cuelga)Texto, separados por comas. Para uno por línea, usa el bloque UIC.
{SERIE}Serie del vehículoTexto.
{TLA}ID interno del equipo de nivel superiorTexto. No es un número de serie.
{MAINTENANCE_PLAN_TITLE}Plan de mantenimiento de la planificaciónTexto.
{kilometers_default}Kilómetros del equipo de nivel superior en la fecha de entrega (o en la de la intervención, si no está entregada)Número sin formato. Vacía si no hay lectura.
{responsible}Nombre de la última persona que guardó datos de RAS en las órdenes de trabajoTexto.
{TEMPLATEID}El «Identificador de plantilla» de la plantillaTexto.
{printing}El valor de printing en la direcciónLo pone tu plantilla.
Los campos del formularioCada campo enviado al generar el PDF, con el nombre de su nameSin ningún cambio.

Bloques

Las observaciones y deficiencias que se escribieron al validar el RAS en las órdenes de trabajo de las intervenciones (y de sus hijas). Cada texto empieza por el ID interno del equipo, no por su número de serie.

<!-- BEGIN observations -->
  <p>{observations.observations}</p>
<!-- END observations -->
<!-- BEGIN deficiencies -->
  <p>{deficiencies.deficiencies}</p>
<!-- END deficiencies -->
<!-- BEGIN UIC -->
  <span>{UIC.UIC}</span>
<!-- END UIC -->
VariableQué contieneFormato y notas
{observations.observations}Una observación de RAS<ID del equipo> - <texto>.
{deficiencies.deficiencies}Las deficiencias anotadas en el RAS<ID del equipo> - <texto>.
{UIC.UIC}Un UIC por vueltaTexto.

El resto de datos que se guardan al validar el RAS (manual del maquinista, mediciones, operaciones, incidencias, comentarios internos) no llegan a la plantilla.

Preguntas frecuentes

¿Dónde queda guardado el PDF?

En ningún sitio: la aptitud RAS no se guarda sola. Genera el PDF y guárdalo tú.

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="…".
  • IDs internos frente a números de serie. {TLA} y el principio de las observaciones son identificadores internos, no números de serie.
  • 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