awetestlib 0.0.3-x86-mingw32 → 0.1.0-x86-mingw32

data/lib/regression/utilities.rb

@@ -0,0 +1,891 @@
+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