{"id":1980,"date":"2011-12-03T01:13:59","date_gmt":"2011-12-03T06:13:59","guid":{"rendered":"http:\/\/ahmeddirie.com\/?p=1980"},"modified":"2013-05-31T08:00:35","modified_gmt":"2013-05-31T13:00:35","slug":"salesforce-soap-api-and-php","status":"publish","type":"post","link":"https:\/\/ahmeddirie.com\/blog\/web-development\/salesforce-soap-api-and-php\/","title":{"rendered":"Salesforce SOAP API and PHP"},"content":{"rendered":"

Lately, I’ve been doing a lot of work integrating a Drupal content management system with Salesforce through it’s SOAP API. Along the way, I’ve come across many stumbling blocks in getting both systems to interact and simply play nice.
\n
\nSome of the features included extending Drupal’s authentication and authorization to happen between both systems, and building a front-end in Drupal that allows users to interact with and manipulate data residing on Salesforce.<\/p>\n

Enough of the small talk, let’s start with the basics and get a connection going to Salesforce using PHP, and run some cool functionality.<\/p>\n

Some Resources<\/h2>\n

It goes without saying, you’ll need a Developer Account with Salesforce. If you don’t already have one, click here<\/a> to get one.<\/p>\n

You’re also going to need the Force.com Toolkit for PHP. To download, click here<\/a>.<\/p>\n

And the last thing you’ll want to keep handy is the Web Services API Developer’s Guide, available here<\/a>.<\/p>\n

Connecting to Salesforce<\/h2>\n

You’ve downloaded the toolkit, and there’s some great stuff in there. For this example, you’ll only really need the soapclient folder and the following files.<\/p>\n

1- SforceBaseClient.php
\n2- SforceHeaderOptions.php
\n3- SforcePartnerClient.php
\n4- partner.wsdl.xml<\/p>\n

At the bottom of the partner.wsdl.xml file on line 3128, you’ll want to modify the link to point to your Developer login site (login.salesforce to test.salesforce)
\n<\/p>\n

Keep those four files in its folder (soapclient) and let’s create your configuration file, inc_config.php<\/p>\n

\r\n<?php\r\n\tdefine ("salesforce_username", 'YOUR_USERNAME');\r\n\tdefine ("salesforce_password", 'YOUR_PASSWORD');\r\n\tdefine ("salesforce_token", 'YOUR_TOKEN');\r\n\tdefine ("salesforce_wsdl", 'soapclient\/partner2.wsdl.xml');\r\n\t\r\n\trequire_once ('soapclient\/SforcePartnerClient.php');\r\n?>\r\n<\/pre>\n
Now let’s create your connection file, inc_connection.php<\/p>\n
\r\n<?php\r\n\trequire ('inc_config.php');\r\n\tini_set('soap.wsdl_cache_enabled', 0);\r\n\tini_set('soap.wsdl_cache_ttl', 0);\r\n\t\r\n\t\/\/Create a new Salesforce Partner object\r\n\t$connection = new SforcePartnerClient();\r\n\r\n\t\/\/Create the SOAP connection to Salesforce\r\n\ttry {\r\n\t\t$connection->createConnection(salesforce_wsdl);\r\n\t} catch (Exception $e) {\r\n  \t\t\/\/Salesforce could be down, or you have an error in configuration\r\n\t\t\/\/Check your WSDL path\r\n\t\t\/\/Otherwise, handle this exception\r\n\t}\r\n\r\n\t\/\/Pass login details to Salesforce\r\n\ttry {\r\n\t\t$connection->login(salesforce_username, salesforce_password.salesforce_token);\r\n\t} catch (Exception $e) {\r\n\t\t\/\/Make sure your username and password is correct\r\n\t\t\/\/Otherwise, handle this exception\r\n\t}\r\n?>\r\n<\/pre>\n
In a perfect world, you should be connected with no problems. If you are having issues, ensure your configurations are correct. <\/p>\n
Getting and Sending Data to Salesforce<\/h2>\n
Let’s run a simple function on one of the core objects in Salesforce. We’ll describe the properties of a core object and store data in one.<\/p>\n
\r\n<?php\r\n     \/\/Describing the Leads object and printing the array\r\n     $describe = $connection->describeSObjects(array('Lead'));\r\n     print_r($describe);\r\n\r\n     \/\/Create New Lead\r\n     $leadFirstName = "Ahmed";\r\n     $leadLastName = "Dirie";\r\n     $leadCompany = "Pick Yours Up";\r\n     $leadEmail = "adirie@pickyoursup.com";\r\n\r\n     \/\/Creating the Lead Object\r\n     $lead = new stdClass;\r\n     $lead->type = 'Lead';\r\n     $lead->fields = array(\r\n          'FirstName' => $leadFirstName,\r\n          'LastName' => $leadLastName,\r\n          'Company' => $leadCompany,\r\n          'Email' => $leadEmail\r\n     );\r\n\r\n     \/\/Submitting the Lead to Salesforce\r\n     $result = $connection->create(array($lead), 'Lead');\r\n?>\r\n<\/pre>\n
You should see your new lead on Salesforce.<\/p>\n","protected":false},"excerpt":{"rendered":"
Lately, I’ve been doing a lot of work integrating a Drupal content management system with Salesforce through it’s SOAP API. Along the way, I’ve come across many stumbling blocks in getting both systems to interact and simply play nice.<\/p>\n","protected":false},"author":2,"featured_media":2586,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[152],"tags":[323,22,55,331,332,329],"_links":{"self":[{"href":"https:\/\/ahmeddirie.com\/blog\/wp-json\/wp\/v2\/posts\/1980"}],"collection":[{"href":"https:\/\/ahmeddirie.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/ahmeddirie.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/ahmeddirie.com\/blog\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/ahmeddirie.com\/blog\/wp-json\/wp\/v2\/comments?post=1980"}],"version-history":[{"count":25,"href":"https:\/\/ahmeddirie.com\/blog\/wp-json\/wp\/v2\/posts\/1980\/revisions"}],"predecessor-version":[{"id":3915,"href":"https:\/\/ahmeddirie.com\/blog\/wp-json\/wp\/v2\/posts\/1980\/revisions\/3915"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/ahmeddirie.com\/blog\/wp-json\/wp\/v2\/media\/2586"}],"wp:attachment":[{"href":"https:\/\/ahmeddirie.com\/blog\/wp-json\/wp\/v2\/media?parent=1980"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/ahmeddirie.com\/blog\/wp-json\/wp\/v2\/categories?post=1980"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/ahmeddirie.com\/blog\/wp-json\/wp\/v2\/tags?post=1980"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}