Config Search Dashboard Tool

The Config Search Dashboard tool lets Creators locate specific configuration values in their applications and modules. These values might include the Property ID of a Panel component or the Canvas Label Text of a Decisions component. More precisely, the tool searches JSON values.

This is useful when updating values shared across multiple applications and modules. Submit a search request and the tool generates a list of all module components containing the specified value. Use this report as a checklist to streamline the update process and avoid manually inspecting each module.

Accessing the Config Search Tool

To access the Config Search Dashboard tool, navigate to your environment, click Resources, and select UDLC Toolkit:

A static image displaying the Resources section of the UDesigner to access the UDLC Toolkit.

Under the Build and Test section of the UDLC Toolkit, locate the Search Config tool and click on the Use this tool button:

Submitting a Config Search Request

To initiate a search, select the location to query. The available options include:

Specific Applications: Displays the Applications drop-down menu, letting you select one or more applications in your environment.
Specific Modules: Displays the Modules drop-down menu, letting you select one or more modules in your environment.

Search Scope

The Config Search Dashboard tool searches only JSON values associated with components. These values typically represent data entered manually during component configuration. The tool does not support searches for system settings or submission data.

Examples of searchable values include:

Property IDs
Labels
Email addresses
Input values
Output values
URLs

Entering Search Values

You can enter one or more values in the search field. When entering multiple values, separate them with a line break. Doing so organizes all values into a single, structured list.

Here is an example of searching for Label Text values:

First Name
Last Name
Email Address

The image below shows you how to format your values:

After making your selections, click Submit and OK in the pop-up modal. Another pop-up Modal displays your Request Number. Unqork uses this number to track the request internally.

Viewing Your Config Search Report

After submitting a request, you receive an email with an attached spreadsheet called Config Search {your-environment} {timestamp in UTC}.xlsx. This spreadsheet is your search report.

To view your report:

Click the attachment's link in the email.
Check your Downloads folder for the .xlsx file.
Open the file in Microsoft Excel or Google Drive.

When you open the spreadsheet, you see three tabs at the bottom of the worksheet:

index
Summary
customSearch

Here is an example of a typical Config Search Report:

The following sections describe the information each tab provides.

Index Tab

Summary Tab

customSearch Tab

This tab provides details of the customSearch operation the tool runs on your applications and modules. These are the columns you see in this tab:

Attribute	Description
Test	The test the tool ran. It'll always be `customSearch`.
Severity	The test's severity. For the `customSearch` test, the severity is Informational.
Test Description	A brief description of what the test does.
Action Item	Here you find more search suggestions if the test does not return the information you need. Following these suggestions ensures you use the Config Search tool correctly.
Overview	A general description of the test and its purpose.
Columns Explanation	The specific operation of the tool and the format you'll see in the customSearch tab for the values you searched. In the example image above, the test runs a reference (`_REF`) operation. This operation looks for a match between the values you entered and the ones in your environment. The result is either a Boolean of true or false.

The Summary tab displays the number of times the test found a match. The three columns are:

Test
Severity
Results Count

This tab displays the most details about your search. Here you see all the applications, modules, and components included in your searched value(s). You see the following columns in this tab:

Attribute	Description
Application ID	The unique identifier of the application whose value(s) matched your search.
Application Name	The unique name of that application.
Module ID	The unique identifier of the module whose value(s) matched your search.
Module Name	The unique name of that module.
Label	The Label Text or Canvas Label Text of the module's component.
Component	A module's component whose value(s) matched your search.
_REF	The value you searched. Each value has its own column. If a match exists for that value, a Boolean of true displays for each matching application and module. The format you'll see in the column heading is the following: `/{VALUE-SEARCHED}/_REF`.
Modified time (UTC)	The timestamp of the last change made to the application or module. Time displays in UTC (Coordinated Universal Time).
Ancestors	The ancestors of the module's component.