Home >

AX1676

Using the Report Builder

Using the Report Builder, you can configure all aspects of a web report, including:

• Defining general report settings like the display title and optional associated file group
• Defining one or more data sources to determine the data available to the report
• Configuring component properties to determine the data and/or text shown in each component, and other display properties
• Defining refresh variables to allow users to change the data in the report based on their selected values

The Report Builder is available as follows:

• When you create a new web report, the new report is automatically opened in the Report Builder.

• You can edit existing reports in the Report Builder. Open the web report that you want to edit, then select Tools > Edit Web Report to open the report in the Report Builder.

  

Report Builder overview

The Report Builder consists of the following:

• Configuration panels docked along the left-hand side of the screen, to configure various aspects of the report.
• A report canvas area showing the placement of the components in the report.
• A secondary toolbar in the right-hand side of the task bar to save and preview the report.

Example Report Builder

The Report Builder configuration is organized into the following panels. Select the icons in the left-hand side of the task bar to switch between different panels.

Report Builder Panels	Icon	Description
Report Settings		Optional. Define general settings for the report, such as a title and an associated file group. For more information, see Defining general report settings.
Data Source		Define one or more data sources for the report. Data sources determine the data available to Data Grid components. For more information, see Defining data sources for Data Grid components.
Refresh Variables		Optional. Define one or more refresh variables for the web report, to allow users to filter the report data on demand. For more information, see Configuring refresh variables for web reports.
Components		Configure the components in the report, such as a Label component for the report title, and a Data Grid component to display data. Component properties determine the display and content of each component. For more information, see Configuring component properties.

To get help on any of these areas, click the help icon in the right-hand side of the task bar. For example, if you are currently on the Refresh Variables panel, clicking the help icon takes you to information about refresh variables.

Defining general report settings

You can define general report settings for each web report. These settings are defined on the Report Settings panel of the Report Builder.

Example Report Settings panel

Report settings

Item	Description
Report Title	Optional. Defines alternate title text to display in the browser tab instead of the full file name. By default, the file name is set as the report title.
File Group Context	Optional. Associates the web report with a file group. You can do this if you want to limit the available tables in the report to tables used by the file group, and you want the report to be dynamic based on file group table variables. For more information, see Associating a web report with a file group.
Help Code	Optional. Associates the web report with a custom help code, to provide report-specific help. Select any help code as defined in the Custom Help Admin area. For more information, see Associating a web report with a help code.
Help Source	Optional. The help source in which to find the help code. By default, this is set to Database, which means that the help code was defined using the Custom Help Admin feature and is stored in your Axiom Software database. Other entries of Product, Web, and Desktop are supported, but these are primarily used by product developers or implementation consultants.
Product Name	Optional. The product help in which to find the help code, when the Help Source is set to Product. This must match an installed product name.
Product Area	Optional. The product area that the file belongs to, for display purposes in the Web Client. This option is only present in systems with installed products.

Configuring component properties

When you create a new web report, the report has one or more components as determined by the template used to create the report. Currently, it is not possible to add or remove components, or to move or resize components. However, you can otherwise configure the component properties.

Each component on a web report has properties that determine the display and content of that component. For each component in the report, you must review these properties and configure them as needed. For example, Label components have display text, and Data Grid components have selected columns to display in the grid.

Components are configured on the Components panel of the Report Builder.

Example Components panel

To configure a component in a web report:

1. Select the component that you want to configure. You can do either of the following to select the component:

   • Click on a component in the web report canvas to select it.

     OR

   • Use the drop-down list at the top of the Components tab to select a component. Components are listed by component name and type.

   The properties for the selected component display in the panel.

2. Edit the component properties as needed. The specific properties depend on the component type.

   For more information on configuring the component properties for a particular component type, see Web report components and view the topic for the relevant component type.

Previewing and saving the web report

At any time, you can save the current web report configuration by clicking the Save icon in the right-hand side of the task bar.

If you want to save a copy of the web report, click the down arrow next to the Save icon to open the Save menu, then click Save As.

Although the display of the web report in the Report Builder is close to the actual display, components are not fully interactive within the editor. If you want to see how end users can interact with the web report, you can use the preview feature.

• To preview the web report, click Preview (the eye icon) in the right-hand side of the task bar. This automatically saves the report and opens it in the normal web report view. You can then test interactivity as needed.

  

• To return to the Report Builder and make further changes, click Return (the back arrow icon) in the right-hand side of the task bar.