Reporting Actions
Identity Automation Consulting Services will sometimes use Jaspersoft, a third-party reporting software, to create templates for Connect Action Sets to use that will export data as a branded PDF file for direct customer consumption. These are the actions used to access an existing template and convey data.
Once created, a .jrxml template file can be called within a Connect Action Set to output parameters, fields, and records in a customizable pdf or html format. Identity Automation provides this as a service to customers, but for those who want to use their own templates, the actions to use to call this file format are listed below.
Load a Jaspersoft .jrxml report definition.
Property | Value | Description |
|---|---|---|
reportDef* | expression, variable | report definition |
parameters | expression, variable | Record or ECMAScript object containing report parameters |
data* | expression, variable | collection of records to be reported on |
format* | choice (pdf, html), text, expression, variable | collection of records to be reported on |
path* | text, expression, variable | path of report output file (relative to dss server managed file store) |
returnVariable | expression, variable | name of the variable to be assigned to the return value |
Note
Any image files referenced by the report definition need to be uploaded to the RapidIdentity Connect server in the same directory as the report definition. Generation of an HTML report also generates a directory named <path>_files that contains image files referenced by the html report.
Load a Jaspersoft .jrxml report definition.
Property | Value | Description |
|---|---|---|
path* | text, expression, variable | the path of the Jaspersoft JRXML report definition file (relative to dss server managed file store) |
returnVariable | expression, variable | name of the variable to be assigned to the return value |
Example
report = loadREportDefinition('report.jrxml')
data = createArray()
insertArrayItem(data, 0, {"employeeID": net.idauto.common.util.UUIDs.randomUUIDString(), "givenName": "John", "sn": "Doe", "mail": "jdoeexample.com", "sAMAccountName": "jdoe"})
insertArrayItem(data, 1, {"employeeID": net.idauto.common.util.UUIDs.randomUUIDString(), "givenName": "Homer", "sn": "Simpson", "mail": "hsimpson@example.com", "sAMAccountName": "hsimpson"})
insertArrayItem(data, 2, {"employeeID": net.idauto.common.util.UUIDs.randomUUIDString(), "givenName": "Bruce", "sn": "Wayne", "mail": "bwayne@example.com", "sAMAccountName": "bwayne"})
insertArrayItem(data, 3, {"employeeID": net.idauto.common.util.UUIDs.randomUUIDString(), "givenName": "John", "sn": "Wick", "mail": "jwick@example.com", "sAMAccountName": "jwick"})
insertArrayItem(data, 4, {"employeeID": net.idauto.common.util.UUIDs.randomUUIDString(), "givenName": "Lisa", "sn": "Simpson", "mail": "lsimpson@example.com", "sAMAccountName": "lsimpson"})
generated = generateReport(report, {"title": "The Report Title", "subtitle": "The Report Sub-Title"}, data, "pdf", "report.pdf")