Running reports
Click below to view a demonstration of running and saving the configuration for a one-time report and scheduling and viewing a regular (periodic) report.
You can run reports with various options to view, save, email, or export the output. To run and save a new report:
Click Manage reports > Reports.
Bravura Security Fabric generates a list of available reports. If this is the first time that you have visited the page, this process may take several seconds.
Select a report category.
Reports belonging to that category are displayed.
Select the report that you want to run.
Optional: Specify your search criteria if you don’t want to see all results.
You can use wildcards as search criteria in many text fields. Available options are described in the sections that follow.
Optional: Configure Display options.
For example select Hide repeating cell values for large data sets.
Optional: If you want to email the report, configure Email report settings.
Email should not be used for saving long reports. If the report size is likely to be larger than 102MB, consider sharing the report by saving to disk or UNC share (next two options).
Optional: If you want to save the report on the Bravura Security Fabric server, configure settings to Save configuration and output on server.
Saving large report files to the drive or partition where the product is installed is not recommended, as it can decrease the available space required by the application. Consider using a UNC share instead (next option)
Optional: if you want completed reports saved to another server, configure settings to Export report output.
Click Run at the bottom of the form to see a report.
When running a report, you may need to click Refresh to reload the page and display the results. You can also click Cancel to cancel the running report. If canceled, a partial report may be displayed.
When Bravura Identity or Bravura Privilege is licensed, you can now use report output to submit pre-defined requests .
If an attribute is encrypted, its value will be masked in report output and the attribute will not present in search criteria options.
When the report has been run, you have several options for displaying the data.
Option | Description |
|---|---|
Visible columns | A drop-down list of the available columns that can be displayed. |
Items per page | The number of items to be displayed in the table. Default is 10 items. |
Highlight | Will highlight text in the table that has been typed. |
Hide repeating cell values | When a large data set is generated, this will help reduce data to be more easily read. |
Default ordering | Will return the table to the default sort ordering. |
You can sort data by clicking a column header to sort the column in ascending or descending order. Only one column can be sorted at a time. Return to the default sorting can be done at anytime by selecting the Default ordering option.
Sorting data only applies to the report output in the web user interface. The sorting is not preserved when the report is saved or sent in an email.
Ensure the email configuration is successfully tested and working. If the size of the report exceeds 10MB, then the report is not sent. Instead, an email message is sent which informs the recipient that the report was too large, and that they may want to change the search criteria to generate a smaller file size. This limitation is hard-coded, not configurable, and some SMTP servers will have a smaller attachment or global email body limit, causing such large email reports to fail to reach their destination even if they leave the Bravura Security Fabric server.
Option | Description |
|---|---|
To | Type comma-separated email addresses to which to send the report and the report selection criteria. Alternatively, type %RECIPIENT_EMAIL% to use that value. Note: If you need to use more than one address in the To, CC or BCC fields, ensure they are separated with just a comma, not comma-space, or the email gateway may not send to all addresses listed. See the SMTP RFC for details. |
Cc | If required, type comma-separated email addresses to which to send a carbon copy of the report. Alternatively, type %RECIPIENT_EMAIL% to use that value. |
Bcc | If required, type comma-separated email addresses to which to send a blind carbon copy of the report. Alternatively, type %RECIPIENT_EMAIL% to use that value. |
Subject | Type a subject for the email. |
Message | Type a message for the body of the email. |
Attachment type | Select the export format: CSV, HTML, or PDF. |
The values in this section are overwritten when scheduling a report.
Option | Description |
|---|---|
Saved report name | Type the name to be used for the downloadable file. You can view the saved report in Manage reports > Saved reports. |
Expiry days | Specify expiry period for the saved reports in days. The value must be between 1 and 999. The default value is 60. You can modify the default using the SAVED REPORTS EXPIRY DAYS setting on the Manage the system > Modules > Manage reports (RPT) menu. |
Never expire | Use this to make the saved report never expire. Expiry days field is hidden when this option is checked. |
Notes | Type notes to be saved with the report. |
Option | Description |
|---|---|
Network path (UNC) | Type a UNC path destination for the exported report. The path must be to a target system. It can map to a real FS share (e.g. \\server\some_path\share_1) or a domain DFS share (e.g. \\domain\namespace\share_1). If you do not want to list users or perform other operations on the system you want to export to, you can set up a NULL type target system simply to store the administrator credentials. In this case, ensure that the listing options are disabled for the target system. If you are mapping to a network drive ensure you enter the credentials using down-level logon name format; for example, DOMAIN\UserName. |
File name | Type a name for the exported report. |
File type | Select the export report format: CSV, HTML, or PDF. |
Target system to use for credentials | Search for and select the target system ID for credentials. |
Administrator ID | Select an administrator ID from the target system. |
Using macros to substitute text
Macros can be used to substitute text when the report runs. The macros must be enclosed in angle brackets <> and are case sensitive.
Macros can be used in the following fields:
Email subject
Email message
Saved report name
Network path (UNC)
File name
Notes
Requester notes
Below is a list of available macros:
Macro | Example substitution |
|---|---|
<SERVER> | bravura-1 |
<USER> | reporter00 |
<DATETIME> | 2015-06-18 01-22 |
<RUNTIME> | 2015-06-18 01-22 |
<DATE> | 2015-06-18 |
<TIME> | 01-22 |
<DAY> | 17 |
<MONTH> | 03 |
<YEAR> | 2015 |
<CC> | 20 |
<YY> | 15 |
<MM> | 03 |
<DD> | 17 |
<HH> | 14 |
<hh> | 02PM |
<mm> | 57 |
<ss> | 04 |