Module: LeapSalesforce

Defined in:
lib/leap_salesforce.rb,
lib/leap_salesforce/auth.rb,
lib/leap_salesforce/error.rb,
lib/leap_salesforce/limits.rb,
lib/leap_salesforce/loader.rb,
lib/leap_salesforce/version.rb,
lib/leap_salesforce/parameters.rb,
lib/leap_salesforce/users/user.rb,
lib/leap_salesforce/soql_object.rb,
lib/leap_salesforce/users/users.rb,
lib/leap_salesforce/soql_data/soql.rb,
lib/leap_salesforce/generator/default.rb,
lib/leap_salesforce/soql_data/tooling.rb,
lib/leap_salesforce/generator/generator.rb,
lib/leap_salesforce/generator/soql_enums.rb,
lib/leap_salesforce/generator/exe_helpers.rb,
lib/leap_salesforce/generator/soql_objects.rb,
lib/leap_salesforce/soql_data/common_enum_methods.rb

Overview

Adding parameters to set for authentication, environment and other common settings

Defined Under Namespace

Modules: Auth, CommonEnumMethods, Default, ExeHelpers, Generator, Loader, Tooling, Users Classes: Error, Limits, RequestError, ResponseError, SetupError, Soql, SoqlObject, User, UserError

Constant Summary collapse

VERSION =

Returns Version of leap salesforce.

Returns:

  • (String) —

    Version of leap salesforce

'1.0.5'
CREDENTIALS_FOLDER =

Returns Folder where credentials are stored.

Returns:

  • (String) —

    Folder where credentials are stored

File.join('config', 'credentials')
CREDENTIAL_FILE =

Returns File where Salesforce credentials are stored.

Returns:

  • (String) —

    File where Salesforce credentials are stored

File.join(CREDENTIALS_FOLDER, 'salesforce_oauth2.yml')

Class Attribute Summary collapse

Class Method Summary collapse

Class Attribute Details

.client_id ⇒ String

Returns Client id in Salesforce OAuth app.

Returns:

  • (String) —

    Client id in Salesforce OAuth app



117
118
119
 
# File 'lib/leap_salesforce/parameters.rb', line 117

def client_id
  @client_id
end

.client_secret ⇒ String

Returns Client secret in Salesforce OAuth app.

Returns:

  • (String) —

    Client secret in Salesforce OAuth app



119
120
121
 
# File 'lib/leap_salesforce/parameters.rb', line 119

def client_secret
  @client_secret
end

.config_folder ⇒ String

Returns Folder where all configuration is stored. By default this is ‘config’.

Returns:

  • (String) —

    Folder where all configuration is stored. By default this is ‘config’



110
111
112
 
# File 'lib/leap_salesforce/parameters.rb', line 110

def config_folder
  @config_folder
end

.environment ⇒ String

Returns Environment to use for tests. This can be accessed to change the username used to login to test.salesforce with. This can be set on the command line with ‘LEAP_ENV’.

Returns:

  • (String) —

    Environment to use for tests. This can be accessed to change the username used to login to test.salesforce with. This can be set on the command line with ‘LEAP_ENV’



31
32
33
 
# File 'lib/leap_salesforce/parameters.rb', line 31

def environment
  ENV['LEAP_ENV'] || @environment
end

.lib_folder ⇒ String

Returns Path where library generated assets are stored. By default lib/leap_salesforce.

Returns:

  • (String) —

    Path where library generated assets are stored. By default lib/leap_salesforce



123
124
125
 
# File 'lib/leap_salesforce/parameters.rb', line 123

def lib_folder
  @lib_folder
end

.logger ⇒ Logger

Returns Logger used by LeapSalesforce.

Returns:

  • (Logger) —

    Logger used by LeapSalesforce



130
131
132
 
# File 'lib/leap_salesforce/parameters.rb', line 130

def logger
  @logger
end

.objects_to_verify ⇒ Array

Returns List of objects to verify metadata for. This includes enums, required values Changes to these values will need to be version controlled.

Returns:

  • (Array) —

    List of objects to verify metadata for. This includes enums, required values Changes to these values will need to be version controlled



126
127
128
 
# File 'lib/leap_salesforce/parameters.rb', line 126

def objects_to_verify
  @objects_to_verify
end

.password ⇒ String

Returns Common API password. This assumes all users use the same password.

Returns:

  • (String) —

    Common API password. This assumes all users use the same password



115
116
117
 
# File 'lib/leap_salesforce/parameters.rb', line 115

def password
  @password
end

.security_token ⇒ String

Returns Token specific to a user used for authentication.

Returns:

  • (String) —

    Token specific to a user used for authentication



121
122
123
 
# File 'lib/leap_salesforce/parameters.rb', line 121

def security_token
  @security_token
end

.sfdx ⇒ Boolean

Setting this variable uses sfdx for authentication and other actions such as opening an organisation link

Returns:

  • (Boolean) —

    Whether Salesforce sfdx is being used



141
142
143
 
# File 'lib/leap_salesforce/parameters.rb', line 141

def sfdx
  @sfdx
end

.soql_objects ⇒ Array

Returns List of Soql Objects identified for Leap Salesforce to maintain.

Returns:

  • (Array) —

    List of Soql Objects identified for Leap Salesforce to maintain



128
129
130
 
# File 'lib/leap_salesforce/parameters.rb', line 128

def soql_objects
  @soql_objects
end

Class Method Details

.api_user ⇒ String

Returns Salesforce username used to execute API tests. This can be changed during tests.

Returns:

  • (String) —

    Salesforce username used to execute API tests. This can be changed during tests



105
106
107
 
# File 'lib/leap_salesforce/parameters.rb', line 105

def api_user
  @api_user || LeapSalesforce::Users.list.first.username
end

.api_user=(user) ⇒ Object

Parameters:



95
96
97
98
99
100
101
102
 
# File 'lib/leap_salesforce/parameters.rb', line 95

def api_user=(user)
  @api_user = if user.is_a? String
                user
              else
                LeapSalesforce::Users.where(user)&.username
              end
  Soaspec::SpecLogger.info "Using user '#{@api_user}' for API"
end

.general_url ⇒ String

Returns General salesforce URL for logging in to.

Returns:

  • (String) —

    General salesforce URL for logging in to



90
91
92
 
# File 'lib/leap_salesforce/parameters.rb', line 90

def general_url
  "https://#{LeapSalesforce.environment == 'prod' ? 'login' : 'test'}.salesforce.com"
end

.oauth_settings ⇒ Hash

OAuth parameters when using a custom Connected application not using sfdx

Returns:

  • (Hash) —

    OAuth2 parameters used in connecting to salesforce



78
79
80
81
82
83
84
85
86
87
 
# File 'lib/leap_salesforce/parameters.rb', line 78

def oauth_settings
  settings = {
    username: '<%= LeapSalesforce.api_user %>', password: LeapSalesforce.password,
    client_id: LeapSalesforce.client_id,
    client_secret: LeapSalesforce.client_secret,
    token_url: "#{LeapSalesforce.general_url}/services/oauth2/token"
  }
  settings[:security_token] = LeapSalesforce.security_token if LeapSalesforce.security_token
  settings
end

.oauth_working? ⇒ TrueClass

Returns If OAuth authentication is working, return true. Otherwise raise exception.

Returns:

  • (TrueClass) —

    If OAuth authentication is working, return true. Otherwise raise exception



46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
 
# File 'lib/leap_salesforce/parameters.rb', line 46

def oauth_working?
  salesforce_reachable?
  if LeapSalesforce.sfdx
    sfdx_auth_setup?
  else
    Soaspec::OAuth2.debug_oauth = true
    Soaspec::OAuth2.new(LeapSalesforce.oauth_settings).access_token
  end
rescue StandardError => e
  raise LeapSalesforce::SetupError, "Cannot perform OAuth. See 'logs'" \
  ' folder for details of what was sent. ' \
  "Error caused by #{e.message} from #{e.backtrace}"
else
  puts "\u2713 OAuth successful".colorize :green
  Soaspec::OAuth2.debug_oauth = false
  true
end

.salesforce_reachable? ⇒ Boolean

Verify connection to Salesforce environment

Returns:

  • (Boolean) 


36
37
38
39
40
41
42
 
# File 'lib/leap_salesforce/parameters.rb', line 36

def salesforce_reachable?
  RestClient.get(LeapSalesforce.general_url)
rescue SocketError
  message = "Unable to connect to #{LeapSalesforce.general_url}. Potentially problem with" \
  ' internet or proxy settings'.colorize :red
  raise LeapSalesforce::SetupError, message
end

.sfdx_auth_setup? ⇒ Boolean

Checks whether sfdx is setup according to standard approach. Errors are logged

Returns:

  • (Boolean) —

    Whether sfdx is setup correctly

Raises:



67
68
69
70
71
72
73
 
# File 'lib/leap_salesforce/parameters.rb', line 67

def sfdx_auth_setup?
  Auth.manually_set_auth? || Auth.jwt_file?
  return true if LeapSalesforce::Auth.sfdx_variables?

  raise LeapSalesforce::SetupError, 'LeapSalesforce::Auth.access_token and ' \
       'instance_url were not able to be retrieved by sfdx'
end