Microsoft Excel Reader

Der Adapter liest ein Microsoft-Excel-Dokument ein (im .xls-Format von Excel 97–2003 oder im XML-basierten OOXML-Format .xlsx) und gibt dessen Inhalt als XML-Dokument aus.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt.

Mögliche Werte:

Read Spreadsheet: Excel-Dokument lesen

Parameter

Adapter

Hauptklasse des Adapters (nicht verändern!)

Mögliche Werte:

de.softproject.integration.adapter.excel.ExcelReader: Hauptklasse (Standard)

Formatter

Verwendeter Formatierer (hat Einfluss auf die XML-Ausgabe, siehe unten)

Mögliche Werte:

de.softproject.integration.adapter.excel.DefaultFormatter: Jeden Zelleninhalt des Excel-Dokuments in einem Element <Cell/> ausgeben (Standard)
de.softproject.integration.adapter.excel.NumberedCellFormatter: Jeden Zelleninhalt der Excel-Datei in einem XML-Element mit Zellennummer ausgeben (z. B. <Cell_0/>)
de.softproject.integration.adapter.excel.LabeledCellFormatter: Jeden Zelleninhalt der Excel-Datei in einem XML-Element mit Zellenbuchstaben ausgeben (z. B. <Cell_A/>)

MinimumInflateRatio

Optional. Gibt das minimale Dekompressionsverhältnis an, das beim Lesen einer Datei zulässig ist.

In Apache POI wurde eine Sicherheitsprüfung eingeführt, um Angriffe durch sogenannte ZIP-Bomben abzufangen. Bei diesen Angriffen steigt die Größe einer Datei beim Entpacken in den Arbeitsspeicher um ein Vielfaches an. Das kann problematisch sein, wenn der Arbeitsspeicher der Java Virtual Machine mit der Größe dekomprimierten Datei überfordert ist, da es dadurch zu einem Serverausfall kommen kann.

Die eingeführte Sicherheitsprüfung verwendet ein minimales Dekompressionsverhältnis. Dieser Wert misst die Differenz zwischen dem von einer Datei im Dateisystem beanspruchten Speicherplatz und dem beim Lesen der Datei benötigten Arbeitsspeicher.

Mögliche Werte:

Beliebige ganze Zahl zwischen 0 und 100

Der Standardwert ist 1. Mit diesem Wert schlägt der Adapter z. B. dann fehl, wenn eine Datei im Dateisystem eine Größe von 1 KB aufweist, im Arbeitsspeicher jedoch eine Größe von 100 KB.
Mit dem Wert 0 wird die Sicherheitsprüfung deaktiviert.
Bei einem Wert von 100 liest der Adapter keines der bereitgestellten Dokumente aus, da eine Datei in einem Fall im Arbeitsspeicher kleiner ist als im Dateisystem.
Wenn der angegebene Wert nicht im zulässigen Bereich (zwischen 0 und 100) liegt oder ungültig ist, wird der Standardwert verwendet

Statuswerte

`1`	Die Operation wurde erfolgreich ausgeführt.
`-1`	Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen.

Output

Mit dem Standardformatierer de.softproject.integration.adapter.excel.DefaultFormatter wird folgende XML-Struktur ausgegeben:

HTML/XML

<Workbook>
   <Sheet name="Name des Tabellenblatts">
      <Row rowId="Zeilennummer">
         <Cell colId="Spalten-ID" type="Datentyp" format="Formatierung"
               formula="Formel"><!--Zelleninhalt--></Cell>
      </Row>
   </Sheet>
</Workbook>

Mit dem Formatierer de.softproject.integration.adapter.excelWriter.NumberedCellFormatter wird folgende XML-Struktur ausgegeben:

HTML/XML

<Workbook>
   <Sheet name="Name des Tabellenblatts">
      <Row rowId="Zeilennummer">
         <Cell_0 colId="Zellen-ID" type="Datentyp" format="Formatierung"
                 formula="Formel"><!--Zelleninhalt--></Cell_0>
      </Row>
   </Sheet>
</Workbook>

Mit dem Formatierer de.softproject.integration.adapter.excel.LabeledCellFormatter wird folgende XML-Struktur ausgegeben:

XML

<Workbook>
   <Sheet name="Name des Tabellenblatts">
      <Row rowId="Zeilennummer">
         <Cell_A colId="Zellen-ID" type="Datentyp" format="Formatierung"
                 formula="Formel"><!--Zelleninhalt--></Cell_A>
      </Row>
   </Sheet>
</Workbook>