kasthuriraajan / module-ballerinax-sfdc

Ballerina Salesforce Connector

Salesforce has a vast collection of APIs since they follow an API-first approach to build features on the Salesforce Platform. This approach gives their users the flexibility to manipulate their data however they want. The most commonly used Salesforce Data APIs are REST API, SOAP API, Bulk API, and Streaming API.

Ballerina Salesforce connector utilizes the Salesforce REST API, Bulk API, and SOAP API for convenient data manipulation. The Salesforce connector allows you to perform CRUD operations for SObjects, query using SOQL, search using SOSL, and describe SObjects and organizational data through the Salesforce REST API and SOAP API. Also, it supports adding bulk data jobs and batches of types JSON, XML, and CSV via the Salesforce Bulk API. For more information about configuration and operations, go to the module(s).

• salesforce
  • Perform Salesforce operations programmatically through the Salesforce REST API. Users can perform CRUD operations for SObjects, query using SOQL, search using SOSL and, describe SObjects and organizational data.
• salesforce.bulk
  • Perform Salesforce bulk operations programatically through the Salesforce Bulk API. Users can perform CRUD operations in bulk for Salesforce.
• salesforce.soap
  • Perform Salesforce operations programmatically through the Salesforce SOAP API which is not supported by the Salesforce REST API. The connector is comprised of limited operations on SOAP API.

Building from the source

Setting up the prerequisites

1. Download and install Java SE Development Kit (JDK) version 11. You can install either OpenJDK or Oracle JDK.

   Note: Set the JAVA_HOME environment variable to the path name of the directory into which you installed JDK.

2. Download and install Ballerina Swan Lake

Building the source

Execute the commands below to build from the source.

1. To build Java dependency

   ./gradlew build
   

2. • To build the package:

     bal pack ./salesforce
     

   • To run tests after build:

     bal test ./salesforce
     

Contributing to Ballerina

As an open source project, Ballerina welcomes contributions from the community.

For more information, go to the contribution guidelines.

Code of conduct

All contributors are encouraged to read the Ballerina Code of Conduct.

Useful links

• Discuss code changes of the Ballerina project in [email protected].
• Chat live with us via our Discord server.
• Post all technical questions on Stack Overflow with the #ballerina tag.