We are very excited to introduce Enterprise Tester Rover, our new mobile plugin for ET which gives users RoverX is a plugin for Enterprise Tester that provides users with the flexibility to test conduct testing anywhere. With Rover, users will now be able to access ET’s core features whether you’re working offsite or all the way , including in remote locations or even in outer space.!
Panel |
---|
Features
|
Panel | ||
---|---|---|
| ||
|
Panel | |||||
---|---|---|---|---|---|
System RequirementsRover RoverX is a plugin for Enterprise Tester and allows users to be able to work with ET data offline. Getting started is easy and there are only a few simple requirements: that enables offline access and management of Enterprise Tester data. To get started, ensure the following requirements are met:
Enterprise TesterRover is compatible with Enterprise Tester 4.10 and above. Enterprise Tester
RoverX is a plugin for Enterprise Tester that enables offline access and management of Enterprise Tester data. To ensure compatibility and functionality, please meet the following requirements:
Applying your Rover LicenseTo apply your Rover License, you will need to have Administrator rights to Enterprise Tester. Navigate to the Admin tab, expand the Extensions folder and double click on Rover. Add the license text ( if you do not have a license text, please contact Catch Sales) to the License Text field: Operating Systems (Client)The client application supports the following Operating Systems:
.NET FrameworkRover requires .NET 4.5 to be installed. When installing the .Net Framework 4.5 you have two options - either installing install from a "web download" (a small download, which will then install only the components you require) or you can download a "redistributable" which is a large file containing all the files necessary for the .Net Framework 4.5 to be installed on any machine. If you plan on installing the Framework on more than one machine within your organization it is suggested that you use the redistributable, to avoid multiple downloads. The web downloader can be downloaded from: http://www.microsoft.com/en-us/download/details.aspx?id=30653 The redistributable can be downloaded from: http://download.microsoft.com/download/2/7/3/273CB528-CAB3-4E8D-88D2-4477F0A1DAE4/enu_vs_common/netfx_ult/dotnetfx45_full_x86_x64.exe |
Panel | |||||
---|---|---|---|---|---|
Getting StartedEnterprise Tester Rover RoverX is an offline mobile client for Enterprise Tester . Rover gives you the that provides flexibility to run your tests and log incidents offline when internet access maybe limited or unavailable. With Rover, you can: without internet access. Here’s a detailed look at its capabilities: Key Features and Functions:
Usage Workflow:
RoverX ensures that testing processes can continue seamlessly even in remote or offline conditions, making it a versatile tool for testers working in diverse environments.
|
Info | ||
---|---|---|
| ||
If your machine or device is used by multiple people (e.g. pool resource), then we recommend that you install Rover into a directory that is associated with your personal profile rather than a shared directory. |
The first time you log into the client, you will need to be able to connect to your ET server. This may mean that you need to be connected to the internet or be able to access your corporate or office network.
From the Login screen, enter in your ET Server URL, username and password.
If you do not have a Rover license applied to your installation of ET Enterprise Tester on the server, a message will appear alerting you that the license is missing or expired. If you see this message please contact your ET Enterprise Tester system administration to check your ET Rover license.
Download ET Users to Rover
Once you have successfully logged into Rover you need to download users from ET Serve to Rover. This enables you to Assign Bugs when using Rover.Click on the User Sync icon in the left hand menu
Once the User Sync has completed the The following message will be displayed on the screen.
Click on the . Select OK button to continue.
Viewing your Projects
Once you have successfully logged into Rover the view will default to the Execution Set of the first project in your project list:
You can change the project in view by selecting the project drop down. The project listed will depend on the projects your user account has access to on the ET server and will be listed in the same order as listed in the explorer navigator:
In ET, the navigator shows the following:
The project category structure and the order of projects is retained.
Navigating Rover
The Navigator on the left side provides 4 view options:
Above the tabs you'll notice a status icon. This will tell you if you are connected to the server or not.
The following icon indicates that you are not connected to the server.
The next image shows that you are connected to the server.
Entity Icons
Rover has a number of entity icons that denote the state of the entity (script assignment or incident). The tables below show each icon and the state of the entity.
Script Assignments
Incidents
Execution Tests
Rover provides you with the ability to run tests from Enterprise Tester when you are on the go - working in remote locations, or in areas where internet connectivity is unreliable or unavailable.
Rover supports synchronizing both script assignments and incidents with Enterprise Tester. This article covers synchronizing and running script assignments.
Although internet access is not required to run tests in Rover, internet access is required:
- When downloading script assignments and incidents from the ET server.
- When uploading test run results, new incidents and new comments on existing incidents to the ET server.
The Getting Started article provides an introduction to help users become familiarized with Rover.
Copying Scripts and Execution Sets to Rover
An internet connection is required for this task.
After logging into Rover, the navigator will display the execution set folders and their script assignments (but not their agile runs) in the first project listed in the Enterprise Tester navigator.
In Enterprise Tester:
In Rover, the execution icon is highlighted in green and the contents of the default project is displayed:
You can change the project by selecting from the drop down list. Projects are organised into categories, just like in ET. Users will only be able to see projects that are defined in their user permissions on the ET server.
Once the project is selected, you can then review and select the execution sets you wish to download from the ET server.
To download execution sets, click on the folder or the individual script assignment you wish to select. You can also download all execution sets and script assignments by clicking on the top execution set folder.
Execution sets and script assignments that have not yet been downloaded (or have been changed since you last downloaded) to your device will display the download icon:
Once you have downloaded the execution set or the script assignment, the download icon will disappear.
You'll also notice that once a script assignment has been downloaded from the server to the client device, the script assignment icon will change from:
- White left corner with a green dot - this icon denotes that the script assignment is on the server and has not been downloaded.
to:
- solid green square - this icon denotes that the script assignment has been downloaded, and has not yet been altered on the client device.
You can view a list of all icons on the Entity Icon section of the Getting Started article.
Viewing and Running Tests
Once you have downloaded your script assignments, depending on the machine or device you are using, you can click or tap on the script assignment in the tree view to view or run your script.
The Script Description, Script Objective, Script Pre-Conditions, Script Post Conditions, Script Notes, all completed script custom fields and the run history will display on screen.
You can click or tap to view any of the previous run on the run history grid. The run history grid will provide you with some basic details including the Run Number, the Run By details, the status of each run and the Sync Status. The sync status will tell you whether the run has been recorded on the server or whether it only resides locally.
Starting a New Run
You can start a new run by clicking or tapping on the Create New Run button located above the run history grid. This will load the run screen which will provide you with all the custom fields scoped for script assignments and you'll also see your steps in a list view. You'll also see:
- The run number
- Step status icon (on each step)
- Step status bar (to the right of the scrollbar)
- The active step is highlighted with a blue border
- Step naviation and Result menu at the bottom of the screen
Similarly to executing a test run in ET, there is a text field for entering actual results. While a step is active you can click or tap on the step result at the bottom of the screen to set that step's status. If you pass a step, the next step will automatically be selected, otherwise the actual result field will be focused so that you can start typing. There are keyboard shortcuts for this screen:
- Ctrl+Up selects the previous step
- Ctrl+Down selects the next step
- Ctrl+P passes the current step
- Ctrl+F fails the current step
- Ctrl+B blocks the current step
- Ctrl+U marks the current step as undetermined
If you wish to quickly pass all steps, you can click or tap on the "hamburger" icon (≡) and select "Pass All".
Depending on the status for the step you'll notice that a status icon will be added to the step and the step background will be shaded. You'll also notice that the bottom status menu highlights the status of the current step. In the image below, Step 2 is highlighted and the status is failed. You'll also notice that the status bar is color coded according to the status of each step. This makes it easy to see the status of each step at a glance.
Passed
Failed
Blocked
Undetermined
Failing a Step and logging an Incident
To log an incident on a failed step, click or tap on the Incidents button under the Actual Results field on the step to open the incidents screen.
The incidents screen will display:
- Any incidents that are already linked to the step
- An area for creating a new incident, or linking to an existing incident that was either downloaded from the ET server or was previously created
Type in a name and click on the Create Incident button to open the incident create screen. Complete the fields and click on save to create a new incident and link it to the step.
As you type a name, you'll also see the list of existing incidents narrow down. Click "Link" on one of these if you'd prefer to link to an existing incident instead of creating a new one. For more information on linking incidents, see Incidents.
Close the window to return to your run. Once you have completed the run, the icon in the tree for the script assignment should now show which indicates that the script assignment has local changes which have not yet been uploaded to the server. See Synchronization to find out how to upload these changes back to the server.
Limitations
Rover does not currently support the following ET features:
- agile runs
- run timer
Incidents
Rover provides you with the ability to run tests from Enterprise Tester when you are on the go - working in remote locations, or in areas where internet connectivity is unreliable or unavailable.
RoverX will restart and by default will be in Offline mode.
Select the icon to go to Online mode. When in Online mode the icon will be green.
Note: Once you click the Login button when you are online this will download all active Enterprise Tester users. This will enable you to assign incidents to users.
If a different user wants to login to RoverX on you device the following message will be displayed.
Confirm the Restart: When prompted with the message "Select OK". RoverX will restart.
Viewing your Projects
When you log in to RoverX for the first time Project field will be blank.
Open the Project List: Click on the down arrow located above the search field. This will display a list of available projects from Enterprise Tester.
View Available Projects: Projects that appear in light grey are Categories within Enterprise Tester. The list of projects shown will depend on the projects your user account has access to in Enterprise Tester.
Select a Project: From the Project drop-down list, choose a project.
Viewing Execution Sets and Packages
Alphabetical Order: Once a project is selected, the Execution Sets and Packages will be displayed in alphabetical order.
Change Project: To view execution sets and packages from a different project, simply select a new project from the Project drop-down list.
In Enterprise Tester, the Explorer Tree shows the following:
The project category structure and the order of projects is retained.
The next time you log in to RoverX the last project selected will be displayed by default.
Navigating Rover
The Navigator on the left side of the RoverX interface provides five key options:
- Refresh: Update the current view to reflect any recent changes or updates from Enterprise Tester server.
Test Execution: Access and manage test executions, including starting new test runs and viewing existing ones.
- Sync Dashboard: Manage and view the sync status, including uploading changes to Enterprise Tester when online.
Online/Offline Mode: Toggle between online and offline modes to manage your test runs and data access as needed.
User Settings: Access and modify your user settings for RoverX.
These options help you navigate and utilize the various features of RoverX efficiently.
Online/Offline Modes
The Online/Offline option can be toggled to indicate your connection status with the Enterprise Tester server.
Offline Mode:
- When you are not connected to the server, RoverX will display an indicator like the following image:
- When you are not connected to the server, RoverX will display an indicator like the following image:
Online Mode:
- When you are connected to the server, the indicator will change to show that you are online.
- When you are connected to the server, the indicator will change to show that you are online.
Toggling between these modes allows you to manage your connection status and perform tasks accordingly.
Search Bar
To find specific items within RoverX, follow these steps:
Enter Search Criteria: Type your search terms into the Search field.
Execute the Search: Press <Enter> on your keyboard or select the Search icon.
View Search Results: The search results will be displayed in the tree view. Only items that match your search criteria, along with their parent folders, will be shown.
- Expand Folders: You may need to expand the folders in the tree view to see all relevant search results and their associated items.
- View Test Runs: Click on the packages to see the test runs returned in the search.
User Settings
User settings are accessible by selecting the Settings button at the bottom left-hand side of the screen. You can manage various settings as follows:
Edit Enterprise Tester URL:
- Modify the URL for your Enterprise Tester server if needed.
Change Password:
- Update your password if it has changed on the Enterprise Tester server.
Delete All Data from Local Database:
- Remove all data stored locally in RoverX. This action clears the local database.
Access Log Files:
- Navigate to the directory containing the log files for RoverX for troubleshooting purposes.
Deleting All Data from Local Database
Warning: This will delete any local test runs or incidents that have not been uploaded to the Enterprise Tester server.
To Delete All Data from the Local Database:
Initiate Deletion:
- On the Login page, select the Delete All Data button.
Confirmation Message:
- A confirmation message will be displayed:
- Select Yes if you are sure you want to proceed.
- A confirmation message will be displayed:
Completion Message:
- Once the local database has been deleted, a message will be displayed:
- Once the local database has been deleted, a message will be displayed:
Restart RoverX:
- Select the OK button. RoverX will restart automatically.
Reconnect and Download:
- Once RoverX has restarted, you will need to connect to the internet and go to Online mode to download Test Execution sets and associated incidents.
This process ensures that you start with a clean slate, but be mindful to upload any pending data to the Enterprise Tester server before proceeding.
Expanding and Collapsing the Right-Hand Panel
The right-hand panel can be expanded and collapsed on any of the screens by selecting the expand /collapse button at the top of the right-hand panel. This allows you to manage the workspace effectively by showing or hiding additional information as needed.
Invoke Error
This error message appears when an action is attempted while another process is still running in the background.
Please wait for the current process to complete before trying again.
For example, this can happen when toggling quickly between Online and Offline mode.
Click "OK" to close the error dialogue. This error does not impact the functionality of the RoverX application.
Additional Error Message:
You may encounter another similar error message.
Click "OK" to close it. Like the Invoke Error, it does not affect the operation of the RoverX application.
Panel | ||||||
---|---|---|---|---|---|---|
Test Execution
RoverX provides you with the ability to run tests from Enterprise Tester when you are on the go - working in remote locations, or in areas where internet connectivity is unreliable or unavailable. RoverX supports synchronizing both test runs and incidents with Enterprise Tester. This article covers synchronizing and running test runs.
The Getting Started article provides an introduction to help users become familiarized with RoverX. Downloading Execution Sets to RoverXAn internet connection is required for this task. Make sure you are in Online mode in RoverX.
This process allows you to work with Execution Sets offline after downloading them from Enterprise Tester. Selecting a Project
Selecting execution sets
To view test runs in RoverX, follow these steps:
Execution sets and individual test runs that you have not yet downloaded to your device, or that have been changed since your last download, will display a download icon . This helps you identify which items need to be downloaded or updated. Download execution sets
While downloading, a progress bar will be displayed to show the download status. Once you have downloaded the execution set or the test runs the download icon will change to . To download one or more test runs, select the folder where the test runs are located. Test Run DetailsWhen viewing test run details in RoverX, they are displayed on the right-hand side of the screen. The following columns are included in the test run details:
Viewing and Running TestsOnce you have downloaded your test runs, you can click or tap on the test run in the table, depending on the device you are using, to view or execute your script. Displayed FieldsWhen you view a test run, the following fields will be displayed on the screen. Note that if any fields are blank in Enterprise Tester, they will not appear in RoverX.
Run HistoryYou can choose to view any of the previous runs on the run history grid. The run history grid provides some basic details, including:
When you load the Test Execution screen, you will see the test steps displayed in a list view. This screen provides the following details:
|
Panel | ||||||
---|---|---|---|---|---|---|
Incidents
RoverX is a tool that enhances the testing capabilities of Enterprise Tester, particularly useful for remote or offline environments. Here’s a summary of its key features and requirements: Key Features:
Internet Connectivity Requirements:
Limitations:RoverX does not currently support the following Enterprise Tester features:
These limitations mean that certain features available in Enterprise Tester will not be accessible while using RoverX. The Getting Started article provides an introduction to help users become familiarized with RoverX. Managing IncidentsIn RoverX, you have the option to manage incidents by either creating new ones or linking them to existing downloaded incidents.
Create IncidentTo log an incident on a failed test step, follow these steps:
External Jira LinksWhen creating an incident, you have the option to link it to an external Jira system, provided that integration has been configured in Enterprise Tester for your project.
This allows you to ensure that incidents are properly linked and synchronized with your external Jira system if configured.
Priority: Status: Type: Resolution: Assigned To: Note: If there is nothing in the Assign To: field , this usually means you have not synced the users from Enterprise Tester to Rover. Description field In Enterprise Tester: In Rover: Editing an Incident:You can edit an incident while it is still local (i.e., has not been synchronized to Enterprise Tester).
Linking Incidents to a Test Step You can view all linked incidents, link additional incidents, or create a new incident. Here’s how to manage incident links:
Returning to the Test Execution ScreenTo return to the Test Execution screen after managing incidents:
This process ensures that you exit the incident management screens and return to your test run view. Synchronizing Runs and IncidentsOnce you have completed your testing, you can synchronize your runs and incidents back to Enterprise Tester. For detailed instructions on how to perform synchronization, please refer to the Synchronization article. |
Panel | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Synchronization
RoverX provides a convenient way to copy your Execution Sets and Incidents to your client machine or device, enabling offline testing. When you are reconnected, you can upload your test runs and incidents back to Enterprise Tester. To synchronize your Execution Sets and Incidents:
Uploading Entities to Enterprise TesterOnce you have completed your testing, you can upload your runs and incidents back to Enterprise Tester by navigating to the Sync Dashboard. To Upload Your Runs and Incidents:
Sync Dashboard at a GlanceThe Sync Dashboard provides a comprehensive view of the synchronization status, allowing you to monitor upload progress and ensure successful data transfer.
Synchronization Process for Completed Test Runs
To ensure smooth and accurate synchronization to Enterprise Tester, the synchronization process is as follows: 1.Upload Completed Test Runs:
2. Upload Incidents Associated with Test Runs:
3. Upload Attachments:
| ||||||||||||
Panel | ||||||||||||
SynchronizationRover provides a convenient way to copy your Execution Sets and Incidents to your client machine or device to enable offline testing. To synchronize your Execution Sets and Incidents you will need an internet connection or be able to access your ET Server if your ET site is not accessible through the internet. This may mean that you need to be connected to your office network for the download and upload processes. Downloading EntitiesDownloads are performed on the entity (Execution Sets and Incidents) screen. If you are planning to download both script assignments and incidents, then you will need to navigate to each tab and and select the entities you wish to download to your local machine or device. In Rover, you can select the drop down next to the project name to display all available projects (this depends on your permission settings on the ET Server). Once the project is selected, select the tab for the entity you wish to download. The green play tab represents Execution Sets/Test Runs and the orange bug tab represents Incidents. Execution Sets/Test Runs Incidents To download entities, click on the download icon next to the folder or the individual entity you wish to select. You can also select all folders and entities for download but clicking on the top level folder. Once you have downloaded your entities, the download icon will disappear. Uploading Entities to the ET ServerOnce you have completed your testing, you can upload your runs and incidents back to the ET server by navigating to the Sync tab. The Sync Dashboard will provide you with a list of all entities, both script assignments and incidents, that have been downloaded from the ET Server or created locally across all projects. you can easily select the entities you wish to sync back to the ET Server. You can select the top level folder to select all entities under the folder or select the Hide Synced option to only show entities that have changed since the last synchronization and select only those entities. You may notice a yellow warning icon appears when you you have selected some of the script assignments. This warning indicates that the run may not be complete. If you proceed with the sync, the run will automatically completed and you will not be able to resume the run. You may wish to deselect these entities before proceeding. When you are ready to sync, select Sync Selected. This will initiate synchronization with the ET server. Once you have completed your synchronization only failed and entities that were deselected from the sync will be shown. If a failed icon appears, hover the mouse or press & hold your finger on the icon to view the message. In some cases, you may need to try re-syncing. If you receive the error: "This item has been deleted from the server and cannot be synchronized, it can only be purged", then this means that the script assignment in the execution set in your ET project has been deleted and Rover cannot map this entity back to the server. The only option is to delete the entity. Before you delete the entity you can review it for data that you don't wish to lose. Once you have completed synchronizing your results, you may wish to clean up your local database by deleting the entities stored locally. You can do this by again selecting the entities and then clicking or tapping the Purge Selected button. Notes on SynchronizationSynchronization requires matching of the ET ID for each entity to successfully synchronize entities between Rover and the ET server. Some changes made to the ET Server between downloading to Rover and uploading results and updated from Rover may cause synchronization issues. Below are some causes of synchronization failure:
Troubleshooting SynchronizationIf you are having trouble diagnosing the cause of your synchronization failure, please send send a copy of your Rover log file for the day that your the sync failed to the Catch Support Team. The |