ole-qa-framework 2.1.0

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ole-qa-framework.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,45 @@
+PATH
+  remote: .
+  specs:
+    ole-qa-framework (2.1.0)
+      headless
+      rspec
+      watir-webdriver
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    childprocess (0.3.9)
+      ffi (~> 1.0, >= 1.0.11)
+    diff-lcs (1.2.4)
+    ffi (1.9.0)
+    headless (1.0.1)
+    multi_json (1.7.7)
+    rake (10.1.0)
+    rspec (2.13.0)
+      rspec-core (~> 2.13.0)
+      rspec-expectations (~> 2.13.0)
+      rspec-mocks (~> 2.13.0)
+    rspec-core (2.13.1)
+    rspec-expectations (2.13.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.13.1)
+    rubyzip (0.9.9)
+    selenium-webdriver (2.33.0)
+      childprocess (>= 0.2.5)
+      multi_json (~> 1.0)
+      rubyzip
+      websocket (~> 1.0.4)
+    watir-webdriver (0.6.4)
+      selenium-webdriver (>= 2.18.0)
+    websocket (1.0.7)
+    yard (0.8.6.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.3)
+  ole-qa-framework!
+  rake
+  yard

data/LICENSE.md

@@ -0,0 +1,14 @@
+### Copyright 2005-2013 The Kuali Foundation
+- - -
+
+Licensed under the Educational Community License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at:
+
+http://www.opensource.org/licenses/ecl2.php
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

data/README.md

@@ -0,0 +1,17 @@
+# Kuali Open Library Environment
+http://www.kuali.org/ole
+- - -
+## OLE QA Testing Framework
+- - -
+
+### Open Library Environment Quality Assurance Testing Framework
+- - -
+This is a testing framework for the Kuali Open Library environment.  It
+will be used to define OLE pages and screen elements for OLE test scripts
+and the OLE Smoke Test Application.
+
+### Usage Examples
+- - -
+The examples directory contains some minimal example scripts to show
+how the testing framework can be used to fulfill common OLE
+use case scenarios.

data/Rakefile.rb

@@ -0,0 +1,25 @@
+#  Copyright 2005-2013 The Kuali Foundation
+#
+#  Licensed under the Educational Community License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at:
+#
+#    http://www.opensource.org/licenses/ecl2.php
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+libdir = File.expand_path(File.dirname(__FILE__))
+$LOAD_PATH.unshift(libdir) unless $LOAD_PATH.include?(libdir)
+
+require 'rubygems'
+require 'rspec/core/rake_task'
+require 'bundler/gem_tasks'
+
+desc "Print the current version number."
+task :version do
+  puts OLE_QA::Framework::VERSION
+end

data/examples/README.md

@@ -0,0 +1,57 @@
+# OLE QA Testing Framework
+## Examples
+- - -
+
+### Create Bib Record
+create_bib_record.rb
+
+This example file shows the simplest way to create a minimal
+MARC bibliographic record in the OLE Library System using this
+Test Framework.  It creates the record directly in the editor,
+saves the record, then closes out the session.  It does not
+contain any asserts or rescues, so Selenium Errors and OLE
+Errors are not handled.
+
+For the sake of simplicity, random text is used to fulfill the
+minimum criteria of a leader string and a control field string.
+
+* Bib Record
+    * Leader - 'HelloWorld'
+    * Control Line - '008','HelloWorld'
+    * Title - '245','','','$aStardust'
+    * Author - '100','1','','$aNeil Gaiman'
+
+### Create Requisition
+create_requisition.rb
+
+This example file shows the simplest straight-through path
+to create a requisition with the minimum requirements for approval:
+a vendor, a delivery address, a requestor phone number, and a line
+item consisting of a bibliographic record with a title, a list price,
+and an accounting string for the purchase to be applied to.
+
+This script contains only one error-checking line:  at the end of the
+script, there will be an if-elsif-else clause wherein the script first
+checks for a success message upon submission of the requisition, and
+prints it if found, and if not, checks for an error message, and prints
+it if found.  If the script finds no success message and no error message,
+it prints whatever message it finds in the appropriate div, with the
+element name requisition.generic_message.
+
+* Bib Record
+    * Leader - 'HelloWorld'
+    * Control Line - '008','HelloWorld'
+    * Title - '245','Where is Joe Merchant?'
+* Line Item
+    * List Price - '23.00'
+    * Accounting Chart Code - 'BL' (Bloomington)
+    * Account Number - '2947494' (Linguistics)
+    * Object Code - '7112' (Monographs)
+    * Percentage - '100.00'
+* Vendor
+    * YBP Library Services
+* Delivery
+    * Building - 'Wells Library'
+    * Room Number - '100'
+* Requestor Info
+    * Phone Number - '812-555-5555' (Bloomington, Non-Usable Number)

data/examples/create_bib_record.rb

@@ -0,0 +1,64 @@
+#  Copyright 2005-2013 The Kuali Foundation
+#
+#  Licensed under the Educational Community License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at:
+#
+#    http://www.opensource.org/licenses/ecl2.php
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+require 'ole-qa-framework'
+
+# Start a new instance of the OLE Testing Framework.
+# Do not run the browser in headless mode.
+ole = OLE_QA::Framework::Session.new(:headless? => false)
+
+# Create an instance of the OLELS Bib Editor Page.
+bib_editor = OLE_QA::Framework::OLELS::Bib_Editor.new(ole)
+
+# Open the page directly via URL.
+# Automatically select the iframe with ID "iframeporlet"
+# (the screen context in which most OLE functions are found).
+bib_editor.open
+
+# Enter a control line with tag "008" and a value of "HelloWorld"
+bib_editor.control_008_link.click
+bib_editor.control_008_field.wait_until_present
+bib_editor.control_008_field.set("HelloWorld")
+
+# Enter a Marc field & subfield line of
+# "245 # # $aStardust"
+bib_editor.data_line_1.tag_field.set("245")
+bib_editor.data_line_1.data_field.set("|aStardust")
+
+# Add another data line.
+bib_editor.data_line_1.add_button.click
+bib_editor.add_data_line(2)
+
+# Enter a Marc field & subfield line
+# "100 1 # $aNeil Gaiman"
+bib_editor.data_line_2.tag_field.wait_until_present
+bib_editor.data_line_2.tag_field.set("100")
+bib_editor.data_line_2.ind1_field.set("1")
+bib_editor.data_line_2.data_field.set("|aNeil Gaiman")
+
+# Set the header fields before saving
+bib_editor.set_button.click
+
+# Save the record.
+bib_editor.submit_button.click
+
+# Print whatever message appears to the command line.
+bib_editor.message.wait_until_present
+puts bib_editor.message.text
+
+# Return to the OLE Library System Main Menu via URL.
+ole.browser.goto(ole.ls_url)
+
+# Shut down the OLE Testing Framework.
+ole.quit

data/examples/create_requisition.rb

@@ -0,0 +1,96 @@
+#  Copyright 2005-2013 The Kuali Foundation
+#
+#  Licensed under the Educational Community License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at:
+#
+#    http://www.opensource.org/licenses/ecl2.php
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+require 'ole-qa-framework'
+
+# Start a new instance of the OLE Testing Framework.
+# Do not run the browser in headless mode.
+ole = OLE_QA::Framework::Session.new(:headless? => false)
+
+# Create an instance of the OLEFS Requisition Page.
+requisition = OLE_QA::Framework::OLEFS::Requisition.new(ole)
+
+# Open the page directly via URL.
+requisition.open
+
+# Select a Delivery Location of Wells Library, Room 100
+requisition.delivery_tab_toggle.click
+requisition.building_search_icon.click
+building_lookup = OLE_QA::Framework::OLEFS::Building_Lookup.new(ole)
+building_lookup.building_name_field.set("Wells Library")
+building_lookup.search_button.click
+building_lookup.element(:return_building_link)  {building_lookup.browser.a(:xpath => "//td[contains(text(),'Wells Library')]/preceding-sibling::td[3]/a")}
+building_lookup.return_building_link.click
+requisition.room_field.set("100")
+
+# Select a Vendor
+requisition.vendor_tab_toggle.click
+requisition.vendor_search_icon.wait_until_present
+requisition.vendor_search_icon.click
+vendor_lookup = OLE_QA::Framework::OLEFS::Vendor_Lookup.new(ole)
+vendor_lookup.vendor_name_field.set("YBP")
+vendor_lookup.search_button.click
+vendor_lookup.element(:return_vendor_link)      {vendor_lookup.browser.a(:xpath => "//td[a[contains(text(),'YBP Library Services')]]/preceding-sibling::td[1]/a")}
+vendor_lookup.return_vendor_link.click
+
+# Enter a Bibliographic Record on the first Line Item
+# - Use the minimum requisition requirement of a Title.
+# - Use the Bib Editor minimum requirement of an 008 field and a leader field.
+# - Print the success or failure message from the Bib Editor to the command line.
+requisition.new_line_item.new_bib_button.click
+ole.browser.windows[-1].use
+bib_editor = OLE_QA::Framework::OLELS::Bib_Editor.new(ole)
+bib_editor.wait_for_page_to_load
+bib_editor.control_008_link.click
+bib_editor.control_008_field.wait_until_present
+bib_editor.control_008_field.set("HelloWorld")
+bib_editor.data_line_1.tag_field.set("245")
+bib_editor.data_line_1.data_field.set("|aWhere is Joe Merchant?")
+bib_editor.set_button.click
+bib_editor.submit_button.click
+bib_editor.message.wait_until_present
+puts bib_editor.message.text
+bib_editor.close_button.click
+ole.browser.windows[0].use
+
+# Enter a list price for the Line Item
+requisition.new_line_item.list_price_field.set("23.00")
+
+# Add the Line Item
+requisition.new_line_item.add_button.click
+requisition.create_line_item(1)
+
+# Apply the 100% of the Line Item's cost to Acct 2947494, Obj Code 7112
+requisition.line_item_1.accounting_lines_toggle.click
+requisition.line_item_1.new_accounting_line.chart_selector.select("BL")
+requisition.line_item_1.new_accounting_line.account_number_field.set("2947494")
+requisition.line_item_1.new_accounting_line.object_field.set("7112")
+requisition.line_item_1.new_accounting_line.percent_field.set("100.00")
+requisition.line_item_1.new_accounting_line.add_button.click
+
+# Enter a Requestor Phone Number in Additional Institutional Info
+requisition.additional_info_tab_toggle.click
+requisition.additional_info_phone_number_field.wait_until_present
+requisition.additional_info_phone_number_field.set("812-555-5555")
+
+# Save the Requisition
+requisition.save_button.click
+
+# Submit the Requisition and print any resulting message to the command line.
+requisition.submit_button.click
+requisition.generic_message.wait_until_present
+puts requisition.generic_message.text
+
+# Exit
+ole.quit

data/examples/purap_workflow_test.rb

@@ -0,0 +1,185 @@
+#  Copyright 2005-2013 The Kuali Foundation
+#
+#  Licensed under the Educational Community License, Version 2.0 (the "License");
+#  you may not use this file except in compliance with the License.
+#  You may obtain a copy of the License at:
+#
+#    http://www.opensource.org/licenses/ecl2.php
+#
+#  Unless required by applicable law or agreed to in writing, software
+#  distributed under the License is distributed on an "AS IS" BASIS,
+#  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#  See the License for the specific language governing permissions and
+#  limitations under the License.
+
+require "ole-qa-framework"
+
+# Start a new instance of the OLE Testing Framework.
+# Do not run the browser in headless mode.
+ole = OLE_QA::Framework::Session.new(:headless? => false)
+
+# Capture the start time in MM/DD/YYYY format.
+time = Time.now.strftime("%m/%d/%y")
+
+# Open a new requisition.
+requisition = OLE_QA::Framework::OLEFS::Requisition.new(ole)
+requisition.open
+
+# Set the description field to "PURAP Workflow Test - MM/DD/YYYY".
+requisition.description_field.set("PURAP Workflow Test - #{time}")
+
+# Set the delivery address to Wells Library, Room 100.
+requisition.delivery_tab_toggle.click
+requisition.building_search_icon.click
+building_lookup = OLE_QA::Framework::OLEFS::Building_Lookup.new(ole)
+building_lookup.wait_for_page_to_load
+building_lookup.building_name_field.set("Wells Library")
+building_lookup.search_button.click
+building_lookup.browser.a(:xpath => "//td[contains(text(),'Wells Library')]/preceding-sibling::td[3]/a").click
+requisition.wait_for_page_to_load
+requisition.room_field.set("100")
+requisition.delivery_tab_toggle.click
+
+# Select "YBP Library Services" as the vendor.
+requisition.vendor_tab_toggle.click
+requisition.vendor_search_icon.click
+vendor_lookup = OLE_QA::Framework::OLEFS::Vendor_Lookup.new(ole)
+vendor_lookup.wait_for_page_to_load
+vendor_lookup.vendor_name_field.set("YBP")
+vendor_lookup.search_button.click
+vendor_lookup.browser.a(:xpath => "//td[a[contains(text(),'YBP Library Services')]]/preceding-sibling::td[1]/a").click
+requisition.wait_for_page_to_load
+requisition.vendor_tab_toggle.click
+
+# Add a Bib Record to the new line item with a title only.
+requisition.new_line_item.new_bib_button.click
+ole.browser.windows[-1].use
+bib_editor = OLE_QA::Framework::OLELS::Bib_Editor.new(ole)
+bib_editor.wait_for_page_to_load
+bib_editor.control_008_link.click
+bib_editor.control_008_field.wait_until_present
+bib_editor.control_008_field.set("HELLOWORLD")
+bib_editor.data_line_1.tag_field.set("245")
+bib_editor.data_line_1.data_field.set("|aTitle of Book")
+bib_editor.set_button.click
+bib_editor.submit_button.click
+bib_editor.close_button.click
+ole.browser.windows[0].use
+
+# Set the list price to $235.00 and add the line item.
+requisition.new_line_item.list_price_field.set("235.00")
+requisition.new_line_item.add_button.click
+requisition.add_line_item(1)
+requisition.wait_for_page_to_load
+
+# Open the line item's accounting lines subtab and add an accounting string.
+# Chart      - Bloomington
+# Account    - 2947494
+# Object     - 7112
+# Percentage - 100
+requisition.line_item_1.accounting_lines_toggle.click
+requisition.line_item_1.new_accounting_line.chart_selector.wait_until_present
+requisition.line_item_1.new_accounting_line.chart_selector.select("BL")
+requisition.line_item_1.new_accounting_line.account_number_field.set("2947494")
+requisition.line_item_1.new_accounting_line.object_field.set("7112")
+requisition.line_item_1.new_accounting_line.percent_field.set("100.00")
+requisition.line_item_1.new_accounting_line.add_button.click
+requisition.line_item_1.add_accounting_line(1)
+requisition.line_item_1.accounting_line_1.chart_selector.wait_until_present
+
+# Open the Additional Information tab and add a phone number.
+requisition.additional_info_tab_toggle.click
+requisition.additional_info_phone_number_field.set("812-555-5555")
+
+# Submit the requisition and wait for a message to appear.
+# Display that message on the command line.
+requisition.submit_button.click
+requisition.wait_for_page_to_load
+requisition.generic_message.wait_until_present
+puts "Requisition:".ljust(20) + "#{requisition.generic_message.text.strip}"
+
+# Reload the requisition.
+requisition.reload_button.click
+requisition.wait_for_page_to_load
+
+# Open the View Related tab and check for a purchase order link.
+requisition.view_related_tab_toggle.click
+requisition.view_related_po_link.wait_until_present
+
+
+
+# Get the requisition's Document ID.  This will be needed to re-open the requisition later.
+requisition_id = requisition.document_id.text.strip
+
+# Get the text of the purchase order link in the View Related tab.
+po_link_text = requisition.view_related_po_link.text.strip
+
+# Use a basic spin assert to check whether the requisition has created an approved purchase order yet.
+# Set the timeout to 30 seconds from now.
+end_time = Time.now + 30
+# Wait for a signal since until isn't wrapped in a method.
+catch :done do
+  # Repeat this loop until either the timeout expires or the loop is broken.
+  until Time.now > end_time
+    # Repeat this loop this on a one second interval.
+    sleep 1
+    # Reopen the requisition.
+    ole.browser.goto("http://tst.ole.kuali.org/kew/DocHandler.do?command=displayDocSearchView&docId=#{requisition_id}")
+    requisition.wait_for_page_to_load
+    # Check the Purchase Order link text in the View Related tab.
+    requisition.view_related_tab_toggle.click
+    requisition.view_related_po_link.wait_until_present
+    po_link_text = requisition.view_related_po_link.text.strip
+    # Break out of this loop if the Purchase Order link has a non-asterisk text value.
+    throw :done unless po_link_text == '********'
+  end
+end
+
+# Open the purchase order.
+ole.browser.goto(requisition.view_related_po_link.href)
+purchase_order = OLE_QA::Framework::OLEFS::Purchase_Order.new(ole)
+purchase_order.wait_for_page_to_load
+
+# Get the purchase order number and the purchase order's total.
+# These will be used to create the payment request.
+po_number = purchase_order.document_type_id.text.strip
+po_total = purchase_order.grand_total_field.text.strip
+
+# Receive the purchase order.
+purchase_order.receiving_button.click
+receiving_doc = OLE_QA::Framework::OLEFS::Receiving_Document.new(ole)
+receiving_doc.wait_for_page_to_load
+receiving_doc.create_receiving_line(1)
+receiving_doc.submit_button.click
+receiving_doc.wait_for_page_to_load
+# Wait for a message to appear after submitting the receiving document.
+# Print that message to the command line.
+receiving_doc.generic_message.wait_until_present
+puts "Receiving:".ljust(20) + "#{receiving_doc.generic_message.text.strip}"
+
+# Get a random string of 12 alphanumeric characters to use as the invoice number.
+invoice_number = Array.new(12){rand(36).to_s(36)}.join
+
+# Open the payment request creation screen, fill in invoice information,
+# and create the payment request.
+payment_request_create_screen = OLE_QA::Framework::OLEFS::PREQ_Creation.new(ole)
+payment_request_create_screen.open
+payment_request_create_screen.purchase_order_number_field.set(po_number)
+payment_request_create_screen.invoice_date_field.set(time)
+payment_request_create_screen.invoice_number_field.set(invoice_number)
+payment_request_create_screen.invoice_amount_field.set(po_total)
+payment_request_create_screen.continue_button.click
+
+# Calculate and approve the payment request once it opens.
+payment_request = OLE_QA::Framework::OLEFS::Payment_Request.new(ole)
+payment_request.wait_for_page_to_load
+payment_request.payment_method_selector.select("Check")
+payment_request.calculate_button.click
+payment_request.wait_for_page_to_load
+payment_request.approve_button.click
+
+# Print a final status message to the command line.
+puts "Payment Request:".ljust(20)  + 'Approved.' unless payment_request.generic_message.present?
+
+# Exit the OLE QA Testing Framework session.
+ole.quit