com.ibm.team.fvt.tests.clm.pages.rm
Class RmWebListPage

java.lang.Object
  extended by com.ibm.team.fvt.tests.web.WebPage
      extended by com.ibm.team.fvt.tests.clm.pages.ClmWebPage
          extended by com.ibm.team.fvt.tests.clm.pages.rm.RmWebPage
              extended by com.ibm.team.fvt.tests.clm.pages.rm.RmWebProjectAreaPage
                  extended by com.ibm.team.fvt.tests.clm.pages.rm.RmWebListPage
All Implemented Interfaces:
ClmWebPageConstants
Direct Known Subclasses:
RmWebArtifactsPage, RmWebCollectionsPage, RmWebModulesPage, RmWebShowArtifactPage

public abstract class RmWebListPage
extends RmWebProjectAreaPage

Abstract class to manage common actions to any RM application web page which is displaying artifacts list.

Following actions are accessible in this page:

Following functionalities are also defined or specialized by this page:


Field Summary
static java.lang.String PAST_WEEK
           
static java.lang.String TODAY
          Time-specific subsections within the 'Recent Artifacts' and 'Recent Comments' section
static java.lang.String YESTERDAY
           
 
Fields inherited from class com.ibm.team.fvt.tests.web.WebPage
NO_DATA
 
Fields inherited from interface com.ibm.team.fvt.tests.clm.pages.ClmWebPageConstants
ADMINISTRATION_HOME_MENU_GROUP, JAZZ_TEAM_SERVER_HOME_MENU_ITEM, LIFECYCLE_PROJECT_ADMIN_MENU_ITEM, USER_NOT_AUTHORIZED_MESSAGE_ID, USER_NOT_AUTHORIZED_MESSAGE_LOCATOR
 
Constructor Summary
RmWebListPage(java.lang.String url, ClmConfig config, com.ibm.team.fvt.tests.config.User user, java.lang.String... data)
           
 
Method Summary
 void addColumns(java.lang.String[] columns)
          Add columns to display in collection items table.
 void checkResourceLinkElements(java.lang.String artifact, java.lang.String[] columns, java.lang.String[] resources)
          Deprecated. Use checkResourceLinkElements(String, String[], String[], String[]) instead. Using this method will throw a ScenarioFailedError error while running your scenario.
 void checkResourceLinkElements(java.lang.String artifact, java.lang.String[] columns, java.lang.String[] resources, java.lang.String[] projectAreas)
          Check link elements for the given artifact.
 void clearAllFilters()
          Clears all the filters.
 RmWebShowCollectionPage clickOnCollection(java.lang.String collection)
          Click on the given collection link.
 RmWebShowModulePage clickOnModule(java.lang.String module)
          Click on the given module link.
 RmWebShowRequirementPage clickOnRequirement(java.lang.String requirement)
          Click on the given requirement link.
 void editArtifactColumn(java.lang.String artifactName, java.lang.String newValue, java.lang.String column)
          Changes the provided columns value with the provided value
 boolean exists(java.lang.String artifact)
          Check whether the given artifact exists or not.
 boolean exists(java.lang.String artifact, java.lang.String column)
          Check whether the given artifact exists at the given column or not.
 int getArtifactsDisplayedCount()
          Get the number of artifacts displayed on the page.
 int getArtifactsTotalCount()
          Get the total number of artifacts selected by the filters in effect.
 java.lang.String getResourceID(java.lang.String artifact)
          Return the ID of the artifact with the given name.
 void lockArtifact(java.lang.String artifact)
          Locks the specified artifact by selecting the 'Manually Lock Artifact for Editing' menu option from the popup-menu.
 void refreshList()
          Refresh the artifacts list.
 void unlockArtifact(java.lang.String artifact)
          Unlocks the specified artifact by selecting the 'Unlock Artifact' menu option from the popup-menu.
 
Methods inherited from class com.ibm.team.fvt.tests.clm.pages.rm.RmWebProjectAreaPage
getProjectAreaName, getProjectAreaTitle, gotoArtifactsPage, gotoCollectionPage, gotoCollectionsPage, gotoModulePage, gotoModulesPage, gotoRequirementPage, searchForArtifact
 
Methods inherited from class com.ibm.team.fvt.tests.clm.pages.rm.RmWebPage
getAdminUIPopupMenu, getAllProjectAreasPage, getHelpPopupMenu, getSidebarSectionItemsCount, getUserPopupMenu
 
Methods inherited from class com.ibm.team.fvt.tests.clm.pages.ClmWebPage
checkRichHover, clickHomeMenuItem, getBannerTitle, getCcmApplication, getConfig, getDmApplication, getJtsApplication, getLpaApplication, getMiniDashboard, getQmApplication, getRmApplication, getTitle, getUser, gotoCcmProjectPage, gotoCcmProjectPage, gotoDmProjectPage, gotoDmProjectPage, gotoJtsAdminHomePage, gotoLpaAllProjectsPage, gotoQmProjectPage, gotoQmProjectPage, gotoRmProjectPage, gotoRmProjectPage, logout, openAdminUIMenu, openHelpMenu, openHomeMenu, openMenu, openMenu, openToolbarMenu, openUserProfileMenu, refresh, save, waitWhileBusy
 
Methods inherited from class com.ibm.team.fvt.tests.web.WebPage
changeUser, checkHoverTitle, checkRichHover, get, getBrowser, getLocation, getPage, getPage, getPageUsingBrowser, goBack, openPage, openPage, openPageUsingBrowser, openPageUsingHoverTitle, openPageUsingLink, openPageUsingLink, openPageUsingLink, openPageUsingLink, openPageUsingLink, openPageUsingLink, richHoverOverLink, toString
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

TODAY

public static final java.lang.String TODAY
Time-specific subsections within the 'Recent Artifacts' and 'Recent Comments' section

See Also:
Constant Field Values

YESTERDAY

public static final java.lang.String YESTERDAY
See Also:
Constant Field Values

PAST_WEEK

public static final java.lang.String PAST_WEEK
See Also:
Constant Field Values
Constructor Detail

RmWebListPage

public RmWebListPage(java.lang.String url,
                     ClmConfig config,
                     com.ibm.team.fvt.tests.config.User user,
                     java.lang.String... data)
Method Detail

addColumns

public void addColumns(java.lang.String[] columns)
Add columns to display in collection items table.

Parameters:
columns -

checkResourceLinkElements

@Deprecated
public void checkResourceLinkElements(java.lang.String artifact,
                                                 java.lang.String[] columns,
                                                 java.lang.String[] resources)
Deprecated. Use checkResourceLinkElements(String, String[], String[], String[]) instead. Using this method will throw a ScenarioFailedError error while running your scenario.

Check link elements for the given artifact.

The links are expected to be found in the given column names and pointing to the given resources.

If one resources slot is null, then the corresponding column is not expected to have any link.

Parameters:
artifact - The artifact name
columns - The column names.
resources - The resources expected to be found in given columns.
Throws:
com.ibm.team.fvt.tests.scenario.errors.ScenarioFailedError - If one link is missing.

checkResourceLinkElements

public void checkResourceLinkElements(java.lang.String artifact,
                                      java.lang.String[] columns,
                                      java.lang.String[] resources,
                                      java.lang.String[] projectAreas)
Check link elements for the given artifact.

The links are expected to be found in the given column names and pointing to the given resources.

If one resources slot is null, then the corresponding column is not expected to have any link.

Parameters:
artifact - The artifact name
columns - The column names.
resources - The resources expected to be found in given columns.
projectAreas - The project areas of the given resources
Throws:
com.ibm.team.fvt.tests.scenario.errors.ScenarioFailedError - If one link is missing.

clearAllFilters

public void clearAllFilters()
Clears all the filters.


clickOnCollection

public RmWebShowCollectionPage clickOnCollection(java.lang.String collection)
Click on the given collection link.

Parameters:
collection - The name of the collection to click on

clickOnModule

public RmWebShowModulePage clickOnModule(java.lang.String module)
Click on the given module link.

Parameters:
module - The name of the module to click on

clickOnRequirement

public RmWebShowRequirementPage clickOnRequirement(java.lang.String requirement)
Click on the given requirement link.

Parameters:
requirement - The name of the requirement to click on

editArtifactColumn

public void editArtifactColumn(java.lang.String artifactName,
                               java.lang.String newValue,
                               java.lang.String column)
Changes the provided columns value with the provided value

Parameters:
artifactName - the artifact being targeted
newValue - the value to be entered
column - the column being edited

exists

public boolean exists(java.lang.String artifact)
Check whether the given artifact exists or not.

Parameters:
artifact - The artifact name
Returns:
true if the artifact is in the artifacts list, false otherwise.

exists

public boolean exists(java.lang.String artifact,
                      java.lang.String column)
Check whether the given artifact exists at the given column or not.

Parameters:
artifact - The artifact name
column - The column name
Returns:
true if the artifact is in the artifacts list at the expected column, false otherwise.

getArtifactsDisplayedCount

public int getArtifactsDisplayedCount()
Get the number of artifacts displayed on the page.

This information is shown in the bottom of the page.

Returns:
The number of artifacts displayed on the page

getArtifactsTotalCount

public int getArtifactsTotalCount()
Get the total number of artifacts selected by the filters in effect.

This information is shown at the bottom of the page.

Returns:
The total number of artifacts selected by the filters on the page

getResourceID

public java.lang.String getResourceID(java.lang.String artifact)
Return the ID of the artifact with the given name.

Parameters:
artifact - The artifact name
Returns:
The ID of the resource, or null if artifact does not exist.

lockArtifact

public void lockArtifact(java.lang.String artifact)
Locks the specified artifact by selecting the 'Manually Lock Artifact for Editing' menu option from the popup-menu.

Parameters:
artifact - The artifact to lock, identified by its name.

refreshList

public void refreshList()
Refresh the artifacts list.

Wait for the "Loading Artifacts..." status message to be displayed and vanished before returning, hence we're sure that all artifacts are loaded

Note that it may happen that either the status message display is too quick to be captured or even it does not appear at all (guessing that it depends on javascript speed execution...). In this case, it returns after WebPage.shortTimeout() seconds.


unlockArtifact

public void unlockArtifact(java.lang.String artifact)
Unlocks the specified artifact by selecting the 'Unlock Artifact' menu option from the popup-menu.

Parameters:
artifact - The artifact to unlock, identified by its name.