sakai-cle-test-api 0.0.75 → 0.1.0

data/lib/sakai-cle-test-api/page_objects/basic_lti.rb

@@ -0,0 +1,6 @@
+#
+class BasicLTI < BasePage
+
+  frame_element
+
+end

data/lib/sakai-cle-test-api/page_objects/blogger.rb

@@ -0,0 +1,205 @@
+#================
+# Blogger Pages
+#================
+
+# The top page of a Site's Blogger feature.
+class Blogger < BasePage
+
+  frame_element
+
+  # Clicks the View All button, then reinstantiates the Class.
+  def view_all
+    frm.link(:text=>"View all").click
+    Blogger.new(@browser)
+  end
+
+  # Clicks the View Members Blog link, then instantiates the
+  # ViewMembersBlog Class.
+  def view_members_blog
+    frm.link(:text=>"View member's blog").click
+    ViewMembersBlog.new(@browser)
+  end
+
+  # Returns true if the specified post title exists in the list. Otherwise returns false.
+  def post_private?(post_title)
+    frm.table(:class=>"tableHeader").row(:text=>/#{Regexp.escape(post_title)}/).image(:alt=>"p").exist?
+  end
+
+  # Clicks the Create New Post link and instantiates the CreateBloggerPost Class.
+  def create_new_post
+    frm.link(:text=>"Create new post").click
+    CreateBloggerPost.new(@browser)
+  end
+  # Clicks on the specified post title, then instantiates
+  # the ViewBloggerPost Class.
+  def open_post(post_title)
+    frm.link(:text=>post_title).click
+    ViewBloggerPost.new(@browser)
+  end
+
+  # Returns an array containing the displayed post titles (as string objects).
+  def post_titles
+    titles = []
+    if frm.table(:class=>"tableHeader").exist?
+      table = frm.table(:class=>"tableHeader")
+      table.rows.each do |row|
+        if row.link(:class=>"aTitleHeader").exist?
+          titles << row.link(:class=>"aTitleHeader").text
+        end
+      end
+    end
+    return titles
+  end
+
+  element(:search_field) { |b| b.frm.text_field(:id=>"_id1:idSearch") }
+  element(:show_comments) { |b| b.frm.checkbox(:id=>"_id1:showComments") }
+  element(:show_full_content) { |b| b.frm.checkbox(:id=>"_id1:showFullContent") }
+
+end
+
+# The page showing contents of a user's Blog.
+class ViewMembersBlog < BasePage
+
+  frame_element
+
+  # Clicks on the member name specified.
+  # The name string obviously needs to match the
+  # text of the link exactly.
+  def member(name)
+    frm.link(:text=>name).click
+    Blogger.new(@browser)
+  end
+
+end
+
+# The page where users create a Post for their Blogger blog.
+class CreateBloggerPost < BasePage
+
+  frame_element
+
+  # Enters the specified string into the FCKEditor for the Abstract.
+  def abstract=(text)
+    frm.frame(:id, "PostForm:shortTextBox_inputRichText___Frame").td(:id, "xEditingArea").frame(:index=>0).send_keys(text)
+  end
+
+  # Enters the specified string into the FCKEditor for the Text of the Blog.
+  def text=(text)
+    frm().frame(:id, "PostForm:tab0:main_text_inputRichText___Frame").td(:id, "xEditingArea").frame(:index=>0).send_keys(text)
+  end
+
+  # Clicks the Add to document button in the text
+  # tab.
+  def add_text_to_document
+    frm.div(:id=>"PostForm:tab0").button(:value=>"Add to document").click
+  end
+
+  # Clicks the Add to Document button on the Image tab.
+  #
+  # This method will fail if the image tab is not the currently selected tab.
+  def add_image_to_document
+    frm.div(:id=>"PostForm:tab1").button(:value=>"Add to document").click
+  end
+
+  # Clicks the Add to Document button on the Link tab.
+  #
+  # This method will fail if the Link tab is not the currently selected tab.
+  def add_link_to_document
+    frm.div(:id=>"PostForm:tab2").button(:value=>"Add to document").click
+  end
+
+  # Clicks the Add to Document button on the File tab.
+  #
+  # This method will fail if the File tab is not the currently selected tab.
+  def add_file_to_document
+    frm.div(:id=>"PostForm:tab3").button(:value=>"Add to document").click
+  end
+
+  # Enters the specified filename in the file field for images.
+  #
+  # The file path can be entered as an optional second parameter.
+  def image_file(filename, filepath="")
+    frm.file_field(:name=>"PostForm:tab1:_id29").set(filepath + filename)
+  end
+
+  # Enters the specified directory/filename in the file field.
+  def file_field(filename, filepath="")
+    frm().file_field(:name=>"PostForm:tab3:_id51").set(filepath + filename)
+  end
+
+  # Clicks the Preview button and instantiates the PreviewBloggerPost Class.
+  def preview
+    frm().button(:value=>"Preview").click
+    PreviewBloggerPost.new(@browser)
+  end
+
+  # Clicks the Save button and instantiates the Blogger Class.
+  def save
+    frm.button(:value=>"Save").click
+    Blogger.new(@browser)
+  end
+
+  element(:title) { |b| b.frm.text_field(:id=>"PostForm:idTitle") }
+  element(:keywords) { |b| b.frm.text_field(:id=>"PostForm:keyWords") }
+  element(:access) { |b| b.frm.select(:id=>"PostForm:selectVisibility") }
+  element(:read_only) { |b| b.frm.checkbox(:id=>"PostForm:readOnlyCheckBox") }
+  element(:allow_comments) { |b| b.frm.checkbox(:id=>"PostForm:allowCommentsCheckBox") }
+  action(:text) { |b| b.frm.button(:value=>"Text").click }
+  action(:images) { |b| b.frm.button(:value=>"Images").click }
+  action(:links) { |b| b.frm.button(:value=>"Links").click }
+  element(:description) { |b| b.frm.text_field(:id=>"PostForm:tab2:idLinkDescription") }
+  element(:url) { |b| b.frm.text_field(:id=>"PostForm:tab2:idLinkExpression") }
+  action(:files) { |b| b.frm.button(:value=>"Files").click }
+
+end
+
+# The Preview page for a Blog post.
+class PreviewBloggerPost < BasePage
+
+  frame_element
+
+  # Clicks the Back button and instantiates the CreateBloggerPost Class.
+  def back
+    frm().button(:value=>"Back").click
+    CreateBloggerPost.new(@browser)
+  end
+
+  # Clicks the Save button and instantiates the CreateBloggerPost Class.
+  def save
+    frm.button(:value=>"Save").click
+    CreateBloggerPost.new(@browser)
+  end
+
+end
+
+# The page for Viewing a blog post.
+class ViewBloggerPost < BasePage
+
+  frame_element
+
+  # Clicks the button for adding a comment to a blog post, then
+  # instantiates the AddBloggerComment Class.
+  def add_comment
+    frm.button(:value=>"Add comment").click
+    AddBloggerComment.new(@browser)
+  end
+
+end
+
+# The page for adding a comment to a Blog post.
+class AddBloggerComment < BasePage
+
+  frame_element
+
+  # Clicks the Save button and instantiates
+  # The ViewBloggerPost Class.
+  def save
+    frm.button(:value=>"Save").click
+    ViewBloggerPost.new(@browser)
+  end
+
+  # Enters the specified string into the FCKEditor box for the Comment.
+  def your_comment=(text)
+    frm.frame(:id, "_id1:_id11_inputRichText___Frame").td(:id, "xEditingArea").frame(:index=>0).send_keys(text)
+  end
+
+end

data/lib/sakai-cle-test-api/page_objects/blogs.rb

@@ -0,0 +1,60 @@
+class BlogsBase < BasePage
+
+  frame_element
+
+  class << self
+    def menu_elements
+      # AddBlogEntry
+      action(:add_blog_entry) { |b| b.frm.link(:text=>"Add blog entry").click }
+    end
+  end
+end
+
+class Blogs < BlogsBase
+
+  menu_elements
+
+  # Returns an array containing the list of Bloggers
+  # in the "All the blogs" table.
+  def blogger_list
+    bloggers = []
+    frm.table(:class=>"listHier lines").rows.each do |row|
+      bloggers << row[1].text
+    end
+    bloggers.delete_at(0)
+    return bloggers
+  end
+end
+
+class AddBlogEntry < BlogsBase
+
+  menu_elements
+
+  include FCKEditor
+
+  expected_element :editor
+
+  element(:editor) { |b| b.frm.frame(:id, "blog-text-input:1:input___Frame") }
+
+  def blog_text=(text)
+    editor.td(:id, "xEditingArea").frame(:index=>0).wait_until_present
+    editor.td(:id, "xEditingArea").frame(:index=>0).send_keys(text)
+  end
+
+  # BlogsList
+  action(:publish_entry) { |b| b.frm.button(:value=>"Publish entry").click }
+  # BlogsList
+  action(:save_draft){ |b| b.frm.button(:value=>"Save Draft").click }
+
+  element(:title) { |b| b.frm.text_field(:name=>"title-input") }
+  element(:only_site_admins) { |b| b.frm.radio(:id=>"instructors-only-radio") }
+  element(:all_members) { |b| b.frm.radio(:id=>"all-members-radio") }
+  element(:publicly_viewable) { |b| b.frm.radio(:id=>"public-viewable-radio") }
+
+end
+
+class BlogsList < BlogsBase
+
+  menu_elements
+
+end

data/lib/sakai-cle-test-api/page_objects/calendar.rb

@@ -0,0 +1,431 @@
+class CalendarBase < BasePage
+
+  frame_element
+  basic_page_elements
+
+  class << self
+    def menu_elements
+      # AddEditEvent
+      action(:add_event) { |b| b.frm.link(:text=>"Add").click }
+
+      # AddEditFields
+      action(:fields) { |b| b.frm.link(:text=>"Fields").click }
+
+      # ImportStepOne
+      action(:import) { |b| b.frm.link(:text=>"Import").click }
+    end
+  end
+
+end
+
+# Top page of the Calendar
+# For now it includes all views, though that probably
+# means it will have to be re-instantiated every time
+# a new view is selected.
+class Calendar < CalendarBase
+
+  menu_elements
+
+  # Selects the specified item in the View select list,
+  # then reinstantiates the Class.
+  def select_view(item)
+    frm.select(:id=>"view").select(item)
+  end
+
+  # Selects the specified item in the View select list.
+  # This is the same method as the select_view method, except
+  # that it does not reinstantiate the class. Use this if you're
+  # not concerned about throwing obsolete element errors when
+  # the page updates.
+  def view=(item)
+    frm.select(:id=>"view").select(item)
+  end
+
+  # Selects the specified item in the Show select list.
+  def show=(item)
+    frm.select(:id=>"timeFilterOption").select(item)
+  end
+
+  # Clicks the link to the specified event, then
+  # instantiates the EventDetail class.
+  def open_event(title)
+    truncated = title[0..5]
+    frm.link(:text=>/#{Regexp.escape(truncated)}/).click
+    EventDetail.new(@browser)
+  end
+
+  # Returns the href value of the target link
+  # use for validation when you are testing whether the link
+  # will appear again on another screen, since often times
+  # validation by title text alone will not work.
+  def event_href(title)
+    truncated = title[0..5]
+    return frm.link(:text=>/#{Regexp.escape(truncated)}/).href
+  end
+
+  def show_events=(item)
+    frm.select(:id=>"timeFilterOption").select(item)
+  end
+
+  # Selects the specified value in the start month select list.
+  def start_month=(item)
+    frm.select(:id=>"customStartMonth").select(item)
+  end
+
+  # Selects the specified value in the start day select list.
+  def start_day=(item)
+    frm.select(:id=>"customStartDay").select(item)
+  end
+
+  # Selects the specified value in the start year select list.
+  def start_year=(item)
+    frm.select(:id=>"customStartYear").select(item)
+  end
+
+  # Selects the specified value in the end month select list.
+  def end_month=(item)
+    frm.select(:id=>"customEndMonth").select(item)
+  end
+
+  # Selects the specified value in the End Day select list.
+  def end_day=(item)
+    frm.select(:id=>"customEndDay").select(item)
+  end
+
+  # Selects the specified value in the End Year select list.
+  def end_year=(item)
+    frm.select(:id=>"customEndYear").select(item)
+  end
+
+  # Clicks the Filter Events button, then re-instantiates
+  # the Calendar class to avoid the possibility of an
+  # ObsoleteElement error.
+  def filter_events
+    frm.button(:name=>"eventSubmit_doCustomdate").click
+    Calendar.new(@browser)
+  end
+
+  # Clicks the Go to Today button, then reinstantiates
+  # the Calendar class.
+  def go_to_today
+    frm.button(:value=>"Go to Today").click
+    Calendar.new(@browser)
+  end
+
+  # Returns an array of the titles of the displayed events.
+  def event_list
+    events_list
+  end
+
+  # Returns an array for the listed events.
+  # This array contains more than simply strings of the event titles, because
+  # often the titles are truncated to fit on the screen. In addition, getting the "title"
+  # tag of the link is often problematic because titles can contain double-quotes, which
+  # will mess up the HTML of the anchor tag (there is probably an XSS vulnerability to
+  # exploit, there. This should be extensively tested.).
+  #
+  # Because of these issues, the array contains the title tag, the anchor text, and
+  # the entire href string for every event listed on the page. Having all three items
+  # available should ensure that verification steps don't give false results--especially
+  # when you are doing a negative test (checking that an event is NOT present).
+  def events_list
+    list = []
+    if frm.table(:class=>"calendar").exist?
+      events_table = frm.table(:class=>"calendar")
+    else
+      events_table = frm.table(:class=>"listHier lines nolines")
+    end
+    events_table.links.each do |link|
+      list << link.title
+      list << link.text
+      list << link.href
+      list << link.html[/(?<="location=").+doDescription/]
+    end
+    list.compact!
+    list.uniq!
+    return list
+  end
+
+  # Clicks the "Previous X" button, where X might be Day, Week, or Month,
+  # then reinstantiates the Calendar class to ensure against any obsolete element
+  # errors.
+  def previous
+    frm.button(:name=>"eventSubmit_doPrev").click
+    Calendar.new(@browser)
+  end
+
+  # Clicks the "Next X" button, where X might be Day, Week, or Month,
+  # then reinstantiates the Calendar class to ensure against any obsolete element
+  # errors.
+  def next
+    frm.button(:name=>"eventSubmit_doNext").click
+    Calendar.new(@browser)
+  end
+
+  # Clicks the "Today" button and reinstantiates the class.
+  def today
+    frm.button(:value=>"Today").click
+    Calendar.new(@browser)
+  end
+
+  def earlier
+    frm().link(:text=>"Earlier").click
+    Calendar.new(@browser)
+  end
+
+  def later
+    frm().link(:text=>"Later").click
+    Calendar.new(@browser)
+  end
+
+  # Clicks the "Set as Default View" button
+  def set_as_default_view
+    frm.link(:text=>"Set as Default View").click
+  end
+end
+
+# The page that appears when you click on an event in the Calendar
+class EventDetail < CalendarBase
+
+  menu_elements
+  # Clicks the Go to Today button, then instantiates
+  # the Calendar class.
+  def go_to_today
+    frm.button(:value=>"Go to Today").click
+    Calendar.new(@browser)
+  end
+
+  def back_to_calendar
+    frm.button(:value=>"Back to Calendar").click
+    Calendar.new(@browser)
+  end
+
+  def last_event
+    frm().button(:value=>"< Last Event").click
+    EventDetail.new(@browser)
+  end
+
+  def next_event
+    frm().button(:value=>"Next Event >").click
+    EventDetail.new(@browser)
+  end
+
+  def event_title
+    frm.div(:class=>"portletBody").h3.text
+  end
+
+  def edit
+    frm.button(:value=>"Edit").click
+    AddEditEvent.new(@browser)
+  end
+
+  def remove_event
+    frm.button(:value=>"Remove event").click
+    DeleteConfirm.new(@browser)
+  end
+
+  # Returns a hash object containing the contents of the event details
+  # table on the page, with each of the header column items as a Key
+  # and the associated data column as the corresponding Value.
+  def details
+    details = {}
+    frm.table(:class=>"itemSummary").rows.each do |row|
+      details.store(row.th.text, row.td.text)
+    end
+    return details
+  end
+
+end
+
+#
+class AddEditEvent < CalendarBase
+
+  include FCKEditor
+
+  menu_elements
+
+  expected_element :message_editor
+
+  # Calendar class
+  action(:save_event) { |b| b.frm.button(:value=>"Save Event").click }
+
+  #
+  def message=(text)
+    message_editor.send_keys(text)
+  end
+
+  # The FCKEditor object. Use this method to set up a "wait_until_present"
+  # step, since sometimes it takes a long time for this object to load.
+  element(:message_editor) { |b| b.frm.frame(:id, "description___Frame").td(:id, "xEditingArea").frame(:index=>0) }
+
+  def frequency
+    frm.button(:name=>"eventSubmit_doEditfrequency").click
+    EventFrequency.new(@browser)
+  end
+
+  def add_attachments
+    frm.button(:value=>"Add Attachments").click
+    EventAttach.new(@browser)
+  end
+
+  def add_remove_attachments
+    frm.button(:value=>"Add/remove attachments").click
+    EventAttach.new(@browser)
+  end
+
+  # Returns true if the page has a link with the
+  # specified file name. Use for test case asserts.
+  def attachment?(file_name)
+    frm.link(:text=>file_name).exist?
+  end
+
+  # Use this method to enter text into custom fields
+  # on the page. The "field" variable is the name of the
+  # field, while the "text" is the string you want to put into
+  # it.
+  def custom_field_text(field, text)
+    frm.text_field(:name=>field).set(text)
+  end
+
+  element(:title) { |b| b.frm.text_field(:id=>"activitytitle") }
+  element(:month) { |b| b.frm.select(:id=>"month") }
+  element(:day) { |b| b.frm.select(:id=>"day") }
+  element(:year) { |b| b.frm.select(:id=>"yearSelect") }
+  element(:start_hour) { |b| b.frm.select(:id=>"startHour") }
+  element(:start_minute) { |b| b.frm.select(:id=>"startMinute") }
+  element(:start_meridian) { |b| b.frm.select(:id=>"startAmpm") }
+  element(:hours) { |b| b.frm.select(:id=>"duHour") }
+  element(:minutes) { |b| b.frm.select(:id=>"duMinute") }
+  element(:end_hour) { |b| b.frm.select(:id=>"endHour") }
+  element(:end_minute) { |b| b.frm.select(:id=>"endMinute") }
+  element(:end_meridian) { |b| b.frm.select(:id=>"endAmpm") }
+  element(:display_to_site) { |b| b.frm.radio(:id=>"site") }
+  element(:event_type) { |b| b.frm.select(:id=>"eventType") }
+  element(:location) { |b| b.frm.text_field(:name=>"location") }
+
+end
+
+# The page that appears when the Frequency button is clicked on the Add/Edit
+# Event page.
+class EventFrequency < CalendarBase
+
+  def save_frequency
+    frm.button(:value=>"Save Frequency").click
+    AddEditEvent.new(@browser)
+  end
+
+  def cancel
+    frm.button(:value=>"Cancel").click
+    AddEditEvent.new(@browser)
+  end
+
+  element(:event_frequency) { |b| b.frm.select(:id=>"frequencySelect") }
+  element(:interval) { |b| b.frm.select(:id=>"interval") }
+  element(:ends_after) { |b| b.frm.select(:name=>"count") }
+  element(:ends_month) { |b| b.frm.select(:id=>"endMonth") }
+  element(:ends_day) { |b| b.frm.select(:id=>"endDay") }
+  element(:ends_year) { |b| b.frm.select(:id=>"endYear") }
+  element(:after) { |b| b.frm.radio(:id=>"count") }
+  element(:on) { |b| b.frm.radio(:id=>"till") }
+  element(:never) { |b| b.frm.radio(:id=>"never") }
+
+end
+
+class AddEditFields < CalendarBase
+
+  # Clicks the Save Field Changes buton and instantiates
+  # The Calendar or EventDetail class--unless the Alert Message box appears,
+  # in which case it re-instantiates the class.
+  def save_field_changes
+    frm.button(:value=>"Save Field Changes").click
+    if frm.div(:class=>"alertMessage").exist?
+      AddEditFields.new(@browser)
+    elsif frm.button(:value=>"Back to Calendar").exist?
+      EventDetail.new(@browser)
+    else
+      Calendar.new(@browser)
+    end
+  end
+
+  def create_field
+    frm.button(:value=>"Create Field").click
+    AddEditFields.new(@browser)
+  end
+
+  # Checks the checkbox for the specified field
+  def check_remove(field_name)
+    frm.table(:class=>/listHier lines/).row(:text=>/#{Regexp.escape(field_name)}/).checkbox.set
+  end
+
+  element(:field_name) { |b| b.frm.text_field(:id=>"textfield") }
+
+end
+
+class ImportStepOne < BasePage
+
+  frame_element
+
+  action(:continue) { |b| bfrm.button(:value=>"Continue").click }
+  element(:microsoft_outlook) { |b| b.frm.radio(:id=>"importType_Outlook") }
+  element(:meeting_maker) { |b| b.frm.radio(:id=>"importType_MeetingMaker") }
+  element(:generic_calendar_import) { |b| b.frm.radio(:id=>"importType_Generic") }
+
+end
+
+class ImportStepTwo < BasePage
+
+  frame_element
+
+  # Goes to ImportStepThree
+  action(:continue) { |b| b.frm.button(:value=>"Continue").click }
+
+  # Enters the specified filename in the file field.
+  #
+  # Note that the file path is an optional second parameter, if you do not want to
+  # include the full path in the filename.
+  def import_file(filename, filepath="")
+    frm.file_field(:name=>"importFile").set(filepath + filename)
+  end
+
+end
+
+class ImportStepThree < BasePage
+
+  frame_element
+
+  expected_element :import_events_for_site
+
+  # Goes to Calendar
+  action(:import_events) { |b| b.frm.button(:value=>"Import Events").click }
+
+  # Returns an array containing the list of Activity names on the page.
+  def events
+    list = []
+    frm.table(:class=>/listHier lines/).rows.each do |row|
+      if row.label(:for=>/eventSelected/).exist?
+        list << row.label.text
+      end
+    end
+    names = []
+    list.uniq!
+    list.each do | item |
+      name = item[/(?<=\s).+(?=\s\s\()/]
+      names << name
+    end
+    return names
+  end
+
+  # Returns the date of the specified event
+  def event_date(event_name)
+    frm.table(:class=>/listHier lines/).row(:text=>/#{Regexp.escape(event_name)}/)[0].text
+  end
+
+  # Unchecks the checkbox for the specified event
+  def uncheck_event(event_name)
+    frm.table(:class=>/listHier lines/).row(:text=>/#{Regexp.escape(event_name)}/)
+  end
+
+  element(:import_events_for_site) { |b| b.frm.radio(:id=>"site") }
+  element(:import_events_for_selected_groups) { |b| b.frm.radio(:id=>"groups") }
+
+end