eIrOcA

Dokuwiki Plugin - OrgApp

Anonymous (anonymous@undisclosed.example.com) — 2019-02-24T19:36:07+0000

Dokuwiki Plugin - OrgApp

Dokuwiki plugin to draw organization charts.

The plugin has been updated with the last version of the applet, there are now more options to draw more compact organization chart (e.g. by reversing the orientation of the last level of leaves).

Plugin usage

Generates charts using the applet OrgApp.

Syntax

<orgapp attribute="value" attribute="value" ...>
 chart definition
</orgapp>

Possible optional attributes:

Name	Description
width	Width of the chart
height	Height of the chart
name	Name of the applet
code	Main class of the OrgApp applet
archive	Archive (URL) location of the OrgApp applet
target	Dafault link target
type	Type of the chart definition (0=SOF), see OrgApp for more details
url	Location (URL) of the organization chart definition

The chart can be defined either directly in the Wiki page or in an external file. In the first case is sufficient to include the definition within the tag orgapp, in the second case you should use the attribute url to define the URL of the definition.

Examples

The following code shows how to define an organization chart directly in the wiki page:

<orgapp>
 <organigram>
  <unit name="eIrOcA" >
   <unit name="eNrIcO" />
   <unit name="sImOnA" />
  </unit>
 </organigram>
</orgapp>

generates the following result:

The following code shows how to draw an organization defined in an external file and changing the default width:

<orgapp width="100%" url="/apps/orgapp/data2.sof"></orgapp>

generates the following result:

Installation

Download and install the plugin using the Plugin Manager using the following http://www.eiroca.net/apps/dokuwiki/dokuwiki-plugin-orgapp.zip. Refer to plugins on how to install plugins manually. Releases at github is always up to date.

Administration

The default values used in the generation of the organization chart can be changed from the control panel.

It is advisable, but not necessary, move the OrgApplet.jar file in the Web server directory serving static resources and change the URL in the field Archive of the administration panel.

WARNING if the applet does not load, you should control:

Java runtime is properly installed in the PC (version 6 or higher)
that Archive field contains the correct URL of the file OrgApplet.jar
to have disabled the nice URL dokuwiki feature. If you want to use nice URL you need to move the OrgApplet.jar file to a static resources folder outside the control of dokuwiki rewrite rules.

History

Version 19.02

dokuwiki “Greebo” compatibility
PHP 7.x compatibility

Version 2013/06/29

Updated with the newest applet

Version 2011/02/03

Added button in the edit toolbar
Support for DokuWiki “Anteater”

Version 2010/04/19

First version

Licence & Copyright

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

DokuWiki, Organization chart, PHP

OrgApp

Anonymous (anonymous@undisclosed.example.com) — 2019-01-19T16:07:08+0000

OrgApp

OrgApp is a Java library to handle and draw organization charts (organigrams).

The library has also an applet and a Swing Java client able to view an organization chart read from a file, in different formats (one of them based upon XML).

The applet supports charts with different layouts and boxes with hyperlinks, customizable colors, sizes, positions, … and it is easy to embed in an HTML page.

Examples

To view the applet, you need a browser supporting Java Plug-in.

Requirements

Supported OS:

Download

The full distribution, including source code, can be downloaded here.

Additional project resources are hosted in a Source Forge Repository.

OrgApp is also supported by:

Documentation

Organigram Applet

OrgApplet.jar is the applet to view the charts, the applet requires a browser supporting Java Plug-in (with a Java version higher than 1.5). The syntax is:

<applet name="Organigram" code="OrganigramApplet.class" archive="URLTO_OrgApplet.jar">
  <param name="DataSource" value="URLTO_organigram.xml" />
  <param name="Target" value="_blank" />
  <param name="Data" value="embedded organization chart definition" />
  <param name="DataType" value="type of the definition" />
</applet>

The parameters meaning is:

DataSource is the URL of the resource that contains the definition of the orgnanigram in any of the supported formats.
Target is the target used in links (unless a more specific will be present in the definition of the organigram node).
Data, if DataSource is not defined this fileds holds the embedded definition of the chart in one of the supported format.
DataType is the type of the embedded definition (0=SOF, 1=TXT, 2=sitemap).

Check the source page to see a real usage.

Organigram Application

OrgApp.jar is a stand alone Java application to view the organization charts, that can be launched with the syntax:

java -jar OrgApp.jar path_to_organigram.xml

where path_to_organigram.xml is obviously the path to the organigram in any of the supported format (format used is autodetected).

Organigram Converter

Convert.jar is a tool to transform an organization chart file from a format to another, the syntax:

java -jar Convert.jar input_file output_type

input_file is the path of the input organigram

output_type is the type of the output organigram, with the following encoding: 0 simple organigram format, 1 text organigram, 2 sitemap.

The output will be printed to the screen, but can be redirected to a file (adding > path_to_output to the command).

The conversion form SOF format to another format can loose lot of information…

Organigram File format

OrgApp support three organigram file formats.

SOF, Simple Organigram Format is a XML based file format
Text Format, is a format where each raw is a node of the organigram
Sitemap format, as described in http://www.sitemaps.org

See data file of the first organigram and of the second one for examples of the file format or the SOF file format documentation present inside the doc directory of the distribution.

Server side helpers

The distribution contains server side library to easly integrate the applet.

OrgApp.inc is a PHP script to easly generate the HTML code necessary to draw the organization chart. Sample code:

require_once("lib\OrgApp.inc");
$OC = new OrgApp();
//Set the dimension of the chats $OC->width=400;
$OC->height=300;
//Generate a chart, the data is a URL
$OC->emitRef('data.xml');
//Generate a chart, the data is read from a file and embedded in the html page
$OC->emitFile('data.xml', 0);
//Generate a chart with the data given
$OC->emitData('<organigram><unit name="Doe, John" department="CEO" role="H"/></organigram>', 0);

Dokuwiki

It's also available a Dokuwiki plugin here.

Screenshoots

Development

To Do

Hyperlinks on box lines
Offscreen (?)
MouseOver effect
Search
Graph editor (?)
Images on the node and in general flexible layout of the node
Staff drawing
Matrix dependencies

           B
           |-S
        -----------
        |     |   |
        B     B.. |
        |-O     ..M
        |-O......

Changes log

Version 0.4.0

PHP script to easly generate the applet in a HTML page
New layouts: TOP (e.g. organization chart), LEFT (e.g. classic tree chart), BOTTOM (e.g. family tree), RIGHT (e.g. direct elimination matches)
It is possible to specify line mode (direct or connector) and use name instead of numbers (e.g. mode=“grow” instead of mode=“2”)
Applet can take the chart definition from “Data” and “DataType” parameters
Collapsible nodes
Added handling of collapsed flag in the GUI (right click toggles it)
Colors now can be expressed also with HTML color notation

Version 0.3.0

Compact aligment
Reading/writing organigram from sitemap.xml
Target of the link can be specified
Bugs fixing

Version 0.2.0

XML file format refactory
Writing organigram in XML format
Reading/writing organigram in text format
Adding Layout support (vertical/horizzontal)
Box mode introduced in layout manager in order to take less room to display the boxes. There are three modes:
- MAX, where all boxes have the same size
- MIN, where the boxes have the minimum size (granted that all boxes on the same row/col have the same size)
- GROW, that grants that “boss” boxes are not lower than operative
Metadata handling including box type (boss highlight)
Individual box colors
Individual line font
Adding compact visualization

Version 0.1.0

2005/11/20 - Improved scrollbars management.
2005/11/20 - Improved the layout management and moved it to a dedicated class.
2005/11/20 - Implemented basic individual line font management and horizontal alignment.
2005/11/20 - Implemented cursor and tooltip update for boxes with a defined link.
2005/11/13 - Implemented box hyperlinks (not on lines yet).
2005/11/06 - Began to implement color, font and style for box lines.
2005/11/06 - Introduced scrollbars.
2005/10/30 - Added link tag for box lines.

Project status

Status: Release

Language: Java

Software metrics.

Licence & Copyright

This program is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

You should have received a copy of the GNU Lesser General Public License along with this program. If not, see http://www.gnu.org/licenses/.

OrgApp, Software, Java, Organigram, Organization chart