# Excel-Action

<!-- last_modified: 04. Apr 2018 -->
Erzeugt eine Excel-Datei, die gleich geöffnet oder als Download angeboten werden kann.

### Parameter

| | |
|--|--|
| createnew | Sheets anlegen, falls diese noch nicht existieren? (Standard = nein)<br>Wird keine Vorlage verwendet, muß `"ja"` gewählt sein. |
| downloadname | Dateiname der erzeugten Datei (nicht ausfüllen, um Datei nicht zum Download anzubieten) |
| dokumentname | Dateiname für die Dokumentenverwaltung (nicht ausfüllen um die erzeugte Datei nicht abzuspeichern)<br>ACHTUNG! `"ordnerid"` muß mit angegebenw werden. |
| ordnerid | ID des Ordners in der Dokumentenverwaltung, in der die fertige Datei abgelegt werden soll<br>Muß mit angegeben werden, wenn in der Dokumentenverwaltung gespeichert werden soll. |
| xml | XML Daten direkt eingeben (wenn leer wird xmlfile genommen)<br>Parameter mit [[[...]]] angeben |
| xmlfile | Dateiname der Seite, welche die XML Daten liefert |
| templateid | Server-Dateiname der Excel-Datei in der Dokumentenverwaltung, die als Vorlage dienen soll (wegen Styling oder Formeln).<br>Leer lassen um neue Datei zu erzeugen, die dann allerdings nicht gestylt werden kann. |
| overwrite | Soll eine evtl. vorhande Datei überschrieben werden (Standard: nein) - wird nicht mehr genutzt |
| beschreibung | Beschreibung für die gespeicherte Datei in der Dokumentenverwaltung (nur für neu erstellte Dateien) |
| forcehttp | Soll in jedem Fall http anstatt https zum template laden benutzt werden? (Standard: nein) |

**Aufbau der XML-Datei**

```xml
<?xml version="1.0" encoding="utf-8" ?>
<data>
  <style name="fettkursiv" bold="true" italic="true"/>
  <style name="comic" font="Comic Sans MS" size="14" color="red"/>

  <sheet name="Sheet-Name" [widthA="20" widthB="10" widthC="40"]>

    <insert row="0" col="0" style="fettkursiv">Zeile0 Spalte0</insert>
    <insert row="0" col="1">Zeile0 Spalte1</insert>
    <insert row="0" col="2">Zeile0 Spalte2</insert>
    
    <insert row="1" col="0">Zeile1 Spalte0</insert>
    <insert row="1" col="1">Zeile1 Spalte1</insert>
    <insert row="1" col="2">Zeile1 Spalte2</insert>

  </sheet>
</data>

ODER

<?xml version="1.0" encoding="utf-8" ?>
<data>
  <sheet idx="0">

    <insert adress="A1">Zeile0 Spalte0</insert>
    <insert adress="B1">Zeile0 Spalte1</insert>
    <insert adress="C1">Zeile0 Spalte2</insert>
    
    <insert adress="A2">Zeile1 Spalte0</insert>
    <insert adress="B2">Zeile1 Spalte1</insert>
    <insert adress="C2">Zeile1 Spalte2</insert>

  </sheet>
</data>
```

| | |
|--|--|
| bold | true/false (oder weglassen) |
| italic | true/false (oder weglassen) |
| color | siehe <a href="https://poi.apache.org/apidocs/org/apache/poi/hssf/util/HSSFColor.HSSFColorPredefined.html" target="_blank">hier</a>, nur Farbnamen<br>![excelfarben.png](https://batix.help/uploads/images/gallery/2026-05/MbGldPr4OpfQCrIB-13041695.png) |
| widthA, widthB ... | Spaltenbreite nach Spaltenname |