Rover 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 Enterprise Tester if it 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 Entities
Downloads 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 Serverin Enterprise Tester).
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 by clicking on the top level folder.
Once you have downloaded your entities, the download icon will disappear.
Uploading Entities to
...
Enterprise Tester
Once you have completed your testing, you can upload your runs and incidents back to the ET server Enterprise Tester 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 Enterprise Tester or created locally across all projects. you You can easily select the entities you wish to sync back to the ET ServerEnterprise Tester.
By default the Hide Synced button is checked. Only 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.
will be displayed.
To show all local entities in Rover deselect the Hide Synced checkbox.
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 button in the bottom left. This will initiate synchronization with Enterprise Tester.
While the synchronization is uploading to Enterprise Tester a progress is displayed on the screen
Once the synchronization is successful a prompt will be displayed. Click Ok to continue
the ET server. Once you have completed your synchronization only failed entities and entities that were deselected from the sync will be showndisplayed.
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 selectin the Purge Selected button.
Prompts for Synchronization
In the following scenarios a pop-up message will be displayed on the screen informing the user that there are un-synced items, and asking if they would like to sync them before leaving the action they are currently doing.
Opening Rover
When you open or log in to Rover, and are online, and there are unsynced items in the project;
- Selecting the OK button will take you to the Sync Dashboard screen.
- Selecting the Cancel button will close the pop-up message and no further action is taken.
Changing between Projects within Rover
When you are online, and you change projects, and there are unsynced items in the project;
- Selecting the OK button will close the pop-up message and leave the user on the current screen.
- Selecting the Cancel button will close the pop-up message and no further action is taken.
Closing Rover
When you close Rover, and are online, and there are unsynced items in the project;
- Selecting the OK button will close the pop-up message and leave the user on the current screen.
- Selecting the Cancel button will continue to close Rover.
Notes on Synchronization
Synchronization requires matching of the ET Enterprise Tester ID for each entity to successfully synchronize entities between Rover and the ET Enterprise Tester server. Some Some changes made to the ET Server Enterprise Tester server between downloading to Rover and uploading results and updated updates from Rover may cause synchronization issues. Below are some causes of synchronization failure:
- Deletions on the ET Server
- Enterprise Tester server - If script assignments are deleted from the the ET Server
- Enterprise Tester server , any runs or updates that have been created will not sync back to ET even if you re-create the script assignment. As
- Rover uses the ET
- Enterprise Tester ID to map entities back to the ET
- Enterprise Tester server, on deletion this ID will no longer exist and therefore cannot be mapped.
- be
- Baseline restore
- restores in ET
- Enterprise Tester - Baselines restores in ET
- Enterprise Tester should not be performed if you are also executing tests using Rover. Although
- Although a baseline restore does restore a project to a previous state, the IDs are not the same and will be replaced with new identifiers. Entities
- Entities will not be able to synchronize back to ET
- Enterprise Tester if a baseline restore is preformed
- performed between the download and upload of entities. Caution should be taken when considering a baseline restore.
- Custom field configuration - If custom field
- fields are made mandatory or new custom mandatory custom field
- fields are created and scoped to your project in between the synchronization of entities with Rover, this will cause the synchronization to fail as the mandatory requirements for saving have not been met. In
- In this case, you will need to make the the
- field not required then
- mandatory and initiate your synchronization.
Troubleshooting Synchronization
If 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 the Catch Support Team. The The Log files can be found with your Rover installation files.e.g. CC:\Program Files (x86)\ET+Rover+1.0.000\Log. Please Please also note the time of the failure.
Rover 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.