✒️SAP BASIS / Importación mediante el sistema de gestión de transporte (TMS) Por Fernando Escola
SAP BASIS Importación mediante el sistema de gestión de transporte (TMS)

Importación mediante el sistema de gestión de transporte (TMS)
Importación de órdenes de transporte usando el TMS
1. Fundamentos e Interfaz del TMS-
Colas de Importación: Son las herramientas principales del TMS para realizar importaciones. Reflejan físicamente los buffers de importación de cada sistema a nivel de sistema de ficheros (file system) y muestran las órdenes en el orden correcto.
-
Acceso Global: Las colas de todos los sistemas del dominio de transporte se pueden visualizar desde cualquier sistema SAP del dominio. Las importaciones también se pueden lanzar de manera remota desde cualquier sistema.
-
Credenciales: Si se importa una orden a un sistema SAP distinto al sistema donde se inició sesión, el TMS puede solicitar las credenciales del sistema destino.
-
Navegación: Para acceder a la Vista General de Importación, se utiliza la transacción STMS y la ruta de menú: Vista General (Overview) → Importaciones (Imports). Si se navega dentro de un sistema específico, se ven sus órdenes pendientes.
Al ingresar a la cola, se dispone de columnas clave como: Nombre de la orden, Tipo, Mandante de origen, Mandante destino, Código de retorno, Banderas de importación, Proyecto, Modo incondicional, Activo, Chequeo de componentes y Estatus de la cola.
Chequeo y Verificación de Versión (CV)Al seleccionar Visualizar más (Display More), se habilita la columna CV (Verificación de Versión), que valida si la orden se ajusta a la versión de release y al nivel de SAP Support Package del sistema destino.
-
Si una orden no se ajusta, no debería importarse, o bien se hace bajo propio riesgo tras analizar su contenido.
-
SAP Note 1090842 (Cross-release transports): Detalla problemas técnicos al transportar entre sistemas con diferentes versiones de SAP BASIS.
-
SAP Note 1742547 (Component version check): Explica cómo funciona esta verificación si existe un componente de software adicional (como un plug-in extra) incorrecto en el sistema de exportación o importación. Se puede excluir un componente específico de la verificación si la diferencia es intencional.
-
Uso del Buffer: Para optimizar el rendimiento, los datos se leen del directorio físico de transporte únicamente la primera vez que se inicia el TMS. Luego, la información se almacena en un buffer en la base de datos.
-
Expiración: Los buffers internos del TMS expiran a la medianoche. La marca de tiempo (time stamp) indica qué tan recientes son los datos.
-
Actualización Automatizada: Para refrescar los datos manualmente se usa Tratar (Edit) → Actualizar (Refresh). SAP recomienda automatizar este proceso en background para que se ejecute cada hora a través de la ruta Opciones (Extras) → Actualizar Todas las Colas de Importación.
-
SAP Note 1924741: Ayuda si la actualización de la cola tarda demasiado tiempo.
-
SAP Note 2461665: Ofrece una guía para automatizar la eliminación manual de órdenes ya importadas en el buffer de transporte.
-
Sirven para delimitar qué órdenes se importarán en la próxima importación completa (import all), separando los plazos de entrega y coordinando a los desarrolladores.
-
Funcionamiento: Las órdenes que están antes de la marca de fin se importarán; las que entran al buffer después de que se puso la marca quedan retenidas para la siguiente ejecución. Solo puede haber una única marca de fin por cola/buffer.
-
Gestión de marcas en STMS (Equivalentes a comandos tp):
-
Establecer (tp setstopmark): Menú Cola (Queue) → Cerrar (Close). Cierra la cola de importación.
-
Eliminar (tp delstopmark): Menú Cola (Queue) → Abrir (Open). Abre la cola de importación (normalmente no es necesario).
-
Mover (tp mvstopmark): Menú Cola (Queue) → Mover Marca de Fin (Move End Mark). Permite reubicar la marca justo delante de una orden específica.
-
-
Reenvío (Forwarding): En casos excepcionales, una orden se puede reenviar a un sistema fuera de las rutas predefinidas (ej. un sistema de capacitación de urgencia) antes de ser importada en el destino final. Se realiza desde Petición (Request) → Reenviar (Forward) → Sistema (System).
-
Riesgos de Modificar la Cola: Añadir o eliminar órdenes individualmente de la cola puede causar inconsistencias debido a dependencias de objetos.
-
Ejemplo: Si se elimina una orden que contiene un elemento de datos nuevo, fallará la importación de las demás órdenes que tengan tablas dependientes de ese elemento.
-
Recomendación: Evitar borrar órdenes individuales. Es mejor realizar las correcciones en DEV y liberar una nueva orden de transporte.
-
Existen tres estrategias principales para importar:
-
Importar de forma individual: (Import Request) Se selecciona una orden específica.
-
Importar todas las órdenes: (Import All) Importación completa de la cola.
-
Importar todo el proyecto: (Import Complete Project) Se filtran e importan solo las órdenes de un proyecto específico.
-
Importar con errores: SAP recomienda importar todas las órdenes (incluidas las que tienen errores) junto con sus correcciones correspondientes. Esto mantiene la secuencia cronológica y evita omisiones de objetos.
-
Simulación (test import): Permite realizar una importación de prueba para verificar posibles conflictos antes de la ejecución real.
-
Pestaña Fecha (Date): Permite programar la importación para un momento específico.
-
Pestaña Ejecución (Execution): Permite elegir entre ejecución síncrona o asíncrona (en background a través del programa tp, evitando que se bloquee la sesión del usuario).
-
Pestaña Opciones (Options): Permite seleccionar "opciones de experto" o modos incondicionales (unconditional modes).
-
Selección del Mandante Destino: Si el Control de Transporte Extendido está activo, el mandante destino es fijo. De lo contrario, se puede elegir uno o dejar el valor por defecto (que coincide con el número del mandante de origen).
-
Post-Importación: Tras finalizar, la marca de fin se elimina y la cola se abre de nuevo automáticamente. Si hay sistemas subsiguientes conectados por una ruta de distribución, las órdenes se añaden automáticamente a sus respectivas colas.
-
Interacción con Aprobación QA: Si el procedimiento de aprobación de QA está activo en el sistema, las órdenes en las colas de los sistemas subsiguientes aparecen como inactivas. El TMS no ejecutará la importación si la cola contiene órdenes inactivas.
-
Importación por Proyectos CTS: Si se usa este método, las órdenes de un proyecto específico que ya fueron aprobadas pueden importarse en el sistema de distribución, incluso si quedan otras órdenes sin procesar o rechazadas de proyectos diferentes.
-
Cuando se ejecuta la importación (ya sea Import All, Import Project o Import Single), los objetos de las órdenes marcadas no se meten a ciegas, sino que se procesan bajo la siguiente lógica técnica:
-
Fusión: Todos los objetos de todas las órdenes de transporte seleccionadas se fusionan en un único conjunto.
-
Clasificación por Nivel: Los objetos se clasifican y se importan según su nivel técnico (por ejemplo, las definiciones de tablas se importan antes que los programas).
-
Gestión de Versiones: Si un mismo objeto está incluido en más de una orden de transporte, el sistema solo mantiene la versión de la última orden de transporte (según la secuencia original de la cola). Esto garantiza que las versiones más recientes sobrescriban a las antiguas y evita que los entornos productivos queden con objetos incorrectos o desactualizados.
-
Desactivación de Import All: Se puede bloquear la capacidad de hacer un Import All en un sistema específico modificando la estrategia de transporte o usando el parámetro tp NO_IMPORT_ALL.
Momentos para importar y Modo de mantenimiento
Al iniciar una importación en el TMS, la pestaña Fecha (Date) ofrece tres alternativas básicas para controlar el momento de la ejecución:
-
Inmediato (Immediate): Inicia el proceso de importación de manera instantánea.
-
A la Hora de Inicio (At Start Time): Programa la importación a una hora específica convirtiéndola en un job de background en el sistema destino.
-
No Iniciar Después de (No Start After): Si se define una fecha y hora en este campo, la importación se cancelará si no logra arrancar dentro del período comprendido entre la hora planificada y este límite.
-
Si no hay procesos de background disponibles en ese momento, la importación no se realiza.
-
Período (Period): Permite configurar la importación para que se ejecute de forma regular (periódica).
-
-
Después del Evento (After Event): Inicia la importación únicamente cuando se activa un evento específico del sistema.
-
Si se marca Ejecutar Importación Periódicamente, se lanzará cada vez que ocurra dicho evento. De lo contrario, solo se ejecutará la primera vez.
-
💡 Monitoreo: Todas las importaciones planificadas se pueden monitorizar desde la cola de importación a través de la ruta: Pasar a (Goto) → Monitor de Jobs (Job Monitor).
2. Planificación y Momentos para Realizar TransportesLas órdenes liberadas en DEV no se importan automáticamente; requieren una ejecución manual. SAP recomienda seguir criterios estrictos para evitar disrupciones:
-
Intervalos Regulares: Se aconseja planificar las importaciones a intervalos establecidos (mensuales, semanales o diarios) usando Import All (Importación Completa) o Import Project (Importación por Proyecto). No se recomiendan las importaciones frecuentes "bajo demanda".
-
Ventanas de Mantenimiento: * QAS: Requiere que no se estén ejecutando pruebas relacionadas con los procesos de negocio afectados.
-
PRD: ¡Es obligatorio contar con una ventana de mantenimiento! Exige que no haya usuarios trabajando en los procesos afectados, no existan jobs ejecutándose y no haya comunicación RFC activa con los sistemas satélites implicados.
-
La gestión de cambios (Change management) abarca la creación, liberación, distribución y verificación de las órdenes en todo el panorama. Su sincronización se basa en:
-
Los roles de los mandantes en el panorama SAP.
-
Los requisitos de sincronización entre los diferentes sistemas.
-
La realización de una copia de seguridad (backup) antes de la importación.
-
Los requisitos de congelación de código (Code freezing).
Para cada punto de transporte del mapa de sistemas, el TMS debe respaldar y definir con claridad los requisitos de liberación, importación y verificación respondiendo a preguntas de control (¿Cuándo?, ¿Quién es responsable?, ¿Cómo se revisa?, ¿Qué pasa si falla en el destino?, ¿Se requieren firmas/aprobaciones formales?).
Acciones Técnicas Clave:-
Copia de Mandantes para Pruebas: Para pruebas unitarias, se pueden copiar los contenidos de las órdenes a otro mandante del mismo sistema usando la transacción SCC1 (o SCC1N a partir de SAP S/4HANA 2020).
-
Liberación de Órdenes: Proceso formal de salida desde DEV.
-
Importación: Carga física en los mandantes de los sistemas subsiguientes.
-
Control y Verificación: Se deben asignar responsables y autorizaciones para restringir el acceso a la gestión de transporte. Es vital controlar los buffers mediante los registros de transporte (transport logs) para establecer estándares de prueba y procedimientos de aprobación formal (sign-off).
La transacción SMAINTENANCE en SAP S/4HANA permite definir un período controlado de mantenimiento técnico. Cuando está activo, los usuarios normales no pueden iniciar sesión.
-
Solo los administradores con una política de seguridad especial (configurada en la transacción SECPOL bajo el atributo TENANT_RUNLEVEL_LOGON_PRIVILEGE) pueden conectarse.
-
Durante este modo, solo se ejecutarán los jobs batch del administrador; todos los demás jobs del sistema se detienen.
El proceso de transición consta de 4 fases sucesivas y automáticas con una duración total de 10 minutos (intentar revertirlo antes de que termine puede provocar errores):
Inicia el flujo inverso para devolver el sistema a la normalidad. El cambio del estado En Mantenimiento a Ejecutando se realiza de manera inmediata.
Las estrategias de transporte en SAP
1. Importancia del Monitoreo y Tipos de Archivos LogPara asegurar la consistencia del sistema, el administrador de SAP Basis debe verificar el resultado de cada importación. El sistema registra cada paso del proceso en archivos de protocolo o logs dentro del directorio de transporte.
Existen dos maneras principales de acceder a estos registros:
A. Desde la Transacción STMS (Cola de Importación)Permite visualizar los logs de los pasos de importación individuales seleccionando la orden de transporte y siguiendo la ruta: Petición (Request) → Visualizar (Display) → Log de transporte.
B. Desde la Transacción SE01 / SE09 / SE10 (Organizador de Transportes)Permite ver todo el historial de una orden (tanto la exportación en DEV como las importaciones en QAS/PRD). Al expandir el árbol de la orden de transporte y hacer doble clic en el nodo del sistema correspondiente, se abre el protocolo.
2. Estructura Jerárquica del Log de TransporteEl protocolo de transporte muestra un desglose jerárquico de las fases técnicas que ejecutó la herramienta de control tp. Se compone de las siguientes secciones informativas:
-
Paso de Transporte (Transport Step): Detalla la acción técnica que se realizó (ej. Export, Dictionary Import, Main Import, Generation de programas/vistas).
-
Fecha y Hora: Registra el inicio y fin exacto de cada paso técnico.
-
Código de Retorno (Return Code): El indicador numérico del éxito o fallo de la operación.
-
Mensajes de Error/Advertencia: Al expandir cada sección o hacer doble clic sobre un paso, se accede a los mensajes detallados con información a nivel del sistema operativo.
El código de retorno es la métrica clave para determinar el estado de un transporte. Los valores estándar son:
-
RC = 0 (Éxito): La importación se realizó correctamente y sin anomalías.
-
RC = 4 (Advertencia / Warning): Se generaron advertencias menores. El transporte suele ser exitoso, pero requiere atención.
-
Ejemplo común: Se importó una estructura de tabla que ya existía de forma idéntica en el destino, o un objeto que no necesitaba ser sobrescrito.
-
-
RC = 8 (Error de Importación): Ocurrieron errores graves en el paso de transporte correspondiente. Los objetos no se importaron correctamente y el sistema destino puede haber quedado inconsistente. Requiere análisis inmediato de los detalles del log y una acción correctiva en el sistema de origen (DEV).
-
RC = 12 o superior (Error Crítico / Fatal): Indica un fallo crítico del sistema o de la herramienta de transporte.
-
Ejemplos comunes: Cancelación del programa (Abonde), base de datos caída durante el proceso, problemas graves de permisos en el sistema de archivos o falta de espacio en el disco del directorio de transporte común.
-
El Historial de Importación es una herramienta de auditoría y diagnóstico que registra de forma cronológica todas las órdenes que ya han sido importadas en un sistema específico durante un período de tiempo determinado.
Acceso y Configuración-
Se accede desde la cola de importación de un sistema en STMS mediante el menú: Pasar a (Goto) → Historial de Importación (Import History).
-
Por defecto, el sistema muestra las importaciones de la última semana.
-
Modificación del intervalo: Es posible cambiar el rango temporal visualizado seleccionando la opción del menú: Filtro (Filter) → Intervalo de tiempo (Time Interval).
Para cada orden importada se detallan los siguientes datos en columnas:
-
Año y mes de ejecución.
-
Fecha y hora exacta de la importación.
-
Número de la orden de transporte.
-
Tipo de orden.
-
Mandante de origen.
-
Código de retorno máximo obtenido (RC).
-
Propietario/Usuario que liberó o importó la orden.
-
Texto breve descriptivo.
-
Proyecto CTS asociado (si aplica).
Gestionando la estrategia de transporte
1. Filtrado de Órdenes en el Historial de ImportaciónCuando se trabaja con un volumen alto de transportes, el Historial de Importación de la transacción STMS ofrece herramientas específicas para acotar la lista y localizar cambios concretos.
Existen dos criterios principales de filtrado rápido en la barra de herramientas:
-
Filtrar por Usuario / Propietario: Permite reducir la lista para mostrar únicamente las órdenes que pertenecen o fueron liberadas por un usuario específico (por ejemplo, el consultor o desarrollador responsable del cambio).
-
Filtrar por Proyecto: Si las órdenes están asociadas a proyectos dentro del Change and Transport System (CTS), se puede aplicar este filtro para aislar visualmente todas las modificaciones vinculadas a una iniciativa o fase de desarrollo en particular.
Para búsquedas más complejas y minuciosas que van más allá del usuario o el proyecto, se utiliza la función Buscar (Find), accesible mediante el icono de los binoculares (o la combinación de teclas habitual).
Al activarla, se despliega una ventana de diálogo que permite realizar consultas cruzadas combinando diferentes campos de datos:
-
Campos Disponibles para la Búsqueda:
-
Petición (Request): El número de identificación único de la orden de transporte (ej. DEVK900XXX).
-
Propietario (Owner): El ID de usuario que creó o liberó el transporte.
-
Texto Breve (Short Text): Permite buscar por palabras clave descriptivas contenidas en el título de la orden (ej. "Corrección", "Fijar error", "Customizing").
-
Proyecto (Project): El identificador del proyecto CTS asociado.
-
-
Uso de Comodines: El sistema permite el uso de caracteres comodín (como el asterisco *) en campos como el Texto Breve o el Propietario para realizar búsquedas parciales cuando no se recuerda el nombre o término exacto.
-
Navegación entre Coincidencias: Si la búsqueda arroja múltiples resultados en el historial, el sistema resalta la primera coincidencia. El usuario puede utilizar la opción Buscar Siguiente (Find Next) para saltar cronológicamente de una orden encontrada a otra dentro de la lista filtrada.
Configuraciones en el TMS dependiendo de la estrategia de transporte
1. Estrategias de Transporte Impulsadas por Cola (Queue-Driven Transports) A. Transportes Masivos (Mass Transports)-
Opción por defecto: La opción de importación "Dejar Solicitud de Transporte en la Cola para Importación Posterior" se activa de manera automática al realizar una importación individual ("importar en singular").
-
Propósito y utilidad: Permite que las solicitudes importadas individualmente mantengan su lugar en la cola para que se vuelvan a importar en el orden correcto durante la siguiente importación masiva o regular de todas las solicitudes.
-
Prevención de errores: Es una configuración fundamental para realizar importaciones preliminares de solicitudes individuales, ya que evita el problema del adelantamiento (overtaker problem), impidiendo que objetos más antiguos queden desactualizados en la siguiente importación regular.
-
Opción por defecto: La opción "Dejar Solicitud de Transporte en la Cola para Importación Posterior" se encuentra desactivada por defecto.
-
Comportamiento del sistema: Si el sistema se gestiona únicamente con solicitudes individuales (sin importación por proyecto), activar esta opción no es útil; las solicitudes se quedarían retenidas en la cola con el estado "La solicitud está lista para ser importada de nuevo" y tendrían que borrarse manualmente.
-
Interfaz de usuario: Los botones de la barra de herramientas en la pantalla de la Cola de Importación cambian de forma dinámica según la estrategia elegida.
-
Restricción del botón "Importar Todas las Solicitudes" (icono de camión completamente cargado o fully loaded truck): Solo se habilita si se ha filtrado uno o más proyectos CTS. Esto evita la importación accidental y masiva de todas las solicitudes que se encuentran en la cola.
-
Las propuestas de transporte se generan automáticamente en el momento en que se exportan las solicitudes de transporte.
-
Las opciones de importación son equivalen y corresponden a las de los transportes individuales.
-
Las importaciones quedan estrictamente vinculadas y condicionadas al procesamiento de las propuestas en la Lista de Tareas (Worklist) del TMS.
-
Si se intenta importar solicitudes de transporte sin utilizar el flujo de trabajo correspondiente, el sistema mostrará una advertencia en la cola de importación.
Los parámetros del programa de control tp y del Sistema de Modificación y Transportes (CTS) se configuran automáticamente según la estrategia seleccionada de la siguiente manera:
-
Para la estrategia de Transportes Masivos: * Los parámetros IMPORT_SINGLE_ONLY, NO_IMPORT_ALL e IMPORT_SINGLE_STRATEGY se configuran en 0.
-
El parámetro WORKFLOW_STRAT_EGY se configura en 0.
-
El parámetro REPEATONERROR se configura en 9.
-
El parámetro STOPONERROR se configura en 9.
-
-
Para la estrategia de Transportes Individuales: * Los parámetros IMPORT_SINGLE_ONLY, NO_IMPORT_ALL e IMPORT_SINGLE_STRATEGY se configuran en 1.
-
El parámetro WORKFLOW_STRAT_EGY se configura en 0.
-
El parámetro REPEATONERROR se configura en 8.
-
El parámetro STOPONERROR se configura en 9.
-
-
Para la estrategia de Transportes por Flujo de Trabajo (Workflow): * Los parámetros IMPORT_SINGLE_ONLY y NO_IMPORT_ALL se configuran en 1.
-
El parámetro IMPORT_SINGLE_STRATEGY se configura en 0.
-
El parámetro WORKFLOW_STRAT_EGY se configura en 1.
-
El parámetro REPEATONERROR se configura en 8.
-
El parámetro STOPONERROR se configura en 9.
-
-
Definición de STOPONERROR: Determina a partir de qué código de retorno (return code) la importación se detiene de forma inmediata. Su valor es 9 para las tres estrategias mencionadas.
-
Definición de REPEATONERROR: Establece el código de retorno a partir del cual una importación se considera no exitosa y debe repetirse, lo que mantiene la orden en la cola. Su comportamiento varía según la estrategia:
-
En Transportes Individuales (Valor 8): Un código de retorno de 8 se clasifica como una importación fallida, por lo que debe repetirse y la orden permanece en la cola de importación.
-
En Transportes Masivos (Valor 9): El mismo código de retorno de 8 se clasifica como una importación exitosa, lo que provoca que la orden de transporte se elimine automáticamente de la cola.
-
âš ï¸ Advertencia Importante: No se deben modificar manualmente estos parámetros relevantes de la estrategia de transporte. El TMS genera y sobrescribe estos valores de forma automática cada vez que se realiza un cambio en la configuración de las rutas de transporte.
Transporte de copias y relocalizaciones
1. Transporte de Copias (Transport of Copies)-
Propósito principal: Permite transportar objetos a cualquier otro sistema SAP de tu elección sin necesidad de seguir las rutas de transporte estándar. Es especialmente útil cuando no existe una ruta de consolidación directa desde el sistema origen (donde se creó la orden) hacia el sistema destino.
-
Estado de los objetos: Los objetos se exportan e importan exactamente en la versión que poseen en el sistema origen al momento de la exportación.
-
Ubicación original: El uso de este tipo de orden no modifica la ubicación original (el sistema de desarrollo propietario) de los objetos.
-
Comportamiento en la cola: A diferencia de las órdenes de Workbench o Customizing, las órdenes de Transporte de Copias no se añaden automáticamente a la cola de importación de los sistemas de entrega subsiguientes.
-
Aclaración del término "Copias": En este contexto de SAP, el concepto de "copia" no hace referencia a la acción de duplicar archivos (copying), sino que se utiliza como el término fijo opuesto a "original".
-
Uso principal: Se utiliza para mover objetos de desarrollo a un sistema de desarrollo diferente de forma temporal.
-
Ejemplo práctico: Llevar a cabo desarrollos especiales en un sistema SAP separado para evitar interferencias con el proceso de desarrollo principal. También se usa si un objeto se creó por error en un sistema de aseguramiento de calidad (QA) y ahora la entrada del sistema original debe moverse al sistema de desarrollo.
-
Efecto: Permite mover la ubicación original de los objetos al sistema destino, pero manteniendo el paquete actual sin alteraciones.
-
Uso principal: Se emplea cuando el sistema de desarrollo de objetos individuales debe cambiarse de forma permanente.
-
Efectos de este tipo de orden:
-
Cambia la ubicación original de los objetos al sistema destino.
-
Cambia la asignación de paquete de los objetos al mismo tiempo de manera simultánea.
-
-
Ventaja: Como el paquete se actualiza automáticamente, los objetos adquieren los atributos de transporte deseados de forma inmediata tras ser importados en el sistema destino de la orden.
-
Uso principal: Se utiliza cuando el sistema de desarrollo de un paquete completo (con todos los objetos que este contiene), y no de elementos individuales sueltos, debe cambiarse de forma permanente hacia un sistema de desarrollo diferente para futuros desarrollos.
 
 
 
Sobre el autor
Publicación académica de Fernando Escola, en su ámbito de estudios para la Carrera Consultor SAP BASIS S/4HANA.
Fernando Escola
Profesión: Especialista en Infraestructura It - Argentina - Legajo: SJ78C
✒️Autor de: 58 Publicaciones Académicas
🎓Egresado del módulo:
Disponibilidad Laboral: FullTime
Presentación:
Soy un profesional de tecnología con más de 25 años de experiencia en infraestructura it, soporte técnico y administración de entornos corporativos. a lo largo de mi carrera trabajé brindando soporte
Certificación Académica de Fernando Escola
























