testcentricity 2.3.13

data/lib/testcentricity/app_core/appium_connect_helper.rb

@@ -0,0 +1,154 @@
+require 'appium_lib'
+
+
+module TestCentricity
+  module AppiumConnect
+
+    attr_accessor :running
+    attr_accessor :config_file
+
+    def self.initialize_appium(project_path = nil)
+      Environ.platform    = :mobile
+      Environ.driver      = :appium
+      Environ.device_type = ENV['DEVICE_TYPE'] if ENV['DEVICE_TYPE']
+
+      @config_file = project_path
+
+      if project_path.nil?
+        Environ.device_name = ENV['APP_DEVICE']
+        Environ.device_os   = ENV['APP_PLATFORM_NAME']
+        Environ.device_orientation = ENV['ORIENTATION'] if ENV['ORIENTATION']
+        if ENV['UDID']
+          Environ.device = :device
+        else
+          Environ.device = :simulator
+        end
+      end
+      @running = false
+    end
+
+    def self.start_driver
+      if @config_file.nil?
+        desired_capabilities = {
+            caps: {
+                platformName:    ENV['APP_PLATFORM_NAME'],
+                platformVersion: ENV['APP_VERSION'],
+                deviceName:      ENV['APP_DEVICE'],
+                automationName:  ENV['AUTOMATION_ENGINE']
+            }
+        }
+        capabilities = desired_capabilities[:caps]
+        capabilities[:avd] = ENV['APP_DEVICE'] if ENV['APP_PLATFORM_NAME'].downcase.to_sym == :android
+        capabilities[:orientation] = ENV['ORIENTATION'].upcase if ENV['ORIENTATION']
+        capabilities[:language] = ENV['LANGUAGE'] if ENV['LANGUAGE']
+        capabilities[:locale] = ENV['LOCALE'].gsub('-', '_') if ENV['LOCALE']
+        capabilities[:newCommandTimeout] = ENV['NEW_COMMAND_TIMEOUT'] if ENV['NEW_COMMAND_TIMEOUT']
+        capabilities[:noReset] = ENV['APP_NO_RESET'] if ENV['APP_NO_RESET']
+        capabilities[:fullReset] = ENV['APP_FULL_RESET'] if ENV['APP_FULL_RESET']
+        if ENV['UDID']
+          capabilities[:udid] = ENV['UDID']
+          capabilities[:bundleId] = ENV['BUNDLE_ID'] if ENV['BUNDLE_ID']
+          capabilities[:xcodeOrgId] = ENV['TEAM_ID'] if ENV['TEAM_ID']
+          capabilities[:xcodeSigningId] = ENV['TEAM_NAME'] if ENV['TEAM_NAME']
+          capabilities[:appActivity] = ENV['APP_ACTIVITY'] if ENV['APP_ACTIVITY']
+          capabilities[:appPackage] = ENV['APP_PACKAGE'] if ENV['APP_PACKAGE']
+        end
+
+        if ENV['APP']
+          capabilities[:app] = ENV['APP']
+        else
+          if Environ.is_android?
+            capabilities[:app] = Environ.current.android_apk_path
+          elsif Environ.is_ios?
+            if Environ.is_device?
+              capabilities[:app] = Environ.current.ios_ipa_path
+            else
+              capabilities[:app] = Environ.current.ios_app_path
+            end
+          end
+        end
+
+      else
+        base_path = 'config'
+        unless File.directory?(File.join(@config_file, base_path))
+          raise 'Could not find appium.txt files in /config folder'
+        end
+        appium_caps = File.join(@config_file, base_path, 'appium.txt')
+        desired_capabilities = Appium.load_appium_txt file: appium_caps
+      end
+      Appium::Driver.new(desired_capabilities).start_driver
+      @running = true
+      Appium.promote_appium_methods TestCentricity::ScreenObject
+      Appium.promote_appium_methods TestCentricity::AppUIElement
+    end
+
+    def self.quit_driver
+      if @running
+        $driver.driver_quit
+        @running = false
+      end
+    end
+
+    def self.driver
+      $driver
+    end
+
+    def self.take_screenshot(png_save_path)
+      FileUtils.mkdir_p(File.dirname(png_save_path))
+      $driver.driver.save_screenshot(png_save_path)
+    end
+
+    def self.install_app(app_path)
+      $driver.install_app(app_path)
+    end
+
+    def self.app_installed?(bundle_id)
+      $driver.app_installed?(bundle_id)
+    end
+
+    def self.launch_app
+      $driver.launch_app
+    end
+
+    def self.close_app
+      $driver.close_app
+    end
+
+    def self.reset_app
+      $driver.reset
+    end
+
+    def self.remove_app(bundle_id)
+      $driver.remove_app(bundle_id)
+    end
+
+    def self.implicit_wait(timeout)
+      $driver.manage.timeouts.implicit_wait = timeout
+    end
+
+    def self.hide_keyboard
+      $driver.hide_keyboard
+    end
+
+    def self.keyboard_shown?
+      $driver.is_keyboard_shown
+    end
+
+    def self.set_geolocation(latitude, longitude, altitude)
+      $driver.set_location(latitude, longitude, altitude)
+    end
+
+    def self.current_context
+      $driver.current_context
+    end
+
+    def self.set_context(context)
+      $driver.set_context(context)
+    end
+
+    def self.available_contexts
+      $driver.available_contexts
+    end
+  end
+end
+

data/lib/testcentricity/app_core/appium_server.rb

@@ -0,0 +1,69 @@
+require 'childprocess'
+
+#
+# This class is designed to start and stop the Appium Server process.  In order to use it you must have Appium
+# and node installed on your computer.  You can pass parameters to Appium at startup via the constructor.
+#
+module TestCentricity
+  class AppiumServer
+
+    attr_accessor :process
+
+    def initialize(params={})
+      @params = params
+    end
+
+    #
+    # Start the Appium Server
+    #
+    def start
+      # terminate any currently running Appium Server
+      if running?
+        system('killall -9 node')
+        puts 'Terminating existing Appium Server'
+        sleep(5)
+        puts 'Appium Server is being restarted'
+      else
+        puts 'Appium Server is being started'
+      end
+      # start new Appium Server
+      @process = ChildProcess.build(*parameters)
+      process.start
+      # wait until confirmation that Appium Server is running
+      wait = Selenium::WebDriver::Wait.new(timeout: 30)
+      wait.until { running? }
+      puts "Appium Server is running - PID = #{process.pid}"
+    end
+
+    #
+    # Check to see if Appium Server is running
+    #
+    def running?
+      response = nil
+      begin
+        response = Net::HTTP.get_response(URI('http://127.0.0.1:4723/wd/hub/sessions'))
+      rescue
+      end
+      response && response.code_type == Net::HTTPOK
+    end
+
+    #
+    # Stop the Appium Server
+    #
+    def stop
+      process.stop
+      puts 'Appium Server has been terminated'
+    end
+
+    private
+
+    def parameters
+      cmd = ['appium']
+      @params.each do |key, value|
+        cmd << '--' + key.to_s
+        cmd << value.to_s if not value.nil? and value.size > 0
+      end
+      cmd
+    end
+  end
+end

data/lib/testcentricity/app_core/screen_objects_helper.rb

@@ -0,0 +1,180 @@
+require 'test/unit'
+
+module TestCentricity
+  class ScreenObject
+    include Test::Unit::Assertions
+
+    attr_reader :strategy, :locator
+
+    def initialize
+      raise "Screen object #{self.class.name} does not have a page_locator trait defined" unless defined?(page_locator)
+      @strategy = page_locator[0].to_sym
+      @locator  = page_locator[1]
+    end
+
+    def self.trait(trait_name, &block)
+      define_method(trait_name.to_s, &block)
+    end
+
+    def self.element(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppUIElement.new("#{element_name}", self, "#{strategy}", "#{locator}", :page);end))
+    end
+
+    def self.button(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppButton.new("#{element_name}", self, "#{strategy}", "#{locator}", :page);end))
+    end
+
+    def self.textfield(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppTextField.new("#{element_name}", self, "#{strategy}", "#{locator}", :page);end))
+    end
+
+    def self.switch(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppSwitch.new("#{element_name}", self, "#{strategy}", "#{locator}", :page);end))
+    end
+
+    def self.checkbox(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppCheckBox.new("#{element_name}", self, "#{strategy}", "#{locator}", :page);end))
+    end
+
+    def self.label(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppLabel.new("#{element_name}", self, "#{strategy}", "#{locator}", :page);end))
+    end
+
+    def self.list(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppList.new("#{element_name}", self, "#{strategy}", "#{locator}", :page);end))
+    end
+
+    def self.section(section_name, class_name)
+      class_eval(%(def #{section_name};@#{section_name} ||= #{class_name}.new("#{section_name}", self, :page);end))
+    end
+
+    def open_portal
+      environment = Environ.current
+
+      Environ.portal_state = :open
+    end
+
+    def verify_page_exists
+      wait = Selenium::WebDriver::Wait.new(timeout: Environ.default_max_wait_time)
+      wait.until { $driver.find_element(@strategy.to_sym, @locator).displayed? }
+      PageManager.current_page = self
+    rescue
+      raise "Could not find page_locator for screen object '#{self.class.name}' (:#{@strategy}, #{@locator}) after #{Environ.default_max_wait_time} seconds"
+    end
+
+    def navigate_to; end
+
+    def verify_page_ui; end
+
+    def load_page
+      verify_page_exists
+      PageManager.current_page = self
+    end
+
+
+
+    def verify_ui_states(ui_states)
+      ui_states.each do |ui_object, object_states|
+        object_states.each do |property, state|
+
+
+          puts "#{ui_object.get_name} - #{property} = #{state}" if ENV['DEBUG']
+
+
+          case property
+          when :exists
+            actual = ui_object.exists?
+          when :enabled
+            actual = ui_object.enabled?
+          when :disabled
+            actual = ui_object.disabled?
+          when :visible
+            actual = ui_object.visible?
+          when :hidden
+            actual = ui_object.hidden?
+          when :checked
+            actual = ui_object.checked?
+          when :selected
+            actual = ui_object.selected?
+          when :value
+            actual = ui_object.get_value
+          when :caption
+            actual = ui_object.get_caption
+          when :name
+            actual = ui_object.tag_name
+          when :placeholder
+            actual = ui_object.get_placeholder
+          when :items
+            actual = ui_object.get_list_items
+          when :itemcount
+            actual = ui_object.get_item_count
+          end
+
+          if state.is_a?(Hash) && state.length == 1
+            error_msg = "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) #{property} property to"
+            state.each do |key, value|
+              case key
+              when :lt, :less_than
+                ExceptionQueue.enqueue_exception("#{error_msg} be less than #{value} but found '#{actual}'") unless actual < value
+              when :lt_eq, :less_than_or_equal
+                ExceptionQueue.enqueue_exception("#{error_msg} be less than or equal to #{value} but found '#{actual}'") unless actual <= value
+              when :gt, :greater_than
+                ExceptionQueue.enqueue_exception("#{error_msg} be greater than #{value} but found '#{actual}'") unless actual > value
+              when :gt_eq, :greater_than_or_equal
+                ExceptionQueue.enqueue_exception("#{error_msg} be greater than or equal to  #{value} but found '#{actual}'") unless actual >= value
+              when :starts_with
+                ExceptionQueue.enqueue_exception("#{error_msg} start with '#{value}' but found '#{actual}'") unless actual.start_with?(value)
+              when :ends_with
+                ExceptionQueue.enqueue_exception("#{error_msg} end with '#{value}' but found '#{actual}'") unless actual.end_with?(value)
+              when :contains
+                ExceptionQueue.enqueue_exception("#{error_msg} contain '#{value}' but found '#{actual}'") unless actual.include?(value)
+              when :not_contains, :does_not_contain
+                ExceptionQueue.enqueue_exception("#{error_msg} not contain '#{value}' but found '#{actual}'") if actual.include?(value)
+              when :not_equal
+                ExceptionQueue.enqueue_exception("#{error_msg} not equal '#{value}' but found '#{actual}'") if actual == value
+              when :like, :is_like
+                actual_like = actual.delete("\n")
+                actual_like = actual_like.delete("\r")
+                actual_like = actual_like.delete("\t")
+                actual_like = actual_like.delete(' ')
+                actual_like = actual_like.downcase
+                expected    = value.delete("\n")
+                expected    = expected.delete("\r")
+                expected    = expected.delete("\t")
+                expected    = expected.delete(' ')
+                expected    = expected.downcase
+                ExceptionQueue.enqueue_exception("#{error_msg} be like '#{value}' but found '#{actual}'") unless actual_like.include?(expected)
+              when :translate
+                expected = I18n.t(value)
+                ExceptionQueue.enqueue_assert_equal(expected, actual, "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) translated #{property} property")
+              end
+            end
+          else
+            ExceptionQueue.enqueue_assert_equal(state, actual, "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) #{property} property")
+          end
+        end
+      end
+      ExceptionQueue.post_exceptions
+    end
+
+    def populate_data_fields(data, wait_time = nil)
+      timeout = wait_time.nil? ? 5 : wait_time
+      data.each do |data_field, data_param|
+        unless data_param.blank?
+          # make sure the intended UI target element is visible before trying to set its value
+          data_field.wait_until_visible(timeout)
+          if data_param == '!DELETE'
+            data_field.clear
+          else
+            case data_field.get_object_type
+            when :checkbox
+              data_field.set_checkbox_state(data_param.to_bool)
+            when :textfield
+              data_field.set("#{data_param}\t")
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/testcentricity/app_core/screen_sections_helper.rb

@@ -0,0 +1,332 @@
+require 'test/unit'
+
+module TestCentricity
+  class ScreenSection
+    include Test::Unit::Assertions
+
+    attr_reader   :context, :name
+    attr_accessor :locator
+    attr_accessor :parent
+    attr_accessor :strategy
+    attr_accessor :parent_list
+    attr_accessor :list_index
+
+    def initialize(name, parent, context)
+      @name        = name
+      @parent      = parent
+      @context     = context
+      @parent_list = nil
+      @list_index  = nil
+      @strategy    = nil
+      @locator     = nil
+    end
+
+    def get_locator
+      if @locator.nil? && defined?(section_locator)
+        @strategy = section_locator[0]
+        @locator  = section_locator[1]
+      end
+
+      locators = []
+      if @context == :section && !@parent.nil?
+        parent_strategy, parent_locator = @parent.get_locator
+      end
+
+      if @parent_list.nil?
+        if parent_strategy == @strategy
+          locators.push([@strategy, @locator])
+        else
+          locators.push([parent_strategy, parent_locator]) unless parent_strategy.nil?
+          locators.push([@strategy, "#{parent_locator}#{@locator}"])
+        end
+      else
+        list_strategy, list_locator = @parent_list.get_locator
+        if parent_strategy == list_strategy
+          list_locator = "#{parent_locator}#{list_locator}"
+        else
+          locators.push([parent_strategy, parent_locator]) unless parent_strategy.nil?
+        end
+        if list_strategy == @strategy
+          obj_locator = "#{list_locator}#{@locator}"
+        else
+          obj_locator = @locator
+          locators.push([list_strategy, list_locator])
+        end
+        unless @list_index.nil?
+          obj_locator = "#{obj_locator}[#{@list_index}]"
+        end
+        locators.push([@strategy, obj_locator])
+      end
+      locators
+    end
+
+
+    def set_list_index(list, index = 1)
+      @parent_list = list unless list.nil?
+      @list_index  = index
+    end
+
+    def get_item_count
+      raise 'No parent list defined' if @parent_list.nil?
+      @parent_list.get_item_count
+    end
+
+    def get_list_items
+      items = []
+      (1..get_item_count).each do |item|
+        set_list_index(nil, item)
+        items.push(get_value)
+      end
+      items
+    end
+
+    def get_object_type
+      :section
+    end
+
+    def get_name
+      @name
+    end
+
+    def set_parent(parent)
+      @parent = parent
+    end
+
+
+    def self.trait(trait_name, &block)
+      define_method(trait_name.to_s, &block)
+    end
+
+    def self.element(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppUIElement.new("#{element_name}", self, "#{strategy}", "#{locator}", :section);end))
+    end
+
+    def self.button(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppButton.new("#{element_name}", self, "#{strategy}", "#{locator}", :section);end))
+    end
+
+    def self.textfield(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppTextField.new("#{element_name}", self, "#{strategy}", "#{locator}", :section);end))
+    end
+
+    def self.switch(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppSwitch.new("#{element_name}", self, "#{strategy}", "#{locator}", :section);end))
+    end
+
+    def self.checkbox(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppCheckBox.new("#{element_name}", self, "#{strategy}", "#{locator}", :section);end))
+    end
+
+    def self.label(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppLabel.new("#{element_name}", self, "#{strategy}", "#{locator}", :section);end))
+    end
+
+    def self.list(element_name, strategy, locator)
+      class_eval(%(def #{element_name};@#{element_name} ||= TestCentricity::AppList.new("#{element_name}", self, "#{strategy}", "#{locator}", :section);end))
+    end
+
+    def self.section(section_name, class_name)
+      class_eval(%(def #{section_name};@#{section_name} ||= #{class_name}.new("#{section_name}", self, :section);end))
+    end
+
+
+
+    def click
+      section = find_section
+      raise "Section object '#{get_name}' (#{get_locator}) not found" unless section
+      section.click
+    end
+
+    def tap
+      section = find_section
+      raise "Section object '#{get_name}' (#{get_locator}) not found" unless section
+      x = section.location.x
+      y = section.location.y
+      tap_action = Appium::TouchAction.new.tap(element: section, x: x, y: y)
+      tap_action.perform
+    end
+
+    def double_tap
+      section = find_section
+      raise "Section object '#{get_name}' (#{get_locator}) not found" unless section
+      x = section.location.x
+      y = section.location.y
+      tap_action = Appium::TouchAction.new.double_tap(element: section, x: x, y: y)
+      tap_action.perform
+    end
+
+    def exists?
+      section = find_section
+      section != nil
+    end
+
+    def enabled?
+      section = find_section
+      raise "Section object '#{get_name}' (#{get_locator}) not found" unless section
+      section.enabled?
+    end
+
+    def disabled?
+      section = find_section
+      raise "Section object '#{get_name}' (#{get_locator}) not found" unless section
+      section.enabled?
+    end
+
+    def visible?
+      if exists?
+        section.displayed?
+      else
+        false
+      end
+    end
+
+    def hidden?
+      !visible?
+    end
+
+    def wait_until_exists(seconds = nil)
+      timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { exists? }
+    rescue
+      raise "Could not find Section object '#{get_name}' (#{get_locator}) after #{timeout} seconds" unless exists?
+    end
+
+    def wait_until_gone(seconds = nil)
+      timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { !exists? }
+    rescue
+      raise "Section object '#{get_name}' (#{get_locator}) remained visible after #{timeout} seconds" if exists?
+    end
+
+    def wait_until_visible(seconds = nil)
+      timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { visible? }
+    rescue
+      raise "Could not find Section object '#{get_name}' (#{get_locator}) after #{timeout} seconds" unless visible?
+    end
+
+    def wait_until_hidden(seconds = nil)
+      timeout = seconds.nil? ? Environ.default_max_wait_time : seconds
+      wait = Selenium::WebDriver::Wait.new(timeout: timeout)
+      wait.until { hidden? }
+    rescue
+      raise "Section object '#{get_name}' (#{get_locator}) remained visible after #{timeout} seconds" if visible?
+    end
+
+
+    def verify_ui_states(ui_states)
+      ui_states.each do |ui_object, object_states|
+        object_states.each do |property, state|
+
+
+          puts "#{ui_object.get_name} - #{property} = #{state}" if ENV['DEBUG']
+
+
+          case property
+          when :exists
+            actual = ui_object.exists?
+          when :enabled
+            actual = ui_object.enabled?
+          when :disabled
+            actual = ui_object.disabled?
+          when :visible
+            actual = ui_object.visible?
+          when :hidden
+            actual = ui_object.hidden?
+          when :checked
+            actual = ui_object.checked?
+          when :selected
+            actual = ui_object.selected?
+          when :value
+            actual = ui_object.get_value
+          when :caption
+            actual = ui_object.get_caption
+          when :name
+            actual = ui_object.tag_name
+          when :placeholder
+            actual = ui_object.get_placeholder
+          when :items
+            actual = ui_object.get_list_items
+          when :itemcount
+            actual = ui_object.get_item_count
+          end
+
+          if state.is_a?(Hash) && state.length == 1
+            error_msg = "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) #{property} property to"
+            state.each do |key, value|
+              case key
+              when :lt, :less_than
+                ExceptionQueue.enqueue_exception("#{error_msg} be less than #{value} but found '#{actual}'") unless actual < value
+              when :lt_eq, :less_than_or_equal
+                ExceptionQueue.enqueue_exception("#{error_msg} be less than or equal to #{value} but found '#{actual}'") unless actual <= value
+              when :gt, :greater_than
+                ExceptionQueue.enqueue_exception("#{error_msg} be greater than #{value} but found '#{actual}'") unless actual > value
+              when :gt_eq, :greater_than_or_equal
+                ExceptionQueue.enqueue_exception("#{error_msg} be greater than or equal to  #{value} but found '#{actual}'") unless actual >= value
+              when :starts_with
+                ExceptionQueue.enqueue_exception("#{error_msg} start with '#{value}' but found '#{actual}'") unless actual.start_with?(value)
+              when :ends_with
+                ExceptionQueue.enqueue_exception("#{error_msg} end with '#{value}' but found '#{actual}'") unless actual.end_with?(value)
+              when :contains
+                ExceptionQueue.enqueue_exception("#{error_msg} contain '#{value}' but found '#{actual}'") unless actual.include?(value)
+              when :not_contains, :does_not_contain
+                ExceptionQueue.enqueue_exception("#{error_msg} not contain '#{value}' but found '#{actual}'") if actual.include?(value)
+              when :not_equal
+                ExceptionQueue.enqueue_exception("#{error_msg} not equal '#{value}' but found '#{actual}'") if actual == value
+              when :like, :is_like
+                actual_like = actual.delete("\n")
+                actual_like = actual_like.delete("\r")
+                actual_like = actual_like.delete("\t")
+                actual_like = actual_like.delete(' ')
+                actual_like = actual_like.downcase
+                expected    = value.delete("\n")
+                expected    = expected.delete("\r")
+                expected    = expected.delete("\t")
+                expected    = expected.delete(' ')
+                expected    = expected.downcase
+                ExceptionQueue.enqueue_exception("#{error_msg} be like '#{value}' but found '#{actual}'") unless actual_like.include?(expected)
+              when :translate
+                expected = I18n.t(value)
+                ExceptionQueue.enqueue_assert_equal(expected, actual, "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) translated #{property} property")
+              end
+            end
+          else
+            ExceptionQueue.enqueue_assert_equal(state, actual, "Expected UI object '#{ui_object.get_name}' (#{ui_object.get_locator}) #{property} property")
+          end
+        end
+      end
+      ExceptionQueue.post_exceptions
+    end
+
+    def populate_data_fields(data, wait_time = nil)
+      timeout = wait_time.nil? ? 5 : wait_time
+      data.each do |data_field, data_param|
+        unless data_param.blank?
+          # make sure the intended UI target element is visible before trying to set its value
+          data_field.wait_until_visible(timeout)
+          if data_param == '!DELETE'
+            data_field.clear
+          else
+            case data_field.get_object_type
+            when :checkbox
+              data_field.set_checkbox_state(data_param.to_bool)
+            when :textfield
+              data_field.set("#{data_param}\t")
+            end
+          end
+        end
+      end
+    end
+
+    private
+
+    def find_section
+      find_element(@strategy, @locator)
+    rescue
+      nil
+    end
+  end
+end