Users Inputs provide an interface for users to supply values that effect gadgets widget search terms in a visual formand displayed results based on their selection. Typically, the inputs are displayed in a checkbox, text area, dropdown menus or radio buttons.
The forms allow users to visually make selections which impact the underlying searches and focus only on points of interest while viewing dashboard's results.
Configuring User Inputs:
There are 2 aspects the should be configured in order to use Inputs
...
The first part to configure inputs is done in the Dashboard's Settings section. Edit the Dashboard and you'll find a User Inputs section.
In the User Inputs section, Administrators define the list of Inputs to be available while viewing a dashboard.
...
Each input has several settings
...
...
General Settings:
- Input Key - The key is the unique identifier of an input in which is used in the underlying search within a
...
widget. Upon selection of a value in the input form in the dashboard, the selected value will be integrated in the query or queries that contains this key
Display Settings:
-
...
Title - The title of the input that is displayed in the inputs form above this input
- Description - The input's description
- Visible - Determines whether this input is displayed in the inputs form or not
- Break Line - Determines whether this input starts a new line in the inputs form or not
- Advanced - Determines if this input should be presented in the main inputs form (default) or should be displayed only in the advanced section of the inputs form
Input Settings:
-
...
Input Type:
Text
Default Value - The value that will be used by default (leave empty for empty default)
Placeholder - Text that will be displayed within the input text area to imply the user what the optional values are
List
Multiple Selection - Determines whether it is possible to select more than one value of the list or not
Show as Drop Down - Determines whether the list should be display an horizontal values list or as a dropdown menu
List Type - Determines the type of list of this input:
Static - A static list of values entered by the administrator
Query Based - A dynamic list which is a result of a search query
Sources Based - A dynamic list of sources available in XpoLog (Logs, Folders, AppTags, Servers)
Predefined - Upload a key=value type of file which contains a list of values that will be displayed in the input
Checkbox
Checked by Default - Allow a true/false type of input
Checkbox Label - The label to be displayed next to the checkbox
- Searches in the Gadgets within a dashboard
After the inputs are defined it is required to enter their references inside the gadgets search queries in order to update a gadget's result on an input selection.
The syntax which is used in the search queries is [XI:INPUT_KEY] - this value will be replaced by XpoLog when a user makes a selection in the inputs forms and click Apply.
After completing the configuration and saving it, the configured inputs will be displayed at the upper part of the dashboard. However, using the inputs will have no effect at this point until the second part of configuring the widgets underlying searches to use the inputs is completed.