awetestlib 0.1.2 → 0.1.5

data/lib/regression/utilities.rb

@@ -1,891 +0,0 @@
-module Utilities
-
-  # Place holder to prevent method not found error in scripts
-  def set_script_variables
-    # TODO: replace with method_missing?
-  end
-
-  def setup
-    #    if @os_sysname =~ /Windows.+Server\s+2003/
-    ##  'Microsoft(R) Windows(R) Server 2003, Enterprise Edition'
-    #      @vertical_hack_ie   = 110
-    #      @vertical_hack_ff   = 138
-    #      @horizontal_hack_ie = 5
-    #      @horizontal_hack_ff = 4
-    #    elsif @os_sysname =~ /Windows XP Professional/
-    #  'Microsoft Windows XP Professional'
-    @vertical_hack_ie        = 118
-    @vertical_hack_ff        = 144
-    @horizontal_hack_ie      = 5
-    @horizontal_hack_ff      = 4
-    #end
-
-    @settings_display_ids    = Hash[
-        "Currency"       => "row-currencyName",
-        "Description"    => "row-description",
-        "Tx Date"        => "row-fmtDate",
-        "Total"          => "row-amount",
-        "[currencyCode]" => "row-currencyCode",
-        "Date in Millis" => "row-dateInMilliseconds",
-    ]
-    @column_data_display_ids = Hash[
-        "Currency"       => "yui-dt0-th-currencyName",
-        "Description"    => "yui-dt0-th-description",
-        "Tx Date"        => "yui-dt0-th-fmtDate",
-        "Total"          => "yui-dt0-th-fmtDate",
-        "[currencyCode]" => "yui-dt0-th-currencyCode",
-        "Date in Millis" => "yui-dt0-th-dateInMilliseconds",
-    ]
-    @settings_panel_index    = 0
-    @x_tolerance             = 4
-    @y_tolerance             = 4
-  end
-
-  def get_trace(lnbr)
-    callertrace = "\nCaller trace: (#{lnbr})\n"
-    Kernel.caller.each_index do |x|
-      callertrace << '    >> ' + Kernel.caller[x].to_s + "\n"
-    end
-    callertrace
-  end
-
-  alias dump_caller get_trace
-
-  def get_mdyy(t = Time.now)
-    "#{t.month}/#{t.day}/#{t.year}"
-  end
-
-  def get_prefix(strg, offset)
-    a_slice = strg.slice(0, offset)
-    a_slice.downcase
-  end
-
-  def get_timestamp(format = 'long', offset = nil, offset_unit = :years)
-    t = DateTime.now
-    if offset
-      t = t.advance(offset_unit => offset)
-    end
-    case format
-      when 'dateonly'
-        t.strftime("%m/%d/%Y")
-      when 'condensed'
-        t.strftime("%Y%m%d%H%M")
-      when 'condensed_seconds'
-        t.strftime("%Y%m%d%H%M%S")
-      when 'long'
-        t.strftime("%m/%d/%Y %I:%M %p")
-      when 'mdyy'
-        get_mdyy(t)
-      when 'm/d/y'
-        get_mdyy(t)
-      else
-        Time.now.strftime("%m/%d/%Y %H:%M:%S")
-    end
-  end
-
-  def calc_index(index, every = 1)
-    (index / every) + (every - 1)
-  end
-
-  def get_variables(file, login = :role, dbg = true)
-    debug_to_log("#{__method__}: file = #{file}")
-    debug_to_log("#{__method__}: role = #{login}")
-
-    @var                   = Hash.new
-    workbook               = Excel.new(file)
-    data_index             = find_sheet_with_name(workbook, 'Data')
-    workbook.default_sheet = workbook.sheets[data_index]
-    var_col                = 0
-
-    2.upto(workbook.last_column) do |col|
-      scriptName = workbook.cell(1, col)
-      if scriptName == @myName
-        var_col = col
-        break
-      end
-    end
-
-    2.upto(workbook.last_row) do |line|
-      name       = workbook.cell(line, 'A')
-      value      = workbook.cell(line, var_col).to_s.strip
-      @var[name] = value
-    end
-
-    @var.keys.sort.each do |name|
-      message_tolog("@var #{name}: '#{@var[name]}'")
-    end if dbg
-
-    @login       = Hash.new
-    login_col    = 0
-    role_col     = 0
-    userid_col   = 0
-    password_col = 0
-    url_col      = 0
-    name_col     = 0
-    role_index   = find_sheet_with_name(workbook, 'Login')
-    if role_index >= 0
-      workbook.default_sheet = workbook.sheets[role_index]
-
-      1.upto(workbook.last_column) do |col|
-        a_cell = workbook.cell(1, col)
-        case a_cell
-          when @myName
-            login_col = col
-            break
-          when 'role'
-            role_col = col
-          when 'userid'
-            userid_col = col
-          when 'password'
-            password_col = col
-          when 'url'
-            url_col = col
-          when 'name'
-            name_col = col
-        end
-      end
-
-      2.upto(workbook.last_row) do |line|
-        role     = workbook.cell(line, role_col)
-        userid   = workbook.cell(line, userid_col)
-        password = workbook.cell(line, password_col)
-        url      = workbook.cell(line, url_col)
-        username = workbook.cell(line, name_col)
-        enabled  = workbook.cell(line, login_col).to_s
-
-        case login
-          when :id
-            key = userid
-          when :role
-            key = role
-          else
-            key = role
-        end
-
-        @login[key]             = Hash.new
-        @login[key]['role']     = role
-        @login[key]['userid']   = userid
-        @login[key]['password'] = password
-        @login[key]['url']      = url
-        @login[key]['name']     = username
-        @login[key]['enabled']  = enabled
-
-      end
-
-      @login.keys.sort.each do |key|
-        message_tolog("@login (by #{login}): #{key}=>'#{@login[key].to_yaml}'")
-      end if dbg
-    end
-
-  rescue
-    fatal_to_log("#{__method__}: '#{$!}'")
-  end
-
-  def translate_var_list(key)
-    if @var[key] and @var[key].length > 0
-      list = @var[key].dup
-      unless list =~ /^\[.+\]$/
-        list = "[#{list}]"
-      end
-      eval(list)
-    end
-  rescue
-    failed_to_log("#{__method__}: '#{$!}'")
-  end
-
-  def grab_window_list(strg)
-    @ai.AutoItSetOption("WinTitleMatchMode", 2)
-    list    = @ai.WinList(strg)
-    stuff   = ''
-    names   = list[0]
-    handles = list[1]
-    max     = names.length - 1
-    rng     = Range.new(0, max)
-    rng.each do |idx|
-      window_handle = "[HANDLE:#{handles[idx]}]"
-      full_text     = @ai.WinGetText(window_handle)
-      stuff << "[#{handles[idx]}]=>#{names[idx]}=>'#{full_text}'\n"
-    end
-    debug_to_log("\n#{stuff}")
-    @ai.AutoItSetOption("WinTitleMatchMode", 1)
-    stuff
-  end
-
-  def debug_call_list(msg)
-    call_array = get_call_array
-    debug_to_log("#{msg}\n#{dump_array(call_array)}")
-  end
-
-  def sec2hms(s)
-    Time.at(s.to_i).gmtime.strftime('%H:%M:%S')
-  end
-
-  def close_log(scriptName, lnbr = '')
-    cmplTS = Time.now.to_f.to_s
-    puts ("#{scriptName} finished.  Closing log. #{lnbr.to_s}")
-    passed_to_log("#{scriptName} run complete [#{cmplTS}]")
-    @myLog.close()
-    sleep(2)
-  end
-
-  protected :close_log
-
-  def find_sheet_with_name(workbook, sheet_name)
-    sheets = workbook.sheets
-    idx    = 0
-    found  = false
-    sheets.each do |s|
-      if s == sheet_name
-        found = true
-        break
-      end
-      idx += 1
-    end
-    if found
-      idx
-    else
-      -1
-    end
-  end
-
-  def nice_array(arr, space_to_underscore = false)
-    new_arr = Array.new
-    if space_to_underscore
-      arr.each do |nty|
-        new_arr << nty.gsub(/\s/, '_')
-      end
-    else
-      new_arr = arr
-    end
-    "['#{new_arr.join("','")}']"
-  end
-
-  def string_count_in_string(strg, substrg)
-    count = strg.scan(substrg).length
-    count
-  end
-
-  def rescue_me(e, me = nil, what = nil, where = nil, who = nil)
-    #TODO: these are rescues from exceptions raised in Watir/Firewatir
-    debug_to_log("#{__method__}: Begin rescue")
-    ok = false
-    begin
-      gaak    = who.inspect
-      located = gaak =~ /located=true/i
-    rescue
-      debug_to_log("#{__method__}: gaak: '#{gaak}'")
-    end
-    msg = e.message
-    debug_to_log("#{__method__}: msg = #{msg}")
-    if  msg =~ /undefined method\s+.join.\s+for/i # firewatir to_s implementation error
-      ok = true
-    elsif msg =~ /undefined method\s+.match.\s+for.+WIN32OLERuntimeError/i # watir and firewatir
-      ok = true
-    elsif msg =~ /undefined method\s+.match.\s+for.+UnknownObjectException/i # watir
-      ok = true
-    elsif msg =~ /window\.getBrowser is not a function/i # firewatir
-      ok = true
-    elsif msg =~ /WIN32OLERuntimeError/i # watir
-      ok = true
-    elsif msg =~ /undefined method\s+.match.\s+for/i # watir
-      ok = true
-    elsif msg =~ /wrong number of arguments \(1 for 0\)/i
-      ok = true
-    elsif (msg =~ /unable to locate element/i)
-      if located
-        ok = true
-      elsif where == 'Watir::Div'
-        ok = true
-      end
-    elsif (msg =~ /HRESULT error code:0x80070005/)
-      ok = true
-                                                  #elsif msg =~ /missing\s+\;\s+before statement/
-                                                  #  ok = true
-    end
-    if ok
-      debug_to_log("#{__method__}: RESCUED: \n#{who.to_yaml}=> #{what} in #{me}()\n=> '#{$!}'")
-      debug_to_log("#{__method__}: #{who.inspect}") if who
-      debug_to_log("#{__method__}: #{where.inspect}")
-      debug_to_log("#{__method__}: #{get_callers(6, true)}")
-    else
-      debug_to_log("#{__method__}: NO RESCUE: #{e.message}")
-      debug_to_log("#{__method__}: NO RESCUE: \n#{get_callers(6, true)}")
-    end
-    debug_to_log("#{__method__}: Exit")
-    ok
-  end
-
-  def get_caller_line
-    last_caller = get_callers[0]
-    line        = last_caller.split(':', 3)[1]
-    line
-  end
-
-  def get_call_list(depth = 9, dbg = false)
-    myList    = []
-    call_list = Kernel.caller
-    puts call_list if dbg
-    call_list.each_index do |x|
-      myCaller = call_list[x].to_s
-      break if x > depth or myCaller =~ /:in .run.$/
-      myCaller =~ /([\(\)\w_\_\-\.]+\:\d+\:?.*?)$/
-      myList << "[#{$1.gsub(/eval/, @myName)}] "
-    end
-    myList
-  end
-
-  alias get_callers get_call_list
-
-  def get_call_list_new(depth = 9, dbg = false)
-    myList    = []
-    call_list = Kernel.caller
-    puts call_list if dbg
-    call_list.each_index do |x|
-      myCaller = call_list[x].to_s
-      break if x > depth or myCaller =~ /:in .run.$/
-      if myCaller.include? @myName
-        myCaller =~ /([\(\)\w_\_\-\.]+\:\d+\:?.*?)$/
-        myList << "[#{$1.gsub(/eval/, @myName)}] "
-        break
-      end
-    end
-    if @projName
-      call_list.each_index do |x|
-        myCaller = call_list[x].to_s
-        break if x > depth or myCaller =~ /:in .run.$/
-        if myCaller.include? @projName
-          myCaller =~ /([\(\)\w_\_\-\.]+\:\d+\:?.*?)$/
-          myList << "[#{$1.gsub(/eval/, @projName)}] "
-          break
-        end
-      end
-    end
-    myList
-  end
-
-  def get_call_array(depth = 9)
-    arr       = []
-    call_list = Kernel.caller
-    call_list.each_index do |x|
-      myCaller = call_list[x].to_s
-      break if x > depth or myCaller =~ /:in .run.$/
-      myCaller =~ /([\(\)\w_\_\-\.]+\:\d+\:?.*?)$/
-      arr << $1.gsub(/eval/, @myName)
-    end
-    arr
-  end
-
-  def get_debug_list(dbg = false)
-    calls = get_call_array(10)
-    puts "#{calls.to_yaml}" if dbg
-    arr = []
-    calls.each_index do |ix|
-      if ix > 1 # skip this method and the logging method
-        arr << calls[ix]
-      end
-    end
-    puts "#{arr.to_yaml}" if dbg
-    if arr.length > 0
-      list = 'TRACE:'
-      arr.reverse.each { |l| list << "=>#{l}" }
-      " [[#{list}]]"
-    else
-      nil
-    end
-  end
-
-  def dump_array(arr, space_to_underscore = false)
-    dump = "  #{arr.inspect}\n"
-    arr.each_index do |x|
-      value = arr[x].to_s
-      value.gsub!(/\s/, '_') if space_to_underscore
-      dump << " #{x.to_s.rjust(5)}>> '#{arr[x].to_s}'\n"
-    end
-    dump
-  end
-
-  def dump_ole_methods(ole)
-    rtrn = ''
-    ole.ole_methods.each do |m|
-      prms = ''
-      m.params.each do |p|
-        prms << "#{p}, "
-      end
-      rtrn << "#{m.name}(#{prms.chop.chop})\n"
-    end
-    rtrn
-  end
-
-  def dump_ole_get_methods(ole)
-    rtrn = ''
-    ole.ole_get_methods.each do |m|
-      prms = ''
-      m.params.each do |p|
-        prms << "#{p}, "
-      end
-      rtrn << "#{m.name}(#{prms.chop.chop})\n"
-    end
-    rtrn
-  end
-
-  def dump_ole_help(ole)
-    rtrn = ''
-    ole.ole_obj_help.each do |m|
-      prms = ''
-      m.params.each do |p|
-        prms << "#{p}, "
-      end
-      rtrn << "#{m.name}(#{prms.chop.chop})\n"
-    end
-    rtrn
-  end
-
-  def dump_select_list_options(element)
-    msg     = "#{element.inspect}"
-    options = element.options
-    cnt     = 1
-    options.each do |o|
-      msg << "\n\t#{cnt}:\t'#{o}"
-      cnt += 1
-    end
-    debug_to_log(msg)
-  end
-
-  def dump_all_tables(browser, to_report = false)
-    tables  = browser.tables
-    msg     = ''
-    tbl_cnt = 0
-    tables.each do |tbl|
-      tbl_cnt += 1
-      row_cnt = 0
-      msg <<"\n=================\ntable: #{tbl_cnt}\n=================\n#{tbl}\ntext:\n#{tbl.text}"
-      tbl.rows.each do |row|
-        row_cnt  += 1
-        cell_cnt = 0
-        msg <<"\n=================\ntable: #{tbl_cnt} row: #{row_cnt}\n#{row.inspect}\n#{row}\ntext:'#{row.text}'"
-        row.each do |cell|
-          cell_cnt += 1
-          msg <<"\ncell: #{cell_cnt}\n#{cell.inspect}\n#{row}\ntext: '#{cell.text}'"
-        end
-      end
-    end
-    if to_report
-      debug_to_report(msg)
-    else
-      debug_to_log(msg)
-    end
-  end
-
-  def dump_table_and_rows(table, to_report = false)
-    msg = "\n=================\ntable\n=================\nn#{table}\n#{table.to_yaml}\nrows:"
-    cnt = 0
-    table.rows.each do |r|
-      cnt += 1
-      msg << "\n#{cnt}: #{r.text}"
-    end
-    msg << "\n=================\n================="
-    if to_report
-      debug_to_report(msg)
-    else
-      debug_to_log(msg)
-    end
-  end
-
-  def dump_table_rows_and_cells(tbl)
-    msg     = ''
-    row_cnt = 0
-    msg <<"\n=================\ntable: #{tbl.inspect}\n=================\n#{tbl}\ntext:\n#{tbl.text}"
-    tbl.rows.each do |row|
-      row_cnt  += 1
-      cell_cnt = 0
-      msg <<"\n=================\nrow: #{row_cnt}\n#{row.inspect}\n#{row}\ntext:'#{row.text}'"
-      row.each do |cell|
-        cell_cnt += 1
-        msg <<"\ncell: #{cell_cnt}\n#{cell.inspect}\n#{row}\ntext: '#{cell.text}'"
-      end
-    end
-    debug_to_log(msg)
-  end
-
-  alias dump_table_rows dump_table_rows_and_cells
-
-  def dump_row_cells(row)
-    msg      = ''
-    cell_cnt = 0
-    msg <<"\n=================\nrow: #{row.inspect}\n#{row}\ntext:'#{row.text}'"
-    row.each do |cell|
-      cell_cnt += 1
-      msg <<"\ncell: #{cell_cnt}\n#{cell.inspect}\n#{row}\ntext: '#{cell.text}'"
-    end
-    debug_to_log(msg)
-  end
-
-  def parse_cookies(browser)
-    cookies = Hash.new
-    strg    = browser.document.cookie
-    ary     = strg.split(';')
-    ary.each do |c|
-      key, value          = c.split('=')
-      cookies[key.lstrip] = value
-    end
-    cookies
-  end
-
-  def capture_screen(browser, ts)
-    browser.maximize
-    browser.bring_to_front
-    caller = get_caller
-    caller.match(/:(\d+):/)
-    lnbr       = $1
-    path       = "#{@myRoot}/screenshot/"
-    screenfile = "#{@myName}_#{@myRun.id}_#{lnbr.to_s}_#{ts.to_f.to_s}.scrsht.jpg"
-    info_to_log("path:#{path} screenfile:#{screenfile}")
-    screenSpec = '"' + path + screenfile + '"'
-    screenSpec.gsub!('/', '\\')
-    screen_capture(screenSpec)
-    screenfile
-  end
-
-  def pdf_to_text(file, noblank = true)
-    spec = file.sub(/\.pdf$/, '')
-    `pdftotext #{spec}.pdf`
-    file = File.new("#{spec}.txt")
-    text = []
-    file.readlines.each do |l|
-      l.chomp! if noblank
-      if l.length > 0
-        text << l
-      end
-    end
-    file.close
-    text
-  end
-
-  def flash_id(browser, strg, count)
-    msg = "Flash link id='#{strg}' #{count} times."
-    msg << " #{desc}" if desc.length > 0
-    browser.link(:id, strg).flash(count)
-    if validate(browser, @myName, __LINE__)
-      passed_to_log(msg)
-      true
-    end
-  rescue
-    failed_to_log("Unable to #{msg} '#{$!}'")
-  end
-
-  def flash(element, count = 4)
-    element.flash(count)
-    debug_to_log("'#{element.inspect}' flashed #{count} times.")
-    true
-  rescue
-    debug_to_log("Flash '#{element.inspect}' failed: '#{$!}' (#{__LINE__})")
-  end
-
-  def get_save_file_path(root, filename)
-    filespec = "#{root}/file/#{filename}"
-    filespec.gsub!('/', '\\')
-  end
-
-  def save_file_orig(filepath, desc = '', wait = WAIT)
-    #    title = translate_popup_title(title)
-    @ai.WinWait("File Download", "", wait)
-    @ai.ControlFocus("File Download", "", "&Save")
-    sleep 1
-    @ai.ControlClick("File Download", "", "&Save", "left")
-    @ai.WinWait("Save As", "", wait)
-    sleep 1
-    @ai.ControlSend("Save As", "", "Edit1", filepath)
-    @ai.ControlClick("Save As", "", "&Save", "left")
-    sleep 1
-    @ai.WinWait("Download complete", "", wait)
-    @ai.ControlClick("Download complete", "", "Close")
-  end
-
-  #TODO This and save_file2 have to be combined somehow.
-  def save_file1(filepath, title = "File Download", desc = '', wait = WAIT)
-    title = translate_popup_title(title)
-    @ai.WinWait(title, '', wait)
-    @ai.WinActivate(title, '')
-    sleep 1
-    @ai.ControlFocus(title, "", "&Save")
-    sleep 3
-    @ai.ControlClick(title, "", "&Save", "primary")
-    sleep 2
-    @ai.ControlClick(title, "", "Save", "primary")
-
-    @ai.WinWait("Save As", "", wait)
-    sleep 1
-    @ai.ControlSend("Save As", "", "Edit1", filepath)
-    @ai.ControlFocus("Save As", "", "&Save")
-    @ai.ControlClick("Save As", "", "&Save", "primary")
-    @ai.ControlClick("Save As", "", "Save", "primary")
-
-    @ai.WinWait("Download complete", "", wait)
-    passed_to_log("Save file '#{filepath}' succeeded. #{desc}")
-    @ai.ControlClick("Download complete", "", "Close")
-  rescue
-    failed_to_log("Save file failed: #{desc} '#{$!}'. (#{__LINE__})")
-  end
-
-  def save_file2(filepath, title = "File Download - Security Warning", desc = '', wait = WAIT)
-    title = translate_popup_title(title)
-    sleep(1)
-    @ai.WinWait(title, '', wait)
-    dl_hndl    = @ai.WinGetHandle(title, '')
-    dl_sv_hndl = @ai.ControlGetHandle(title, '', "&Save")
-    @ai.WinActivate(title, '')
-    sleep 1
-    @ai.ControlFocus(title, "", "&Save")
-    sleep 1
-    @ai.ControlFocus(title, "", "Save")
-    sleep 1
-    @ai.ControlClick(title, "", "&Save", "primary")
-    sleep 1
-    @ai.ControlClick(title, "", "Save", "primary")
-    sleep 1
-    w = WinClicker.new
-    w.clickButtonWithHandle(dl_sv_hndl)
-    sleep 1
-    w.clickWindowsButton_hwnd(dl_hndl, "Save")
-    sleep 1
-    w.clickWindowsButton_hwnd(dl_hndl, "&Save")
-
-    @ai.WinWait("Save As", "", wait)
-    sleep 1
-    @ai.ControlSend("Save As", "", "Edit1", filepath)
-    @ai.ControlFocus("Save As", "", "&Save")
-    @ai.ControlClick("Save As", "", "&Save", "primary")
-
-    @ai.WinWait("Download complete", "", wait)
-    passed_to_log("Save file '#{filepath}' succeeded. #{desc}")
-    @ai.ControlClick("Download complete", "", "Close")
-  rescue
-    failed_to_log("Save file failed: #{desc} '#{$!}'. (#{__LINE__})")
-  end
-
-  #method for handling save dialog
-  #use click_no_wait on the action that triggers the save dialog
-  def save_file(filepath, download_title = "File Download - Security Warning")
-    # TODO need version for Firefox
-    # TODO need to handle first character underline, e.g. 'Cancel' and '&Cancel'
-    download_title   = translate_popup_title(download_title)
-    download_text    = ''
-    download_control = "&Save"
-    saveas_title     = 'Save As'
-    saveas_text      = ''
-    saveas_control   = "Edit1"
-    dnld_cmplt_title = "Download Complete"
-    dnld_cmplt_title = translate_popup_title(dnld_cmplt_title)
-    dnld_cmplt_text  = ""
-    #    save_title = ""
-    side             = 'primary'
-    msgdl            = "Window '#{download_title}':"
-    msgsa            = "Window '#{saveas_title}':"
-    msgdc            = "Window '#{dnld_cmplt_title}':"
-    begin
-      if @ai.WinWait(download_title, download_text, WAIT)
-        @ai.WinActivate(download_title, download_text)
-        if @ai.WinActive(download_title, download_text)
-          dl_title = @ai.WinGetTitle(download_title, download_text)
-          #          dl_hndl  = @ai.WinGetHandle(download_title, download_text)
-          #          dl_text  = @ai.WinGetText(download_title, download_text)
-          #          dl_sv_hndl = @ai.ControlGetHandle(dl_title, '', download_control)
-          #          dl_op_hndl = @ai.ControlGetHandle(dl_title, '', '&Open')
-          #          dl_cn_hndl = @ai.ControlGetHandle(dl_title, '', 'Cancel')
-          debug_to_log("#{msgdl} activated. (#{__LINE__})")
-
-          if @ai.ControlFocus(dl_title, download_text, download_control)
-            debug_to_log("#{msgdl} focus gained. (#{__LINE__})")
-
-            @ai.Send("S")
-            #              @ai.ControlSend(dl_Stitle, download_text, download_control, "{ENTER}")
-            sleep_for 1
-
-            if @ai.ControlClick(dl_title, download_text, download_control, side)
-              debug_to_log("#{msgdl} click succeeded on '#{download_control}'. (#{__LINE__})")
-
-              if @ai.WinWait(saveas_title, saveas_text, WAIT)
-                debug_to_log("#{msgsa} appeared. (#{__LINE__})")
-                sleep_for 1
-                if @ai.ControlSend(saveas_title, saveas_text, saveas_control, filepath)
-                  debug_to_log("#{msgsa} controlsend of '#{saveas_control}' succeeded. (#{__LINE__})")
-
-                  @ai.Send("S")
-                  @ai.ControlSend(saveas_title, saveas_text, saveas_control, "{ENTER}")
-                  sleep_for 1
-
-                  if @ai.ControlClick(saveas_title, saveas_text, saveas_control, side)
-                    passed_to_log("#{msgsa} click succeeded on '#{saveas_control}'. (#{__LINE__})")
-                    if @ai.WinWait(dnld_cmplt_title, dnld_cmplt_text, WAIT)
-                      debug_to_log("#{msgdc} appeared. (#{__LINE__})")
-                      sleep_for 1
-                      if @ai.ControlClick(dnld_cmplt_title, dnld_cmplt_text, "Close", side)
-                        passed_to_log("Save file for #{filepath} succeeded.")
-                      else
-                        failed_to_log("#{msgdc} click failed on 'Close'. (#{__LINE__})")
-                      end
-                    else
-                      failed_to_log("#{msgdc} did not appear after #{WAIT} seconds. (#{__LINE__})")
-                    end
-                  else
-                    failed_to_log("#{msgsa} click failed on '#{saveas_control}'. (#{__LINE__})")
-                  end
-                else
-                  failed_to_log("#{msgsa} controlsend of '#{saveas_control}' failed. (#{__LINE__})")
-                end
-              else
-                failed_to_log("#{msgsa} did not appear after #{WAIT} seconds. (#{__LINE__})")
-              end
-            else
-              failed_to_log("#{msgdl} click failed on '#{download_control}'. (#{__LINE__})")
-            end
-          else
-            failed_to_log("#{msgdl} Unable to gain focus on control '#{dl_title}'. (#{__LINE__})")
-          end
-        else
-          failed_to_log("#{msgdl} Unable to activate. (#{__LINE__})")
-        end
-      else
-        failed_to_log("#{msgdl} did not appear after #{WAIT} seconds. (#{__LINE__})")
-      end
-    rescue
-      failed_to_log("Save file failed: '#{$!}'. (#{__LINE__})")
-    end
-  end
-
-  #method for cancelling Print window
-  # TODO need to handle 'Cancel' and '&Cancel' (first character underlined)
-  def close_print(title = 'Print', text = '', button = '&Cancel', side = 'left')
-    msg = "Popup: title=#{title} button='#{button}' text='#{text}' side='#{side}':"
-    if @ai.WinWait(title, text, WAIT)
-      passed_to_log("#{msg} found.")
-      @ai.WinActivate(title)
-      if @ai.WinActive(title, text)
-        passed_to_log("#{msg} activated.")
-        if @ai.ControlFocus(title, text, button)
-          passed_to_log("#{msg} focus attained.")
-          if @ai.ControlClick(title, text, button, side)
-            passed_to_log("#{msg} closed successfully.")
-          else
-            failed_to_log("#{msg} click failed on button (#{__LINE__})")
-          end
-        else
-          failed_to_log("#{msg} Unable to gain focus on button (#{__LINE__})")
-        end
-      else
-        failed_to_log("#{msg} Unable to activate (#{__LINE__})")
-      end
-    else
-      failed_to_log("#{msg} did not appear after #{WAIT} seconds. (#{__LINE__})")
-    end
-  rescue
-    failed_to_log("Close #{msg}: '#{$!}'. (#{__LINE__})")
-  end
-
-  #method for handling file download dialog
-  #use click_no_wait on the action that triggers the save dialog
-  # TODO need version for Firefox
-  # TODO need to handle 'Cancel' and '&Cancel' (first character underlined)
-  # TODO replace call to close_modal_ie with actual file download
-  def file_download(browser = nil)
-    title  = 'File Download'
-    title  = translate_popup_title(title)
-    text   = ''
-    button = 'Cancel'
-    if @browserAbbrev == 'IE'
-      close_popup(title, button, text)
-    else
-
-    end
-  end
-
-  #method for handling file upload dialog
-  #use click_no_wait on the action that triggers the save dialog
-  # TODO need version for Firefox
-  def file_upload(filepath)
-    title   = 'Choose File'
-    title   = translate_popup_title(title)
-    text    = ''
-    button  = "&Open"
-    control = "Edit1"
-    side    = 'primary'
-    msg     = "Window title=#{title} button='#{button}' text='#{text}' side='#{side}':"
-    begin
-      if @ai.WinWait(title, text, WAIT)
-        passed_to_log("#{msg} found.")
-        @ai.WinActivate(title, text)
-        if @ai.WinActive(title, text)
-          passed_to_log("#{msg} activated.")
-          if @ai.ControlSend(title, text, control, filepath)
-            passed_to_log("#{msg} #{control} command sent.")
-            sleep_for 1
-            if @ai.ControlClick(title, text, button, "primary")
-              passed_to_log("#{msg} Upload of #{filepath} succeeded.")
-            else
-              failed_to_log("#{msg} Upload of #{filepath} failed. (#{__LINE__})")
-            end
-          else
-            failed_to_log("#{msg} Unable to select #{filepath}. (#{__LINE__})")
-          end
-        else
-          failed_to_log("#{msg} Unable to activate. (#{__LINE__})")
-        end
-      else
-        failed_to_log("#{msg} did not appear after #{WAIT} seconds. (#{__LINE__})")
-      end
-    rescue
-      failed_to_log("#{msg} Unable to upload: '#{$!}'. (#{__LINE__})")
-    end
-
-  end
-
-  def upload_file(data_path)
-    limit = 180 # .seconds
-    Timeout::timeout(limit) {
-      wait = 20
-      @ai.WinWait("Choose File to Upload", "", wait)
-      sleep 1
-      @ai.ControlSend("Choose File to Upload", "", "Edit1", data_path)
-      @ai.ControlClick("Choose File to Upload", "", "[CLASS:Button; INSTANCE:2]", "left")
-      sleep 4
-      #sleep 1
-    }
-    failed_to_log("Choose File to Upload not found after #{limit} '#{$!}'")
-  rescue Timeout::Error
-    failed_to_log("File Upload timeout after #{limit} '#{$!}'")
-  end
-
-  def focus_on_textfield_by_id(browser, strg, desc = '')
-    msg = "Set focus on textfield name='#{strg}' "
-    msg << " #{desc}" if desc.length > 0
-    tf = browser.text_field(:id, strg)
-    if validate(browser, @myName, __LINE__)
-      tf.focus
-      if validate(browser, @myName, __LINE__)
-        passed_to_log(msg)
-        true
-      end
-    end
-  rescue
-    failed_to_log("Unable to #{msg} '#{$!}'")
-  end
-
-  def flash_text(browser, strg, count, desc = '')
-    msg = "Flash link text='#{strg}' #{count} times."
-    msg << " #{desc}" if desc.length > 0
-    strgCnt = string_count_in_string(browser.text, strg)
-    if strgCnt > 0
-      browser.link(:text, strg).flash(count)
-      if validate(browser, @myName, __LINE__)
-        passed_to_log(msg)
-        true
-      end
-    else
-      failed_to_log("#{msg} Link not found.")
-    end
-  rescue
-    failed_to_log("Unable to #{msg} '#{$!}'")
-  end
-
-
-end