Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel

On this page

Table of Contents
exclude(On this page).*
stylecircle
typeflat
separatorPipe

UI Text Box
sizemedium
typeinfo

The Add or disable option in Cascading Select Thispost function allows dynamically adding to dynamically add new options, re re-enabling enable disabled options, and disabling and disable exiting options in cascading select list custom fields.

It supports adding/re-enabling/disabling root options or child options. 


Image AddedConfiguration

ui-text-box
typenote

In this documentation and the post function configuration you will notice the symbol ( * ) next to some parameters, it means that this field is mandatory and shall not be left empty. Fields without the symbol are optional.

Basic configuration*

Below you will find a detailed description of each parameter of the basic configuration of the function.

Field*

Expand
titleField
Info
iconfalse

Select the cascading select list field to be updatedthat you want to update from the dropdown list or start typing to look up existing fields.


text-boxStart typing to search for a field.
ui-expand
title
typetip
Option level
*
Info
iconfalse

Select the option level where the new option is going to be insertedthat you want to update. The following options are available:

OptionDescription
Parent
  • Child
  • Option name*

    This is the default. The main or parent level will be updated.
    Child

    If you want to add/disable a child option you must additionally select a field containing the name of the parent option.

    Example: You specify the field region (custom select list field). If the field contains the value Asia, the option will created as a child option (or disabled) of Asia.



    UI Expand
    titleSource field
    Info
    iconfalse

    Select the field containing the name of the option to be updated

    Mode

    option value that you want to add / disable. The selected field must contain a text value.

    You could use temporary fields. They could be set in a prior post function (e.g. with the Update or copy field values post function) and the set value used in this post function.


    UI Expand
    titleMode
    Info
    iconfalse

    Select the action to be executed. The following options are available:

    OptionDescription

    Add new option, or skip if it already exists

    The new option value will be added. If it already exists the operation will be skipped without further analysis. This is the default.

    Add new

    options

    option, or enable if it is disabled

    The new option value will be added. If it already exists in a disabled state, it will be enabled.

    Force adding new

    options

    option, even if it already exists

    The new option value will be added regardless of whether it already exists. Duplicate entries will likely be the result.

    Force adding new option, even if it is disabled

    The new option value will be added regardless of whether it already exists - either in an enabled or disabled state. Duplicate entries will likely be the result.

    Disable option

    The specified option value will be disabled.



    UI Expand
    titleAdditional options
    You have the option to sort the options list you added, alphabeticallyCheck Sort options alphabetically if you want to keep your option list sorted. If unchecked, the new option value will be added to the bottom of the list.


    Enter a condition (Logical/boolean condition) using the JWT expression parser - full feature list syntax.

    You can even logically link and gather conditions in expressions as you like in order to map more complex conditions.

    The post function will only be executed if the condition is met (returns true).
    UI Expand
    iconfalse
    titleConditional execution
    Note

    Include Page
    DECADIS:_snip_condExecution_Server
    DECADIS:_snip_condExecution_Server



    Image AddedUse cases and examples

    Page properties report
    firstcolumnUse case
    headingsJWT feature, Workflow function, Parser functions, Label
    cqllabel = "use-case-workflow" and parent = currentContent()


    Excerpt Include
    DECADIS:Contact support
    DECADIS:Contact support
    nopaneltrue


    Page properties
    hiddentrue


    Tech review

    Status
    colourGreen
    titledone

    Style guide

    Status
    colourGreen
    titledone

    Status
    titletodo
    Status
    colourYellow
    titleReady for review
    Status
    colourGreen
    titledone
    Status
    colourRed
    titleflagged


    Page properties
    hiddentrue


    Short descriptionAdd a new option, or disable an existing one in a cascading select list custom field.
    Label