Author: jleroux Date: Thu Nov 8 15:17:25 2018 New Revision: 1846159 URL: http://svn.apache.org/viewvc?rev=1846159&view=rev Log: No functional changes Updates updateWiki.bat to use AsciiDoctor Removes *.md.html files, replaces them by *.html from AsciiDoctor I'll update the wiki page... Added: ofbiz/tools/wiki-files/birt/Creating reports.html (with props) ofbiz/tools/wiki-files/birt/How to use flexible reports.html (with props) ofbiz/tools/wiki-files/birt/Report master creation.html (with props) ofbiz/tools/wiki-files/birt/Using the Birt Report Designer.html (with props) Removed: ofbiz/tools/wiki-files/birt/Creating reports.md.html ofbiz/tools/wiki-files/birt/How to use flexible reports.md.html ofbiz/tools/wiki-files/birt/Report master creation.md.html ofbiz/tools/wiki-files/birt/Using the Birt Report Designer.md.html Modified: ofbiz/tools/updateWiki.bat ofbiz/tools/wiki-files/README.html Modified: ofbiz/tools/updateWiki.bat URL: http://svn.apache.org/viewvc/ofbiz/tools/updateWiki.bat?rev=1846159&r1=1846158&r2=1846159&view=diff ============================================================================== --- ofbiz/tools/updateWiki.bat (original) +++ ofbiz/tools/updateWiki.bat Thu Nov 8 15:17:25 2018 @@ -5,10 +5,10 @@ pandoc applications/datamodel/DATAMODEL_ pandoc themes/README.md -s -o tools/wiki-files/themes/README.md.html call asciidoctor README.adoc -o tools/wiki-files/README.html -call asciidoctor "plugins/birt/documents/Creating reports.md" -o "tools/wiki-files/birt/Creating reports.md.html" -call asciidoctor "plugins/birt/documents/Using the Birt Report Designer.md" -o "tools/wiki-files/birt/Using the Birt Report Designer.md.html" -call asciidoctor "plugins/birt/documents/How to use flexible reports.md" -o "tools/wiki-files/birt/How to use flexible reports.md.html" -call asciidoctor "plugins/birt/documents/Report master creation.md" -o "tools/wiki-files/birt/Report master creation.md.html" +call asciidoctor "plugins/birt/documents/Creating reports.adoc" -o "tools/wiki-files/birt/Creating reports.html" +call asciidoctor "plugins/birt/documents/Using the Birt Report Designer.adoc" -o "tools/wiki-files/birt/Using the Birt Report Designer.html" +call asciidoctor "plugins/birt/documents/How to use flexible reports.adoc" -o "tools/wiki-files/birt/How to use flexible reports.html" +call asciidoctor "plugins/birt/documents/Report master creation.adoc" -o "tools/wiki-files/birt/Report master creation.html" pandoc tools/demo-backup/README.md -s -o tools/wiki-files/demos/README.md.html pandoc tools/documentation/BuildBot/BuildBot.md -s -o tools/wiki-files/BuildBot/BuildBot.md.html Modified: ofbiz/tools/wiki-files/README.html URL: http://svn.apache.org/viewvc/ofbiz/tools/wiki-files/README.html?rev=1846159&r1=1846158&r2=1846159&view=diff ============================================================================== --- ofbiz/tools/wiki-files/README.html (original) +++ ofbiz/tools/wiki-files/README.html Thu Nov 8 15:17:25 2018 @@ -1644,7 +1644,7 @@ Secure Sockets Extension) API

Added: ofbiz/tools/wiki-files/birt/Creating reports.html URL: http://svn.apache.org/viewvc/ofbiz/tools/wiki-files/birt/Creating%20reports.html?rev=1846159&view=auto ============================================================================== --- ofbiz/tools/wiki-files/birt/Creating reports.html (added) +++ ofbiz/tools/wiki-files/birt/Creating reports.html Thu Nov 8 15:17:25 2018 @@ -0,0 +1,588 @@ + + + + + + + +Report creation - Admin/Super-User + + + + + +
+
+

Introduction

+
+
+ + + + + +
+
Note
+
+this feature will be officially available with the R17.12 branch first release +
+
+
+

A flexible report is an OFBiz content of FLEXIBLE_REPORT type that allows a final user to make use of the reporting module to obtain flexible reports, ie reports which are created from an entity or view definition and even from a service. A flexible report is created from a Report Master (content REPORT_MASTER), and an optional XML override of the parent form.

+
+
+
+
+

Pre-requisite

+
+
+
    +
  • +

    OFBiz framework

    +
  • +
  • +

    The Birt plugin

    +
  • +
  • +

    The BIRT Report Designer

    +
  • +
+
+
+
+
+

Report creation

+
+
+
    +
  1. +

    Get to Birt component in OFBiz Birt menus

    +
  2. +
  3. +

    Click on the "Flexible Report" menu (varies depending on themes)

    +
  4. +
  5. +

    Click on the "Generate report" button, you get to this screen:

    +
  6. +
  7. +

    Fill the form: +Example Report

    +
    +
      +
    • +

      The list "Choose report topic" will let you choose among predefined report masters your topic of interest.

      +
    • +
    • +

      The report name is a simple short name from which the file name will be generated.

      +
    • +
    • +

      The description is a short description which will allow you to recognise the report and its topic.

      +
    • +
    • +

      The box "Generate filters in design" will add in the design the visualisation of the filters filled in the filtering form.

      +
    • +
    +
    +
  8. +
+
+
+

Finally, if you don’t find what you want, you will need to create a new Report Master…​

+
+
+

Once the form is validated, OFBiz will show you the "Edit Report" screen. Edit Report screen

+
+
+
+
+

Report information

+
+
+

This first panel allows you to change the report description and status. Actually it does not make sense changing the status to published before having downloaded the .rptdesign file (Birt Report Designer file) from the server (in database), edited and uploaded it back to the server. This is explained in the section below. Changing the status allows users to use your reports. But if you publish without any change the report will render as empty.

+
+
+
+
+

The .rptdesign report file: download, edit, upload and publish it

+
+
+

To really use the report you need to download the .rptdesign file from the server in a location from where you can edit it with the BIRT Report Designer. So you need to install first the BIRT Report Designer. Then you can edit the .rptdesign file in the BIRT Report Designer. For that refer to the "Using the Birt Report Designer.md.html" file. You can also find the Markdonw version in the same directory: ofbiz-framework/plugins/birt/documents

+
+
+

Editing the downloaded file

+
+

Once you installed the BIRT Report Designer and have downloaded the .rptdesign file, you can edit it with the Birt Report Designer. When you have edited it suiting your needs you must upload it to the server for your changes to be taken into account by OFBiz.

+
+
+

This is when things begin to be really interesting. You can then test your report using the "Preview" panel. There you can temporarily filter the result, and use the export format you prefer, once done click "Send". You can then decide to change the report content in the Birt Report Designer again or keep your changes. Once done in the Birt Report Designer, simply select the changed file to upload, and upload it again. You can re-test your changes and continue until you really get what you want! You can then publish the report to allow users to select and use it. There are 2 ways to publish a report from the "Manage reports" screen or directly in the "Report information" panel. We will see the "Manage reports" screen below.

+
+
+
+
+
+

Filters Overriding

+
+
+

You may want to overide the default filters. You can then use the Xml "Override filters" panel to override and personnalize the form, once done click "Save". If you ignore that step, it will NOT prevent the report creation, it is already done, it will just be with the generic filtering form inherited from the master from.

+
+
+ + + + + +
+
Note
+
+if no preview is available, it is usually due to a mistake in the master form code. You can edit it in the database. +
+
+
+
+
+

Manage reports

+
+
+

The "Manage reports" button get you to a screen which allows to edit (get back to current page), publish or delete a report.

+
+
+
+
+

Use a report

+
+
+

Users can select and use any published report from that screen. When they select a report they then get the same "Preview" Panel and can do the same things than in the "Edit Report" screen. Refer users to

+
+
+
+
+ + + \ No newline at end of file Propchange: ofbiz/tools/wiki-files/birt/Creating reports.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: ofbiz/tools/wiki-files/birt/Creating reports.html ------------------------------------------------------------------------------ svn:keywords = Date Rev Author URL Id Propchange: ofbiz/tools/wiki-files/birt/Creating reports.html ------------------------------------------------------------------------------ svn:mime-type = text/html Added: ofbiz/tools/wiki-files/birt/How to use flexible reports.html URL: http://svn.apache.org/viewvc/ofbiz/tools/wiki-files/birt/How%20to%20use%20flexible%20reports.html?rev=1846159&view=auto ============================================================================== --- ofbiz/tools/wiki-files/birt/How to use flexible reports.html (added) +++ ofbiz/tools/wiki-files/birt/How to use flexible reports.html Thu Nov 8 15:17:25 2018 @@ -0,0 +1,522 @@ + + + + + + + +Using a flexible report - User + + + + + +
+
+

Introduction

+
+
+ + + + + +
+
Note
+
+this feature will be officially available with the R17.12 branch first release +
+
+
+

A flexible report is an OFBiz content of FLEXIBLE_REPORT type which allows the final user to obtain reports using the Birt reporting module. It will be produced at a specific time of your choosing, with your chosen output format, filtering the data with a few parameters defined during report design creation.

+
+
+
+
+

Pre-requisite

+
+
+
    +
  • +

    OFBiz

    +
  • +
  • +

    The Birt plugin

    +
  • +
  • +

    Pre-published reports created from report masters

    +
  • +
+
+
+
+
+

Using the report

+
+
+
    +
  1. +

    go to the Birt component or to another page harboring reports.

    +
  2. +
  3. +

    In the Birt component, click "Use a report".

    +
  4. +
  5. +

    Select your report and hit "Send".

    +
  6. +
  7. +

    The next screen will allow you to filter your data through a set of pre-defined criteria. Should you leave it empty, you will retrieve unfiltered data.

    +
  8. +
  9. +

    Select the desired export format

    +
  10. +
  11. +

    Upon validation, your report is now loaded and can be saved.

    +
  12. +
+
+
+ + + + + +
+
Note
+
+Report loading can be a bit long depending on the data treatment +
+
+
+
+
+ + + \ No newline at end of file Propchange: ofbiz/tools/wiki-files/birt/How to use flexible reports.html ------------------------------------------------------------------------------ svn:eol-style = native Propchange: ofbiz/tools/wiki-files/birt/How to use flexible reports.html ------------------------------------------------------------------------------ svn:keywords = Date Rev Author URL Id Propchange: ofbiz/tools/wiki-files/birt/How to use flexible reports.html ------------------------------------------------------------------------------ svn:mime-type = text/html