Sunteți pe pagina 1din 8

Getting Started Newsletters Store

Hi, Guest Log On Join Us Search the Community

Products Services & Support About SCN Downloads

Activity Communications Actions
Industries Training & Education Partnership Developer Center

Lines of Business University Alliances Events & Webinars Innovation Browse

Process Integration (PI) & SOA Middleware

Tool to update several communication channels in a

change list in SAP PI
Posted by Anand V D in Process Integration (PI) & SOA Middleware on Dec 2, 2013 5:37:06 AM

Share 1 1 Tweet 3 Like 22

Recently in our landscape we had to set up several PI systems for different testing/quality purpose. Activating large
number of channels manually is time consuming activity, Hence we created this tool to so that we can update the
communication channels easily and quickly. This tool is easy to use and it uses simple excel sheet to get the
communication channel details. It connects to PI system and calls the change list and communication channel services
to retrieve and update channel details.

Prerequisites: postpost
To use this tool following prerequisites have to be met
1) JDK 1.6 or later should be installed on your system.
2) The PI user should have two roles SAP_XI_API_DEVELOP_J2EE and SAP_XI_API_DISPLAY_J2EE
3) MS office excel 2007(xlsx only) or above is required.

Download Link:
Download the zip file from below link and extract it.

How to use:
This tool should be used in three steps

1) GetChannels: In first step, we create an excelsheet lets say Channels.xlsx and place it in the same folder as the tool.
The first sheet of the excelsheet has 5 details to be provided Target PI host,Target PI port, Changelistkey, Source PI host
and Source PI Port.
TargetPIHost: Host of the PI system which has the change list

TargetPIPort: Port of the PI system which has the change list

ChangeLisyKey: Change List key
SourcePIHost: Host of the PI system from which details of the channels have to be fetched
SourcePIPort: Port of the PI system from which details of the channels have to be fetched

Here source system will be your development system and target system will be your quality system to which the objects
are transported from development.

Now open a command prompt, navigate to the folder where this tool is extracted and run GetChannels.bat file from the
tool. Pass the name of the excelsheet to it. It asks for user and password to connect to PI system.

GetChannels.bat will retrieve the party,component and channel names in the change list from target system and write
them in first sheet of the excelsheet. After successful execution of GetChannels.bat, excelsheet will look as shown

2) GetDetails:Now open the excelsheet and update the business system details for Source PI System in first sheet. You
can get this information in SLD business system transport path. If the component is business component then you may
simply copy it from Target PI System. Save and close the excelsheet.
Now run GetDetails.bat file in command prompt and pass the excelsheet name as parameter to it.

It will connect to source PI system and retrieve adapter-specific-attributes of all the channels in first sheet of excel and
write them into second sheet of same excelsheet. Name of this sheet will be Channels. After successful execution of
GetDetails.bat, the excelsheet will look as shown below.

Only green colored cells value should be edited and rest should not be changed. These cells have cell comment which
should not be changed because they are adapter-specific-attribute key. Update the details of non transportable attributes
like folders,FTP host etc in the sheet. Red colored cell indicates that these are password values which must be filled
manually, if required. It is easy to edit if similar channels are grouped by applying filter on adapter type, direction,
transport protocol and message protocol. Save and close the excelsheet. You may want to save a copy of this
excelsheet as backup at this point.

3) Update: Now run Update.dat file in command prompt and pass the excelsheet name as parameter to it. It will update
the channels in target PI system changelist with the values of the excelsheet.
After successful execution of Update.bat, the changelist can be activated easily at once.

1) The change list has atleast one channel in it.
2) The change list is assumed to be under same user as used in this tool. If not, first transfer the change list
under that user and then use this tool.
3) The channels in the change list of target PI system are available in source PI system and not opened in edit
mode in source system.
4) The business system/service of the channels in changelist are activated in target system or they are in the
same change list or different change list under the same user used in the tool.

5) Only adapter-specific-attributes of the channels needs to be updated.

If you face any issue in using this tool, leave a comment below.

Products: sap_netweaver_process_orchestration, sap_netweaver_process_integration Topics: process_integration Tags:
sap_process_integration_(pi), pi, sap_pi, sap_process_integration, xi, sap_netweaver_pi

Average User Rating

(12 ratings)

Share 1 1 Tweet 3 Like 22


Iñaki Vila Dec 2, 2013 2:39 PM

Hi Anand,
Thanks for sharing this tool. It could be helpful when you need to transport several scenarios between
environments and you want to change the communication channels, also it's a good tool to have an
excel about all the communication channels actives outside PI environment.
From my point of view, it has the disadvantage to need to access to OS (in several projects i cant have
this possibility).


Like (3)

Anand V D Dec 2, 2013 4:34 PM (in response to Iñaki Vila)

Hi Iñaki,

Thank you for your comments.

Actually i use Integration Directory API which has web services for ID objects. It almost
similar to using normal Integration builder but without user interface. It is specially useful for
mass changes like above use case.

you can find more on this here

Integration Directory Programming Interface - Integration Directory - SAP Library


Like (2)

Shabarish Vijayakumar Dec 2, 2013 2:37 PM

excellent share!
Like (3)

Hareesh Gampa Dec 2, 2013 9:26 PM

Thanks for sharing Anand..

Like (2)

mastan vali Dec 2, 2013 9:34 PM

Hi Anand,

thanks for publishing such a wonderful blog.


Like (2)

Venkatesh M Dec 3, 2013 7:32 AM

Hi Anand,

Appreciate your effort in developing and sharing this tool..Excellent and an useful Tool !!


Like (1)

Gagandeep Batra Dec 3, 2013 7:49 AM

Good Work Anand,

Thanks for sharing...

Like (1)

Praveen Gujjeti Dec 4, 2013 3:39 PM

A very good tool Anand. Thanks for sharing

Praveen Gujjeti

Like (1)

Abhinav verma Dec 5, 2013 8:03 AM

Hi Anand,

Really appreciate the way you come up with a new and enhanced tool.Which will really help us to do
the configuration.

Thanks a lot.


Like (1)

Abhinav verma Dec 5, 2013 11:30 AM

Hi Anand,

I have one doubt,all the .bat files and all classes which i can see in the zip files are created by you or
getupdate.bat such files are standard files.

Because If i want to develop one similar tool as you have developed so do I need to have knowledge of
how to create the bat files and all the windows and API files etc.Just wanted to clear this things.


Like (0)

Anand V D Dec 5, 2013 12:10 PM (in response to Abhinav verma)

Hi Abhinav,

Only the classes in the folder com\sap\pi\channelactivation are custom classes. Remaining
classes are generated by NWDS while generating ws client.

The .bat files are also created by me. If you open .bat file in a notepad, you can see the name
of the main class.


Like (0)

Abhinav verma Dec 5, 2013 11:51 AM

Hi Anand,

I am getting this error when I am trying to execute the command from CMD.

GetChannel.bat is not recognized as an internal and external command.

operable program or batch file.

Is it is because I am in office Network.


Like (0)

Anand V D Dec 5, 2013 11:57 AM (in response to Abhinav verma)

Hi Abhinav,

Its GetChannels.bat (once you navigate to the folder in cmd, type get and press TAB)


Like (0)

Abhinav verma Dec 5, 2013 12:50 PM (in response to Anand V D)

Thanks Anand for correcting me.After Correcting this,it asked for user id and pwd
and than it is saying error in getChannelsInChangelist<>

Any Idea.Is it because PI server i am connecting remotely from my local machine ??

It would be great if you can help me out in this...


Like (0)

Anand V D Dec 5, 2013 12:55 PM (in response to Abhinav verma)

Hi Abhinav,

Check if the PI user has two roles i.e SAP_XI_API_DEVELOP_J2EE and


If yes, paste the complete error message here.


Like (0)

Abhinav verma Dec 7, 2013 5:25 AM (in response to Anand V D)

Hi Anand,

Both roles are assigned to my id.I am not able to share the

screenshot here,as insert image button is disabled here.

Can you please share ur email id.I will send it to your email id


Like (0)

Anand V D Dec 7, 2013 5:58 AM (in response to Abhinav


Like (0)

Tuncay AYDIN Dec 12, 2013 11:55 AM

Hi Anad,

Thanks for sharing..


Like (1)

Fons van Nuland Dec 16, 2013 8:43 PM

Hello Anand,

Nice blog. The download link seems to be broken. Can you check on that?

Best regards,


Like (1)

Anand V D Dec 17, 2013 5:19 AM (in response to Fons van Nuland)

Hi Fons,

Sorry about that...i will add another link shortly.


Like (0)

Anand V D Dec 17, 2013 4:39 PM (in response to Fons van Nuland)

updated the download link

Like (1)

anoop pindyan Dec 22, 2013 6:59 PM

glad to see you in SDN , great work .thanks.

Like (1)

divyesh vasani Dec 30, 2013 11:53 AM

Nice one.

Like (1)

Anupam Ghosh Dec 30, 2013 3:09 PM

Hi Anand,
This is a great initiative and this proves that you think for PI community.
Thank you for writing this blog and hope to get many more from experts like you.


Like (1)

Anand V D Dec 31, 2013 4:52 AM (in response to Anupam Ghosh)

Thanks Anupam,
Your comments are encouraging as always, but am no expert

Like (0)

Pavan kumar Feb 6, 2014 7:44 AM

Good One Anand.

Link is not working could you please update the link.Is this tool similar to the MIGRATION tool in NWA?

Like (1)

Anand V D Feb 6, 2014 4:19 PM (in response to Pavan kumar)

Hi Pavan,

Link is working. Click on the channel editor folder to start the download.


Like (0)

Srinivas Karnam Feb 12, 2014 8:25 AM

Thanks Anand for sharing a very useful tool


Like (1)

Avinash Ayanala May 12, 2014 5:52 PM

Hi Anand,

Thanks for the really precious information.

I have used your tool successfully and i have done exactly as you said but when i executed the update
bat file i am not able to activate the channels in the change list and it is giving statement saying
updated successfully and i am using 7.31 single stack server please help me in this issue.


Like (0)

Anand V D May 13, 2014 8:02 AM (in response to Avinash Ayanala)

Hi Avinash,

The changelist will not be activated...the idea behind creating this utility is to update the non-
transportable attributes of the communication channels easily and quickly in the changelist.

After executing update.bat, you have to activate the changelist manually in ID.


Like (0)
Avinash Ayanala May 13, 2014 10:53 AM (in response to Anand V D)

Hi Anand,

Thanks for the info.

Like (0)

Site Index Contact Us SAP Help Portal

Follow SCN
Privacy Terms of Use Legal Disclosure Copyright