About Configuration Folders

Updated on 13 Dec 2024
2 Minutes to read

Print
Share
Dark
Light

Article summary

Did you find this summary helpful?

Thank you for your feedback

Overview

The Configuration Folder is a Designer Folder behavior that allows users to create additional configurations on Data Structures. The types of configurations could be Entity Actions, Visibility Rules, and Access Patterns. The Data Structures that can use Configuration Folders are:

Database Structures (must be enabled)
Entities (Internal and External)
Flow Execution Extensions (deprecated in v9.5)
Case Entities

Do Not Store Data In Configuration Folders

Configuration Folders are meant to store designer elements that add additional abilities to the Data Structures they are tied to. They are not for storing process data. Do not use them for data storage.

Configuration Folder Action Bar

Configuration Folders can contain Actions. Users may configure actions to modify the data within the Data Structure and/or to better organize their data.

Certain Actions within the Configuration Folder Action Bar may/may not be present depending on its Data Structure. Below is a table stating every Action visible throughout each variation.

Action Name	Supported Data Structures	Brief Description
Add Access Pattern	Database Structures and Entities	Generates a custom step to retrieve data based on a criteria.
User Actions	All supported Data Structures	Creates custom right-clickable user actions.
Validation Rule	Case Entities, Database Structures, and Entities	Allows for Rules to ensure created data is valid.
Entity Events	Case Entities, Database Structures, and Entities	Flows created for notification on the deletion or creation of an Entity.
State Triggers	All supported Data Structures	Flows that run when an Entity enters a particular state.
Generate Descriptions	Case Entities and Entities	A defined message description to generate from a Flow.
Action Visibility Rule	All supported Data Structures	Rules created to hide user Entity actions.
Create Reporting Data Flow	Database Structures and Entities	Used to create Flows that can be used as report data sources.
Create Page	Case Entities	Create a variety of Pages for the Case Entity

Add Access Pattern

Add Access Patterns are similar to querying a database; a user may define a custom Fetch for the Entity. The Access Pattern retrieves a list of field results that fulfill user-specified criteria with search conditions such as Equals, Contains, Greater Than, Less Than, etc.

For example, if a user passes the default Fetch by Id, then the corresponding Entity will be returned.

To set up the Add Access Pattern:

Select ADD ACCESS PATTERN from the Action Bar in a supported Data Structure.
A dialog will display requesting the user to configure which fields to filter on and the step name.
Access Pattern Configuration Restrictions
- Access step names cannot contain spaces or special characters. Use pascal or camel casing when naming access pattern steps.
- Access patterns can only be used with primitive types, such as Int32, String, DateTime, Decimals, and Boolean types. User composite types cannot have access patterns because they are serialized in the database.
After saving the Access Pattern, a new step is under User Defined Types > Data Structure Name. For this example, an Entity Data Structure was used.
The Flow step now exists under User Defined Types > ExampleEntities.
Inputs need to be configured to use Access Pattern steps.

QueryType

QueryType performs the same function as Match Type. If both are configured, the system will use the Match Type selection and ignore the QueryType.

State Triggers

State Triggers are Flows auto-triggered when a specific state is in place. When something moves from one state to a specified state, a Flow can be triggered to run as soon as that application or assignment moves to a specific stage.

Create Auto Trigger Flow: Runs a Flow when a specific state is in place.
Use Shared Auto Trigger Flow: Runs a Flow that is used for multiple specified states.

Feature Changes

Description	Version	Release	Developer Task
Changed the icon for configuration folders.	9.5	November 2024	[DT-042291]

For further information on Data Structures, visit the Decisions Forum.

Was this article helpful?

What's Next

Creating Configuration Extensions

Table of contents

Overview 
Configuration Folder Action Bar
Add Access Pattern
State Triggers
Feature Changes