The easiest way to deploy/undeploy a component in SAP PI/PO for developers

If you want to deploy (or undeploy) a component, e.g. (a new version of) an adapter in SAP PI / PO, then you have multiple possibilities to do so. You can use the Software Update Manager (SUM), you can use JSPM or even write a user defined script, e.g. in Gradle, that uses ant. But the deployment with SUM and JSPM you need access to this tools and this is normally a task for SAP basis people. And writing a gradle script is not a trivial task.

So IMHO the best way for a developer to deploy a component is to use the Eclipse-based NetWeaver Development Studio (NWDS). In NWDS you can open the Deployment view by going to Window -> Open Perspective -> Other ... and then select Deployment. If the Repository Explorer on the left-hand side is empty than you are not connected to a PI system. To connect to your PI / PO system go to Windows -> Preferences and type "SAP AS Java" in the filter text field. Select SAP AS Java and click the Add button. Then you have to specify the host name of your system. The instance number should normally be 0 and the domain default. Click OK. After that you should see the PI / PO system in repository explorer in Deployment view.

When you expand the node, you'll see all components deployed on the system. You can right-click on a component and select "Add to Undeployment List" or drag-and-drop it to the undeployment list and click "Start". To deploy a new component you have to import the sca-file from your workspace or the file system. If everything was fine, you should receive a success message.

One more thing to think about is the deployment / undeployment strategy. You can configure it in settings section under deployment / undeployment list. For undeployment you can decide, whether to stop the process or to undeploy depending components if there are some. For deployment you have to choose whether only components with lower versions have to be updated or components with lower and equal versions or components with any version (which means that components with higher version can be replaced with ones with lower version which can be usefull to test a behavior in a previous version of the component).

That's it! It is a quick and easy way to make the deployment of a component on SAP PI / PO.

Overview of SFDC APIs

The Salesforce.com (aka Force.com aka SFDC) comes with four different API's which you can use in your application. Being involved in developing of an SFDC adapter for SAP PI and having some experience in real life problems while consulting clients using the adapter, I want to share some thoughts on which API is better suited for which purpose and which you should use in your application.

So which APIs do we have in Salesforce?

The first one is REST API. REST acronym stands for REpresentational State Transfer and is a software architectural style for WWW. It works with Uniform Resource Identifiers (URIs) and uses standard HTTP methods such as HEAD, GET, POST, PATCH and DELETE. A URI points to a REST resource, which is an abstraction that can be a record or a group of records in SFDC.
The characteristics of the SFDC REST API are:

• synchronous and easy to use API
• one HTTP request for one operation (like create, upsert, delete) on a single record. So if you have to update 10000 records, you have to make 10000 HTTP calls to SFDC. Which is to keep in mind, because you can easily hit your license limit.

SOAP API:

• is a SOAP-based web services interface which can be used to process synchronously multiple (up to 200) records at a time.
• requires some experience in developing web services
• uses WSDL to provide services. In SFDC you can generate and use two kinds of WSDL: the enterprise WSDL, which is tightly bound to your company and a more generic partner WSDL.

Bulk API:

• is asynchronous. Because of it's asynchronous nature you will not receive the result of your request automatically, but have to request it actively (after some waiting time, which may be required to complete your request)
• based on REST principles
• is optimized for processing big data sets (thousands to millions of records).
• consists of batches which are processed in the background (a batch can contain a maximum of 10000 records)

Topic Subscription:

• designed to get live updates from Salesforce
• you can subscribe to objects you are interested in (e.g. ContactEmail) and you will receive live notification, if a change was made on a Contact's email
• however the topic subscription is not reliable in the sense that you will not receive all updates in case there was e.g. network problems or your system was down
• so it is nice for receiving live updates, but you have to make a regression update regularly, e.g. making a bulk query every night, to make sure that data keeps consistent.
• is quite error prone at the moment. If you establish a connection to SFDC and listen for change events, you will receive exceptions like "unknown client" from time to time, which will break the connection and requires you to reconnect again

To be precise we have one more API in SFDC, the so-called metadata API. But this one is not intended to manipulate standard objects, so it is not in the scope of this post.

Conclusion

Use REST API if you want an easy synchronous communication and you have not to much records to manipulate

Use Bulk API if you have a big number of records to manipulate (the communication in this case is asynchronous)

Use SOAP API if you have expirience in developing web services an you want a SOAP based communication, which allows you to process up to 200 records in a single call

Use Topic Subscription to receive live updates on objects in Salesforce, but keep in mind that the data consistency with Topic Subscription alone is not guaranteed

Outlook

In following posts I will go into more details on the APIs and give some implementation specifics.

Fixing problem "Channel started but inactive" in SAP PI

Problem
 
Today I faced a problem on SAP PI which took some time for me to solve. The problem was that I made some changes on our SFDC adapter and deployed it again on PI. After that the communication channel was shown as "Channel started but inactive" in comunication channel monitoring. I tried to stop and start the channel, but with no effect. In the integration builder the channel's state was set to active, so firstly I had no idea how to fix this issue.

Solution

After some trying and asking PI experts I figured out the solution, which  was not obvious. The solution was to go to Java Locks at <sap-instance:port>/nwa/locks (default port is 50000) and delete the lock entry for this channel.

Hope this can be useful for some of you!