Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

Where are PDF reports used

PDF reports are used throughout the system - anywhere the result is a PDF.  For example Invoices, Sales Orders, Picking Slips, Labels etc.

What editor is required

PDF Reports have been defined using stimulsoft

The process of defining a report is as follows: 

  1. You must have the Stimulsoft Editor - this will require you to obtain a license.  http://www.stimulsoft.com/en/online-store
      We need to
      1. You can use the fully functional demo they provide as a starting point.

    What do I need to get started

    The process of defining a report is as follows:

    Use existing example as a starting point

    We can send you the current mrt file on the system to use as a starting point (the extension of the file is .mrt - in the same way an excel file is .xls )

    Get some sample data to view the report as you build it

    Update your user preference for DebugReportXML to Selected (NAV: System > User Preferences)

    ...

    Image Added

     

    Using this setting, when you

    ...

    print an existing report in the system it will provide a download for you of the XML used in the report which you can use in Stimulsoft as the XML source

    You will get the following:

    Image Added

    Save this file - it is example data.

    Note

    This does not tell the system the fields that are available - we will provide that as part of the report definition. It does provide some example data in the available fields for you to use.

    If a field you want to use is not available - you will need to talk to us so we can add it to the report definition.

    Upload this sample data file to the editor.

    -image required

    Use the Stimulsoft Editor to edit the report

    See the Stimulsoft help to learn how to do this 

    Some tips:

    1. A data band will repeat lines as defined until no more lines are available
    2. A Report summary band will sit below the data band results
    3. Page header and footers are repeated across multiple pages
    4. A column header band provides the column headings for the data band and will repeat across pages
    5. Report title is only the first page
    6. Expressions can be used to add fields together, combine strings etc.
    7. A field may link directly to a data column
    8. you will need a field with text in the expression for labels

    Loading into the test system for testing

    Provide the finished MRT to us to upload into the test system.

    Providing the finished report for use in the test system requires us to generate a new app server and make the new one the default for new users.  You will have to logout and log back in to start using the new default app server.

     

    Note
    When the system is looking for a stimulsoft report to use it looks in the following order:
    1. The report name (eg invoice.mrt) prefixed by the search code of the host company
      1. eg COMPANY1invoice.mrt if you are logged into the host company called COMPANY1
      2. or COMPANY2invoice.mrt if logged into the host company called COMPANY2
    2. The report name prefixed by the host company Report Prefix, eg C1invoice.mrt - if the host company you are logged into has the search code C1.
    3. The report name with no prefix, eg invoice.mrt (the default report)