Home

Forms602 to UIProtocol Converter

Project Admins:

• Jindřich Bašek

602toUIPConvertor is utility based on Apache Fop (see http://projects.apache.org/projects/fop.html) used for converting rich electronic XSL-FO based forms in format Forms602 (see http://www.602.cz/) to user interfaces description format and application container format UIProtocol (see http://uiprotocol.eu) developed on the Czech Technical University in Prague.

Utility accepts files in .fo or .zfo format and produces UIProtocol Application format .uipapp.
UIProtocol Application can be executed using UIProtocol Server. Server then offers converted form - UIProtocol Application to UIProtocol client.
Utility is able to produce UIProtocol Application compatible with Java UIProtocol server and .NET UIProtocol server.

Installation and usage

For install extract zip archive to arbitrary folder.

Utility can be launched using 602toUIPConvertor.bat or 602toUIPConvertor.sh inside bin folder.
Use 602toUIPConvertor.bat on Windows operating system.
Use 602toUIPConvertor.sh on GNU/Linux and unix based system.

The utility requires Java Runtime Environment version 6 or higher to run.

Usage: [-n] [[file name 1] [file name 2] ... [file name]]

If no file name specified, utility converts all 602 forms placed inside folder "input" located in the parent directory of directory where executable for launching conversion is placed.
Files with filename extension other than zfo or fo are ignored.

Forms converted to UIProtocol Application format are saved to folder "output" located in the parent directory of directory where executable for launching conversion is placed.

If argument -n present, utility will produce UIProtocol Application compatible with .NET UIProtocol server.
If argument -n NOT present, utility will produce UIProtocol Application compatible with Java UIProtocol server.

Sources and building

You will need:

• Java Development Kit version 6 or higher
• Apache Maven version 3
• Apache ANT
• SVN client

How to checkout source and build convertor:

First prepare folder structure:

• UIP
  • fop

Checkout sources:

Open your command promt and go to folder UIP/fop.
Checkout Forms602toUIPconverter sources using:

svn checkout svn://svn.code.sf.net/p/forms602touip/code/trunk trunk

Forms602toUIPconverter needs some libraries from Web solution for UIProtocol dev. support project https://sourceforge.net/projects/uipwds/.

In the command promt go to folder UIP.
Checkout Web solution for UIProtocol dev. support sources using:

svn co https://uipwds.svn.sourceforge.net/svnroot/uipwds trunk

Folder strukture after successfull checkout:

• UIP
  • fop
    • trunk
      • 602toUIPConvertor
      • 602toUIPConvertorReactor
      • Fop602toUIP
      • Fop602toUIPMaven
  • trunk
    • UIPConstants
    • UIPJavaHandlersFiles
    • UIPSShared
    • UIPServerInnTree
    • UIPServerJavaEventHandlersApi
    • UIPServerSignalerReactor
    • UIPServerXmlSslUipCommunication
    • UIPEventLibrary
    • UIPPortal
    • UIPServer
    • UIPServerInterfaceFactory
    • UIPServerReactor
    • UIPServerTreeConvertors
    • UIPJavaEventHandlers
    • UIPSReflectionsFork
    • UIPServerDevelApi
    • UIPServerJavaEventHandlers
    • UIPServerSignaler
    • UIPServerXmlOutTree

All projects excepting Fop602toUIP are standard Maven projects. Fop602toUIP is ANT project.

Forms602toUIPconverter building:

In the command promt go to folder UIP/fop/trunk/Fop602toUIP and enter command

ant

This will prebuild Apache FOP on which Forms602toUIPconverter is based.

In the command promt go to folder UIP/fop/trunk/602toUIPConvertorReactor and enter command

mvn install

This will build Forms602toUIPconverter and creates installation package inside UIP/fop/trunk/602toUIPConvertorReactor/target folder. This file can be installed and convertor launched acording the chapter Installation and usage.