Download as pdf or txt
Download as pdf or txt
You are on page 1of 9

04/07/23, 12:25 Writing a SICF service | SAP Blogs

× Community

 Do you have an S- or P- account? 


If so, you need SAP Universal ID. In a few
months, SAP Universal ID will be the only
Get started with SAP Universal ID
option to login to SAP Community. Without
it, you will lose your content and badges. If
you have multiple accounts, use the
Consolidation Tool to merge your content.

Ask a Question Write a Blog Post

Matthijs Mennens
June 28, 2018 | 8 minute read

Writing a SICF service


 10  23  43,811

Follow  

Introduction
 Like
This blog will guide you through the process of creating a SICF service (REST).
SICF is an SAP transaction which is used to maintain services for HTTP
 RSS Feed communication, using the Internet Communication Manager (ICM) and the
Internet Communication Framework (ICF). This can be useful in multiple
situations. For example: A certain system might not have the proper Gateway
installation or configuration to create services there.

Following steps will be taken to create and test such a service:

1. Creating a structure and table type


2. Creating the ZIF_REST Interface.

https://blogs.sap.com/2018/06/28/writing-a-sicf-service/ 1/18
04/07/23, 12:25 Writing a SICF service | SAP Blogs

gi Add the attributes ‘RESPONSE‘ and ‘REQUEST‘ to the interface.


n.
m
in
.j
s

The method ‘SET_RESPONSE’ has an importing parameter ‘IS_DATA’ with the


‘XSTRING’ type. Make sure you activate the interface.

3.    Creating a Handler Class


Go to ‘SE24’ and create a new class called ‘ZCL_REST_TEST‘. Select the tab
‘Interfaces’ and add interface ‘IF_HTTP_EXTENSION’.

Go back to the tab ‘Methods’ and you’ll see a method has been added. Add
another method called ‘GET_REST’.

Add the following parameters to the method ‘GET_REST’.

https://blogs.sap.com/2018/06/28/writing-a-sicf-service/ 3/18
04/07/23, 12:25 Writing a SICF service | SAP Blogs

This method will first check what type of request we’re dealing with (GET, PUT,
POST, … etc.).  It will then append the name to the base class name. So, if a GET
request is executed, the name of the class it will execute is
‘ZCL_REST_TEST_GET’.

METHOD GET_REST.

******************************************************************
" VARIABLES
******************************************************************
DATA: LV_CLASS_NAME TYPE SEOCLSNAME.
DATA: LV_REQUEST_METHOD TYPE STRING.

******************************************************************
" APPEND REQUEST METHOD TO BASE CLASS
******************************************************************
LV_REQUEST_METHOD = IO_SERVER->REQUEST->GET_HEADER_FIELD( '~request

CONCATENATE 'ZCL_REST_TEST_' LV_REQUEST_METHOD INTO LV_CLASS_NAME.

******************************************************************
" RETURN CLASS OBJECT
******************************************************************
TRY.
CREATE OBJECT EO_REST
TYPE (LV_CLASS_NAME)
EXPORTING
IO_REQUEST = IO_SERVER->REQUEST
IO_RESPONSE = IO_SERVER->RESPONSE.

******************************************************************
" ERRORS
******************************************************************
CATCH CX_SY_CREATE_OBJECT_ERROR.
ENDTRY.

ENDMETHOD.

4.    Creating the class for a GET Request


Go to ‘SE24’ and create a new class ‘ZCL_REST_TEST_GET’ and add interface
‘ZIF_REST’.

https://blogs.sap.com/2018/06/28/writing-a-sicf-service/ 5/18
04/07/23, 12:25 Writing a SICF service | SAP Blogs

" VARIABLES
******************************************************************
DATA: LT_EQUIPS TYPE ZTT_TEST_EQUI.
DATA: LV_STRING_WRITER TYPE REF TO CL_SXML_STRING_WRITER.
DATA: LV_XSTRING TYPE XSTRING.

******************************************************************
" EXECUTE GET_EQUIPMENTS METHOD
******************************************************************
TRY.

LT_EQUIPS = GET_EQUIPMENTS( ME->ZIF_REST~REQUEST ).

******************************************************************
" CONVERT EQUIPMENTS TO JSON
******************************************************************
LV_STRING_WRITER = CL_SXML_STRING_WRITER=>CREATE( TYPE = IF_SXML=>C
CALL TRANSFORMATION ID SOURCE ARRAY = LT_EQUIPS RESULT XML LV_STR
LV_XSTRING = LV_STRING_WRITER->GET_OUTPUT( ).

******************************************************************
" ADD THE JSON EQUIPMENTS TO THE RESPONSE
******************************************************************
ME->ZIF_REST~RESPONSE->SET_DATA( DATA = LV_XSTRING ).

CATCH CX_ROOT.
ENDTRY.
ENDMETHOD.

Now open method ‘SET_RESPONSE’ and add following code. This method will be
executed when ‘HANDLE_REQUEST’ has finished. It will return the data as a
String.

METHOD ZIF_REST~SET_RESPONSE.

CALL METHOD ME->ZIF_REST~RESPONSE->SET_DATA


EXPORTING
DATA = IS_DATA.

ENDMETHOD.

https://blogs.sap.com/2018/06/28/writing-a-sicf-service/ 7/18
04/07/23, 12:25 Writing a SICF service | SAP Blogs

Your class will now have the first two methods below. Add a new method:
‘CONSTRUCTOR’.

Add the following parameters to ‘CONSTRUCTOR’. This will instantiate the class
when called upon.

Open method ‘HANDLE_REQUEST’. This method will be executed from the


handler class (‘ZCL_REST_TEST’). It will use the data that was added as the body
of the POST request. Add the data as JSON.

METHOD ZIF_REST~HANDLE_REQUEST.

******************************************************************
" TYPES
******************************************************************
TYPES: BEGIN OF TYPE_EQUI,
EQUNR TYPE STRING,
EQKTX TYPE STRING,
END OF TYPE_EQUI.

******************************************************************
" VARIABLES AND OBJECTS
******************************************************************
DATA: LS_EQUI TYPE TYPE_EQUI.

https://blogs.sap.com/2018/06/28/writing-a-sicf-service/ 9/18
04/07/23, 12:25 Writing a SICF service | SAP Blogs

METHOD ZIF_REST~SET_RESPONSE.

CALL METHOD ME->ZIF_REST~RESPONSE->SET_DATA


EXPORTING
DATA = IS_DATA.

ENDMETHOD.

Now open method ‘CONSTRUCTOR’ and add following code. This method will
instantiate the request and response when the class is called.

METHOD CONSTRUCTOR.

ME->ZIF_REST~RESPONSE = IO_RESPONSE.
ME->ZIF_REST~REQUEST = IO_REQUEST.

ENDMETHOD.

6.    Creating a node in transaction SICF


Go to transaction ‘SICF’ and find a fitting node to which we can append a new
one. In this case, we’ll opt for the already existing ‘ZREST’ node. Right click the
node and add a new sub-element. We’ll name this node .

Add a fittting description for the service node.

https://blogs.sap.com/2018/06/28/writing-a-sicf-service/ 11/18
04/07/23, 12:25 Writing a SICF service | SAP Blogs

Click one of the two following buttons to active the node/service.

7.     Testing the GET service


Open Postman or something else to test web services.  Add the correct URL and
authorization and press ‘SEND’.

This will return an array with data. In this case only the equipment where the
equipment number matches.

   8. Testing the POST service


Open Postman or something else to test web services.  Add the correct URL and
authorizations.

Add the JSON body to the request and press ‘SEND’.

https://blogs.sap.com/2018/06/28/writing-a-sicf-service/ 13/18
04/07/23, 12:25 Writing a SICF service | SAP Blogs

Single Sign-On to the SAP CRM Web UI in Solution Manager 7.2


By Gurdeep Antil Aug 04, 2019

Related Questions 
Transport webservice Entry in SICF to QAS and PRD
By Former Member Aug 10, 2009

Difference between Normal webservice and SICF service


By titus cheriyan May 27, 2020

Starting with .NET and SAP


By Former Member Jun 28, 2004

10 Comments

Jacques Nomssi Nzali


June 29, 2018 at 9:20 pm

in section 3. Creating a Handler Class -  missing the proposed name of the handler class is missing

JNN

Like 2 | Reply | Alert Moderator | Share

Jacques Nomssi Nzali


June 29, 2018 at 10:02 pm

section 2. Attributes REQUEST and RESPONSE are missing from the interface

Like 1 | Reply | Alert Moderator | Share

Matthijs Mennens | Blog Post Author


June 30, 2018 at 7:19 am

https://blogs.sap.com/2018/06/28/writing-a-sicf-service/ 15/18
04/07/23, 12:25 Writing a SICF service | SAP Blogs

Dear @Matthijs Mennens thanks for this fantastic blog.

I have a question, and it is about how do you handle the authorisation. If I am not wrong anyone with the
user and password could have access to any published service URL. Is there any way to link the service to a
role as it is done with the web services?

Thanks

Like 0 | Reply | Alert Moderator | Share

Wei Han
October 25, 2022 at 8:00 am

Dear Matthijs Mennens,

Thank for your sharing. I have one question here. Do you know how to set the " Transport Protocol" to
HTTPS? thanks.

BR

Wei

Like 0 | Reply | Alert Moderator | Share

Hameed Jaafari
November 22, 2022 at 10:21 pm

Hello.

This was a great tutorial, better than most of other postings I have seen. Even I could follow it and make it
work. however there is a little type in the source code. At one location EO_REST must change to  EQ_REST.
Otherwise all activated with no errors.

Thank you.

H.

Like 0 | Reply | Alert Moderator | Share

https://blogs.sap.com/2018/06/28/writing-a-sicf-service/ 17/18

You might also like