Global Configuration

Learn how to configure Bundled Fields globally, so they can be used in spaces.

To start using Bundled Fields, their global configuration must be set up first. This configuration allows administrators to create, edit, delete, and make them available for specific projects (spaces).

In order to include Bundled Fields into request forms of a selected space:

• Create a bundle and configure its subfields.
• Assign the bundle to projects (spaces).
• Assign the bundle to request types.

Currently, the following field types are supported as subfields:

• Text field
• Text area
• Number
• Select (single and multiple)
• Date picker
• Date time picker
• Checkbox
• Radio button

Creating bundles

To make use of the Bundled Fields feature and create a bundle, follow the below steps.

Steps

1. Go to Marketplace apps > Manage apps > Extension for Jira Service Management > Bundled Fields.
2. Provide a name for a new bundle and click Create.

   

3. To insert subfields into the bundle, click Add subfields.

   

4. You are redirected to the view with the subfields configuration. To add a subfield to the bundle, click on it or use drag and drop.

   

   Tip

   • By using drag and drop you can insert subfields into the selected part of your bundle.
   • Once you click on the subfield to be added, it is automatically placed at the end of the subfields list. You can change the order of the list by using Layout Editor.
5. Give your subfield a unique name.
6. [Optional] Use the Display label toggle to manage the visibility of your Label on the Customer Portal. When the toggle is disabled, the subfield is displayed without any title.
7. [Optional] Provide a Label for the subfield to be displayed on the Customer Portal.
8. [Optional] Introduce a Description to provide users with information about the subfield.
9. [Optional] Check the Required field checkbox to set the subfield as required.
   Note

   In the Customer form extension configuration, you can only set conditions for a Bundled Field. It’s not possible to set a Bundled Field as required by using a validator.
10. [Optional] Click Remove to remove the selected subfield from the bundle.

    

11. After adding and configuring all desired subfields, you can customize their layout in Layout Editor. Use drag and drop to change the position of your subfields. You can also adjust the subfield size by clicking the marked bottom right corner. The custom layout will be displayed in request forms on the Customer Portal.
    Note

    The order of subfields on the list doesn’t affect their layout in Layout Editor.

12. Click Save to store the bundle configuration.

Result

Your bundle is created and its configuration is saved.

Using bundles

With Bundled Fields settings you can easily make the created bundle ready to be used and displayed on the Customer Portal.

Steps

1. Go to Extension for Jira Service Management > Bundled Fields > Preview to see how the created bundle will be displayed in a request form on the Customer Portal. The width and size of the preview accurately reflects the Customer Portal view.
   Tip

   By accessing Preview you can also see how many times users can duplicate your bundle on the Customer Portal. To change the number of duplicates, go to Settings.

   

2. Navigate to Settings where you can:

• determine the minimum and maximum number of duplicates of the bundle that can appear in a single request form.
• change the text which is displayed on the Customer Portal as New bundle button.
• manage editing of the bundle in Issue View.
• enable settings that automatically hide the subfields that have been added to the bundle by the administrator but have no data to be displayed to users.

3. Go to Request types to assign the bundle to relevant projects (spaces) and request types.

Tip

You can add a single bundle to multiple service projects (spaces) and request types.

4. [Optional] To remove the created bundle from the selected project (space) and related request types, use the Bin icon next to the project name.

5. [Optional] To remove the created bundle from particular request types, use the Bin icon next to the selected request type name.

6. [Optional] To access the configuration of the selected request form, click Edit form.

   Note

   By clicking the Edit form option you are redirected to the Space settings > Customer form extension view, related to the selected request type, where you can configure the request form. For more information, see Project Configuration.

7. [Optional] Click Customer Portal to view the preview of how the bundle will be displayed in a request form. Bundles are visible as the last items in request forms.

   

Result

The bundle is created, configured, and available in the Customer form extension configuration for the selected request types in the selected projects (spaces).

Shared subfields

By creating a new bundle, you can use the previously created subfields. The number of bundles in which a particular subfield is currently used is displayed next to the subfield name.

Subfields added to a bundle that are used in other bundles are marked as Shared In: number of bundles.

By introducing changes to the shared subfield configuration, you will affect all bundles in which it is used.

Permanent delete of subfields

To permanently delete a subfield, remove it from all bundles in which it is used. Next, you can create a new bundle or open an existing one, navigate to the Previously Created area on the right, and click the Bin icon next to the subfield you wish to delete.

Editing bundles

You can edit the configuration of the created bundles any time.

Steps

1. Go to Extension for Jira Service Management > Bundled Fields.
2. Click the bundle which you wish to edit.
3. Click the Pen icon next to the bundle name to edit it.
4. Click Edit subfields to edit subfields in the bundle and their layout.
5. Click Save to store the introduced changes.
   Info

   By clicking Discard all the introduced changes will be lost.

6. Go to Request types to edit projects and request types that are assigned for the bundle.
7. Go to Settings to edit the minimum and maximum number of duplicates of the bundle in a request form.

Result

All changes to the bundle configuration are saved.

Deleting bundles

Learn how to permanently delete the created bundles.

Steps

1. Go to Extension for Jira Service Management > Bundled Fields.
2. Click the bundle which you wish to delete.
3. Click the Bin icon next to the bundle name.
4. Click Delete to confirm that you wish to permanently remove the bundle.

Result

The selected bundle is permanently deleted.

Note

By deleting a bundle you can’t delete its subfields. The subfields remain visible by creating a new bundle. It’s possible to manually delete them from the right sidebar using the Bin icon.

Next steps

• For instructions explaining how to configure Bundle Fields in a project (space), see Project Configuration.
• For an overview describing the display of Bundled Fields in request forms, see Display Bundled Fields.