Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
minLevel1
maxLevel6
outlinefalse
typeflat
separatorpipe
printablefalse

Overview

From version 8.24.0 onwards, Scaffolding provides an administrator setting that allows Confluence administrators to set the default limit for User Options results.

...

The processing stops when this limit is exceeded,

...

and an error message is displayed

...

Why there is a limit for User Options

The User Options macro is useful for retrieving users with specific permissions from a variety of user directories. However, processing a huge number of users with their permissions, when used with the check or select list type, may cause performance issues for Confluence.

...

.

This limit is different from the List Data items limit in the sense that it only targets accidental misuse of the powerful User Options macro at an upstream stage when very large user directories are being queried. On the other hand, the List Data items limit activates downstream just before rendering and it targets all List Data submacros.

Enabling or disabling the User Options limit

Info

This query limit is enabled by default when upgrading to Scaffolding 8.24.0. The default limit value is 250.

Refer to the Accessing Scaffolding's Administrator Settings guide to get access to the settings page.

  • go to the User Options query limit settings header

  • choose the Edit button

...

On this page, you can enable or disable the User Options limit by

  • toggling the Enabled toggle on or off

...

In the User Options query limit input field (defaults to 250).

  • update the value to set a new limit (if required)

  • choose Save

Info

From version 8.24.0 onwards, when this limit is exceeded, the processing stops and an error message is displayed.

...

On this page:

Table of Contents
minLevel1
maxLevel6
outlinefalse
styledisc
typelist
printabletrue

Understand the limitations of User Options

The User Options macro is useful for retrieving users with specific permissions from

...

various user directories. However,

...

when used with the check or select list type, processing many users with their permissions

...

may cause performance issues for Confluence.

...

If there are many user results, selecting an option from a

...

long list of radio buttons, checkboxes, or dropdown menus

...

can be tedious. Setting List Data with the auto-completetype is more appropriate in that use case.

This limit targets accidental misuse of the powerful User Options macro at an upstream stage when very large user directories are being queried.

This limit is different from the List Data items limit. The List Data items limit activates downstream just before rendering and

...

targets all List Data

...

sub-macros.

...

Enable or

...

disable the User Options limit

...

When upgrading to Scaffolding 8.24.0

...

, this query limit is enabled by default, and the default limit value is 250.

...

  1. To access the settings page, refer to Accessing Scaffolding's

...

...

  1. Go to the User Options query limit settings header.

...

  1. Select Edit

...

  1. .

...

  1. Image contains the settings for the User Options query limit.Image Added
  2. Use the Enabled toggle to enable or disable the User Options limit

...

  • by toggling the Enabled toggle on or off

...

  1. .

    User Options query limit settingsImage Added
  2. In the User Options query limit input field

...

  1. , update the value to set a new limit

...

  1. .

...

  1. Choose Save.

From version 8.24.0 onwards, the processing stops when this limit is exceeded and an error message is displayed.