Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The TM web services are REST services created with ODATA API under the name of ‘/RTC/TM_GW_SRV’. These services are used by SmartChange Apps as SmartChange Approval or SAP Transport Integration for JIRA:
This article describes the activation of the SmartChang Odata services.

\uD83D\uDCD8 Instructions

System prerequisites 

Required Software components:

  • SAP_BASIS min 7.31 SP00 

  • If the system runs on 7.31 as a prerequisite you have to deploy at least the following three add-ons IW_BEP, GW_CORE and IW_FND using transaction SAINT. When using SAP NetWeaver 7.40 or higher, this step is not necessary since the software component SAP_GWFND is already deployed as part of SAP Basis.
    Minimum requirement:

    • SAP Gateway Backend Framework: 

      • IW_BEP 200 SP09

    • SAP Gateway Hub Framework:

      • IW_FND 200 SP09

      • GW_CORE 200 SP09

Service activation 

  1. Step: Activate HTTP service: SMICM

  2. Step: Configure SAP Gateway (transaction SPRO)

    • Activate SAP Gateway

      Image Modified
    • Create SAP System Alias

      Image Modified
  3. Activate ICF node OPU (transaction SICF)

    • Select service node OPU

    • Activate Service

      Image Modified
    • Confirm activation

      Image Modified
  4. Import Trasport Request SmartChange (OData Hub_Registration v5.3.0.0).

  5. Service Registration (transaction /IWFND/MAINT_SERVICE)
    Go to /IWFND/MAINT_SERVICE to activate the Service Registration. The SICF node is delivered by default as inactive for security reasons.
    The technical service name is /RTC/TM_GW_SRV - TransportManager OData Service.

    1. Click on the service name in the Service Catalog. 
      In the Systems Aliases window - add the system alias created before. 
      In the ICF nodes window - Activate the ODATA ICF node.  

Info

SmartChange (OData Hub_Registration v5.2.0.0)

Service name: /RTC/TM_GW_SRV

Additional configuration

  1. Create trusted RFC connection between Development system(s) and TM Server.

    • Use the naming convention: ZRTC_TM_<targetSID>_<targetClient>_TRUST, where <targetSID> is the SID of the development system, and <targetClient> is the working client of the development system.

    • Make sure that the RFC destination is set up as trusted: SM59>Logon and Security tab>Trust relationship = "Yes". 

    • Check if Systems are already Trusted Systems: TM Server must be a Trusted System of Development System (Transaction SMT1 on DEV).

      If NO, continue with following steps on DEV system:

  2. Transaction SM59: Create an ABAP type RFC named 'TMS' (where TMS is SID of TM Server) to TM Server.

  3. Transaction SMT1: Create a new trusted connection and follow the steps in the wizard to create it. Add 'TMS' as RFC there. 

    • on TMS system, a new RFC will be created called TRUSTING@"DEVsid"_"DEV_installationnumber"

    • Test the connection. If not successfully connected: 

      • error message is "Service 'sapmsDEV' unknown - in TMS Operation System check in the service file (/etc/service) if the service exists and create it. 

        sapmsDEV  3601/tcp  # SAP System Message Server Port

  4. Assign the role /RTC/SC_INTEGRATION (authorization for using trusted RFC connections - object S_RFCACL) to all user using Odata Services (e.g. with SmartChange Approval, SAP Transport Integration for Jira)

Info

Note:
The trusted RFC connection is needed for distributed landscapes (TMS is not on the Development system) for OData services Create TR and Release TR. All the actions in OData start in TM Server. TM Server needs to go via RFC to DEV, in the client where the transports are created/released with the logon user. In order to do this, DEV should trust TM Server. 

General information

The TM web services are REST services created with ODATA API under the name of ‘/RTC/TM_GW_SRV’.

These calls are secured by the generated token ‘X-CSRF-Token’ which is fetched via a request of type ‘GET’ and sent to the other types of calls that require changes to the entities (‘POST’/’PUT’/DELETE’) when the session is created from the external.

Each entity is mapped to a structure from the ABAP Dictionary and its fields are used as input and also as output parameters. The ‘PUT’ and the ‘DELETE’ request types will not return any of the fields.

The service has navigations from an entity to another when both entities have linked keys.

E.g. of navigation from a transport request to its attributes for a ‘GET’ request:

‘sap/opu/odata/sap/RTC/TM_GW_SRV/Transport_RequestSet(<KEY>)/TR_AttributesSet’.

On this page

Table of Contents
maxLevel4
outlinetrue
stylenone
excludeOn this page

Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@638004ca
sortmodified
showSpacefalse
reversetrue
typepage
cqllabel = "kb-how-to-article" and type = "page" and space = "CONNECT"
labelskb-how-to-article