Report Plugin Layout¶
The.rpl file is required for all plug-ins. It consists of a report layout that contains general information and properties and a <plug-in> tag that defines properties, data and variables that are specific for each plug-in. For example, the Excel plug-in has a property that determines whether or not the first row in the Excel document should contain the display names for the data fields. The default values are used if the tags are missing or if the value inside the tag is of a wrong type. Properties belonging to the general report layout:
Property Name | Sub Property Name | Type | Default value | Description |
---|---|---|---|---|
version | Number | N/A | The version of the report. | |
plugin-type | CSV/SCRIPT/XSL/XML/EXCEL/S-EXCEL | XML | The type of the plug-in that is going to be used on the xml. | |
plugin-class | Text | N/A | The fully qualified name of the plug-in class. It is very important to get this correct, see each plug-in documentation for the correct names. |
|
output-method | BINARY/FILE/E-MAIL | N/A | This is the method that defines the destination of the report. | |
output-name | Text | <ReportId>_<ResultKey> | The file or attachment name. | |
output-extension | Text | xml | The (file) type of the output. For example csv, xml, xsl, xlsx | |
default-output-reference | binary | <host>:<port>/<UNC PATH> | <the physical address of the print job printer> | Address for binary output. This can be either a host:port reference or a UNC path. Leave this empty to configure the reference depending on printer. |
file-sender | Text | N/A | File Sender name configured in Solution Manager. For example: FILE_SENDER1, FILE_SENDER2 | |
file | Text | <output-name>.<output-extension> | This sets the file name for the FILE destination. Note: This is deprecated. Set instead the other output-references that builds the default for this value. |
|
List (; separated) | <e-mail address on the print job> | List of addresses to send mail to. | ||
e-mail-sender | Text | <empty> | The email address used as the sender. | |
e-mail-cc | List (; separated) | <empty> | List of addresses to send CC-mail to. | |
e-mail-subject | Text | <empty> | The subject as a text string | |
e-mail-body | CDATA (see example) | <empty> | A text block that defines the body of the mail. | |
full-xml | TRUE/FALSE | TRUE | Whether or not the xml that is sent to the plug-in should contain meta data. | |
flattened-xml | enabled | TRUE/FALSE | TRUE | Whether or not the xml that is sent to the plug-in should be of a flattened structure. |
strongtyping | TRUE/FALSE | TRUE | Whether or not the xml that is sent to the plug-in should have defined types for the data fields and be of a flattened structure. | |
<full-xsd-column-set> | ON/OFF | OFF | When OFF, only columns that are available in the data will be included. If set to ON, all listed columns in the report schema will be included. This could be good in an Excel sheet if you want columns to be fixed so you can reference them with a static reference. | |
report-id | List (, separated) | N/A | The IDs of the reports that the installer will install this layout on. | |
report-title | Text | Other | The title of the report, used by the installer when importing layout. |
Example¶
<?xml version="1.0" encoding="UTF-8"?>
<report-layout>
<properties>
<version>0.1</version>
<plugin-type>CSV</plugin-type> <!--SCRIPT,XSL,XML,EXCEL,S-EXCEL-->
<plugin-class>
ifs.application.printagentservice.impl.extendedformatter.csvplugin.CSVPlugin
</plugin-class>
<output-method>FILE</output-method> <!-- BINARY,FILE,E-MAIL-->
<output-extension>csv</output-extension>
<default-output-reference>
<binary>\\user\ZebraGX4</binary>
<file-sender>FILE_SENDER1</file-sender>
<e-mail>firstname.lastname@something.com</e-mail>
<e-mail-sender>firstname.lastname@something.com</e-mail-sender>
<e-mail-cc></e-mail-cc>
<e-mail-subject>Email Subject</e-mail-subject>
<e-mail-body>
<![CDATA[
Email Body Content from the RPL
]]>
</e-mail-body>
</default-output-reference>
<full-xml>TRUE</full-xml>
<flattened-xml>
<enabled>TRUE</enabled>
<strongtyping>TRUE</strongtyping>
</flattened-xml>
<report-id>MODULE_REP</report-id>
<report-title>RPL LAYOUT</report-title>
</properties>
<plugin>
<properties>
<!-- plugin specific properties -->
</properties>
<data>
<!-- plugin specific data -->
<![CDATA[Put your data here]]>
</data>
<variables>
<!-- plugin specific variables -->
</variables>
</plugin>
</report-layout>