Page History
Table of Contents | ||
---|---|---|
|
Overview
A Test Model is your test bench where you define all the parameters, rules so that the system can then generate all the scenarios and test scripts automatically. In this section we will go through the basic steps to create/copy your test models.
Actions
Create a Test Model
UI Steps | |||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||
|
Tip |
---|
Want to understand how to create a test model? Explore our Test Models samples. |
Import a Test Model from a File
Xray Test Case Designer allows you to import all types of details you might have in your model. The import feature is straightforward but fairly inflexible.
You can import from .xlsx ( MS Excel) or from OPML (Mind Mapping & Outlining).
Import from Excel
Provide an Excel spreadsheet with a sheet named Inputs. Each column in the sheet is a parameter and each row has parameter values:
Animals | Letters | Parameter 3 |
---|---|---|
Monkey | A | Value 1 |
Ferret | B | Value 2 |
C |
The spreadsheet must be in the Excel Workbook file format and end in a .xlsx extension. Save a spreadsheet in Excel Workbook format by selecting File→Save As and picking the .xlsx file type.
Info |
---|
To ensure you have the correct file format for importing, export an existing model, or start with this Excel example file. If you follow the format from an export or this sample, you can also import constraints, value expansions, notes, and auto-scripts from their respective sheets. |
Import from a Mind Map or Outline
Many mind mapping and outlining tools support exporting to OPML, a simple hierarchical format that can be used to define test model inputs only. To import from OPML, ensure your file name has a .opml extension.
Level | Usage | Notes |
---|---|---|
First outline level, if named with >3 characters and if they are all capital letters | Parameter Group | Optional way to group like parameters |
First outline level, or next level under a group | Parameter name | |
Next level | Parameter values | |
Next level | Values expansions | Optional |
Info |
---|
To ensure you have the correct format for importing, compare your file with this OPML example. |
UI Steps | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
|
Make a Copy of an Existing Test Model
UI Steps | |||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||
|
A couple of things to note:
“Model name” of the copy will just add “(copy)” to the original by default, but can be changed as long as it is unique in a given project or the private collection.
Project name has to be filled and should be unique per user account (i.e., another user can have a different project with the same name).
“Revision History” checkbox allows to preserve traceability of edits across plans. However, for old plans, it may be better to clear the history for faster performance.
“Switch” checkbox allows to instantly start working on the copied version. Uncheck it if you create something for the future needs and are not ready to edit it yet.
The copy of the model is ready to be used in the project you specified.
Edit Test Model Details
UI Steps | ||||||
---|---|---|---|---|---|---|
| ||||||
|
View Version and revert Test Model version (Revisions)
The Revisions option allows you to easily revert to a previous version of that test model.
We provide a list of each revision and the date so all you have to do is click a button to revert to that version. We also give you the option to copy that model (in case you want to view it, but also want to keep all the updates you have made since then) and create a new model based on that version.
When you are editing a test plan, you will see a Revisions link under the sub-menu of the plan name dropdown (see the image below)
Info |
---|
Revisions are available in editable test models, the revisions link is not available in un-editable test models (such as the “original” sample ones). |
For each revision three options are available:
- Revert
- Make a copy
- Download
A version of a model can be searched for by Label, User, and Update Details (e.g., typing “Java” in the search field would return “Revision 2”). The Revisions feature allows a solid version control of your test model.
Revert a Test Model version
To revert, click the Revisions link and a list of all versions of the model is displayed:
Review the Test Model
Add notes to the Test Model
Notes are specific to individual plans. They are located under Review in the left navigation pane and/or to the right from the plan name at the top.
Fill in the details of your note and click the “Create” button. Keep in mind that anyone with access the plan (including reviewers, etc.) can use this feature. This is usually a good thing.
If you need more context for a note, it may be useful to check the Revisions under the plan name dialog.
How many notes have been created for a plan? That information is shown here in the red counter at the top.
Delete a Test Model
UI Steps | ||||||
---|---|---|---|---|---|---|
| ||||||
|
Share a Test Model
First, open the model from the project that you would like to share. Next, click on “Share” underneath Review in the left navigation pane.
Info |
---|
If the plan is not yet in a project, you will first need to move it to a project. If the plan you are sharing is already in a project, you can skip this step. Please note that all of the plans in the project will be shared because sharing is done by project, not by individual plan. |
Add one or multiple email addresses, specify the rights to grant, and add the users.
The email address field will present the list of users from your organization upon partial match.
As explained in the table below, you can select different usage rights based on your preferences.
When sharing with someone who is not yet familiar with how to use Xray Enterprise Designer, you might want to select “Can Copy and Comment on Plans.” That way, the person you share with will be able to make comments to your plans and ask clarifying questions about it, but they will not be able to make changes to your plan.
Synchronize a Test Model
After you have designed your test model, you can synchronize to Xray so that you can then track test execution.
UI Steps | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||
|
To keep track of synchronizations, access the "Sync History" on the screen to track all synchronizations as well as its status:
Tip |
---|
To better track the issues created on Jira, system will add labels to issues with the test model ID and with a generic label to tag the issues synched from Xray Test Case Designer. |
...