Libro de Tubos

Entrenamiento (caso práctico con bifurcación) · Formato Reporte Diario de Curvado · Formato Reporte Diario de Soldadura

Registro de trazabilidad de cada tubo y accesorio instalado: material (colada), posición (PK), juntas soldadas, curvado e inspecciones END. Ruta del módulo: /ncs_libro_tubo. Para aprender con un caso completo, pulse Cargar ejemplo y siga el entrenamiento.

1. Empresa y orden de trabajo (OT)

Cada libro queda asociado internamente a su empresa y a la orden de trabajo (OT) actual (la OT en la que usted ingresó en el ERP); esa referencia se guarda en la base de datos y no se muestra en pantalla.

• Para crear un libro (o cargar el ejemplo) debe haber una OT actual; si no, el sistema lo indica. Un ramal hereda la OT de su línea madre.
• Con una OT actual solo se listan y se pueden abrir los libros de esa OT; al cambiar de OT se ven los de la otra. Los libros creados antes de esta referencia no tienen OT y no se muestran con una OT seleccionada.
• El inventario y las juntas pertenecen a la empresa y se comparten entre las OT; Borrar todo afecta a todas las OT de la empresa.

2. Flujo de trabajo

1. Inventario (acopio): cargue los tubos y accesorios con ID, colada, diámetro, espesor, revestimiento y longitud de fábrica.
2. Libros y ramales → Nuevo libro: nombre y PK de arranque en metros (ej. 5100 = 5+100.00).
3. Abrir el libro → Agregar tramo: elija el elemento de acopio, indique juntas, coordenadas y curvado. El PK se calcula solo.
4. Validar al cierre del día y Excel para entregar el libro.

Cada día: primero el Reporte Diario de Curvado, luego el Reporte Diario de Soldadura, y al final la validación cruzada (ver entrenamiento, sección 5 y sección 6).

3. Cálculo del PK

• PK inicio = PK fin del tramo anterior. PK fin = PK inicio + longitud instalada.
• Se guarda en metros y se muestra como K+MMM.MM (12500.50 m → 12+500.50).
• Intercalar: indique "posición" al agregar; los tramos siguientes se desplazan y todos los PK se recalculan.
• Editar la longitud o eliminar un tramo recalcula los PK posteriores.
• Ecuación de PK: en un tramo, el campo "PK adelante" reemplaza al PK fin del anterior (salto hacia el PK de diseño).

4. Mapa visual de la pantalla del libro

Pantalla que se abre con Abrir en la lista de libros. Los números de la imagen corresponden a la lista de componentes de abajo (rojo: botones de acción; azul: datos y herramientas de la tabla; verde: encabezados y paginación).

123456789101112131415161718192021

4.1 Componentes de la barra superior

4.2 Datos y herramientas de la tabla

4.3 Encabezados, botones de fila y pie

5. Detalle de los botones del libro

Explicación paso a paso de cada botón de la barra superior y de los botones de cada fila (números 2 a 8 y 17 a 20 del mapa), con fórmulas y ejemplos.

5.1 Agregar tramo

Abre el formulario descrito en 6.8. Al guardar, el sistema asigna la secuencia, calcula PK inicio y PK fin y recalcula los tramos siguientes si se intercaló.

Lo que cambia en el acopio: el elemento pasa a estado Instalado. Las juntas escritas se crean si no existían (6.5).

5.2 Validar

Recorre el libro tramo por tramo y arma una lista de hallazgos en un panel. No modifica ningún dato: se puede ejecutar cuantas veces se quiera, normalmente al cierre del día, después de cargar el Reporte de Curvado y el de Soldadura (entrenamiento, sección 6).

5.3 Recalcular PK

Ordena los tramos por secuencia, los renumera 1, 2, 3… sin huecos y rehace todos los PK con esta regla (la misma de la capítulo 3):

PK inicio(n) = PK fin(n−1)  ·  PK fin(n) = PK inicio(n) + longitud instalada(n)  ·  PK inicio(1) = PK de arranque

Si un tramo tiene PK adelante (ecuación de PK, capítulo 7), ese valor reemplaza al PK fin del anterior y desde ahí sigue la cascada. El cálculo se hace en centímetros enteros, sin error de decimales.

¿Cuándo usarlo? Normalmente nunca: el libro se recalcula solo al agregar, editar, cortar o borrar. Úselo cuando Validar informe "PK inicio no coincide con el esperado" (por ejemplo, tras una carga masiva o una corrección directa en la base de datos). Deja un registro resumen en la auditoría con la cantidad de tramos modificados y el PK final de la línea.

5.4 Consolidar END

Cada junta puede tener varias referencias a reportes END (Rx, UT, AUT, VT…), registradas en la pestaña Soldaduras y END (6.5). Este botón resume esas referencias en la columna Estado NDT de cada junta del libro, con esta regla (se evalúa en este orden):

Solo se actualizan las juntas cuyo estado cambió; el mensaje informa cuántas. No es automático: después de agregar o cambiar referencias END hay que volver a pulsar el botón. Queda registrado en la auditoría (evento consolidar_end).

5.5 Excel

Descarga un archivo .xlsx con el libro tal como está en ese momento (no hace falta guardar nada antes). Tiene dos hojas:

• LIBRO DE TUBOS: un renglón por tramo con ID, colada, longitud, PK inicio/fin en formato K+MMM, juntas, WPS, estado NDT, curvado, coordenadas y observaciones. Los PK se muestran como 12+500.50, no como 12500.5.
• DOCUMENTACION Y GUIA: empresa, OT y guía de lectura de las columnas.

Recomendación: ejecute Recalcular PK si hace falta, Validar y Consolidar END antes de exportar, para entregar un libro consistente (flujo en la capítulo 2).

5.6 Vaciar libro

Elimina todos los tramos del libro y de sus ramales. Los tubos y accesorios vuelven al acopio como En Acopio; se conservan la cabecera del libro (nombre, PK de arranque) y la auditoría. Sirve para rehacer el libro desde cero o repetir el ejemplo (entrenamiento, sección 1).

5.7 Editar tramo (lápiz naranja)

Abre el mismo formulario de 6.8 con los datos del tramo. Se puede cambiar longitud, juntas, WPS, fechas, costura, ecuación de PK, coordenadas, curvado y observaciones. No se puede cambiar el tubo o accesorio del tramo.

• La longitud instalada es obligatoria (mayor que 0 y hasta 9999 m).
• Al guardar se ejecuta Recalcular PK: todos los tramos posteriores se corren la diferencia.
• El curvado se guarda sobre el elemento de acopio (tipo y grados van juntos).

¿Quiere cambiar el tubo? Borre el tramo (5.10) y agréguelo de nuevo con el otro elemento indicando "Intercalar en posición" (5.1).

5.8 Cortar / niple (tijera celeste)

Registra que en obra se cortó el tubo para ajustarlo a la zanja o al empalme. El sistema deja trazabilidad completa: el trozo instalado y el sobrante conservan la colada y el ID de fábrica.

Cómo usarlo: pulse la tijera de la fila → escriba la nueva longitud instalada (en metros) → confirme.

Condición: 0 < longitud instalada < longitud de fábrica. La comparación es contra la longitud original del acopio, no contra la que tenga el tramo en ese momento. Si no se cumple, el sistema informa "La longitud instalada debe ser mayor que 0 y menor que la longitud de fabrica (X m)" y no cambia nada.

5.9 Crear ramal (bifurcación, botón celeste)

Solo aparece en filas cuyo elemento es una Te. Crea el libro del ramal que sale de esa Te.

Cómo usarlo: pulse el botón → escriba el nombre del ramal (obligatorio, hasta 100 caracteres) → confirme.

• Cómo se ve en la fila: después de crearlo, el botón de ramal se reemplaza por la etiqueta gris Ramal: nombre (ej. Ramal: DEMO Ramal B). Significa que esa Te ya tiene su ramal creado; no es un botón ni hay nada pendiente.
• Qué hacer: vuelva a la lista con Libros y pulse Abrir en el ramal (6.3); allí cargue sus tubos con Agregar tramo. El primer tubo del ramal debe llevar como junta anterior la tercera soldadura de la Te.
• Cómo se representa en la línea: la fila de la Te en la línea principal solo ocupa su longitud pasante (ej. 2.00 m, 5+136.10 → 5+138.10) y la línea continúa con el tramo siguiente. El ramal es otro libro con su propio PK desde 0+000.00; no aparece intercalado en el PK de la línea principal.
• La tercera soldadura de la Te es la junta anterior del primer tubo del ramal (capítulo 7).
• Mientras exista el ramal no se puede borrar la Te: el sistema responde "Este accesorio origina un ramal; elimine primero el ramal".
• Un elemento que no es Te no puede originar ramal.

5.10 Borrar tramo (papelera roja)

Quita el tramo del libro. Pide confirmación.

• El tubo o accesorio vuelve al acopio con estado En Acopio (conserva su ID actual, por ejemplo TB-D006A si fue cortado).
• Se recalculan los PK de los tramos posteriores (5.3).
• Las juntas no se borran; si ya no las usa ningún tramo se pueden eliminar en 6.5.
• No se puede borrar una Te que originó un ramal (5.9).

5.11 Diagrama

Botón gris Diagrama, junto a Agregar tramo. Abre (y vuelve a cerrar) un panel con un esquema lineal del libro, dibujado con los mismos datos de la tabla, de izquierda a derecha en el orden de los tramos.

• Tramos: cada línea negra es un tramo, con su ID encima y su longitud debajo. Haga clic en un tramo o en una junta para ver su detalle (5.12).
• Nodos (círculos): representan las uniones. Bajo cada uno se lee el tipo de unión posterior del tramo anterior (ej. W-D001, Brida) y el PK, o sin unión si aún no está definida.
• Primer nodo: dice inicio y el PK de arranque. En un ramal dice link a libro padre y al hacer clic abre la línea madre.
• Último nodo: borde negro; si el tramo se marcó como fin de línea dice final de línea.
• Se actualiza solo cuando cambia la tabla (agregar, editar, borrar).

Sirve para revisar de un vistazo la continuidad de uniones y detectar extremos abiertos antes de Validar.

5.12 Detalle de tramo y de junta (bajo el diagrama)

Al hacer clic en un tramo o en una junta (círculo) del diagrama se abre un panel de detalle debajo. Todos los paneles tienen el botón Cerrar (vuelve al mensaje inicial). El panel de un tramo ofrece además Editar tramo (abre el formulario de 6.8).

Si el círculo es una junta soldada, el panel muestra:

• Título grande y centrado con el código (Junta W-D003).
• Botón Reporte (menú desplegable): Word (.docx) o PDF. Genera el reporte de esa junta (esquema, datos, estampe por pase, ensayos END y reportes de inspección), horizontal en A4.
• Esquema de elementos contiguos: solo el tramo de antes, la junta (con su PK) y el tramo de después, con su longitud. En la primera junta no hay tramo antes y dice Junta inicial; si no hay tramo después dice Fin de línea (último tramo marcado como fin) o Frente abierto.
• Datos de la junta (tipo de empalme, PK, qué une, WPS, fecha de soldadura, estado NDT, N° Rep). El botón Editar datos permite cambiar WPS, fecha, N° Rep y Comentario.
• Tabla Soldadura — Estampe por pase: columnas Raíz, 1 PASE … 10 PASE y N° Rep; dos filas, Lado 1 y Lado 2. Cada celda muestra el estampe del soldador (ej. ECR) o ::: si no hay, y un lápiz que abre la ventana Estampe para editar ambos lados de ese pase (vacío = quitar).
• Tabla E.N.D.: una fila resumen con Fecha (de la última inspección), VT, PT, UT, RT (OK, PEND., RECHAZADO o ::: si no hay ensayo), N° Reporte y Comentario. Los reportes con método Rx se cuentan en la columna RT.
• Reportes de inspección: lista de cada reporte END de la junta, con el botón rojo para borrarlo y una fila al pie para agregar uno (N° de reporte, método, fecha, resultado, observaciones). Al agregar o borrar, el Estado NDT de la junta se actualiza solo.

Si el círculo es otro tipo de empalme (brida, acople, otro) o un extremo sin definir, el panel muestra solo los datos básicos del empalme (sin pases, END ni reporte).

6. Referencia de botones por pantalla

6.1 Pantalla principal

6.2 Barra de todas las tablas

6.3 Pestaña Libros y ramales

Columnas: tipo (línea principal o ramal), línea madre, PK de arranque, cantidad de tramos y nota de amarre (Tie-in) del ramal.

6.3.1 Ventana Nuevo libro (pestañas General y Geometría)

Se abre con Nuevo libro. Con Editar (lápiz) es la misma ventana, con el título "Editar libro #N" y los datos cargados. Tiene dos pestañas: General y Geometría.

Pestaña General (datos básicos del libro):

123456789

Pestaña Geometría (opcional):

12345678910

6.3.2 Ventana Exportar libros

Se abre con el botón Exportar de la pestaña Libros y ramales. Genera un archivo con los libros de la orden actual para llevarlos a otra orden o empresa, o para respaldo.

1234567891011

Contenido del archivo (ambos formatos): libros y ramales con su vínculo a la Te de origen; tubos y accesorios instalados en esos libros (ID, colada, tipo, diámetro, espesor, revestimiento, longitud, y el tubo de origen si es un sobrante de corte); tramos con sus PK, coordenadas, uniones y fin de línea; juntas con WPS, fecha, Estado NDT, pases/estampes y referencias END; y curvados.

Nombre del archivo: libro_empresa{id}_orden{OT-año}_{fecha}.xml (o .sql).

Cómo se usa el SQL (solo usuarios autorizados):

1. Abra el script y complete las tres variables del encabezado con los datos de la empresa y la orden destino: @company_id, @company_key y @ot_key.
2. Ejecútelo en la base de datos destino. Corre dentro de una transacción (START TRANSACTION … COMMIT).
3. Los tubos y las juntas que ya existan en la empresa destino se reutilizan; sus pases, reportes END y curvados se agregan.

6.3.3 Ventana Importar libros

Se abre con el botón Importar. Carga en la orden actual un archivo XML generado con Exportar (6.3.2). Solo acepta XML; el SQL no se importa desde aquí.

123456

• Archivo XML generado por este módulo: seleccione el archivo (hasta 15 MB). Debe ser un XML válido de Libro de Tubos, versión 1.
• Importar: el sistema valida todo el archivo antes de escribir en la base. Si hay un dato inválido, informa cuál y no se importa nada (todo o nada).
• Requiere una orden de trabajo actual (capítulo 1).

Al terminar muestra un resumen: libros, tramos, elementos nuevos y reutilizados, juntas nuevas y reutilizadas. La importación queda registrada en la auditoría (evento importar).

6.4 Pestaña Inventario (acopio)

Estados: En Acopio → Curvado (si tiene reporte de curvado) → Instalado. Los sobrantes de un corte (ID-B) vuelven como "En Acopio".

6.4.1 Ventana Agregar elemento

Se abre con Agregar elemento. Con Editar es la misma ventana con los datos cargados. Todos los campos son obligatorios.

12345678910

6.5 Pestaña Soldaduras y END

Las juntas se crean al escribir su código en un tramo. El Estado NDT se actualiza con Consolidar END (dentro del libro).

6.6 Pestaña Auditoría

Lista cada alta, cambio y baja: N°, fecha, usuario, evento (created, updated, deleted, recalculo_pk, corte, ramal, consolidar_end, vaciar_libro, borrar_todo), tabla, registro, libro, valores antes y después, e IP. Se busca por usuario, evento o tabla.

6.7 Pantalla del libro (botones superiores)

Vea también el mapa visual de la pantalla.

6.8 Formulario Agregar / Editar tramo

Ventana emergente que se abre con Agregar tramo (5.1) o con Editar en una fila (5.7). Tiene tres pestañas: Tramo, Unión anterior y Unión posterior. En todos los campos, el ícono ⓘ muestra una descripción al pasar el mouse. (*) = obligatorio.

6.8.1 Pestaña Tramo

La imagen es de un tramo en edición; al agregar, aparecen además Tubo / accesorio (*) y Posición (ver tabla bajo la imagen). Los números están junto al nombre de cada campo, sin cubrirlo.

123456789101112131415161718

Solo al agregar (no se ven al editar):

6.8.2 Pestañas Unión anterior y Unión posterior

Las dos pestañas tienen los mismos campos; describen el empalme con el tramo contiguo. Unión anterior = entre el inicio de este tramo y el tramo anterior (aguas arriba). Unión posterior = entre el final de este tramo y el siguiente (aguas abajo).

Ejemplo con tipo "Junta soldada" (pestaña Unión anterior de un tramo en edición; la Unión posterior es igual):

12345678910

Ejemplo con tipo "Brida" (también válido para Acople mecánico y Otro):

123456

Descripción de todos los campos:

Solo en la pestaña Unión posterior, cuando el tipo es Sin definir, aparece el panel Extremo sin unión definida:

6.9 Botones de cada fila del libro

Columnas ocultas por defecto: diámetro, espesor, revestimiento, WPS, coordenadas y costura (actívelas en el menú Columnas).

7. Cortes, niples, bifurcaciones y ecuación de PK

• Niple: al cortar, el código original se conserva como ID de fábrica; el instalado queda ID-A y el sobrante ID-B.
• Bifurcación: la línea principal solo suma la longitud pasante de la Te y no reinicia su PK; el ramal parte de 0+000.00. La tercera soldadura de la Te es la junta anterior del primer tubo del ramal.
• Ecuación de PK: use el campo "PK adelante" y deje en Observaciones la memoria de cálculo topográfico.

8. Auditoría

Fechas y hora: todas las fechas que muestra el módulo (auditoría, juntas, reportes END, reportes Word/PDF y el selector de rango de fechas) usan el formato de fecha y la zona horaria de la configuración general de su empresa. Los filtros por rango se interpretan como días completos de esa zona horaria. Los campos de calendario de los formularios (ej. fecha de soldadura) muestran la fecha según el idioma de su navegador, pero se guardan y se reportan con el formato de la empresa.

Cada alta, cambio y baja queda con usuario, fecha, IP y valores antes/después. Los recálculos, cortes, ramales, consolidaciones END y borrados masivos dejan un registro resumen.