Show a settings summary in collapsed sections of the definition form
Description
Problem
In the approval definition form, some options of the definition settings and of the step panel sit in collapsible sections. A collapsed section does not tell what is set inside it. Some sections are on by default (for example "Webhook notifications", "Watcher notifications", "Availability") and others are off by default (for example "Add comment on action", "Automatic reminders", "Field updates"), so an admin cannot tell how the definition behaves without opening every section. Global settings already solve this with a summary in the header of a collapsed section.
Change
Every collapsible section in the definition settings and in the step panel shows a short summary at the right of its header while it is collapsed, and hides it while it is expanded. The format is the one global settings use:
-
A section with one option shows On or Off.
-
A section with several options lists only the enabled ones, for example "Approval, Rejection: On", and shows Off when none is enabled.
-
A section that holds values shows the values instead of On, for example "Every 2 days" or "Optional • default 1 week", and Off when nothing is set.
The summary follows the form while the admin edits it, before anything is saved. In the read-only view it shows the saved settings. Sections open and close as today: a section that holds a non-default setting still opens by itself when the form loads, and its summary shows once it is collapsed.
A long summary sits at the right edge of the header, is cut off with an ellipsis and shows its full text on hover. The header is shared with global settings, so their summaries get the same layout.
Summaries per section:
|
Section |
Summary, for example |
|---|---|
|
Conditions (Jira) |
The condition and the label rule: "Open bugs • Labels: all of 2, none of 1" |
|
Label condition (Confluence) |
The label rule: "Labels: any of 2, none of 1" |
|
Availability |
Manual start and the work item types: "Manual start, All work item types", "2 work item types"; Confluence: On / Off |
|
JSM settings |
"Available to customers, Public comments: On" |
|
Page versioning (Confluence) |
"Current version • re-approve: Approved, In progress" |
|
Automatic reminders |
"Every 2 days, creator included" |
|
Approval decision deadline |
"Custom • max 1 month • default 1 week" |
|
Validity expiration settings |
The type, the period or date, and what happens on expiry: "Required • 6 months from approval date • relaunch" |
|
Slack notifications |
The workspace as named in the picker and the channel override: "Default (Acme)", "Sales (Acme) • channel C0123456789" |
|
Webhook notifications, Watcher notifications |
On / Off |
|
Audit |
Unchanged (definition ID, version, date, author) |
|
Step: Conditions / Label condition |
As in the definition settings |
|
Step: Add comment on action |
"Approval, Rejection: On" |
|
Step: Watcher notifications |
On / Off |
|
Step: Voting deadline |
The date, time and UTC offset: "2026-11-02 14:00 (UTC+01:00)" |
|
Step: Group members (group step) |
"Excluded: Approval creator, 3 users • Skip when empty" |
|
Step: Group approval (work item field user step) |
The votes required: "2 to pass, 1 to fail" |
|
Step: Exclude from group (work item field user step) |
"Approval creator, 1 user field" |
|
Step: Field updates |
"Dynamic update, Remove when cleared: On" |
Sections added by work not yet in dev get a summary the same way when that work and this ticket meet: "Required comments" (AP-2487, the renamed "Add comment on action"), "Teams notifications" (AP-2146), "Business time" and the new voting deadline options (AP-2466).
Acceptance criteria
-
Every collapsible section in the definition settings and in the step panel shows a summary while collapsed and hides it while expanded.
-
A section with a single option shows On or Off, also when the option is on by default. For example "Webhook notifications" on a new definition shows On.
-
A section with several options lists only the enabled ones and shows Off when none is enabled.
-
A section with values shows them: the deadline type and periods, the reminder interval, the Slack workspace, the number of excluded users and user fields.
-
After changing an option and collapsing the section, the summary shows the new state before the definition or the step is saved. Cancelling and opening it again shows the saved state.
-
In the read-only view, the summaries show the saved settings.
-
A long summary is cut off with an ellipsis at the right edge of the header and shows its full text on hover. It does not push the section name or wrap the header, in the definition settings, in the step panel and in global settings.
-
Sections expand and collapse as today.
Manual tester notes
-
New definition (Jira, webhooks configured): "Webhook notifications" and "Watcher notifications" show On; sections that are off show Off. Turn an option on, collapse the section: the summary changes before saving.
-
Edit each definition settings section, collapse it and compare the summary with what is set: conditions with labels, work item types, JSM options, a Custom deadline, reminders in hours, validity with a specific date and with a period, a non-default Slack workspace with a channel override.
-
Step panel: user step; group step with a fixed group, excluded users and "skip the step"; group step from a work item field; work item field user step with "Treat users as a group", excluded user fields and dynamic updates; vote step with a deadline. Cancel a step change and open the step again: the saved state shows.
-
Read-only view: open a definition from the definitions list with "View" as a user who can view but not edit.
-
Confluence: "Label condition", "Availability" (On / Off) and "Page versioning".
-
Long summaries (a long condition or Slack workspace name, many options on): ellipsis and full text on hover, at full width and in a window narrower than 1280 px, where the step panel takes the full width.
-
Global settings pages: summaries sit at the right edge and long ones show the ellipsis and hover text.
-
Light and dark theme.