Name Value Part

A name value part is a type of data object that can be added to a report template or report definition. A name value part displays a single value, along with a user-defined label, based on a custom data set. These custom data sets are defined using the Name Value Parts page. For example you might want to create a list of single value counts for ticket status.

Tickets Created Last <N> Days
Total Tickets Past Due
Tickets Closed Last <N> Days
Total Open Tickets

NOTE   Creating or editing of name value parts is not supported on the Kaseya Cloud platform. All Cloud-based accounts can use pre-defined name value parts via the Control cabinet when creating a report template or a new custom report.

Adding a Name Value Part to a Layout

  1. Drag-and-drop a name value part from the folder tree in the left hand pane in to one of the cells in the right hand pane.
  2. Click the gear icon to configure the name value part. The report template cannot be saved until the name value part has been configured at least once. Unconfigured name value parts display a red box around their cells.

add-name-val-prt-1-new

  1. Drag-and-drop a name value part from the folder tree in the left hand pane into the Name Value Container list in the right hand pane. You can drop multiple instances of the same name value part into the same list. For example a Name Value Container list can include two instances: Agents Online and Agents Offline.

add-name-val-part-new1

You can optionally edit an instance. Let's assume you want to change the Agents Offline instance to Agents All.

  1. Select the row of the instance you want to edit in the Name Value Container list.
  2. Click Edit. Any changes you make only applies to this instance in the report template or report definition you are editing.
  • Name - The name displayed by this Name Value Instance in configuration dialogs.
  • Name Label - The label displayed in the report with its corresponding value.
  • Parameters - One or more parameters that determine the value returned for this name value part when a report is published. The values a parameter can have are determined by the query or stored procedure specified using the Name Value Parts page.

    NOTE   Hover the cursor over each parameter's name to see a tooltip description of the acceptable values for that parameter.

add-name-val-prt-3-new