This gem provides a Salesforce Adapter under DataMapper 1.[12].x.

Past version support:

• DataMapper 1.0.x is supported by dm-salesforce-adapter 1.0.1 (https://github.com/jpr5/dm-salesforce-adapter/tree/v1.0.1)
• DataMapper 0.10.x is supported by dm-salesforce 0.10.5 (https://github.com/jpr5/dm-salesforce-0.10.x/tree/v0.10.5)
• DataMapper 0.9.x is not supported

class Account include DataMapper::Salesforce::Resource def self.default_repository_name :salesforce end property :id, Serial property :name, String property :description, String property :fax, String property :phone, String property :type, String property :website, String property :is_awesome, Boolean has 0..n, :contacts end class Contact include DataMapper::Salesforce::Resource def self.default_repository_name :salesforce end property :id, Serial property :first_name, String property :last_name, String property :email, String belongs_to :account end DataMapper.setup(:salesforce, {:adapter => 'salesforce', :username => 'salesforceuser@mydomain.com', :password => 'skateboardsf938915c9cdc36ff5498881b', :path => '/path/to/wsdl.xml', :host => ''}) account = Account.first account.is_awesome = true account.save 

See the fixtures for more examples.

Salesforce provides an XML-based WSDL definition of an existing schema/object model for download. dm-salesforce-adapter uses this WSDL to auto-generate a SOAP-based Ruby driver and classes, which is then used to implement a basic, low-level DataMapper Adapter.

Upon first access, the driver and classes are cached locally on disk in one of the following locations (in order of precedence):

• In apidir, defined in database.yml (see included database.yml-example)
• In ENV['SALESFORCE_DIR']
• In ENV['HOME']/.salesforce/

1. Obtain a working salesforce.com account

2. Get a valid security token (if you don't already have one)

   • Login to https://login.salesforce.com
   • Click "Setup"
   • Click "Personal Setup" / "My Personal Information" / "Reset My Security Token"
     • This will send a message to your account's email address with an "API key" (looks like a 24 character token)

3. Get the Enterprise WSDL for your object model

   • Login to https://login.salesforce.com
   • Click "Setup"
   • Click "App Setup" / "Develop" / "API"
   • Click "Generate Enterprise WSDL", then click the "Generate" button
   • Save that to an .xml file somewhere (path/extension doesn't matter - you specify it in database.yml / DataMapper.setup)

4. Copy and modify config/example.rb to use your info

   • The :password field is the concatenation of your login password and the API key
   • If your password is 'skateboards' and API key is 'f938915c9cdc36ff5498881b', then the :password field you specify to DataMapper.setup should be 'skateboardsf938915c9cdc36ff5498881b'

Run 'ruby example.rb' and you should have access to the Account and Contact models (schema differences withstanding).

Don't forget to:

• Retrieve a new copy of your WSDL anytime you make changes to your Salesforce schema
• Wipe the auto-generated SOAP classes anytime you update your WSDL

• Yehuda Katz
• Corey Donohoe
• Tim Carey-Smith
• Andy Delcambre
• Ben Burkert
• Larry Diehl
• Jordan Ritter
• Martin Emde
• Jason Snell
• Frederic Jean