leap_salesforce_ui 0.1.7 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 10d36f660f1fd79ec05c6dcf5a0571b8b9394154ee59bece411722672045d9cc
-  data.tar.gz: e4bb12986774537a04ec55759e3005da3e54b1825acd62ec4e0251e8fdbabd4c
+  metadata.gz: 9e1be86926699d819e7022902b56f15ac1b8bdf1e57a66558a26c4cfc5a2285d
+  data.tar.gz: 6b590aa9a06d618c77e55280b56903b92ed8eeb5a6bf1f550bd91575f8e25c96
 SHA512:
-  metadata.gz: 810cd99d1b6d9ff927cba94c9c680267c5005801210b5e9287229a897aa305befdb506c05cec90f55fb8dc2ae1949b47a5f33cb2855c0d5b417e5c20b2686f1f
-  data.tar.gz: cab59fba240bdad1a26b86166339ed1caa4e46cc6bacca7c7e2502b387c6343e3d8ba710c523c4cd25c6243fb085fd33788760ccb1e1c826d2c2cdb61fddd603
+  metadata.gz: d9f507fcef6ccc42efebaa071ca82c23d2da3647a3b2320269a42c02f226e1d3d2497212ae7192e4a27c002045e3b2223cdbcba37fcdd548a50a183b5b1fa756
+  data.tar.gz: 3c49e8e58f6101fc3cd1bf7f378c93d4490de36a5893af083a43b702f6f288419d0772c9a4185f30bf04e5556ddf5e25905acfbe5ca6226765ff744d41e22cf4

data/.gitlab-ci.yml

@@ -3,7 +3,7 @@ variables:
   client_id: $client_id
   client_secret: $client_secret
 
-test:
+.zal_test:
   services:
     - docker:19.03.5-dind
   image: docker:19.03.5
@@ -24,5 +24,18 @@ test:
   variables:
     BROWSER: chrome
 
+test:
+  image: ruby:2.7
+  script:
+    - export CHROME_VERSION="google-chrome-stable"
+    - wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -
+    - echo "deb http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list
+    - apt-get update -qqy
+    - apt-get -qqy install google-chrome-stable
+
+    - bundle install
+    - bundle exec rake leaps:create_poms
+    - bundle exec rake spec
+
 include:
   - template: Code-Quality.gitlab-ci.yml

data/.leap_salesforce.yml

@@ -5,3 +5,4 @@ soql_objects:
   - Contact
   - Account
   - Broker: Broker__c
+  - RecordType

data/ChangeLog

@@ -1,3 +1,22 @@
+Version 0.3.0
+* New
+  * Ability to set record type on creating an object with 'set_record_type' method
+* Fixed
+  * New syntax for clicking on dropdown/picklist
+
+Version 0.2.0
+* Pass in security token defined by leap_salesforce with convention ENV['KEY'_token] to SOAP
+  session login
+
+Version 0.1.9
+* Ability to login through SOAP session with the LeapSalesforce.login_through_session parameter
+
+Version 0.1.8
+* Fixed Watir version at 6.19. Need to update syntax to work with latest version
+
+Version 0.1.7
+* Fixed filling in form for Salesforce's new layout
+
 Version 0.1.6
 * Bug fix
   * Not appending to Gemfile meant Rakefile could not load leap_salesfore_ui rake tasks

data/README.md

@@ -100,13 +100,21 @@ RSpec.describe "Creating record" do
 end
 ```
 
-One doesn’t have to identify how to recognise first_name, last_name, etc. 
+One does not have to identify how to recognise first_name, last_name, etc. 
 From the metadata it works out what kind of field (textfield, textarea, reference) and then 
 finds the corresponding label and uses that to fill in the field.
 
 This test then uses the API to setup a dependent account (through FactoryBot) and then to find the contact 
 created to verify that what was entered on the UI was saved as expected.
 
+To specify a record_type, call the `set_record_type` method after the `visit` method.
+The default record type can be used by calling visit with
+```ruby
+visit(use_record_type: false)
+```
+
+> See create spec for example
+
 ### Manually specify label
 
 Sometimes the label on the UI does not match the metadata label. In that case, one case manually
@@ -132,6 +140,23 @@ To run tests in headless mode, set headless mode to true.
 LeapSalesforce.headless = true
 ```
 
+### Authentication
+If IP address for user profile is not allowed you will need to use a security token. See
+leap_salesforce for how to set this for each user's key through environment variables. 
+
+### Helpful commands
+
+Go to Salesforce instance defined by logging in
+```ruby
+LeapSalesforce.browser.goto SoqlHandler.instance_url
+```
+
+Login through SOAP session to get information for browser
+```ruby
+user = LeapSalesforce::Users.where username: LeapSalesforce.ui_user
+session = LeapSalesforce::Session.new user.username, LeapSalesforce.password,
+                                      user.security_token
+```
 
 ## Development
 

data/Rakefile

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "config/credentials/token" if File.exist? 'config/credentials/token.rb'
 require "bundler/gem_tasks"
 require "rspec/core/rake_task"
 require "leap_salesforce/rake"

data/install_chrome.sh

@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+export CHROME_VERSION="google-chrome-stable"
+wget -q -O - https://dl-ssl.google.com/linux/linux_signing_key.pub | apt-key add -
+echo "deb http://dl.google.com/linux/chrome/deb/ stable main" >> /etc/apt/sources.list.d/google-chrome.list
+apt-get update -qqy
+apt-get -qqy install google-chrome-stable

data/leap_salesforce_ui.gemspec

@@ -29,8 +29,8 @@ It reads the Metadata from Salesforce and creates the foundation for UI tests.'
   spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.add_dependency "leap_salesforce", ">= 1.0.3"
-  spec.add_dependency "watir", ">= 6.17.0"
+  spec.add_dependency "leap_salesforce", ">= 1.2.1"
+  spec.add_dependency "watir", "7"
   spec.add_dependency "webdrivers"
 
   # For more information and examples about making a new gem, checkout our

data/lib/leap_salesforce_ui/base_page.rb

@@ -15,9 +15,11 @@ module BasePage
   end
 
   # Visit the current page, logging in if required
-  def visit
+  # @param [Boolean] use_record_type Whether to specify record type
+  def visit(use_record_type: true)
     LoginPage.login
     page_url = "#{SoqlHandler.instance_url}/lightning/o/#{@soql_object.soql_object_name}/new"
+    page_url += '?useRecordTypeCheck=1' if use_record_type
     LeapSalesforce.logger.info "Visiting #{self}"
     browser.goto page_url
     self

data/lib/leap_salesforce_ui/create_page.rb

@@ -1,7 +1,9 @@
 # frozen_string_literal: true
+require_relative 'set_record_type'
 
 # Base class for creating entities in Salesforce
 class CreatePage
   extend BasePage
   extend LeapSalesforce::FormFiller
+  extend LeapSalesforce::SetRecordType
 end

data/lib/leap_salesforce_ui/form_filler.rb

@@ -89,7 +89,7 @@ module LeapSalesforce
     def set_picklist(label, value)
       LeapSalesforce.logger.info "Setting picklist, label '#{label}' with '#{value}'"
       field_transaction label, value do
-        dropdown = form.text_field(xpath: "//*[./*[text()='#{label}']]//following-sibling::div//input")
+        dropdown = form.button(xpath: "//*[./*[text()='#{label}']]//following-sibling::div//button")
         dropdown_id = dropdown.attribute "id"
         LeapSalesforce.logger.debug "Using dropdown id: #{dropdown_id}"
         dropdown.focus

data/lib/leap_salesforce_ui/login_page.rb

@@ -41,8 +41,18 @@ Go to #{DISABLE_2STEP_URL} to learn how to disable it"
     end
 
     def login
+      raise "Need to set LeapSalesforce.ui_user" unless LeapSalesforce.ui_user
       LeapSalesforce.logger.info "Logging in as user '#{LeapSalesforce.ui_user}'"
-      browser.goto "#{LeapSalesforce.general_url}/?un=#{LeapSalesforce.ui_user}&pw=#{LeapSalesforce.password}"
+      if LeapSalesforce.login_through_session
+        browser.goto SoqlHandler.instance_url
+        user = LeapSalesforce::Users.where username: LeapSalesforce.ui_user
+        session = LeapSalesforce::Session.new user.username, LeapSalesforce.password, user.security_token
+        browser.cookies.add "sid", session.session_id
+        browser.cookies.add "sidClient", session.user_id
+        browser.goto SoqlHandler.instance_url
+      else
+        browser.goto "#{LeapSalesforce.general_url}/?un=#{LeapSalesforce.ui_user}&pw=#{LeapSalesforce.password}"
+      end
       continue_button = browser.button(id: "thePage:inputForm:continue")
       if continue_button.exists?
         browser.checkbox(id: "thePage:inputForm:remember").set

data/lib/leap_salesforce_ui/set_record_type.rb

@@ -0,0 +1,12 @@
+module LeapSalesforce
+  module SetRecordType
+    # Set record type for an object before create form appears
+    def set_record_type(record_type)
+      LeapSalesforce.logger.info "Setting record type to '#{record_type}'"
+      option = browser.label(xpath: "//label[.//*[@class='slds-form-element__label' and text()='#{record_type}']]")
+      option.click
+      browser.button(text: 'Next').click
+      self
+    end
+  end
+end

data/lib/leap_salesforce_ui/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module LeapSalesforceUi
-  VERSION = "0.1.7"
+  VERSION = "0.3.0"
 end

data/lib/leap_salesforce_ui.rb

@@ -35,6 +35,8 @@ module LeapSalesforce
   @ui_user = nil
   # @return [Boolean] Whether to run in headless mode
   @headless = false
+  # @return [Boolean] Whether to login using session obtained via SOAP
+  @login_through_session = false
   class << self
     def browser(test_name = nil)
       @browser ||= new_browser(test_name)
@@ -50,6 +52,8 @@ module LeapSalesforce
 
     # @return [Boolean] Whether to run in headless mode. Default false
     attr_accessor :headless
+    # @return [Boolean] Whether to login using session obtained via SOAP
+    attr_accessor :login_through_session
 
     # @param [String, Symbol, Regexp, LeapSalesforce::User] user User or email address of user
     def ui_user=(user)
@@ -66,7 +70,7 @@ module LeapSalesforce
     def new_browser(test_name = nil)
       if ENV["WEBDRIVER_URL"]
         # TODO: Get working on Ruby 3
-        Watir::Browser.new :chrome, { **zalenium_args("LeapSalesforce", test_name || "Test") }
+        Watir::Browser.new :chrome, options: { **zalenium_args("LeapSalesforce", test_name || "Test") }
       else
         args = {}
         args[:headless] = true if headless

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: leap_salesforce_ui
 version: !ruby/object:Gem::Version
-  version: 0.1.7
+  version: 0.3.0
 platform: ruby
 authors:
 - IQA
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-08-14 00:00:00.000000000 Z
+date: 2022-02-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: leap_salesforce
@@ -17,28 +17,28 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 1.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.3
+        version: 1.2.1
 - !ruby/object:Gem::Dependency
   name: watir
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: 6.17.0
+        version: '7'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: 6.17.0
+        version: '7'
 - !ruby/object:Gem::Dependency
   name: webdrivers
   requirement: !ruby/object:Gem::Requirement
@@ -83,6 +83,7 @@ files:
 - config/general.rb
 - docker-compose.yml
 - exe/leap_salesforce_ui
+- install_chrome.sh
 - leap_salesforce_ui.gemspec
 - lib/leap_salesforce_ui.rb
 - lib/leap_salesforce_ui/base_page.rb
@@ -102,6 +103,7 @@ files:
 - lib/leap_salesforce_ui/page_introspection.rb
 - lib/leap_salesforce_ui/rake.rb
 - lib/leap_salesforce_ui/rake/pom.rake
+- lib/leap_salesforce_ui/set_record_type.rb
 - lib/leap_salesforce_ui/update_page.rb
 - lib/leap_salesforce_ui/version.rb
 - lib/leap_salesforce_ui/view_page.rb