Editing parameters (Proxy)

You need administrator rights in Jira to perform the tasks on this page.

Once you have gone to the Custom fields page (see https://okapya.atlassian.net/wiki/pages/resumedraft.action?draftId=2042364198), click Edit Parameters to customize the various proxy settings:

The following page will appear:

Parameters

These parameters control the look and feel of the Checklist Read-Only Proxy.

In all fields that allow you to add custom text to your banner or progress bar, the following are supported:

Setting

Description

Setting

Description

Proxy type

The look and feel of the proxy:

  • Checklist: Displays the entire checklist in read-only mode.

Do not select this option for use on Agile cards, as Jira limits the vertical height of the field and prevents it from displaying properly.

  • Banner: Displays a banner that contains a label that indicates the status of the checklist.

  • Progress bar: Displays a progress bar that shows the status of the checklist.

Banner configuration

Banner appearance

The color scheme of the banners:

  • Subtle: Displays the banners in muted colors.

  • Normal: Displays the banners in bold colors.

Banner type

The type of banner that will be displayed:

  • Progression: Displays the same progress summary that appears in the checklist header.

  • Custom Labels: Enables the Banner labels section at the bottom of the page for creating custom checklist statuses.

Banner prefix

The optional banner prefix that can be displayed:

  • Checkbox icon: Displays a checkbox icon on the left side of each banner.

  • None: Displays the banner as normal, with no prefix.

  • Custom field’s name: Displays the custom field name as the banner prefix.

  • Custom Prefix: Displays a custom banner prefix; enter the prefix in the Prefix field that appears.

Banner labels

Completed

Displays the entered custom status when the entire checklist is complete.

Incomplete

Displays the entered custom status when the checklist is partially complete.

All mandatory

Displays the entered custom status when all mandatory items in the checklist are complete.

Empty

Displays the entered custom status when the checklist contains no items.

Progress bar configuration

Label type

The type of label displayed on the progress bar.

  • Default: Displays the checklist name and the completion percentage.

  • None: Displays no label.

  • Custom: Displays the specified custom label.

Using variables in custom text fields

In all fields that allow you to add custom text to your proxy, a number of variables can be inserted. This can be a powerful way to pull up-to-date checklist data into your proxy.

The available variables are:

  • %CompletedItems%: The number of items in the checklist that are checked.

  • %IncompleteItems%: The number of items in the checklist that are unchecked.

  • %TotalItems%: The total number of items in the checklist.

  • %PercentCompleted%: The percentage of the total number of items in the checklist that are checked.

  • %PercentIncomplete%: The percentage of the total number of items in the checklist that are unchecked.

  • %CompletedMandatoryItems%: The number of mandatory items in the checklist that are checked.

  • %IncompleteMandatoryItems%: The number of mandatory items in the checklist that are unchecked.

  • %TotalMandatoryItems%: The total number of mandatory items in the checklist.

  • %PercentMandatoryCompleted%: The percentage of the total number of mandatory items in the checklist that are checked.

  • %PercentMandatoryIncomplete%: The percentage of the total number of mandatory items in the checklist that are unchecked.

  • %CompletedGlobalItems%: The number of global items in the checklist that are checked.

  • %IncompleteGlobalItems%: The number of global items in the checklist that are unchecked.

  • %TotalGlobalItems%: The total number of global items in the checklist.

  • %PercentGlobalCompleted%: The percentage of the total number of global items in the checklist that are checked.

  • %PercentGlobalIncomplete%: The percentage of the total number of global items in the checklist that are unchecked.


SERVER documentation (On Cloud? Go here.)
Have questions? Contact our Service Desk for help anytime.