App general settings
Only Jira admins have permission to manage Agile Test general settings.
To access App Settings
Select the wheel icon (⚙️) in the top-right corner to open Jira administration.
Select Apps in the left-hand navigation.
Find Agile Test on the left panel.
1. Test environments
A test environment refers to the setup or infrastructure needed to carry out software testing activities. It is a controlled, isolated environment specifically designed for testing, ensuring that the software performs as expected.
During testing, Test Executions will be frequently created, and each one should be linked to a Test Environment, indicating the platform on which your tests are being conducted.
In order to add a new Test Environment, click on + New Test Environment button. Then fill in the information, and click on Create button.
2. Configuration
A. Enable AgileTest for Projects
On this page, you can enable or disable Agile Test plugin for specific projects. By default, AgileTest is enabled for all projects from your instance. To disable a specific project, simply search for specific ones and uncheck the checkbox.
Once disabled, the project will no longer appear on the Agile Test main page, and users will not be able to access the app from the project screen.
B. AI Configuration
The default language for AI generation is set to English. If you prefer a different language, simply select one from the dropdown list. Supported languages include English, French, German, Spanish, Portuguese, Dutch, Polish, Japanese, Korean, and Chinese.
For users who may not wish to use AI-generated content, this feature can be easily disabled at any time by switching off the toggle option.
3. Test step fields
Agile Test provides 3 default test step fields: Action, Data, and Expected Result. These step fields are flagged as DEFAULT and cannot be edited further.
However, these 3 step fields may not always be enough to fully define your test steps. You can create a custom step fields by choosing + New Test Step Field on the top right hand corner.
The custom step field is flagged as CUSTOM and can be enabled or disabled by selecting the option button in the Actions column.
The number of custom fields are limited to 7 only. If this limit is reached, user has 2 options
Update Existing Fields: Modify the details of your current custom fields to meet your needs.
Delete and Create New: Remove an existing custom field to make room for a new one.
Assignee is a step custom field, however it is not editable.
4. API Integration
In this setting, the admin user can create and manage Client IDs and Client Secrets, which are used to request credential tokens for accessing exposed APIs.
You can now create milestones, preconditions, test cases, test environments, test executions, test plans, and test steps directly through APIs.
Users can copy the necessary info when selecting Preferences from left side panel to create API key for some users.
Then navigate to the API-doc by accessing via this link “https://agiletest.atlas.devsamurai.com/api-docs/“. Once you have a temporary token generated earlier, users can use it inside the Authorization HTTP header.
Selecting each feature field in the provided API-doc “https://agiletest.atlas.devsamurai.com/api-docs/ “ for further instructions and personalization.
5. Test Step Statuses
In this setting, we allow users to manage available Test step statuses. The default statuses are To Do, Pass, and Fail. To add a new status, click + Test Step Status button.
Remember to map the new status to one of built-in statuses. Doing that will ensure your test statistics are compiled and used to calculate the final Test run result.
6. Test Types
In Agile Test, there are 3 default test types: Manual, Generic, and Gherkin. Each is linked to one of the built-in types: Steps, Unstructured, and Gherkin, respectively. This setting allows you to configure and manage all test types in your instance.
Steps: Each test case consists of a list of test steps. During testing, users go through the test steps one by one and mark their status accordingly.
Learn more about Test execution https://docs.devsamurai.com/agiletest/test-executions
Unstructured: Each test case contains a rich text field called 'Definition,' where you can input any details needed. This format is mainly used for automation tests, especially when test results are imported, either manually or automatically.
Gherkin: The test case is built using Gherkin scripts, which automatically support formatting and keyword prompts. With this type, you can utilize the common structure of 'Given, When, Then,' which defines the inputs, actions, and expected results for test steps.
Should you need any assistance or further AgileTest inquiries, contact here!