Learning Objective:
After completing this unit, you’ll be able to:
- Overview of SKYVVA soap and rest API
- Comfortably connect soap UI with salesforce organization.
Introduction
SoapUI is an open-source web service testing application for service-oriented architectures and representational state transfers. We can connect soap UI with salesforce organization to push data.
Required details:
- SoapUI application.
- Username and password of your salesforce organization.
- Security Token.
We can push data using:
- Soap API
- Rest API
What is a SOAP API?
SOAP is a standard communication protocol system that permits processes using different operating systems like Linux and Windows to communicate via HTTP and its XML.
SOAP-based APIs are designed to create, recover, update and delete records like accounts, passwords, leads, and custom objects. These offer over twenty different kinds of calls that make it easy for the API developers to maintain their accounts, perform accurate searches and much more.
These can then be used with all those languages that support web services.
SOAP APIs take the advantages of making web-based protocols such as HTTP and its XML that are already operating all operating systems that are why its developers can easily manipulate web services and get responses without caring about language and platforms at all.
Explaining a Simple SOAP Example
SOAP, by its very nature, requires a little more setup, but I think you’ll be amazed at how simple it is to use. Begin this example by creating a Windows Forms application using Apex. The sample code uses java, but the same technique works fine with other Apex language (you’ll need to modify the code to fit). Add labels, text boxes, and buttons as shown here (the Latitude and Longitude fields are read-only).
How to Integrate SoapUI to SKYVVA
Follow the given steps to connect SoapUI with SKYVVA
Step1: Generate API file
- Go to your Salesforce Organization
- Click on API under Integration
- Click on Generate Enterprise WSDL
Go to SoapUI
- Click on SOAP
- Create a new SOAP project
- Save the WSDL file in your system.
Step2: Go to SoapUI application
- SoapUI is open-source. Users can easily download from Google.com.
- Here we are using SoapUI Version 5.5.0
- Right-click & open SoapUI application
- Click Soap & create a new SOAP project as shown in the picture.
- Write your Project name
- Browse Initial WSDL XML file
- Click on the OK button.
- Expand login & click “Request 1“
- Delete this section its UN-use-able
- Enter your Org credentials
- Username
- Password + Security Token
- Click on play button
- Great you Generated sessionId successfully.
Step3: Now repeat almost same steps but this time download SKYVVA WSDL
- Go to salesforce setup & Apex Classes in search box
- Click Apex Classes
- Scroll down to Service
- Click & generate WSDL
- Save the generated file
- Go to SoapUI
- Click on SOAP
- Create a new SOAP project
- Type Project Name in the open window. Browse your Initial WSDL XML file and Click ok
- Expand SkyvvaIServices
- Go to integrate
- Rename it to Authorization
Step 4: Create Interface in your org
- Go back to your org
- Create Integration & copy IntegrationID
- Create Interface & copy Interface Name
Go to the related page and create IStructure
- Name
- BillingCity
- BillingCountry
- Click on Open Mapping button
Step5: Go to SoapUI to connect SKYVVA with soap UI
- Paste this code
- Submit
- Great you pass your code to salesforce
- When you click on submit your code automatically transfer to salesforce Org
Step6: Check result
Go to your Salesforce org
- Click on Message Monitoring Tab
- Select your Integration
- Select your Interface
- OK
- Click on Search button
Congratulations your record has been updated successfully
2 What is REST API ?
REST is an architectural style of the web services that work as a channel of communication between different computers or systems on the internet. The term REST API is something else. Those application programming interfaces that are backed by the architectural style of the REST architectural system are called REST APIs.
REST API compliant web services, database systems, and computer systems permit requesting systems to get robust access and redefine representations of web-based resources by deploying a predefined set of stateless protocols and standard operations. By these protocols and operations and redeploying the manageable and updatable components without causing the effect on the system, REST API systems deliver fast performance, reliability, and more progression.
Explaining a Simple REST Example IntegrateBatch
The examples in this section use REST API resources to create, retrieve, update, and delete records, along with other record-related operations.
- Open SoapUI
- Click on REST
Login to your Salesforce org
- Go to setup
- Copy your URL
- Paste URL here to create new REST project
- Click ok
- Rest project created.
- Expand URL
- Right-click on Request
- Click on Clone Request
- Specify the name of cloned Request
- Eg. Authorization
- Click ok
Now here something is very important
Method POST
Endpoint URL: https://skyvva-test-dev-ed.lightning.force.com/
RESOURCE : /services/apexrest/skyvvasolutions/integrateBatch
- Media type by default application/json where we post. (json is the format)
- Header its some tricky although it is easy
- Click on Header
- Add header name eg. Authorization
- A bearer is a keyword after press space key
- Paste your sessionID
- Press enter key
Now go back to your salesforce org
- Create Integration & copy IntegrationID
- Create Interface & copy Interface Name
Click on Related List & create IStructure
- Name
- BillingCity
- BillingCountry
- Click on Open Mapping button
- Select Ext Id & Save
Go to SoapUI
Paste this code under Media type section
URL : https://skyvva-test-dev-ed.lightning.force.com/
RESOURCE: /services/apexrest/skyvvasolutions/integrateBatch
- Paste the code and submit it.
Great you pass
- Number Of Records”: “3”
- Basket Name”: “IB-00000”
- Basket Id”: “a0A2V0000uHgCiEAK”
Go to your salesforce org
- Go to your Integration
- Click on Batch Control Board
Here is all information about our Integration Inbound processing
- Click on view
- Successfully saved
Explaining a Simple REST Example Create New Message
Follow the same steps to create the REST project.
Go back to your salesforce org
- Create an Integration & copy IntegrationID
- Create an Interface & copy Interface Name
Click on Related List create IStructure
- Name
- BillingCity
- BillingCountry
- Click on Open Mapping Button
- Go to mapping section select ExtId & save
- Go to SoapUI
- Paste this code under Media type section
- URL : https://skyvva-test-dev-ed.lightning.force.com/
- RESOURCE: /services/apexrest/skyvvasolutions/createNewMessage
- Submit
- Great you pass code
Go to your Salesforce org
- Click on Message Board
- Go to your Integration
- Select Interface
- OK
- Click on search button
This is the example of Failed message see red flag, If user having business requirement New, Pending, and Cancelled messages use method process message to reprocess. As now we explain it in next step
Explaining a Simple REST Example Process Message
We have to follow the same steps for creating REST Project 3
- Follow same steps
Go back to your salesforce org
- Copy Integration
- Copy Interface Name
Go to SoapUI
- Paste this code under Media type section
- URL : https://skyvva-test-dev-ed.lightning.force.com
- RESOURCE: /services/apexrest/skyvvasolutions/processMessage
- Click on Detail List
- See Integration and Interface name
Go to SoapUI
- Submit
- Great you pass code
Go to your salesforce org
- Go to your message board
- Congratulation you done very easily
Explaining a Simple REST Example Integrate Synchronous
This feature is created to allow user call Skyvva Services by REST Api from their system.
- Create integration & copy Name
Create interface & copy Name
Click on Related list & create IStructure
- Name
- BillingCity
- BillingCountry
- Click on Open Mapping Button
Go to SoapUI
- Paste this code under Media type section
- URL : https://skyvva-test-dev-ed.lightning.force.com
- RESOURCE: /services/apexrest/skyvvasolutions/IntegrateSynchronous
- Submit
Great code pass successfully
- Go to your salesforce org
- Go to your Integration
- Click on Message Monitoring Tab
- Select your Integration
- Select your Interface
- OK
Click on Search button
Green flag status reflects your inbound integration is successfully achieved with the help of SoapUI.