Module: Restforce::DB

Extended by:
Forwardable
Defined in:
lib/restforce/db.rb,
lib/restforce/db/dsl.rb,
lib/restforce/db/task.rb,
lib/restforce/db/model.rb,
lib/restforce/db/client.rb,
lib/restforce/db/runner.rb,
lib/restforce/db/worker.rb,
lib/restforce/db/adapter.rb,
lib/restforce/db/cleaner.rb,
lib/restforce/db/command.rb,
lib/restforce/db/mapping.rb,
lib/restforce/db/railtie.rb,
lib/restforce/db/tracker.rb,
lib/restforce/db/version.rb,
lib/restforce/db/attacher.rb,
lib/restforce/db/registry.rb,
lib/restforce/db/strategy.rb,
lib/restforce/db/collector.rb,
lib/restforce/db/associator.rb,
lib/restforce/db/accumulator.rb,
lib/restforce/db/initializer.rb,
lib/restforce/db/record_cache.rb,
lib/restforce/db/synchronizer.rb,
lib/restforce/db/attribute_map.rb,
lib/restforce/db/configuration.rb,
lib/restforce/db/instances/base.rb,
lib/restforce/db/field_processor.rb,
lib/restforce/db/timestamp_cache.rb,
lib/restforce/db/association_cache.rb,
lib/restforce/db/associations/base.rb,
lib/restforce/db/record_types/base.rb,
lib/restforce/db/strategies/always.rb,
lib/restforce/db/strategies/passive.rb,
lib/restforce/db/associations/has_one.rb,
lib/restforce/db/instances/salesforce.rb,
lib/restforce/db/associations/has_many.rb,
lib/restforce/db/strategies/associated.rb,
lib/restforce/db/synchronization_error.rb,
lib/restforce/db/associations/belongs_to.rb,
lib/restforce/db/instances/active_record.rb,
lib/restforce/db/record_types/salesforce.rb,
lib/restforce/db/associations/foreign_key.rb,
lib/restforce/db/record_types/active_record.rb

Overview

:nodoc:

Defined Under Namespace

Modules: Associations, Instances, Model, RecordTypes, Strategies Classes: Accumulator, Adapter, AssociationCache, Associator, Attacher, AttributeMap, Cleaner, Client, Collector, Command, Configuration, DSL, FieldProcessor, Initializer, Mapping, Railtie, RecordCache, Registry, Runner, Strategy, SynchronizationError, Synchronizer, Task, TaskMapping, TimestampCache, Tracker, Worker

Constant Summary collapse

VERSION = 
"3.2.2"

Class Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.configuration ⇒ Object

Public: Get the current configuration for Restforce::DB.

Returns a Restforce::DB::Configuration instance.



79
80
81
 
# File 'lib/restforce/db.rb', line 79

def self.configuration
  @configuration ||= Configuration.new
end

.last_run ⇒ Object

Returns the value of attribute last_run.



63
64
65
 
# File 'lib/restforce/db.rb', line 63

def last_run
  @last_run
end

Class Method Details

.client ⇒ Object

Public: Get a Restforce client based on the currently configured settings.

Returns a Restforce::Data::Client instance.



86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
 
# File 'lib/restforce/db.rb', line 86

def self.client
  @client ||= begin
    client = DB::Client.new(
      username:       configuration.username,
      password:       configuration.password,
      security_token: configuration.security_token,
      client_id:      configuration.client_id,
      client_secret:  configuration.client_secret,
      host:           configuration.host,
      api_version:    configuration.api_version,
      timeout:        configuration.timeout,
      adapter:        configuration.adapter,
    )

    # NOTE: By default, the Retry middleware will catch timeout exceptions,
    # and retry up to two times. For more information, see:
    # https://github.com/lostisland/faraday/blob/master/lib/faraday/request/retry.rb
    client.middleware.insert(
      -2,
      Faraday::Request::Retry,
      methods: [:get, :head, :options, :put, :patch, :delete],
    )

    client
  end
end

.configure {|configuration| ... } ⇒ Object

Public: Configure Restforce::DB by assigning values to the current configuration.

Yields the current configuration. Returns the current configuration.

Yields:



126
127
128
129
 
# File 'lib/restforce/db.rb', line 126

def self.configure
  yield(configuration)
  configuration
end

.reset ⇒ Object

Public: Clear all globally cached values for Restforce::DB.

NOTE: This is an “idempotent” reset; following invocation, all functions should still work as before, but globally cached values will be repopulated.

Returns nothing.



138
139
140
141
142
 
# File 'lib/restforce/db.rb', line 138

def self.reset
  FieldProcessor.reset
  @user_id = nil
  @client = nil
end

.reset! ⇒ Object

Public: Eliminate all customizations to the current Restforce::DB configuration and client.

NOTE: This is a hard reset; following invocation, Restforce::DB will need to be reconfigured in order for functionality to be restored.

Returns nothing.



151
152
153
154
155
156
 
# File 'lib/restforce/db.rb', line 151

def self.reset!
  reset

  @configuration = nil
  @last_run = nil
end

.user_id ⇒ Object

Public: Get the ID of the Salesforce user which is being used to access the Salesforce API.

Returns a String.



117
118
119
 
# File 'lib/restforce/db.rb', line 117

def self.user_id
  @user_id ||= client..user_id
end