Register Now

Login

Lost Password

Enter your email to reset your password.

BY Author

How to Use Custom (Apex) WSDL Option in Salesforce.com Adapter?

For more queries on Oracle ICS visit https://shalindrasingh.wordpress.com/

This blog focuses on new feature released with ‘Oracle Cloud Adapter for Salesforce.com’ on ICS starting from 16.1.5. On- Prem SOA Suite will have same feature coming up down the line.

In this blog will walk you through the features of new options; Custom WSDL Support and also how to leverage CUSTOM WSDL (Apex WSDL) of force.com to do the integration between force.com and external system with Salesforce adapter on ICS.

Before we proceed we should know answers of following questions – (If you aware of these terminology)

  1. Why Custom WSDL?
  2. What is Custom WSDL?
  3. How to Generate & Download Custom WSDL?

Why Custom WSDL:

Though Salesforce, by default, provide rich connectivity through standard SOAP and REST API, but there still be a need to extend / enrich the built in functionality in order to support business specific requirement. There could completely new business requirement that by default does not exist. Again all these things can be achieved through Apex coding / custom coding on force.com.

Few use cases could be as follows –

  1. Need Custom validation logic.
  2. Combining operations and objects and building new business process
  3. Complex transactional logic
  4. Aggregate operations to bypass governors and limits
  5. Creating completely new functionality
  6. Customizing web services based on the requirement from third party

What is Custom WSDL:

Further to that if there is requirement to talk to external party for these new business requirement (for which customization has been done) then methods of created apex classes can be exposed as web services. Here we will focus on exposing them as SOAP web services and hence you will get WSDL defining that web service for external party to consume. We call this WSDL as custom WSDL.

Download this WSDL. This WSDL will be used in later steps.

To know more about Apex, click here

How to Generate & Download Custom WSDL:

  • Login into Salesforce.com
  • In setup search for Apex in quick search and click on App Setup -> Develop -> Apex Classes
  • Click on ‘New’ button on that page to create new Apex class
  • Write the Apex code based on the logic you want to built. Once done click on Save.

 

global class MyWebService {

webService static Id makeContact(String lastName, Account a) {

Contact c = new Contact(lastName = ‘Weissman’, AccountId = a.Id);

insert c;

return c.id;

}

} from Salesforce.com documentation

 

  • Once you save it, you see the button ‘Generate WSDL’. Click on this button
  • You will see the WSDL on the web page. Download this WSDL in your local.

 

By now you have covered all those steps you should know before using Custom WSDL feature of salesforce adapter. Now let’s understand how to use this feature in adapter.

 Configure Salesforce Adapter to Consume Custom WSDL:

  1. First step is to create Salesforce connection on ICS. To follow on how to create Salesforce Connection on ICS click here.
  2. After step 1, click in ‘Integrations’ link.
  3. Click on ‘Create New Integration’.
  4. Select ‘Map My Data’ option from pop up window.
  5. Provide the name of the integration and press ok.
  6. Drag and drop connection created on step 1 on the target side on this page.
  7. Below page (Basic Info Page) will open up
  8. BasicInfoPage
  9. Select the highlighted option (Custom Applications built using Apex Classes and hosted on force.com) on this page after providing the name for adapter instance on this page.
  10. Click on the next
  11. In Custom Operations page, there will be option to ‘Select the Custom WSDL’.
  12. Click on ‘Choose File’.
  13. Select the WSDL downloaded above in the section ‘How to Generate & Download Custom WSDL’
  14. You should be able to see something like below after uploading the custom WSDL file. Following things to notice –
  1. It should display the name of the selected (uploaded) WSDL file
  2. It should list down all operation(s) exposed in the uploaded WSDL file.
  1. CustomOperations
  2. Select the operation you want to use in this integration flow.
  3. Click to the Next. It will display applicable header properties (if any) on the Header page. If you are unsure about it, leave as is and click Next.
  4. This should be summary page. Now click on ‘Done’ button and you have completed the configuration required at design time to consume custom wsdl.
  5. Complete the flow (by configuring adapter at source side and completing the required mapping) and activate it and you are good to go

Leave a reply

%d bloggers like this: