blob: d6d902e04fe48f8a3ff62a55688efa62a7a0528c [file] [log] [blame]
DESCRIPTION
This file contains information about libraries that are supported
by code in OFBiz but that are left out of SVN because of licensing issues.
What is below is a list of jar files and where to put them, and the file(s)
to change to include them in the OFBiz build and/or run-time configuration.
NOTE: While these aren't included in the main SVN repository they are available
on the old Undersun SVN server in the specialized/libraries component directory.
-=- Workflow __________________________________________________________________________________________________________________________________________________
-Shark (LGPL):
http://www.enhydra.org/workflow/shark/
Current version : http://shark.objectweb.org/doc/1.1/release_notes/release_notes.html
framework/shark/lib:
js.jar
sharkassignment-historyrelated-1.2_1.jar
sharkassignment-standard-1.2_1.jar
sharkassignment-xpdlstraightparticipantmapping-1.2_1.jar
sharkauthentication-ldap-1.2_1.jar
sharkcaching-lru-1.2_1.jar
sharkclientapi-1.2_1.jar
sharkcommonapi-1.2_1.jar
sharkcorbaadmin-1.2_1.jar
sharkcorbaclientapi-1.2_1.jar
sharkcorbaserver-1.2_1.jar
sharkcorbawhandler-1.2_1.jar
sharkeventaudit-notifying-1.2_1.jar
sharkeventaudit-smtp-1.2_1.jar
sharkinternalapi-1.2_1.jar
sharkinteroperability-wfxml-1.2_1.jar
sharkkernel-standard-1.2_1.jar
sharklimitagent-standard-1.2_1.jar
sharklimitagent-timer-1.2_1.jar
sharklogging-standard-1.2_1.jar
sharkprocesslocking-memory-1.2_1.jar
sharkrepositorypersistence-filesystem-1.2_1.jar
sharkscripting-standard-1.2_1.jar
sharksecurity-standard-1.2_1.jar
sharktoolagent-standard-1.2_1.jar
sharkusergroup-ldap-1.2_1.jar
sharkutilities-common-1.2_1.jar
sharkutilities-map-1.2_1.jar
sharkutilities-misc-1.2_1.jar
sharkwebservice-asap-1.2_1.jar
sharkwebservice-asapapi-1.2_1.jar
sharkwebservice-asaputils-1.2_1.jar
sharkwebservice-wfxml-1.2_1.jar
sharkwebservice-wfxmlapi-1.2_1.jar
sharkwebservice-wfxmlutils-1.2_1.jar
sharkxpdl-standard-1.2_1.jar
wrd-1.2_1.jar
NOTE: these jars based on a build from version 1.2_1 may be found attached
in https://issues.apache.org/jira/browse/OFBIZ-552
For an updated version some changes to the integration code in the
shark component may be necessary.
TO BUILD: once the jars are in place you can build from the
ofbiz/framework/shark directory, or you can add it to the build
list in the ofbiz/build.xml file in the framework-builds file list.
TO DEPLOY: once the build is done the Shark container must be setup in the
ofbiz-containers.xml file or other containers file being used.
The shark-container container should be un-commented.
TO DEPLOY, PART 2: to get the component to load on startup, and get the webapp
in place and such the shark component needs to be uncommented in the
framework/component-load.xml file.
You may experiment online with Jawe XPDL editor:
http://www.enhydra.org/workflow/jawe/index.html
There is an example XPDL file in https://issues.apache.org/jira/browse/OFBIZ-552
it came from http://www.wfmc.org/standards/docs/xpdl_sample/sample%20workflow%20process.xpdl
For the moment Shark engine in OFBiz refuses to load it (OK in Jawe)
-=- Web Presentation: ________________________________________________________________________________________________________________________________________________
-JPublish/EdenLib (Apache):
NOTE: these were removed for library compatibility reasons, not for license
reasons; working these back in may be tricky
http://sourceforge.net/projects/jpublish
http://edenlib.sourceforge.net/
framework/webapp/lib:
JPublish.jar
EdenLib.jar
TO BUILD comment out exclude: framework/webapp/build.xml:
org/ofbiz/webapp/view/GenericViewRenderer.java
org/ofbiz/webapp/view/JPublishViewHandler.java
org/ofbiz/webapp/view/JPublishWrapper.java
org/ofbiz/webapp/view/FopPdfViewHandler.java
org/ofbiz/webapp/ftl/FreeMarkerViewHandler.java
org/ofbiz/webapp/ftl/FreeMarkerViewRenderer.java
org/ofbiz/webapp/ftl/JpCacheIncludeTransform.java
AND uncomment the jpublish type section portions of:
org/ofbiz/webapp/region/Section.java
-=- Scripting: ________________________________________________________________________________________________________________________________________________
-JavaScript/Rhino (NPL 1.1):
http://www.mozilla.org/js
TO BUILD comment out exclude: base/build.xml:org/ofbiz/base/util/OfbizJsBsfEngine.java
-applets (Netscape javascript plugin : Sun Binary Code License Agreement - BCLA)
Developpers : http://wp.netscape.com/eng/mozilla/3.0/handbook/javascript/packages.htm
This link is also interesting : http://forum.java.sun.com/thread.jspa?threadID=516303&tstart=225
NOTE: applications/product/src/ShipmentScaleApplet.java needs netscape.javascript.JSObject
If you're using the Sun JDK/JRE 1.4 or greater, the jar is located under jre/lib and it's called plugin.jar.
You may also find it in the old Undersun SVN server in the specialized/libraries component directory.
TO BUILD: Copy plugin.jar in framework/base/lib. This seems only needed under Windows.
-=- Reporting: ________________________________________________________________________________________________________________________________________________
-JasperReports (LGPL):
http://sourceforge.net/projects/jasperreports
TO BUILD comment out excludes:
framework/webapp/build.xml:org/ofbiz/webapp/view/JasperReportsPdfViewHandler.java,org/ofbiz/webapp/view/JasperReportsXmlViewHandler.java
applications/content/build.xml:org/ofbiz/content/report/JREntityListIteratorDataSource.java,org/ofbiz/content/report/JRMapCollectionDataSource.java
Also upgrade the itext2.0.1.jar to itext.2.1.7.jar (this will however break the birt report generator.)
- JIMI (used by FOP ):
http://java.sun.com/products/jimi
FOP may require a library called JIMI to print certain graphical formats such as GIFs. Jimi is a Sun library which cannot
be included in OFBIZ due to licensing incompatibility, but you can download it yourself at: http://java.sun.com/products/jimi/
and rename the ZIP file that comes with it as jimi-xxx.jar, then copy it into the same directory as fop.jar, which at this time
is ${ofbiz.home}/framework/webapp/lib/
-=- POS _______________________________________________________________________________________________________________________________________________________
-GTK Swing (LGPL):
http://sourceforge.net/projects/gtkswing/
TO DEPLOY: base/config/pos-containers.xml:org.gtk.java.swing.plaf.gtk.GtkLookAndFeel for look and feel
-JavaPOS hardware drivers
TO DEPLOY: specialpurpose/pos/lib/
Epson Printer TM-T88III (Proprietay licence) needs jpos18-controls.jar (version specific)
https://www.epson-pos.com/cgi-bin/sdssm/main/td_login.jsp
epsonJposService180.jar
epsonJposServiceCommon.jar
Star (Proprietay licence)
http://www.star-micronics.co.jp/service/s_print/starjavapos_win32-linux-macosx_yyyymmdd.zip.htm
starjavapos.jar
-=- Office (Word, etc) File Handling __________________________________________________________________________________________________________________________
-OpenOffice UNO (LGPL)
http://udk.openoffice.org/
applications/content/lib/uno:
XFlatXml.jar
XMergeBridge.jar
XSLTFilter.jar
XSLTValidate.jar
htmlsoff.jar
java_uno.jar
java_uno_accessbridge.jar
juh.jar
jurt.jar
jut.jar
officebean.jar
ridl.jar
unoil.jar
TO BUILD comment out exclude: applications/content/build.xml:org/ofbiz/content/openoffice/*
-=- Accounting: Payment Processing ____________________________________________________________________________________________________________________________
-CyberSource
applications/accounting/lib/cybersource:
cybsclients.jar
cybssecurity.jar
TO BUILD comment out exclude: applications/accounting/build.xml:org/ofbiz/accounting/thirdparty/cybersource/**
-Securepay
applications/accounting/lib/cybersource:
Base64.jar
securepayxmlapi_obf.jar
xercesImpl-2.4.0.jar
xmlParserAPIs-2.4.0.jar
TO BUILD comment out exclude: applications/accounting/build.xml:org/ofbiz/accounting/thirdparty/securepay/**
-WorldPay
applications/accounting/lib/worldpay:
config
config/currency.properties
config/keystore
config/keystore/wcc
config/keystore/wcc/public-1.key
config/keystore/wcc/revision
cryptix-lib
cryptix-lib/Cryptix.properties
cryptix.jar
ijce-lib
ijce-lib/IJCE.properties
ijce-lib/java.security.fallback
ijce-lib/TargetHelp.html
readme.txt
select.jar
select.properties
TO BUILD comment out exclude: applications/accounting/build.xml:org/ofbiz/accounting/thirdparty/worldpay/**