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
- Desde dónde se abre {#ras-donde}
- Cómo se elige la plantilla: por el título {#ras-plantilla}
- Qué tiene que hacer la plantilla {#ras-que-hacer}
- Variables {#ras-variables}
- Bloques {#ras-bloques}
- Preguntas frecuentes
- Nombres que no debes usar
- Cuidado con
- La serie «Variables para plantillas»
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:
| Variable | Qué contiene | Formato y notas |
|---|---|---|
{pdf_puppeteer} | 1 si la plataforma genera el PDF con Puppeteer; si no, vacía | Para cargar un CSS de impresión u otro. |
{pdf_docraptor} | 1 si la plataforma genera el PDF con DocRaptor; si no, vacía | Igual 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
- 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 condownload=1, por ejemplo conformaction="?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 suname. El PDF se llamaServiceAptitude_seguido de los identificadores de las intervenciones. No se archiva en ningún sitio: guárdalo tú. - 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 demsg. La plantilla lo manda con un eventocustoma 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.
| Variable | Qué contiene | Formato y notas |
|---|---|---|
{id} | IDs internos de las intervenciones | Texto, separados por comas. Ponlo en la dirección del botón de PDF. |
{ORDER_NUMBER} | Número de intervención | Texto. De una de ellas. |
{ORDER_NAME} | Nombre de la intervención | Texto. De una de ellas. |
{TYPE_NAME} | Tipo de pedido | Texto. |
{STORE} | Almacén o taller de mantenimiento | Texto. |
{ORDER_DAY} | Fecha de reparación | dd/mm/aaaa. |
{ORDER_TIME} | Hora de reparación | hh:mm. |
{NOTIFICATION_DATE} | Fecha de entrega | dd/mm/aaaa. |
{NOTIFICATION_HOUR} | Hora de entrega | hh:mm. |
{ORDER_DATE} | Fecha de la intervención | aaaa-mm-dd. |
{DELIVERY_FULL_DATE} | Fecha y hora de entrega | aaaa-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 equipo | Texto. |
{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ículo | Texto. |
{TLA} | ID interno del equipo de nivel superior | Texto. No es un número de serie. |
{MAINTENANCE_PLAN_TITLE} | Plan de mantenimiento de la planificación | Texto. |
{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 trabajo | Texto. |
{TEMPLATEID} | El «Identificador de plantilla» de la plantilla | Texto. |
{printing} | El valor de printing en la dirección | Lo pone tu plantilla. |
| Los campos del formulario | Cada campo enviado al generar el PDF, con el nombre de su name | Sin 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 -->
| Variable | Qué contiene | Formato 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 vuelta | Texto. |
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ú.
¿Cómo pongo un logo?
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 uses | Usa | Por 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 unvalue="{campo}". Para textos largos, usa<textarea name="campo">{campo}</textarea>en lugar devalue="…". - 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,INCLUDEoDEFINEse toma como una orden de la plantilla. Escribe los comentarios con otra palabra delante.
La serie «Variables para plantillas»
- Variables para plantillas de documentos: sintaxis común y lista de todos los tipos
- Ofertas y propuestas
- Pedidos de venta
- Facturas
- Albaranes, packing list y justificantes de entrega
- Órdenes de compra
- RMA (devoluciones)
- Tarifas
- Etiquetas de artículo y de ubicación
- Etiquetas de contenedor y de lote
- Etiqueta de expedición
- Etiquetas de fabricación
- Etiqueta de dirección
- Mensaje regalo
- DeCA: documento de control del transporte
- Intervenciones
- Informes de la intervención
- Informe de fallo
- Aptitud RAS
- Expedientes de homologación de vehículos
- Itinerarios y contratos de viaje combinado
- Notas de gasto
- Consentimiento RGPD