Show TOC

Procedure documentationRetrofitting Transport Requests

 

You want to start the retrofit process for transport requests related to an urgent or normal change.

Prerequisites

If you are using Change Request Management, your change document has the status Authorized for Production (urgent change) or Successfully Tested (normal change).

Procedure

  1. For Change Request Management, to start the retrofit, choose the Start Retrofit action in your change document, at header level or in the Transport Management assignment block.

    For Quality Gate Management, to start the retrofit choose Start of the navigation path Scenario Transport Next navigation step Start Retrofit End of the navigation path .

    If you use the retrofit without the Change Control Management scenarios, you start the retrofit directly from the task list in the administration cockpit.

    The system displays an overview of the transport requests available for the selected retrofit system. You must import in the specified sequence.

    Note Note

    By default, the system only displays transport requests that are released and those for which the retrofit is not yet finished.

    Choose Legend to display explanations for all symbols used on the screen.

    End of the note.

    Field

    Description

    Request

    Transport request ID

    Type

    Indicates whether the transport request contains changes to development objects (Workbench Request), or Customizing settings (Customizing Request) that are imported using generated Business Configuration Sets (BC Sets).

    If the objects were not processed in the retrofit system, they are transported to the retrofit system by means of a transport of copies (automatic import).

    Critical Retrofit

    Indicates whether a transport request contains objects that cannot be imported directly by the tools used. The following applies:

    • Green: Objects can be imported using the automatic import

    • Yellow: Objects can be imported using postprocessing tools

    • Red: Objects have to be transferred manually to the retrofit system

    For more information about the objects in the transport request, choose the traffic light icon. The system displays the log for this transport request, as well as SAP Notes in the transport requests, because they are transport-critical, and can cause problems in the retrofit system.

    Retrofit Request

    Displays the transport request in the retrofit system

    Retrofit Status

    Indicates the current status of the transport request:

    • Process Retrofit: Transports that have not been processed yet

    • Retrofit Manual: Transports that were manually retrofitted

    • Retrofitted: Transports that have been processed

    • Retrofit Rejected: Transports that have been rejected for retrofit

    Choose Retrofit Filter to hide or unhide transport requests with a specific status.

    Show Sequence Dependency

    Indicates whether a transport request is dependent on other transport requests. If you choose the icon in the field, the system lists the transport requests that belong to the sequence-dependent requests. If there is no sequence dependency, several users can process a retrofit, for example.

  2. You can display the retrofit status for each of the objects in a transport request by double-clicking it.

    Note Note

    You can also display the retrofit status in the Transport Management assignment block. For more information, see Transport Management Functions in the WebClient UI.

    End of the note.

    The system displays the object list for a transport request. The color of the row indicates the status of the object.

    You can filter the objects according to their status by choosing the icon in the left screen area. You can also compare the objects in the source and retrofit systems.

    The implementation status field displays an “I” if the retrofit has been implemented.

  3. Choose Add Note to add information to a transport request, for example, the reasons for manually processing objects.

  4. In the Retrofit Request field, specify the retrofit request in the retrofit system into which the changes are to be imported, for each transport request. The system displays the transport requests owned by you and the transports requests in which you have a task.

    The transport request in the system determines the adjustment.

  5. To transport a request, select it and choose the relevant retrofit method.

    • Retrofit for All Categories: The retrofit is performed for all objects in this transport request. The relevant method is applied based on the object type and status.

    • Auto-Import: The retrofit is performed for the objects that can be imported automatically.

      The system collects all objects that do not have any conflicts in a transport of copies. The system imports the transport of copies directly into the retrofit development system and copies them to the target transport request, in order to distribute them to the development implementation system landscape.

    • Transfer with SCWB: The retrofit is performed for the objects supported by the Correction Workbench.

    • Transfer with BC Set: The retrofit is performed for the objects supported by BC Sets.

  6. Select a transport request and choose Additional Functions to use the following features:

    Function

    Use

    Display logs / Display old logs

    Display logs for transport requests in the lower screen area

    Consistency check

    The system checks that:

    • A retrofit request exists

    • The transport request import sequence is correct

    • There are no SAP Note objects in the request, that could cause cross-system object locks during the import

    The result of the consistency check is displayed in the lower screen area.

    Reject retrofit

    To prevent transport requests from being processed, for example, because the change is no longer required. The status of the selected transport request in the overview changes to Retrofit Rejected.

    Retrofit manual

    To flag transport requests that have not been processed by the retrofit process tools, as completed. The status of the selected transport request in the overview changes to Retrofit Manual.

    Call TMS Alert Viewer

    Displaying the TMS Alert Viewer

    Display / Edit BC Sets

    Copying Changes Using the Correction Workbench and BC Sets

    Create retrofit data again

    If an error occurred during the creation of the retrofit data (for example, because no categorization is done, or the RFC connection was not available), you can use this option to create new retrofit data for the selected transport request. Note that the latest versions of the relevant objects are used.

  7. Choose List Retrofit-Critical Objects to list all transport-critical transport objects, so that you can process them manually. You can export the objects in various formats, for further processing (for example, manual retrofit of transport objects).

    Choose Cancel to close the list and go back to the transport request overview for the selected retrofit system.

  8. Before an automatic import takes place, the system performs a recheck of the retrofit classification. If it finds any cross-system object locks that have not been detected before (that is, a former conflict-free object now causes a conflict with the retrofit system), the system displays a warning message and a dialog window for you to decide whether you would like to cancel the process or continue.

    Note Note

    The system performs the recheck by default to ensure consistency and security in the retrofit process. You can change the recheck settings in Customizing under Start of the navigation path SAP Solution Manager Next navigation step Capabilities Next navigation step Change Request Management Next navigation step Retrofit Next navigation step Maintenance of Retrofit Parameters End of the navigation path.

    End of the note.
  9. Use the retrofit status inquiry to specify whether the retrofit was completed successfully.

    You need to specify this because the absence of object transfer warnings only means that there were no technical system errors. Cancelled procedures do not cause errors, so you must confirm that you have completed the procedure successfully, manually.

    • When you set the retrofit to completed successfully, the transport requests no longer appear in the transport request overview for the retrofit.

    • If you specify the retrofit as not having been completed successfully, the transport requests remains in the transport request overview for the retrofit, and continue to show the retrofit status Process Retrofit.

  10. If an error occurred during the creation of the retrofit data (for example, because no categorization is done, or the RFC connection was not available), you can choose Start of the navigation path Additional Functions Next navigation step Create Retrofit Data Again End of the navigation path   to create new retrofit data for the selected transport request. Note that the latest versions of the relevant objects are used.

  11. To leave the retrofit transport request window, choose End.

    The task list overview appears.

Result

The monitored transport from the maintenance system into the development system is completed.

Note Note

In the task list daily overview, the system shows the entry Start Retrofit at the time that you executed the retrofit.

To display the retrofit application log, double-click on Start Retrofit in the daily overview. The log displays all messages for the retrofit steps.

End of the note.