Configuration¶
The Configuration
tab can have multiple subtabs, for example, a tab for
account configuration (to configure the account by adding account credentials),
proxy configuration, and logging level configuration.
Configuration Properties¶
Property | Type | Description |
---|---|---|
title* | string | - |
description | string | To provide a brief summary of an configuration page. |
subDescription | object | To provide broader description of an configuration page |
tabs* | array | To specify a list of tab. |
Tabs properties¶
Property | Type | Description |
---|---|---|
name* | string | To define the particular tab name. |
title* | string | To show the title of the tab. |
entity* | array | A list of fields and their properties. |
groups | array | It is used to divide forms into distinct sections, each comprising relevant fields. |
table | object | To display accounts stanza in table |
style | string | By specifying this property in the global config file, the forms can either be opened as a new page or in a dialog. Supported values are “page” or “dialog”. Default value is dialog. |
options | object | This property allows you to enable the saveValidator feature. |
hook | object | It is used to add custom behaviour to forms. Visit the Custom Hook page to learn more. |
warning | object | It is used to add custom warning message for each of modes (‘create’, ‘edit’, ‘config’, ‘clone’), message is displayed on form |
conf | string | Configuration name for a rest handler. |
restHandlerName | string | It specify name of the REST handler script, that provides fields, models and validators for the fields supported under the specified input and any specific actions to be performed on CRUD operations for the given input. (Do NOT use with restHandlerModule or restHandlerClass) |
restHandlerModule | string | It specify name of the REST handler script that implements the custom actions to be performed on CRUD operations for the given input. (Use with restHandlerClass) |
restHandlerClass | string | It specify name of the class present in the restHandlerModule, which implements methods like handleCreate, handleEdit, handleList, handleDelete and is child class of splunktaucclib.rest_handler.admin_external.AdminExternalHandler. (Use with restHandlerModule) |
customTab | Object | This property allows you to enable the custom tab feature. |
hideForPlatform | string | Defines for which platform element should be hidden from UI perspective. Currently only two platforms are supported cloud or enterprise . |
Tab components¶
Instead of specifying a tab from scratch with above fields, you can add a predefined tab.
Currently available tab components:
Usage¶
"configuration": {
"title": "Configuration",
"description": "Set up your add-on",
"tabs": [
{
"name": "account",
"title": "Account",
"table": {},
"entity": []
},
{
"name": "proxy",
"title": "Proxy",
"entity": [],
"options": {
"saveValidator": ""
}
},
{
"type": "loggingTab"
}
]
}
Note: The example above creates a Configuration page with two empty tabs: Account and Proxy.
Specify your properties in "table"
and "entity"
.
Output¶
This is how table looks in the UI:
This is how form looks in the UI:
More information about how to set Proxy tab, can be found here.