[]
        
(Showing Draft Content)

Report Bursting

Report Bursting in Wyn Enterprise is used to configure scheduled tasks for distributing reports to multiple recipients. The Report Bursting process involves delivering reports based on predefined datasets using parameters to filter data and email recipients.


Here's a quick video to help you understand about report bursting in Wyn Enterprise.



For example, when generating Billing Statements for your customers you can set the parameters like account number and email address to filter out the reports for each customer.


To use Report Bursting and deliver user-specific reports in Wyn, follow the below instructions,

  1. On the Resource or Document Portal, navigate to the document list and select an existing report. With the report selected, click the Info icon at the top right corner of your screen.

    Report Bursting - Navigate to Info Tab

  2. Info pane will appear on the right side, open the Tasks tab and click the + Add Task option to access the Add Task pop-up.

    Report Bursting - Add Task Popup Access

  3. Add Basic Information: On the Add Task pop-up, add the basic information including Task Description, click the Use Report Bursting checkbox, select an Execution option, and add execution details. Click Next to continue.

    Click Next to continue


  4. Bursting Dataset: There are two options to burst datasets,

  • Custom Dataset - Select the Custom Dataset option and, set embedded dataset fields, and fill in the records manually. Fields can be of various datatypes including String, Data, DateTime, etc. You can also add multiple records for a single field and remove the records using the Add Field and Add Record buttons.

    Report Bursting - Custom Dataset

  • Existing Dataset - Select the Existing Dataset option and then, select an existing Wyn dataset from the Select Existing Dataset dropdown. Click Next to continue.

    Report Bursting - Existing Dataset

Caution: The number of records in the bursting dataset should not exceed 100. Using more than 100 records will impact the system performance.

  1. Export Settings: You can choose the file format option and parameters to export the reports,

  • Export tab - Choose a format to export the report from the Export Format dropdown. To manage the advanced settings of the selected export option, select the Advanced Settings checkbox. Following are the available export format options in Wyn Enterprise -

    PDF, Excel, Word, CSV, HTML, Image, JSON, TXT, XML, and Excel Data. Export Templates from the WynReports Settings are also available as export options.

    Report Bursting - Export Tab

  • Parameters tab - Select or enter valid parameters and click Next to set delivery options. You can also use the dataset fields under the Bursting Dataset Fields section as parameters.

    Report Bursting - Set Parameters

  1. Delivery: Set the delivery options by adding recipient email address in the Email To, and the sender's email address in the Reply-To, Subject, and Body of the email. And, select Attachment Type from the dropdown and select a storage duration. To allow anonymous emails, select the Allow Anonymous checkbox. Click OK to finish.

    Report Bursting - Delivery Options

  2. The scheduled task appears on the Tasks tab under Scheduled Tasks section. Use the play icon to run the task in real time or use the ellipses button to access Disable, Edit, Duplicate, and Delete options.

    Report Bursting - Scheduled Task

Note the following for Report Bursting,

  1. Report Bursting cannot be applied to multiple reports.

  2. Schedule Template feature to schedule a task on documents cannot be used when Use Report Bursting option is selected.

  3. Report Bursting supports Email Delivery option only.

  4. If the Administrator has made a setting to hide the Use Report Bursting option, then you will not be able to see it while scheduling a task.

  5. If the Administrator has made a setting to hide the Use Report Bursting and you re-edit a task that was created by using report bursting then:

    • The Report Bursting option will be still visible, and it can be checked off.

    • If you check off this option, it cannot be checked again.

    • When this option is checked, you can change the bursting dataset: custom dataset, existing dataset.

    • The bursting field can be added/deleted/modified when using a custom dataset.

Customize PDF Exported Report File Name

When you export a report and the export type selected is PDF, you can set the name of the exported report file name to distinguish it by using the previously created rendered report value part or bursting fields.


To set the name of the exported report follow the steps given below:

  1. Create a report and add a Parameter. In this example, we have added Parameter1.

    Add Parameter1


  2. Go to Info Panel ->Export-> Rendered Report Values. Add the Key and Value. For details refer to Export.

    add part


  3. Save the report.


  4. Create a scheduled task. Select Use Report Bursting option and click Next.

    Select Report Bursting option


  5. Set the Report Bursting settings. In this example we have selected Custom Dataset and added three fields and records as shown below and then click Next.

    Add custom part and bursting fileds


  6. On the Export Settings, select Export Format as PDF and enable Advanced Settings.

    Enable Advanced Settings


  7. Go to the Filename section and under the Template setting, select the template using the previously created rendered report value part or bursting fields from the dropdown and click Next. Please note, that in this example, we have selected the template with the bursting field <Field1>.

    selecting bursting filed - field1


  8. Select the Delivery Type. In this example, we have selected Delivery Type as Local Storage. Click OK and run the task.


    The file will have different names according to the selected template.


    The exported file is collected to the .zip archive. When you unzip it, the file name is displayed. In this example, as we have selected the bursting field <Field 1>, the file name will have the name as shown below:

    exported report name


    Note: If the filename template part value already contains a bursting field (e.g. filename template part value is equal to parameter value and bursting field is set as parameter value), the corresponding value appears in the filename when the report is exported.

Scenarios for .pdf Exports

Report Bursting Enabled

Delivery Type

Scenario Description

Report Name

Export Filename Templates Setting Value

File Name Setting Value

Exported Report(s) File Name

Zip Archive File Name

Email / Local Storage

Bursting field not used in custom part value

Sample

{ReportName}_{CustomPart}

-

Sample_CustomPartValue_1.pdf Sample_CustomPartValue_2.pdf

TaskName.zip

Email / Local Storage

Bursting field used in custom part value

Sample

{ReportName}_{CustomPart}

-

Sample_FirstCustomPartFirstValue.pdf Sample_CustomPartSecondValue.pdf

TaskName.zip

Email / Local Storage


Sample

{ReportName}_BurstingField

-

Sample_BurstingFieldRecord1Value.pdf Sample_BurstingFieldRecord2Value.pdf

TaskName.zip

File Share


Sample

{ReportName}_BurstingField


Sample_BurstingFieldRecord1Value.pdf Sample_BurstingFieldRecord2Value.pdf

Sample.zip

File Share


Sample

{ReportName}

FSName

Sample_1.pdf

Sample_2.pdf

FSName.zip

File Share


Sample

{ReportName}_BurstingField

FSName

Sample_BurstingFieldRecord1Value.pdf Sample_BurstingFieldRecord2Value.pdf

FSName.zip

File Share

Bursting field was used in custom part value

Sample

{ReportName}_{CustomPart}

FSName

Sample_FirstCustomPartFirstValue.pdf Sample_CustomPartSecondValue.pdf

FSName.zip

File Share

Bursting field not used in custom part value

Sample

{ReportName}_{CustomPart}

FSName

Sample_CustomPartValue_1.pdf Sample_CustomPartValue_2.pdf

FSName.zip

Report Bursting Disabled

Is Multiple

Delivery Type

Report Name

Export Filename Templates Setting Value

File Name Setting Value

Exported Report(s) File Name

Zip Archive File Name

-

Email

Sample

-

-

Sample.pdf

-

-

Email

Sample

{ReportName}

-

Sample.pdf

-

Yes

Email

FirstSample, SecondSample

{ReportName},{ReportName}_{CustomPart}

-

FirstSample.pdf, SecondSample_CustomPartValue.pdf

TaskName.zip

-

Local Storage

Sample

{ReportName}

-

Sample.pdf

-

Yes

Local Storage

Unavailable for Multi-document task

Unavailable for Multi-document task

Unavailable for Multi-document task

Unavailable for Multi-document task

Unavailable for Multi-document task

-

File Share

Sample

{ReportName}

-

Sample.pdf

-

-

File Share

Sample

{ReportName}_{CustomPart}

-

Sample_CustomPartValue.pdf

-

-

File Share

Sample

{ReportName}

FSName

FSName.pdf

-

-

File Share

Sample

{ReportName}_{CustomPart}

FSName

FSName_CustomPartValue.pdf

-

Yes

File Share

Unavailable for Multi-document task

Unavailable for Multi-document task

Unavailable for Multi-document task

Unavailable for Multi-document task

Unavailable for Multi-document task