- Get started
- About
- Conditions and validators comparison
- Migration to Cloud
- Connect to Assets API
- Use cases
- Dynamic Forms
- Dynamic Forms Overview
- Add Dynamic Fields
- Add Translations
- Configure Conditions
- Configure Validators
- Copy Dynamic Fields
- Display Dynamic Fields
- Dynamic Fields in Team-managed projects
- REST API
- Use Case
- Supported fields
- Bundled Fields
- Bundled Fields Overview
- Global Configuration
- Project Configuration
- Display Bundled Fields
- Search with Bundled Fields
- Automation
- Request details view
- Customization Overview
- Display Additional Details
- Display Attachments
- Display Related Issues
- Display SLAs
- Use Case
Dynamic Forms Use Case
Learn about exemplary configuration of Dynamic Forms
Objective
The aim of an exemplary configuration is to create a dynamically displayed request form for the Request new hardware request type which will require specific information concerning how soon new hardware is needed. Thanks to the configuration a reporter raises a precise request while the Support Team gets detailed information which is necessary for the team to plan equipment orders and distribution.
Before you start, make sure that the fields you want to display are added to the linked issue type. You can add fields to the issue type by editing the create screen for your project. For more information, see Atlassian documentation.
As any change in a request type is automatically saved and visible on the Customer Portal, we recommend to keep request forms Hidden from portal while modifying them.
Exemplary request form for the Request new hardware request type. As Urgency is set to Critical, the I need it before date picker is displayed.
Copy Description field
Steps
- Go to Project Settings > Customer form extension to access the Dynamic Forms configuration.
- Select Request new hardware from the Request Types list.
- Click Copy fields with configuration.
- Select from this request type. A dialog box window appears.
- Select Description and click Copy.
- To avoid duplication, remove the non-dynamic Description from the Fields Defined in Request Type section.
a. Click visit the request type page.
b. Go to the Request form tab.
c. In Visible fields, click Remove by Description.
d. Refresh the Dynamic Forms browser tab.
Result
The previously non-dynamic Description field is now a dynamic field. You can configure Conditions and Validators for the field or add Translations.
Add Dynamic Fields
Steps
- In the Dynamic Forms configuration, navigate to the Dynamic Fields section and click Manage fields.
- Select Approvers, Due date, and Urgency from the Request Types list.
- Click Save.
- In Display name fields, change display names of Description, Approvers, and Due date.
- Add Field help to all Dynamic Fields.
- Use drag and drop to change the order of fields so that Approvers is right below Description.
Result
Dynamic Fields are added to the Request new hardware request form. You can now add Translations and configure Conditions and Validators for them.
Add Translations
Steps
- In Project Settings > Customer form extension > select the desired request type and click Add translations.
- In Language, select Polish (Poland).
- Make sure Request new hardware is selected in Request Type.
- Provide Polish translations for Display name and Field help. Changes are saved automatically.
Result
The dynamic form for the Request new hardware request type is now available in Polish.
Configure Conditions
Steps
- In Project Settings > Customer form extension, go to the Dynamic Fields section and select Due date.
- Click Conditions in the Options column.
- In Select field, select Urgency.
- In Select condition, select is equal.
- In Select…, select Critical.
- Click the Add a condition to field icon.
- In Select condition, select is equal.
- In Select…, select High.
- Click Save.
Result
If the urgency of the request is Critical or High, the Due date date picker is displayed. This way, if the reporter needs to request hardware for a specific date, it can be indicated. As a result the Support Team will receive a precise timeframe to resolve the request, which will be helpful in planning actions such as placing an order.
Configure Validators
Steps
- In Project Settings > Customer form extension, go to the Dynamic Fields section and select Description.
- Click Validators in the Options column.
- In a new validator, select at least x characters.
- Type 1000 in the Minimal number of characters field.
- Click Save.
- Select the Approvers field.
- Click Validators in the Options column.
- In a new validator, select is required.
- Click Save
- Repeat steps 7, 8, and 9 for the Urgency field.
Result
Validators are configured and all fields, except Due date are required and cannot be empty. Description can be maximum 1000 characters long.
If you can’t find the answer you need in our documentation, raise a support request.
Include as much information as possible to help our support team resolve your issue faster.