JarCastingsalesforce-api-client
Setup dependency
JDK "1.8"
In build.gradle
Add maven url
repositories {
mavenCentral()
}
Add dependency
dependencies {
compile group: 'com.github.mideo', name:'salesforce-api-client', version: '0.0.2'
}
Usage
SalesforceConfig config = new SalesforceConfig("https://test.salesforce.com")
.clientId("dfghjkl")
.clientSecret("fdghjkl;")
.userName("[email protected]")
.userToken("gfhjk")
.password("fghjkl");
SalesforceConnectionClient connectionClient = new SalesforceConnectionClient(config);
SalesforceWebServiceClient webClient = new SalesforceWebServiceClient(connectionClient);
//Create sObject from POJO
class Account {
def name;
def email;
def id;
}
Account account = new Account();
account.name = "testName bazz";
account.email = "[email protected]";
account.id = webClient.createObject("Account", account);
//Update sObject from POJO
Account account = new Account();
account.name = "testName2 bazzer";
account.email = "[email protected]";
String result = webClient.updateObject("Account",account.id, account);
//Create sObject from HashMap
Map<String,Object> logData = new HashMap<>();
logData.put("Short_Description__c","Api test"+ DateTime.now().toString());
logData.put("Description__c","test description Api test"+ DateTime.now().toString())
String id = webClient.createObject("Log__c", logData);
//Update sObject from HashMap
logData.put("Exception_Type__c","dummyEx"+ DateTime.now().toString());
result = webClient.updateObject("Log__c",id, logData);
//Retrieve Object
Map<String, Object> resultMap = webClient.retrieveObject("Case", caseId);
//Delete sObject
String result = webClient.deleteObject(contactId);
//Execute Anonymous Apex
ExecuteAnonymousResult exectueResult = webClient.executeApexBlock("System.debug('test debug message');");
//Export data
List<Map<String, String>> dataList = webClient
.setPublishStatusCheckTimeout(10000)
.exportDataFromTable("Account");
//Publish csv stream to sObject via bulk api
PublishResult publishResult = webClient.publishCsvToTable(csvInputStream, "Contact");
//Get published data status
String status = getPublishedDataStatus(
publishResult.jobInfo.getId,
publishResult.batchInfo.getId
);
//Export filtered data
Map<String,String> filter = new HashMap<>();
filter.put("Product__c","DummyBox");
filter.put("Delivered",true);
List<Map<String, String>> dataList = webClient.exportDataFromTable("Order__c", filter);
//Export filtered data columns
Map<String,String> filter = new HashMap<>();
filter.put("Product__c","DummyBox");
filter.put("Delivered",true);
List<String> columns = new ArrayList<>();
columns.add("Short_Description__c");
columns.add("Description__c");
List<Map<String, String>> dataList = webClient.exportDataFromTable("Order__c", columns, filter);
Ant Tasks
Retrieving sObjects to csv
Define config json {<sObjectName>: [<comma seperated list of columns>]}
e.g. conf.json
{
"Settings__c" : ["Name","Value__c"],
"Account": ["Name","Email"]
}
In build.xml
<project name="Sample usage of Salesforce Ant tasks" xmlns:sfApi="antlib:com.github.mideo.salesforce">
<taskdef resource="com/github/mideo/salesforce/antlib.xml"
uri="antlib:com.github.mideo.salesforce"
classpath="lib/salesforce-api-client-0.0.1-SNAPSHOT.jar"/>
<!-- persistSObjectToCSV data to csv files -->
<target name="persistSObjectToCSV" description="Retrieve Custom Settings to SFDC">
<sfApi:persistSObjectToCSV
configFileName="conf.json"
csvFilesRelativePath="config/customSettings"
userName="${sf.username}"
password="${sf.password}"
serverUrl="${sf.serverurl}"
/>
</target>
Publishing/Dataload csv files from directory to sObject
In build.xml
<taskdef resource="com/github/mideo/salesforce/antlib.xml"
uri="antlib:com.github.mideo.salesforce"
classpath="lib/salesforce-api-client-0.0.1-SNAPSHOT.jar"/>
<!-- publishCSV data to sfdc -->
<target name="publishCSV" description="Publish Custom Settings to SFDC">
<sfApi:publishCSV
csvFilesRelativePath="config/settings"
userName="${sf.username}"
password="${sf.password}"
serverUrl="${sf.serverurl}"
/>
</target>