Skip to content

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.
  e-mail 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>