Document toolboxDocument toolbox

Create an input

Adding inputs to an Activeboard

Follow these steps to add an input to an Activeboard:

Input properties

When you click the title bar (or the ellipsis menu and select Properties), a panel opens on the right side with the following tabs:

Data

ID

Text input
Select input

This is a unique name for the input used for internal calls, such as referring to data in the input from a widget (see Calling an input value from a widget). It is auto-generated and cannot be modified.

Name

Text input
Select input

The name of the input. This is the friendly name that appears in the input title bar in the Activeboard.

Description

Text input
Select input

A meaningful description assigned to the input to tell about its content.

Data source

Text input
Select input

This is the query that feeds data to the input. Click the Edit button to open the Query Editor, where you can edit and update the input's query script.

Custom date range

Text input
Select input

(Optional) Toggle on this option to set a date range for the input that overrides the date range set for the Activeboard. Inputs with a custom date range show the calendar icon next to the title. Learn more about setting time ranges here.

Data loading

Text input
Select input

You can select the data fetching method for your input. When you select an option other than Inherited, the input option will always take priority over the global Activeboard option.

25_Create an input.png

 

Inherited (default)

This option aligns the data fetching method with that of the Activeboard.

On demand

PERFORMANCE: OPTIMAL Having several inputs with this option has a positive impact on performance, as it ensures that resources are utilized exactly where and when you need them.

When this option is enabled, the input will retrieve data only when manually prompted. This means that the input is empty after accessing the Activeboard and displays a message explaining why, along with a button to manually fetch data.

Inputs with this option enabled will remain unaffected by the Active refresh and will work fine when scheduling Activeboard reports. However, it has implications when exporting the Activeboard to PDF.

30_Create an input.png

Lazy

PERFORMANCE: BALANCED Having several inputs with this option has minimal impact on performance, as resources are utilized only when needed and for limited data segments.

When this option is enabled, the input will retrieve data only when it enters the screen after scrolling. This means that the input will not be loaded unless it is within the visible part of the landing screen or enters the screen after scrolling.

Eager

PERFORMANCE: POTENTIALLY REDUCED Having several inputs with this option might affect performance considerably, as it needs to allocate as many resources as needed to retrieve data instantly.

When this option is enabled, the input will retrieve data as soon as the Activeboard is accessed.

Visual

The settings available in the Visual tab will depend upon the type of input chosen. Learn more about the settings of the different types of inputs in this article.

Raw

Here you can access the raw configuration of each input. You can edit this, and copy and paste it in the Raw field of another input to clone the input settings. This is especially useful when you wish to copy inputs across different Activeboards. If you perform any changes, click the Save changes button to apply them.

 

Related articles