Skip to content

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:

image

This is how form looks in the UI:

image

More information about how to set Proxy tab, can be found here.