Config.json

The config.json is an internal configuration file in the product, an example file can be seen at the end of this page and modified at will. To update the config.json, a user needs to upload it to the resource folder (Administration > Resources) of either the tenant or in general to the whole application via the super/admin. Only the changed and updated features to the resource folder will be overwritten in the product according to the new configuration.

→ If the document is uploaded to a super/admin, the changed config.json will be applied to all tenants of the environment.
→ If the document is uploaded only to a specific tenant, the changed config.json will only be applied to that tenant and will not affect the other tenants or the super/admin environment.

→ If the document is uploaded to both super/admin and a tenant, the tenant version of the document is considered.

• Some properties might only take effect or make sense when the config.json is uploaded via the super/admin, like:

  • loginPage > tenants

  • loginPage > additionalHtml

Overview of configuration file - config.json

We can do configurations in the product via config.json. The full overview of the file is as follows.

{
    "autoRefreshInterval": 300000,
    "filterDateFields": [],
    "showHome": true,
    "features": {
        "documents": true,
        "notes": true,
        "efforts": true,
        "processModel": true,
        "cpm": true,
        "workflowdesign": true
    },
    "tasks": {
        "showAdhoc": true,
        "showQuery": true
    },
    "loginPage": {
        "tenants": [],
        "additionalHtml": ""
    },
    "registerPage": {
        "additionalHtml": ""
    },
    "preCacheSmartformData": {
        "allUsers": false,
        "allGroups": false,
        "csvPreloading": []
    },
    "documents": {
        "countDocumentsRecursive": true
    },
    "tsdConfig": {
        "allowPasswordFields": false,
        "enableLogging": false,
        "clearConsoleBeforeLog": false
    },
    "table": {
        "bulkActions": {
            "useNew": true
        },
        "filter": {
            "useNew": true
        }
    }
}

Home menu - How to hide home from main screen

The file should be configured as follows:

{
  "showHome": false
}

Home icon is hidden successfully. Users will automatically be redirected to “my open tasks” list.

DatePicker activation

Scenario 1: to activate the datepicker for specific index columns, update the config.json file by updating it to [smartFormIndex1]. Once updated, upload the modified file to the "Resources" section. This action will ensure that the "datepicker" is now visible on the index1 field

"filterDateFields" : ["smartFormIndex1"] 

The Datepicker is activated successfully

Scenario 2: to activate more than one datepicker, values can be written comma-separated if more than one index column will be filtered.

"filterDateFields" : ["smartFormIndex1","smartFormIndex2"]

The datepickers are activated successfully.

Hiding tabs

These parameters determine the features document, notes, efforts, process model for the tasks and CPM info for the instances should be disabled. If parameters are set to false, features will be disabled.

Hide Documents Tab

Scenario 1: To hide the "Documents" tab in the product interface, update the config.json file by setting the status of the "documents" to false. Once updated, upload the modified file to the "Resources" section. This action will ensure that the "Documents" tab is no longer visible.

{
  "features": {
		"documents": false,
		"notes": true,
		"efforts": true,
		"processModel": true,
		"cpm": true
  }
}

The “documents” tab is hidden successfully

Hide Notes Tab

Scenario 2: To hide the "notes" tab in the product interface, update the config.json file by setting the status of the "notes" to false. Once updated, upload the modified file to the "Resources" section. This action will ensure that the "notes" tab is no longer visible.

{
  "features": {
		"documents": false,
		"notes": false,
		"efforts": true,
		"processModel": true,
		"cpm": true
  }
}

The “notes” tab is hidden successfully

Hide Efforts Tab

Scenario 3: To hide the “efforts" tab in the product interface, update the config.json file by setting the status of the "efforts" to false. Once updated, upload the modified file to the "Resources" section. This action will ensure that the "efforts" tab is no longer visible.

{
  "features": {
		"documents": false,
		"notes": false,
		"efforts": false,
		"processModel": true,
		"cpm": true
  }
}

The “efforts” tab is hidden successfully

Hide Process model Tab

Scenario 4: To hide the “processModel" tab in the product interface, update the config.json file by setting the status of the "processModel" to false. Once updated, upload the modified file to the "Resources" section. This action will ensure that the "processModel" tab is no longer visible.

{
  "features": {
		"documents": false,
		"notes": false,
		"efforts": false,
		"processModel": false,
		"cpm": true
  }
}

The “processModel” tab is hidden successfully.

Hide CPM Tab

Scenario 5: To hide the “cpm" tab in the product interface, update the config.json file by setting the status of the "cpm” to false. Once updated, upload the modified file to the "Resources" section. This action will ensure that the "cpm" button is no longer visible.

{
  "features": {
		"documents": false,
		"notes": false,
		"efforts": false,
		"processModel": false,
		"cpm": false
  }
}

The “cpm” tab is hidden successfully.

Task properties

Hiding Ad-hoc button from task properties

Scenario 1: To hide the “Ad-hock" button from task properties, update the config.json file by setting the status of the "showAdhoc” to false. Once updated, upload the modified file to the "Resources" section. This action will ensure that the "Ad-hoc" button is no longer visible.

{ 
  "tasks": {
		"showAdhoc": false,
		"showQuery": true
  }
}

Ad-hoc button is hidden successfully

Hiding Show Query button from task properties

Scenario 2: To hide the “Show Query" button from task properties, update the config.json file by setting the status of the "showQuery” to false. Once updated, upload the modified file to the "Resources" section. This action will ensure that the "Show Query" button is no longer visible.

{ 
  "tasks": {
		"showAdhoc": true,
		"showQuery": false
  }
}

Show Query button is hidden successfully

Login Page dropdown

To activate the “dropdown" button box on login page, update the config.json file by setting the status of the "loginPage” according to the configuration file displayed below. You can specify a different label that will be shown for a specific tenant name. E.g. tenant name is “X124” but “admin” should be shown.

Once updated, upload the modified file to the "Resources" section. This action will ensure that the "dropdown box" button is displayed.

{
	"loginPage": {
		"tenants": [
            {"label": "actionhandler", "value": "actionhandler"},
			{"label": "admin", "value": "X124"},
			{"label": "assignment", "value": "assignment"},
			{"label": "basic", "value": "basic"}
		],
		"additionalHtml": "\n\t\t\t<div><b>config.json Test</b></div>\n\t\t\t\n\t\t\t<div>\n\t\t\t\tAT349_loginSiteNeedsToBeConfigurable\t\n\t\t\t</div>"
	}
}

The dropdown box button is displayed successfully on the login page

Auto Refresh Interval

"autoRefreshInterval": 50000

This parameter determines the auto-refresh interval for the tasks and instance lists. It will reload the list every 5 minutes in case multiple users are working on the same instances and if another user completes one task or instance. The minimum value for the auto-refresh is 30 seconds.