The history feature allows you to review the history of changes made to test cases and shared steps.
This makes it clear when the changes were made, by whom, and with what intent.
Table of Contents
Viewing changes
To view past changes, click "Show version diff" in the menu on the test case edit screen (or detail screen) to move to the history viewing screen.
Version history list
On the right side of the screen, you can see a list of the history saved so far. Comments, modification date and time, and user name are displayed.
The order of display is the newest first.
When the checkboxes on "Version history" are selected, the old version is reflected on the left of "Version diff" and the new version is reflected on the right.
*You cannot check more than 3 checkboxes.
Version diff
On the left side of the screen, the contents of each test step at the time selected in "Version history" are displayed.
Switching the UI thumbnail display
Similar to the test execution results screen, UI images can be displayed as thumbnails when hovering over each step.
This feature is disabled by default, but can be enabled by setting.
History of UI and UI elements for each step
The history of changes to the UI and the UI element specified for each step can be viewed on the history viewing screen.
Click the icons below to open the details of UI and UI element.
*This icon is displayed when the step's command has a target element and a valid UI element is set.
Pressing the icon opens the details of UI and UI element as shown below.
Here you will find the following information
- UI name
- UI image
- UI element (red boxed area)
- Element name
- Locator
Limitations
- In addition, the following data is not supported for displaying details.
- Command
- Web API call
- Assert no visual diff
- Draw a figure by freehand
- Set geolocation
- Click and upload file
- Command
Saving changes
You can save automatically or manually with comments.
Auto Save
When you edit a test case, it is automatically saved on MagicPod.
In the changelog, changes made within a certain period of time are saved as a single change, even if they were made multiple times.
Also, when a test case or a shared step is added by creating a new test case or duplicating, it is saved as initial data.
List of messages when auto-saving
- Autosaved: test case update
- Saved when a test case is updated.
- Autosaved: UI merge operation
- Saved when UI organization is executed.
- Autosaved: duplicate operation
- Saved when a test case duplicate operation is performed.
- Autosaved: initial data
- An empty step is saved as initial data when a test case is created.
- A shared step is saved as initial data when a shared step is created.
- Autosaved: shared step update
- Saved when a shared step is updated. (It is not displayed in the history of the test case edit page but in the history of the shared step edit page.)
- Autosaved: restore version of {Date} {Time Zone}
- By using the restore feature, it will be saved as a message when a test case or shared step is updated.
Manual save with comments
Changes to test cases and shared steps can be manually saved with comments.
Click on the "Save to history with a comment" button.
Enter your changes in the "Comment" field, which can be up to 255 characters long.
Press "Save" to save the changes with the comment on MagicPod. The details of the changes are automatically entered in the details field.
It overwrites the history automatically saved before that time within a certain period of time.
Restore feature
Test cases or shared steps can be restored to a point in time.
Restore operation
(1) Click the "Revert to this version" button of the version you wish to revert to,
(2) When the confirmation screen appears, click the "Revert to this version" button further.
Clicking the button starts the restoration of the test case or shared step.
When the restoration is completed, a message is displayed and the new history from the restoration operation is shown on the right side.
The following warning may be displayed at (2).
In this case, please execute the restore operation if there is no problem after confirming the warning.
The history is newly made and displayed in the displayed test case and shared step.
Data to be restored
- Test case
- Shared step
- Data pattern
- Shared step variables
- UI used within the step of the test case/shared step
Limitations
- Similar to difference highlighting, the restore function also supports the restoration of image difference confirmation names but does not support the restoration of image difference confirmation patterns or expected value images. (*This will be improved through future updates.)
- It is not possible to restore to a test case that contains a shared step that has already been deleted.
- Data prior to version 0.99.26 (March 26, 2023) cannot be restored.
If a test case uses a shared step, restoring the test case will not restore the shared step used to a certain point in time. If you want to restore a shared step, you need to restore it separately in the shared step history. - Basic information such as test cases, shared steps, and UI names are not restored.