UseTheForce
Ruby wrapper to mimick parts of ActiveRecord query interface to obtain data conveniently (and human friendly 😅) from Salesforce RESTful API.
Installation
Add this line to your application's Gemfile:
gem 'use_the_force'
And then execute:
$ bundle install
Or install it yourself as:
$ gem install use_the_force
Usage
Put your authentication credentials in an initializer:
UseTheForce.configuration do |config|
config.username = ENV["SALESFORCE_USERNAME"]
config.pw = ENV["SALESFORCE_PW"]
config.api_version = ENV["SALESFORCE_API_VERSION"]
config.client_id = ENV["SALESFORCE_CLIENT_ID"]
config.client_secret = ENV["SALESFORCE_CLIENT_SECRET"]
config.security_token = ENV["SALESFORCE_SECURITY_TOKEN"]
config.instance_url = ENV["SALESFORCE_INSTANCE_URL"]
end
Define your Salesforce models:
class Salesforce::User < UseTheForce::Base
fields :Email, :Name, :IsPirate__c
table_name :User__c
end
Lookup records in a similar fashion like ActiveRecord
, for example,
you can use find_by
:
user = Salesforce::User.find_by(Email: "guybrush.threepwood@trendence.de")
user.Name # Guybrush Threepwood
… or where
for filering:
pirates = Salesforce::Pirate.where(Flag__c: "black").where(HasWoodenLeg: false).all
pirates.count # 42