How to activate the SmartChange OData services

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 using transaction SMICM

2. Step: Configure SAP Gateway (transaction SPRO)

   • Activate SAP Gateway

     

   • Create SAP System Alias

     

     
     Not using a central hub please check if system alias LOCAL is created:

     

3. Activate ICF node OPU (transaction SICF)

   • Select service /default_host/sap/opu

   • Activate Service OPU

     

   • Confirm activation

     

4. Import Transport Request SmartChange (OData Hub_Registration v5.4.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.  

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)

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’.