Report Builder settings reference

Reference information for the Report Builder: the visual formats and configuration settings of each chart widget category, and the properties that you can add as report columns for each data set.

Chart widget categories and settings

The following table lists the visual formats and configuration settings for each widget category on the Create Charts page.

Table 1. Chart widget configuration settings
Widget category Visual formats Configuration settings
Distribution over time
  • Bar Chart - Vertical
  • Line Chart

Displays how a DEX property changes over a selected time range.

  • Chart's name – A descriptive title for the chart.
  • Chart's property – The DEX property to visualize (for example, DEX Boot Score). The dropdown displays only the DEX properties that you selected in the Data Sets step; non-DEX properties are not displayed.
  • Time range – The reporting period for the chart: Last month, Last quarter, Last year, Current month (the default), Current quarter, Current year, or Custom.
  • View by – The aggregation interval, set in the chart header on the Preview Report step: View by Day, View by Week (the default), or View by Month.
  • Group by – The device attribute that the metric is categorized by, set in the Group by drawer: All, Manufacturer, DEX Device Type, or OS Name and Version. For any feature other than All, you must also select the values to chart, to a maximum of five.
Note:
This widget category is available only when the selected columns include DEX properties, such as Dex Score or Dex Device Score. If the report includes a Distribution over time chart, the Content list is not displayed on the Preview Report page for any of the charts.

For the chart controls and the two-tab data drawer, see Working with Distribution over time charts.
Percentage of a whole
  • Donut Chart
  • Gauge Chart
  • Pie Chart
  • Chart's name – A descriptive title for the chart.
  • Chart's property – The data set column to visualize.
  • Operator – The comparison operator (for example, Equals).
  • Value – The matching criteria.
Quick link Link widget with a count as the link label

Defines the KPI that you want a quick link to. The widget is made up of a link to a filtered view of the data, according to criteria that you define, and the link label is the count of the filtered elements.

The BigFix properties that you selected in the Data Sets step are converted into explorer-compatible properties for use in the Report Builder widgets and configurations.

  • Caption – The label displayed under the count.
  • Count of – The data set column to count.
  • Operator – The comparison operator (for example, Contains).
  • Value – The matching criteria.
Composition
  • Horizontal Bar Chart
  • Pie Chart
  • Treemap Chart
  • Vertical Bar Chart
  • Chart's name – A descriptive title for the chart.
  • Chart's property – The data set column to visualize.
Category breakdown
  • Bar chart - Horizontal groups
  • Bar chart - Horizontal stacked
  • Bar chart - Vertical groups
  • Bar chart - Vertical stacked

Shows the breakdown of one property within each value of another property from the same BigFix object.

  • Chart's name – A descriptive title for the chart.
  • Widget's property 1 – The data set column that defines the categories (primary axis).
  • Widget's property 2 – The data set column whose values are broken down within each category (legend).
Note:
Records with no value for the selected property are shown as N/A.
Note:
The property dropdown lists display only the columns that you selected in the Data Sets step.
Note:
Every chart provides a See data in data table format with download options icon in its upper-right corner, which opens the chart data as a table that you can copy or export. See Viewing chart data in a table.

Template wizard settings

The following table lists the settings of the Customize step of the guided template wizard.

Setting Description
Make this report actionable Adds action buttons to the report. The buttons that are displayed depend on the chosen data set and on the permissions and visibility of the report user.
Schema overview Lists the base fields that the template always includes. The field count is displayed on the right. Base fields cannot be removed.
Add property (Optional) Adds more fields to the data model. Select properties from the Property name dropdown list, and then select Apply. You can add a maximum of 16 optional properties. Select Reset to clear the selection.
Data model Displays the schema definition of the report. Each field shows its name, data type (string, integer, number, datetime, content, or boolean), and a description. Optional fields that you added include a delete icon.
Variations Sub-templates that narrow the report to a specific focus. Each variation card shows a name, a description, and a category chip. Select the grid or list icon to change how the variations are displayed.
Content list toolbar On the Preview step, provides Column to show or hide columns, Density to change the row height, and Search by Name to find a specific row. The number of selected rows and the total number of rows are displayed below the toolbar. For an actionable report, select one or more rows to enable the action buttons, such as Delete and Stop.
Note:
On the Report templates page, each template card shows the template name, its data source, a description, and a template type chip, such as Operations, Security, Compliance, Inventory, or Actions. Use the template type dropdown list or the Search field to narrow the list.

Report details page controls

The following table lists the controls that are available when you open a saved report from the All Reports page.

Control Description
Reconfigure report Opens the report in the Report Builder wizard in edit mode.
More options icon Provides the Export and Duplicate report actions.
Refresh icon Reloads the report data and updates the "Updated" timestamp below the report title.
Filter icon Opens the Filter panel, where you can create, save, and apply filters.
View by group Limits the report to the selected device groups. Search for a group, select Select all or individual check boxes, and then select Apply. Select Reset to clear the selection. A badge on the control shows the number of selected groups. This list is displayed only for reports that were created from a guided template.
See data in data table format with download options icon Opens the chart data as a table that you can sort, copy, or export. See Viewing chart data in a table. For a Distribution over time chart, the table also provides the Aggregated data and Details by (Historical property) tabs and a View by list.
Chart time grouping list For a Distribution over time chart, sets the interval used on the chart: View by Day, View by Week (the default), or View by Month.
Group By For a Distribution over time chart, opens the Group by drawer, where you categorize the metric by a device attribute. Select a value in Choose grouping feature. For any feature other than All, select the values to chart in the Select values to chart list, to a maximum of five, and then select Apply. Select Save to apply the grouping. Select Reset to restore the default grouping.
Average Devices Score For a Distribution over time chart, the benchmark average score across the contributing endpoints. The value is displayed above the chart and drawn on the canvas as a dotted line.
Reset Zoom, zoom in, and zoom out Adjust the magnification of the horizontal axis to focus on a shorter period.
Note:
In the custom configuration wizard, the filter icon and the View by group list are available on the Create Charts and Preview Report steps. The Preview Report step also provides the chart data drawer icon and the chart zoom controls. A Distribution over time chart provides a refresh icon, the Group By button, and the View by list in its chart header.

Data set properties

In the Data Sets step, select Add Column to add properties as report columns. You can select up to a maximum property limit of 18. The Name, Id, and Computer group columns are included by default and cannot be removed. The following tables list the properties available for each data set.

Devices properties

Property Description
Agent Type Type of agent that manages the device (for example, Native).
Agent Version Version of the BigFix agent that is installed on the device.
Correlation Flag Indicates whether the device record is correlated with other records that represent the same device.
Correlation Id Identifier that links correlated device records.
Cpu Processor description of the device, including speed and model.
Cpu Architecture Processor architecture of the device (for example, x86_64).
Cpu Cores Number of processor cores on the device.
Cpu Model Model name of the device processor.
Database Id Identifier of the database that stores the device record.
Database Name Name of the database that stores the device record.
Device Type Type of the device (for example, server, desktop, or laptop).
Dex Application Score DEX (digital employee experience) score that rates software performance and reliability on the device.
Dex Boot Score DEX score that rates the boot speed of the device.
Dex Cpu Score DEX score that rates the CPU utilization of the device.
Dex Das Score DEX device analytics score reported for the device.
Dex Device Score Endpoint DEX score that rates the device experience, based on device reliability and performance.
Dex Disk Score DEX score that rates the disk health of the device.
Dex Gpu Score DEX score that rates the GPU health of the device.
Dex Last Report Time Time when the device last reported DEX data.
Dex Logon Score DEX score that rates the logon speed on the device.
Dex Memory Score DEX score that rates the memory utilization of the device.
Dex Partition Score DEX score that rates the disk partition usage of the device.
Dex Reliability Score DEX score that rates the device reliability, based on crashes and hard resets.
Dex Score Overall DEX score of the device.
Dex Sentiment Score DEX score based on user sentiment feedback.
Dex Wi-fi Score DEX score that rates the Wi-Fi connectivity of the device.
Extension Flag Indicates whether the device record originates from an agent extension.
Gpu Dedicated Capacity Dedicated memory capacity of the device GPU.
Gpu Shared Capacity Shared memory capacity of the device GPU.
Hostname Host name of the device.
Id Unique identifier of the device.
Ip Addresses IP addresses that are assigned to the device.
Last Report Time Time when the device last reported to the BigFix server.
License Type BigFix license type that applies to the device.
Link Href URL of the device resource in the REST API.
Locked Flag Indicates whether the device is locked and cannot run actions.
Number Of Gpus Number of GPUs that are installed on the device.
Operating System Operating system that runs on the device.
Ram Capacity Amount of RAM that is installed on the device.
Ram Manufacturer Manufacturer of the RAM that is installed on the device.
Ram Type Type of the RAM that is installed on the device (for example, DDR4).
Relay Distance Number of network hops between the device and its relay.
Relay Hostname Host name of the relay that the device connects to.
Relay Selection Method Method that the device uses to select its relay (automatic or manual).
Relay Server Relay server that the device reports to.
Relay Server Flag Indicates whether the device acts as a relay.
Relevant Fixlet Count Number of Fixlets that are currently relevant to the device.
Remediated Fixlet Count Number of Fixlets that were remediated on the device.
Root Server BigFix root server that the device reports to.
Root Server Flag Indicates whether the device is the BigFix root server.
Wi-fi Manufacturer Manufacturer of the wireless network adapter of the device.

Fixlets properties

Property Description
Analysis Flag Indicates whether the content item is an analysis.
Applicable Computer Count Number of computers where the Fixlet is currently applicable.
Baseline Flag Indicates whether the content item is a baseline.
Category Category that is assigned to the Fixlet.
Charset Character set of the Fixlet content.
Components Xml XML definition of the components included in a baseline.
Creation Time Time when the Fixlet was created.
Custom Flag Indicates whether the Fixlet is custom content.
Custom Site Flag Indicates whether the Fixlet belongs to a custom site.
Cve Id List CVE identifiers that are associated with the Fixlet.
Digest File Name File name of the Fixlet digest.
Display Category Category label that is displayed in the UI.
Display Name Name of the Fixlet that is displayed in the UI.
Display Source Source label that is displayed in the UI.
Display Source Id Source identifier that is displayed in the UI.
Display Source Severity Source severity that is displayed in the UI.
Download Size Total size of the files that the Fixlet downloads.
Evaluation Period Period over which the agent evaluates the Fixlet relevance.
Fixlet Flag Indicates whether the content item is a Fixlet.
Globally Visible Flag Indicates whether the Fixlet is visible to all operators.
Group Flag Indicates whether the content item is a group.
Id Unique identifier of the Fixlet.
Link Href URL of the Fixlet resource in the REST API.
Locally Visible Flag Indicates whether the Fixlet is visible only to the owning operator.
Master Site Flag Indicates whether the Fixlet belongs to the master action site.
Modification Time Time when the Fixlet was last modified.
Open Action Count Number of open actions that were created from the Fixlet.
Operator Site Flag Indicates whether the Fixlet belongs to an operator site.
Parent Relevances Relevance expressions that are inherited from the parent content.
Relevance Relevance expression that determines where the Fixlet applies.
Relevance Clauses Individual relevance clauses of the Fixlet.
Remediated Computer Count Number of computers where the Fixlet was remediated.
Sans Id List SANS identifiers that are associated with the Fixlet.
Source Source site or vendor of the Fixlet.
Source Id Identifier that is assigned by the Fixlet source.
Source Release Date Date when the source released the Fixlet.
Source Severity Severity level that is assigned by the Fixlet source.
Task Flag Indicates whether the content item is a task.
Type Content type of the item (for example, Fixlet or task).
Unlocked Computer Count Number of applicable computers that are not locked.
Visible Flag Indicates whether the Fixlet is visible in the UI.
Wizard Link Link to the wizard that created the Fixlet.
Wizard Name Name of the wizard that created the Fixlet.

Deployments properties

Property Description
Action Script Script that the deployment runs on the target devices.
Action Script Type Type of the action script (for example, BigFix action script).
Applicability Relevance Relevance expression that determines where the deployment applies.
Computer Group Flag Indicates whether the deployment targets a computer group.
Constrain By Property Name Name of the property that constrains the deployment targets.
Constrain By Property Relation Relation that is used in the property constraint.
Constrain By Property Value Value that is used in the property constraint.
Continue On Errors Flag Indicates whether a multiple-action group continues to run when a component fails.
Custom Success Relevance Custom relevance expression that defines when the deployment is successful.
Database Id Identifier of the database that stores the deployment record.
Database Name Name of the database that stores the deployment record.
Date Range End End of the date range in which the deployment can run.
Date Range Start Start of the date range in which the deployment can run.
End Date Date when the deployment ends.
End Flag Indicates whether an end date is set for the deployment.
End Time_of_day Time of day when the deployment stops running.
Expiration Flag Indicates whether the deployment expires.
Expiration Time Time when the deployment expires.
Group Member Flag Indicates whether the deployment is a member of an action group.
Hidden Flag Indicates whether the deployment is hidden.
Id Unique identifier of the deployment.
Link Href URL of the deployment resource in the REST API.
Management Rights Flag Indicates whether the deployment is restricted by management rights.
Message Action Button Flag Indicates whether the user message includes an action button.
Message Allow Cancel Flag Indicates whether users can cancel the deployment from the message.
Message Postpone Delay How long users can postpone the deployment from the message.
Message Text Text of the message that is displayed to users before the deployment runs.
Message Timeout Delay How long the user message is displayed before it times out.
Message Title Title of the message that is displayed to users before the deployment runs.
Multiple Flag Indicates whether the deployment is a multiple-action group.
Offer Category Category of the offer, if the deployment is presented as an offer.
Offer Flag Indicates whether the deployment is presented to users as an offer.
Operator Site Flag Indicates whether the deployment was issued from an operator site.
Postaction Allow Cancel Flag Indicates whether users can cancel the post-action, such as a restart.
Postaction Force Delay Delay before the post-action is forced to run.
Postaction Message Text Text of the message that is displayed before the post-action.
Postaction Message Title Title of the message that is displayed before the post-action.
Postaction Postpone Delay How long users can postpone the post-action.
Precache Flag Indicates whether downloads are cached before the deployment runs.
Reapplication Interval Interval between reapplications of the deployment.
Reapplication Limit Maximum number of times that the deployment reapplies.
Reapply Flag Indicates whether the deployment reapplies when it becomes relevant again.
Require User Absence Indicates whether the deployment runs only when no active user is present.
Require User Presence Indicates whether the deployment runs only when an active user is present.
Restart Flag Indicates whether the target device restarts after the deployment completes.
Retry Delay Wait time between retry attempts.
Retry Limit Maximum number of retry attempts.
Retry Wait For Reboot Flag Indicates whether the deployment waits for a restart before it retries.
Running Message Text Text of the message that is displayed while the deployment runs.
Running Message Title Title of the message that is displayed while the deployment runs.
Secure Parameter Flag Indicates whether the deployment parameters are stored securely.
Selected Groups String Computer groups that are selected as deployment targets.
Settings Flag Indicates whether custom settings are applied to the deployment.
Show Message Flag Indicates whether a message is displayed to users before the deployment runs.
Show Running Message Flag Indicates whether a message is displayed while the deployment runs.
Shutdown Flag Indicates whether the target device shuts down after the deployment completes.
Single Flag Indicates whether the deployment is a single action.
Source Relevance Relevance expression from the source Fixlet.
Start Date Date when the deployment starts.
Start Flag Indicates whether a start date is set for the deployment.
Start Time_of_day Time of day when the deployment starts running.
State Current state of the deployment (for example, Open, Stopped, or Expired).
Subscription Flag Indicates whether the deployment relates to a site subscription.
Success On Custom Relevance Indicates whether success is evaluated by a custom relevance expression.
Success On Original Relevance Indicates whether success is evaluated by the original relevance becoming false.
Success On Run To Completion Indicates whether success is evaluated by the action script running to completion.
Targeted By Id Flag Indicates whether the deployment targets devices by identifier.
Targeted By List Flag Indicates whether the deployment targets devices from a list.
Targeted By Property Flag Indicates whether the deployment targets devices by property values.
Targeted List List of the deployment targets.
Targeted Names Names of the targeted devices.
Targeting Method Method that is used to target the deployment.
Targeting Relevance Relevance expression that is used to target the deployment.
Temporal Distribution Time window over which the deployment start is staggered across devices.
Time Issued Time when the deployment was issued.
Time Range End End of the time range in which the deployment can run.
Time Range Start Start of the time range in which the deployment can run.
Time Stopped Time when the deployment was stopped.
Top Level Flag Indicates whether the deployment is the top-level action of a group.
Untargeted Flag Indicates whether the deployment has no specific targets.
Urgent Flag Indicates whether the deployment is sent with urgent priority.
Utc Time Flag Indicates whether the deployment schedule uses UTC time.