Module: Restforce::Client::API
Instance Method Summary collapse
-
#create(sobject, attrs) ⇒ Object
(also: #insert)
Public: Insert a new record.
-
#create!(sobject, attrs) ⇒ Object
(also: #insert!)
See .create.
-
#describe(sobject = nil) ⇒ Object
Public: Returns a detailed describe result for the specified sobject.
-
#destroy(sobject, id) ⇒ Object
Public: Delete a record.
-
#destroy!(sobject, id) ⇒ Object
See .destroy.
-
#find(sobject, id, field = nil) ⇒ Object
Public: Finds a single record and returns all fields.
-
#list_sobjects ⇒ Object
Public: Get the names of all sobjects on the org.
-
#org_id ⇒ Object
Public: Get the current organization’s Id.
-
#query(soql) ⇒ Object
Public: Executs a SOQL query and returns the result.
-
#search(sosl) ⇒ Object
Public: Perform a SOSL search.
-
#update(sobject, attrs) ⇒ Object
Public: Update a record.
-
#update!(sobject, attrs) ⇒ Object
See .update.
-
#upsert(sobject, field, attrs) ⇒ Object
Public: Update or Create a record based on an external ID.
-
#upsert!(sobject, field, attrs) ⇒ Object
See .upsert.
Methods included from Verbs
define_api_verb, define_verb, define_verbs
Instance Method Details
#create(sobject, attrs) ⇒ Object Also known as: insert
Public: Insert a new record.
Examples
# Add a new account
client.create('Account', Name: 'Foobar Inc.')
# => '0016000000MRatd'
Returns the String Id of the newly created sobject. Returns false if something bad happens
127 128 129 130 131 |
# File 'lib/restforce/client/api.rb', line 127 def create(sobject, attrs) create!(sobject, attrs) rescue *exceptions false end |
#create!(sobject, attrs) ⇒ Object Also known as: insert!
See .create
Returns the String Id of the newly created sobject. Raises an error if something bad happens.
138 139 140 |
# File 'lib/restforce/client/api.rb', line 138 def create!(sobject, attrs) api_post("sobjects/#{sobject}", attrs).body['id'] end |
#describe(sobject = nil) ⇒ Object
Public: Returns a detailed describe result for the specified sobject
sobject - Stringish name of the sobject (default: nil).
Examples
# get the global describe for all sobjects
client.describe
# => { ... }
# get the describe for the Account object
client.describe('Account')
# => { ... }
Returns the Hash representation of the describe call.
60 61 62 63 64 65 66 |
# File 'lib/restforce/client/api.rb', line 60 def describe(sobject=nil) if sobject api_get("sobjects/#{sobject.to_s}/describe").body else api_get('sobjects').body['sobjects'] end end |
#destroy(sobject, id) ⇒ Object
Public: Delete a record.
Examples
# Delete the Account with Id '0016000000MRatd'
client.delete('Account', '0016000000MRatd')
Returns true if the sobject was successfully deleted, false otherwise.
207 208 209 210 211 |
# File 'lib/restforce/client/api.rb', line 207 def destroy(sobject, id) destroy!(sobject, id) rescue *exceptions false end |
#destroy!(sobject, id) ⇒ Object
See .destroy
Returns true of the sobject was successfully deleted, raises an error otherwise.
217 218 219 220 |
# File 'lib/restforce/client/api.rb', line 217 def destroy!(sobject, id) api_delete "sobjects/#{sobject}/#{id}" true end |
#find(sobject, id, field = nil) ⇒ Object
Public: Finds a single record and returns all fields.
sobject - The String name of the sobject. id - The id of the record. If field is specified, id should be the id
of the external field.
field - External ID field to use (default: nil).
Returns the Restforce::SObject sobject record.
230 231 232 |
# File 'lib/restforce/client/api.rb', line 230 def find(sobject, id, field=nil) api_get(field ? "sobjects/#{sobject}/#{field}/#{id}" : "sobjects/#{sobject}/#{id}").body end |
#list_sobjects ⇒ Object
Public: Get the names of all sobjects on the org.
Examples
# get the names of all sobjects on the org
client.list_sobjects
# => ['Account', 'Lead', ... ]
Returns an Array of String names for each SObject.
41 42 43 |
# File 'lib/restforce/client/api.rb', line 41 def list_sobjects describe.collect { |sobject| sobject['name'] } end |
#org_id ⇒ Object
Public: Get the current organization’s Id.
Examples
client.org_id
# => '00Dx0000000BV7z'
Returns the String organization Id
76 77 78 |
# File 'lib/restforce/client/api.rb', line 76 def org_id query('select id from Organization').first['Id'] end |
#query(soql) ⇒ Object
Public: Executs a SOQL query and returns the result.
soql - A SOQL expression.
Examples
# Find the names of all Accounts
client.query('select Name from Account').map(&:Name)
# => ['Foo Bar Inc.', 'Whizbang Corp']
Returns a Restforce::Collection if Restforce.configuration.mashify is true. Returns an Array of Hash for each record in the result if Restforce.configuration.mashify is false.
92 93 94 95 |
# File 'lib/restforce/client/api.rb', line 92 def query(soql) response = api_get 'query', :q => soql mashify? ? response.body : response.body['records'] end |
#search(sosl) ⇒ Object
Public: Perform a SOSL search
sosl - A SOSL expression.
Examples
# Find all occurrences of 'bar'
client.search('FIND {bar}')
# => #<Restforce::Collection >
# Find accounts match the term 'genepoint' and return the Name field
client.search('FIND {genepoint} RETURNING Account (Name)').map(&:Name)
# => ['GenePoint']
Returns a Restforce::Collection if Restforce.configuration.mashify is true. Returns an Array of Hash for each record in the result if Restforce.configuration.mashify is false.
113 114 115 |
# File 'lib/restforce/client/api.rb', line 113 def search(sosl) api_get('search', :q => sosl).body end |
#update(sobject, attrs) ⇒ Object
Public: Update a record.
Examples
# Update the Account with Id '0016000000MRatd'
client.update('Account', Id: '0016000000MRatd', Name: 'Whizbang Corp')
Returns true if the sobject was successfully updated, false otherwise.
151 152 153 154 155 |
# File 'lib/restforce/client/api.rb', line 151 def update(sobject, attrs) update!(sobject, attrs) rescue *exceptions false end |
#update!(sobject, attrs) ⇒ Object
See .update
Returns true if the sobject was successfully updated, raises an error otherwise.
161 162 163 164 165 166 |
# File 'lib/restforce/client/api.rb', line 161 def update!(sobject, attrs) id = attrs.delete(attrs.keys.find { |k| k.to_s.downcase == 'id' }) raise 'Id field missing.' unless id api_patch "sobjects/#{sobject}/#{id}", attrs true end |
#upsert(sobject, field, attrs) ⇒ Object
Public: Update or Create a record based on an external ID
sobject - The name of the sobject to created. field - The name of the external Id field to match against. attrs - Hash of attributes for the record.
Examples
# Update the record with external ID of 12
client.upsert('Account', 'External__c', External__c: 12, Name: 'Foobar')
Returns true if the record was found and updated. Returns the Id of the newly created record if the record was created. Returns false if something bad happens.
182 183 184 185 186 |
# File 'lib/restforce/client/api.rb', line 182 def upsert(sobject, field, attrs) upsert!(sobject, field, attrs) rescue *exceptions false end |
#upsert!(sobject, field, attrs) ⇒ Object
See .upsert
Returns true if the record was found and updated. Returns the Id of the newly created record if the record was created. Raises an error if something bad happens.
193 194 195 196 197 |
# File 'lib/restforce/client/api.rb', line 193 def upsert!(sobject, field, attrs) external_id = attrs.delete(attrs.keys.find { |k| k.to_s.downcase == field.to_s.downcase }) response = api_patch "sobjects/#{sobject}/#{field.to_s}/#{external_id}", attrs (response.body && response.body['id']) ? response.body['id'] : true end |