--- title: "Rules Through the Code Editor" slug: "rules-through-the-code-editor" updated: 2026-10-23T21:31:31Z published: 2026-10-23T21:31:31Z canonical: "documentation.decisions.com/rules-through-the-code-editor" --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # Rules Through the Code Editor ### **Defining data collection in Code (Code)** The data collection rules defined in the UI are automatically converted to JSON code. You can also manually edit this code for greater flexibility and advanced options. The JSON code includes four key fields for data collection: `tags`, `extract_identifiers`, and `matching_criteria`, `dashboard_context`. This chapter explains how to configure these key fields. For this purpose: 1. Go to `Admin Panel -> Configure Data Collection` . 2. In the Data Collection list, click **Rules & tests** for the selected Data Collection. 3. Go to the bottom of the page to see the following section: ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-V4ZMDSHG.png) 4. Click the **plus (+)** icon for an existing rule. 5. Click the **Code** tab. The JSON code displays. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-20XIS0XP.png) 6. At the bottom, click the **pencil** icon to edit rule code manually. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-L6FQOTJ0.png) 7. Click **Edit** to confirm. The **Edit Rule** window displays. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-5XQXGCIC.png) 8. Edit as desired and save it. --- ### **Tags** Tags are used to categorize the active window. There are two internal tags that the Process Intelligence platform uses for data categorization: `appname` and `content-category`. The `appname` tag specifies the application name (e.g., Excel, SAP, or Salesforce), and the `content-category` tag defines the window name within the application (e.g., Report, Purchase Order, or Case). Tags are defined as a list of key-value pair objects in the JSON code. Here’s an example of the tag field: ```json "tags": [  {    "key": "appname",    "value": "Excel"  },  {    "key": "content-category",    "value": "Report"  } ] ``` ### **Extracted identifiers** Extracted identifiers specify the process-related identifiers and attributes collected from the active window. These can be gathered from sources like the URL or title using regex matching or URL query parameters. In advanced configurations, identifiers can also be collected from the UI. For this, you must first define the UI-capturing rule in the `reactions` field (not covered in this tutorial) of the configuration JSON file. The `extract_identifiers` is a list of extraction rules. Here’s an example of the extracted identifiers field: ```json "extract_identifiers": [  {    "id": "04c24a3a-86bb-41c7-a8e9-c546c94c4b56",    "identifier_name": "SAP - Purchase Order",    "key": null,      "regex_pattern": "(?<=po/)(.*?)(?=[?/]|$)",    "hash_identifier": false,    "from_fields": [      "url"    ],    "compiled_regex": "(?<=po/)(.*?)(?=[?/]|$)"  } ] ``` ### **Matching Criteria** While tags and extracted identifiers define what information is collected from the window, the matching criteria determines when this information is collected. Data (e.g. tags and extracted identifiers) is collected from the active window only if the matching criteria is met. The matching criteria consist of two fields: `rule_engine_rule` and `context`. - `rule_engine_rule`: Allows users to define simple Python code to evaluate the matching criteria. You can automatically access some attributes of the active window (e.g., `url`, `title_lower`, and `process_name_lower`) and compare them to the matching criteria. For more information on the Python rule engine, visit: [zeroSteiner/rule-engine](https://github.com/zeroSteiner/rule-engine). - `context`: Defines variables passed to the `rule_engine_rule`. These variables can be accessed within the rule using a Python dictionary. For example, if a variable `variable1` is defined in `context`, its value can be accessed in the `rule_engine_rule` by calling `context['variable1']`. Here’s an example of the matching criteria field: ```json "matching_criteria": {  "rule_engine_rule": "active_process_name_lower and context['process_name'] in active_process_name_lower",  "context": {    "process_name": "code.exe"  } } ``` ### **Dashboard Context** The `dashboard_context` has three fields that help categorize rules correctly in the admin panel: - `app_name`: Should match the `appname` tag defined in the tags field. - `window_name`: Should match the `content-category` tag. This field is optional if no `content-category` is defined. - `process_name`: Should match the `extracted_identifiers.identifier_name` tag. This field is optional if no identifiers are defined. Here’s some example of the dashboard context field: ```json "dashboard_context": {  "app_name": "Excel",  "window_name": null,  "process_name": null } ``` ```json "dashboard_context": {  "app_name": "Salesforce",  "window_name": "Case",  "process_name": "Salesforce Case Tracking" } ``` --- ### **Defining Tests in code (Code)** The data collection rules defined in the UI are automatically converted to JSON code. You can manually edit this code by downloading the file from **Configure Data Collection → Advanced Setup → Test File Management**. After making changes, upload the edited tests back to the dashboard through the Test File Management interface. The JSON code includes two key fields for data collection: `row_event` and `expected_processed_event`. ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-KBGNOFPJ.png) **Row Event** This field includes information similar to the UI, allowing you to input an example process name, URL, and title. The `row_event` field is an object with three optional fields: - `process_name` - `url` - `title` You can define all three fields or just one of them. **Expected Processed Event** The `expected_processed_event` field specifies what information is expected to be collected from a window given the fields in `row_event`. This field is an object, and the most common fields in the `expected_processed_event` object are: - `tags` - `extracted_identifiers`