blob: 7a0ac273920a26291c5ef3167c9e5ce45709594e [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML>
<head>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=windows-1252">
<TITLE></TITLE>
<STYLE>
<!--
@page { margin: 2cm }
P { margin-bottom: 0.21cm; text-align: justify }
P.western { font-family: "Arial", sans-serif; font-size: 10pt }
TD P { margin-bottom: 0.21cm; text-align: justify }
TD P.western { font-family: "Arial", sans-serif; font-size: 10pt }
H1 { margin-bottom: 0.21cm }
H1.western { font-family: "Arial", sans-serif; font-size: 11pt }
H1.cjk { font-size: 16pt }
H1.ctl { font-size: 16pt }
P.textkörper-einzug-western { text-indent: 0.5cm; font-family: "Arial", sans-serif; font-size: 10pt }
P.textkörper-einzug-cjk { text-indent: 0.5cm }
P.textkörper-einzug-ctl { text-indent: 0.5cm }
-->
</STYLE>
</head>
<body LANG="de-DE">
<HR>
<P ALIGN=LEFT STYLE="margin-top: 0.42cm; page-break-after: avoid">
<H1>
Java Application &bdquo;FilterUI&ldquo;
</H1>
</P>
<H2 CLASS="western">Content</H2>
<UL>
<LI><A HREF="#general">General</A></LI>
<LI><A HREF="#intention">Intention</LI>
<LI><A HREF="#licence">Licence</LI>
<LI><A HREF="#features">Features</LI>
<LI><A HREF="#requirements">Requirements</LI>
<LI><A HREF="#installation">Installation</LI>
<LI><A HREF="#startit">Start It</LI>
<LI><A HREF="#documentation">Documentation</LI>
<LI><A HREF="#snapshots">Snapshots</LI>
<LI><A HREF="#download">Download / Source</LI>
</UL>
<H2 CLASS="western"><A NAME="general">General</A></H2>
<P CLASS="western"><FONT FACE="Arial, sans-serif">
I've started development of a new java based application to access filter
configuration data of any StarOffice or OpenOffice installation.
The first version of it will be a very simple tool and supports
read only access only. It's planned to extend it's functionality,
step by step, to get a full-featured administration tool. But
this task can't be done by one person only. So I offer the code
on OpenOffice. Please feel free to contact me if you are
interested in this code.
</FONT></P>
<H2 CLASS="western"><A NAME="intention">Intention</A></H2>
<P CLASS="western"><FONT FACE="Arial, sans-serif">
The filter configuration of an office is a very complex mechanism.
Configuration data is organized similar to a database, e.g.,
filters are registered for different types. This data is
available, inside an office installation, in a file named
TypeDetection.xml. The structure of the file is simple, but the
number of entries can be very high, e.g., on a full installation
set. Reading and editing large sets isn't easy. That is the
reason for this application: to provide a simple access to the
data source and also illustrate the use of the office filter
api.
</FONT></P>
<H2 CLASS="western"><A NAME="licence">Licence</A></H2>
<P CLASS="western"><FONT FACE="Arial, sans-serif">
It's completely free. Use of the binaries and source will not be regulated in any
way. That doesn't include any external requirements, e.g., jdk /
office, which may use their own license models.
</FONT></P>
<H2 CLASS="western"><A NAME="features">Features</A></H2>
<UL>
<LI><P CLASS="western"><FONT FACE="Arial, sans-serif">Version 1.0</FONT></P>
<UL>
<LI><P CLASS="western"><FONT FACE="Arial, sans-serif">
remote connection to an already(!) running office<BR>
(doesn't include proxy support)
</FONT></P>
<LI><P CLASS="western"><FONT FACE="Arial, sans-serif">
read only view of all installed filters/types and their properties of remote office
</FONT></P>
<LI><P CLASS="western"><FONT FACE="Arial, sans-serif">
query mode to specify which filter should be shown
</FONT></P>
<LI><P CLASS="western">
locale of application is changeable during runtime<BR>
(prepared but not fully used)
</P>
</UL>
</UL>
<H2 CLASS="western"><A NAME="requirements">Requirements</A></H2>
<UL>
<LI><P CLASS="western"><FONT FACE="Arial, sans-serif">
an OS which supports java and uses a windowing environment<BR>
(e.g. Linux with Gnome/KDE)
</FONT></P>
<LI><P CLASS="western"><FONT FACE="Arial, sans-serif">
JDK 1.2
</FONT></P>
<LI><P CLASS="western"><FONT FACE="Arial, sans-serif">
Office installation<BR>
(StarOffice 6.0 [beta] or OpenOffice [641c])<BR>
For access of all known filters, it is necessary to make a full
installation of office; otherwise, only a subset will be
available. Furthermore, it is necessary to enable java support.
The following JAR files will be used:
</FONT></P>
</UL>
<P CLASS="western" STYLE="margin-left: 2.2cm">
<FONT FACE="Arial, sans-serif">
unoil.jar<BR>
ridl.jar<BR>
jurt.jar<BR>
juh.jar<BR>
sandbox.jar
</FONT></P>
<H2 CLASS="western"><A NAME="installation">Installation</A></H2>
<P CLASS="western"><FONT FACE="Arial, sans-serif">
There exist three possiblities:</FONT></P>
<OL>
<LI><P CLASS="textk&ouml;rper-einzug-western"><A NAME="install_1"/>
Get the <A HREF="http://framework.openoffice.org/documentation/filterui/filterui.jar">JAR</A> file, for direct use.<BR>
Copy it into your office installation (this means your directory &bdquo;&lt;office_install&gt;/program/classes&ldquo;) or to any
other directory which includes the required JAR files.<BR>
(see Requirements)
</P>
<LI><P CLASS="western" ALIGN=LEFT><FONT FACE="Arial, sans-serif"><A NAME="install_2"/>
Use sources from OpenOffice project <A HREF="http://framework.openoffice.org/source/browse/framework/framework">framework/framework</A>.
Change to sub directory <A HREF="http://framework.openoffice.org/source/browse/framework/framework/java/filterui/">&ldquo;java/filterui&ldquo;</A>.
There you will find all necessary sources to build the application as a
packed JAR file, as well as to generate the class and property
files. See <A HREF="http://framework.openoffice.org/source/browse/framework/framework/java/filterui/readme.txt">&ldquo;java/filterui/readme.txt&ldquo;</A> for further information.
After compilation, you will have a JAR file. Use it
in the same manner as described in <A HREF="#install_1">1</A>.
</FONT></P>
<LI><P CLASS="western" ALIGN=LEFT><FONT FACE="Arial, sans-serif">
Get the java sources and build it by yourself.<BR>
Of course, this is possible also &ndash; but I will not document
it here. See <A HREF="#install_1">1</A> and <A HREF="#install_2">2</A>
for more information on how to build from source, and use it for your own interests.
</FONT></P>
</OL>
<H2 CLASS="western"><A NAME="startit">Start It</A></H2>
<OL>
<LI><P CLASS="western"><FONT FACE="Arial, sans-serif">
Start office with the following command line parameter to initiate remote mode:<BR>
&bdquo;<I>soffice -accept=socket,host=&lt;HOST&gt;,port=&lt;PORT&gt;;urp;</I>&ldquo;<BR>
Variable &lt;HOST&gt; describe the host on which office runs, e.g., &bdquo;localhost&ldquo;.<BR>
Variable &lt;PORT&gt; describe the port on which office listens for incoming requests.<BR>
These values must correspond to values set in the configuration
file of the &bdquo;FilterUI&ldquo; application named &bdquo;filterui.ini&ldquo;.
</FONT>
</P>
<LI><P CLASS="western"><FONT FACE="Arial, sans-serif">
Start application with the following command: &bdquo;<I>java -jar filterui.jar</I>&ldquo;
</FONT></P>
</OL>
<H2 CLASS="western"><A NAME="documentation">Documentation</A></H2>
<P CLASS="western"><FONT FACE="Arial, sans-serif">
It will come as soon as possible ...
</FONT>
<H2 CLASS="western"><A NAME="snapshots">Snapshots</A></H2>
<TABLE BORDER=0 CELLPADDING=0 CELLSPACING=5 STYLE="page-break-inside: avoid">
<TR VALIGN=MIDDLE>
<TD><A HREF="mainwin.png">Main Window</A></TD>
<TD><IMG SRC="mainwin_tbn.png"></TD>
</TR>
</TABLE>
<H2 CLASS="western"><A NAME="download">Download/Source</A></H2>
<UL>
<LI><A HREF="filterui.jar">JAR</A></LI>
<LI><A HREF="http://framework.openoffice.org/source/browse/framework/framework/java/filterui/">Link to CVS directory of openoffice</A></LI>
</UL>
</P>
<HR>
<TABLE WIDTH=367 BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-inside: avoid">
<COL WIDTH=113>
<COL WIDTH=254>
<TR VALIGN=TOP>
<TD WIDTH=113>
<P CLASS="western" ALIGN=LEFT><FONT FACE="Arial, sans-serif"><FONT SIZE=2><B>Author</B></FONT></FONT></P>
</TD>
<TD WIDTH=254>
<P CLASS="western" ALIGN=LEFT><FONT FACE="Arial, sans-serif"><FONT SIZE=2>Andreas
Schl&uuml;ns</FONT></FONT></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=113>
<P CLASS="western" ALIGN=LEFT><B><FONT SIZE=2><FONT FACE="Arial, sans-serif">email</FONT></FONT></B></P>
</TD>
<TD WIDTH=254>
<P CLASS="western" ALIGN=LEFT><FONT FACE="Arial, sans-serif"><FONT SIZE=2><A HREF="mailto:andreas.schluens@germany.sun.com">andreas.schluens@germany.sun.com</A></FONT></FONT></P>
</TD>
</TR>
<TR>
<TD WIDTH=113 VALIGN=TOP>
<P CLASS="western" ALIGN=LEFT><FONT FACE="Arial, sans-serif"><FONT SIZE=2><B>last
modified</B></FONT></FONT></P>
</TD>
<TD WIDTH=254 VALIGN=BOTTOM SDVAL="37280" SDNUM="1031;0;TT.MM.JJ">
<P CLASS="western" ALIGN=LEFT><FONT FACE="Arial, sans-serif"><FONT SIZE=2>25.01.2002</FONT></FONT></P>
</TD>
</TR>
</TABLE>
<P ALIGN=LEFT STYLE="margin-bottom: 0cm"><BR>
</P>
</body>
</HTML>