<<InsertPage page='WidgetTrail'>>

Das JExcel Plugin erlaubt es Excel Arbeitsblätter/mappen im Wiki anzuzeigen. Dadurch vereinfacht sich das Anzeigen von Informationen in Excel enorm, da nicht erst Excel geöffnet werden muss. Es ist gar kein Excel auf dem Rechner nötig um die Tabelle anzuzeigen.Die Anzeige ist WikiTable Markup konform - somit entsteht kein Bruch zur normalen Wiki-Ansicht. 

Einbinden lassen sich Excel Tabellen, die als Datei an das Wiki angehängt wurden. (siehe [[Dateianhang]]). Grundsätzlich lassen sich alle Excel Tabellen anzeigen, die per URL aufrufbar sind. 

Es ist oft gewünscht in Privaten Wikis Excel Tabellen aus Netzwerklaufwerken innerhalb des Firmennetzes einzubinden. Dazu muss das Netzlaufwerk über das HTTP Protokoll aufrufbar gemacht werden. Einfach gesagt bekommt das Netzwerklaufwerk eine URL. Der [[cciServer]] bietet hierzu einen vorkonfigurierten Mechanismus. Um das einbinden zusätzlich zu vereinfachen, kann dem per URL zugreifbaren Netzwerklaufwerk ein [[InterwikiLink]] als Abkürzung gegeben werden.

== Ansicht

<<JExcel src='JExcelExample.xls'>>


== Herkunft und Verfügbarkeit

Das JExcelPlugin Plugin ist kein Bestandteil des JSPWiki. Es ist jedoch Bestandteil der [[cci Server]] Distribution.

Dies ist die cci Server Implementierung des Excel To HTML Plugins [[JSPWiki:ExcelToHTMLPlugin]] mit anderer Technik.

== Parameter

* src -> (Mandatory wenn url nicht gesetzt) Name des Excel Attachments (z.B. src='JExcelExample.xls')
* url -> (Mandatory wenn src nicht gesetzt) Name eines Excel files über url (z.B. url='http://myserver/files/JExcel%20file.xls'). Im Moment wird erwartet dass die URL schon kodiert ist (siehe %20 = leer-zeichen)
* display -> tabs|list, optionaler Parameter, gibt an ob die Arbeitsblätter, die in der Excel Arbeitsmappe enthalten mit "Reitern" (tabs) oder als Liste mit Überschrift angezeigt werden
* sheets -> Sind mehrere Arbeitsblätter vorhanden, so werden standardmässig alle Blätter angezeigt. Wird der sheets Parameter angegeben, so werden nur diese Blätter in angegebener Reihenfolge angezeigt (z.b. 'Extras,Mappe1').

== Features

* erlaubt manuelle Formate für Nummernfelder :
** + Datum
** + Zeit
** + Zahlenformat
** - Probleme bei Währungen, die Excel-Intern formatiert sind
* erlaubt WikiMarkup in Textfeldern:
** + Wiki Links
** + Interwiki Links
** - Anderes Markup ist noch nicht getestet


== Beispiel

Default
{{{
<<JExcel src='JExcelExample.xls'>>
}}}

Listenansicht
{{{
<<JExcel src='JExcelExample.xls' display='list'>>
}}}

Arbeitsblätter selektieren

{{{
<<JExcel src='JExcelExample.xls' display='tabs' sheets='Zusatz'>>
}}}

Vollständiges Codebeispiel. Zur Simulation bitte die Datei JExcelExample.xls an die jeweilige Seite anhängen.
{{{
==JExcel Default

<<JExcel src='JExcelExample.xls'>>

==JExcel List

<<JExcel src='JExcelExample.xls' display='list'>>

==JExcel Selection

<<JExcel src='JExcelExample.xls' display='tabs' sheets='Zusatz'>>
}}}