XLS Adapter

Verwendung

Der XLS Format Adapter erzeugt aus Microsoft-Excel-Dateien XML-Formate und umgekehrt.

  • XLS > XML

    Der XLS Format Adapter kann Excel-Dateien im Format XLS der Excel-Versionen 95, 97, 2000, 2003, 2007 und 2010 einlesen.

    Sie können einzelne oder alle Arbeitsblätter einer Excel-Datei konvertieren. Auch Excel-typische Darstellungsformate wie Schriftart und Schriftgröße, Farbe, Ausrichtungen werden in der XML-Struktur abgebildet. Für die Zellenformatierung werden Fonts, Datum, Zahlen und arithmetische Formeln unterstützt. String-Funktionen werden nicht unterstützt. Aus allen Formelarten kann der letzte berechnete Wert übernommen werden.

    Grafiken können weder eingelesen noch erzeugt werden!

    Das erzeugte XML-Format hat eine dreidimensionale Struktur, die drei Dimensionen entsprechen dem Arbeitsblatt, der Zeile und der Spalte in der Excel-Eingangsnachricht.

  • XML > XLS

    • Format

      Beim Konvertieren von XML-Nachrichten in das XLS-Format erwartet der XLS Format Adapter Eingangsnachrichten im XMLSS-Format und gibt Excel-Dateien im Format von Excel 97 aus.

      Benannte Farben (Named Colors) aus dem XML-Kalkulationstabellenformat (XMLSS) von Microsoft werden nicht unterstützt. Es werden nur bestimmte Farben unterstützt. Für alle anderen wird eine in der Tabelle der unterstützten Farben enthaltene Farbe gewählt, die der gewünschten Farbe am ähnlichsten ist, z.B.: #CD5C5C wird durch #993366 ersetzt.

  • AutoFilter

    Der XML-XLS Adapter unterstützt AutoFilter in den generierten XLS-Dateien.

    Zu diesem Zweck muss in der XML-Datei der Zellbereich angegeben werden, auf den der AutoFilter angewendet werden soll. Zu diesem Zweck wird das Attribut ref im AutoFilter-Tag verwendet.

    Beispiel:

    <?xml version="1.0" encoding="UTF-8"?>
    <Workbook>
      <Styles>
        ...
      </Styles>
      <Worksheet Name="Worksheet_1" Protected="0">
        <Table DefaultRowHeight="12.8" DefaultColumnWidth="48">
          ...
        </Table>
        <AutoFilter ref="A1:C4">
        </AutoFilter>
      </Worksheet>
    </Workbook>

    Erläuterung der Zellbereichsangabe:

    <!-- To Enable filtering for a range of cells, add AutoFilter block with cell range information inside "ref" attribute -->
    <AutoFilter ref="A1:C4">
      <!-- Here “A1” refers to the first cell in the worksheet, where column A and row 1 intersect -->
      <!-- Here “C4” refers to the last cell at the intersection of column C and row 4 -->
    </AutoFilter>

    Die Mapping-Vorlage für den XLS Adapter wurde entsprechend aktualisiert (Repository-Ordner Global > System > Mapping-Templates > XLS Adapter). Gegebenenfalls ist ein Update-Patch für den globalen Repository-Ordner erforderlich, um das neueste Template und das neueste Beispiel zu erhalten.

    Diese Funktion wird in INUBIT nur für Apache POI >= 3.16 unterstützt.

Eingangsnachrichten für XML-XLS Adapter erstellen

Der XML-XLS Adapter erwartet Eingangsnachrichten im XMLSS-Format. Um Ihre Eingangsnachrichten in dieses Format zu konvertieren, verwenden Sie ein XSLT Converter Modul und das mitgelieferte Mapping Template.

So gehen Sie vor

  1. Erstellen Sie einen XSLT Converter.

  2. Öffnen Sie im Bereich XML Zieldatei das -Menü und wählen Sie Öffnen von > Repository.

    Der Repository Explorer wird angezeigt.

  3. Öffnen Sie das Verzeichnis Global > System > Mapping Templates > XLS Adapter und markieren Sie die Datei template.xml.

  4. Klicken Sie auf OK.

    Der Explorer schließt sich und das Template wird angezeigt.

  5. Bilden Sie Ihre Eingangsnachricht auf die Template-Struktur ab, um eine Nachricht im erforderlichen Format zu erzeugen.

XLS > XML: Zeitzone zum Konvertieren von Datumswerten umstellen

Beim Konvertieren von Microsoft-Excel-Dateien nach XML können Sie die Zeitzone, die zum Konvertieren von Datumswerten genutzt werden soll, explizit angeben.

Um für Zeitreihen, die sich über den Zeitpunkt der Winter-/Sommerzeitumstellung erstrecken, sicherzustellen, dass die Sommerzeit ignoriert wird und es daher auch einen Wert für 02:00 Uhr gibt, müssen Sie die Zeitzone relativ zur Greenwich Mean Time angeben, z.B. GMT+1.

So gehen Sie vor

  1. Fügen Sie Ihrem Modul die Moduleigenschaft timeZone hinzu.

  2. Geben Sie als Wert das Kürzel der Zeitzone ein, die für Ihre Daten in der Excel-Datei gilt.

Dialogbeschreibungen XLS Adapter

Dialog XLS-XML Adapter Eigenschaften

Dieser Dialog bietet folgende Optionen:

Auswahl des XLS-Prozessors

  • Prozessor

    Wählen Sie den für Ihre Eingangsdaten geeigneten XLS- bzw. XLSX-Prozessor.

Auswahl Arbeitsblätter

  • Arbeitsblatt

  • Alle

    Um alle Arbeitsblätter einer Excel-Datei einzulesen.

  • Einzelnes

    Um ein ausgewähltes Arbeitsblatt einzulesen.

    Über den Button Auswählen können Sie dazu eine Excel-Datei laden. Die darin enthaltenen Arbeitsblätter werden in der Auswahlbox angezeigt.

Zeilen und Spalten

  • Leere Zeilen mit aufnehmen

    Sollen leere Zeilen, die vor anderen Zeilen mit Daten stehen, im erzeugten XML-Format als leere XML-Tags übernommen werden, so wählen Sie diese Checkbox. Anderenfalls werden solche leeren Zeilen ignoriert. Leere Zeilen am Ende eines Arbeitsblattes werden immer ignoriert.

  • Leere Zellen mit aufnehmen

    Sollen leere Zellen, die vor anderen Zellen mit Daten stehen, im erzeugten XML-Format als leere XML-Tags übernommen werden, so wählen Sie diese Checkbox. Anderenfalls werden solche leeren Zellen ignoriert. Leere Zellen am Ende einer Zeile werden immer ignoriert.

  • Formelergebnis ausgeben (nur verfügbar für Prozessoren ab POI 3.1)

    Wenn diese Checkbox aktiviert ist, werden Formeln ausgeführt, und das Ergebnis wird als Attribut Value dem Cell- Tag der XML-Ausgangsnachricht hinzugefügt.

  • Nur Werte basierend auf der aktuellen Filterauswahl ausgeben

    Bei Aktivierung dieser Checkbox werden die Daten aus der ausgewählten Spalte und Zeile im Excel-Arbeitsblatt auf Basis der aktuellen Filterauswahl extrahiert. Ist die Filterauswahl auf „Alle" gesetzt, werden alle Werte in die Ausgabe übernommen. Analog werden ebenfalls alle Werte in die Ausgabe übernommen, wenn kein Filter ausgewählt wurde.

  • Zeilen am Anfang überspringen

    Anzahl der Zeilen, die ignoriert werden sollen.

  • Spalten am Anfang überspringen

    Anzahl der Spalten, die in jeder Zeile ignoriert werden sollen.

XML Spreadsheet (XMLSS) Konfiguration

  • Zahlendarstellung

    • Exponentialdarstellung

      Repräsentiert die Zahlen in Exponentialdarstellung

    • Dezimaldarstellung

      Wenn Sie die Dezimaldarstellung wählen, müssen Sie als nächstes das Trennzeichen angeben.

  • Dezimaltrennzeichen

    Wählen Sie zwischen Punkt und Komma

  • Mindestanzahl Nachkommastellen

    Anzahl der Nachkommastellen.

  • Mit XMLSS Namensräumen

    • Wenn markiert: XML wird mit Namensräumen erstellt.

    • Wenn nicht markiert: XML wird ohne Namensräumen erstellt.

  • Layout-Informationen ins XML übertragen:

    Wenn markiert, dann werden die Angaben zu verwendeten Farben, Linien und Schriftstärken etc. ins XML übernommen, ansonsten werden diese verworfen. Die Übernahme von Layout-Informationen erhöht die Größe der XML-Datei beträchtlich.

  • Datumsformat

    Wählen Sie ein Datumsformat aus.

  • Zeichensatz

    Die Standardzeichensatzkodierung von Excel ist UTF-8. Darüber hinaus sind die Zeichensätze US-ASCII, ISO‑8859-1, UTF-16BE, UTF-16LE und UTF-16 wählbar. Diese sechs Zeichensätze sind vorausgewählt, da sie Teil der Java Platform Specification sind und daher immer unterstützt werden.

    Sie können die Zeichensatz-Auswahlliste aber auch anpassen. Sie können auch jeden anderen beliebigen Zeichensatz eintragen.

Dialog XML-XLS Adapter Eigenschaften

Dieser Dialog bietet folgenden Optionen:

Auswahl des XLS-Prozessors

Wählen Sie den für Ihre Ausgangsdaten geeigneten XLS- bzw. XLSX-Prozessor.

Das folgende Schema enthält alle Elemente und Attribute, die bezogen auf POI 37 unterstützt werden: Global/System/Mapping Templates/XLS Adapter/POI37.xsd

XML Spreadsheet (XMLSS) Konfiguration

  • Datumsformat

    Wählen Sie ein Datumsformat aus.

Aktion bei fehlendem Dokument

Legen Sie fest, was passieren soll, falls die XML-Datei leer ist:

  • XSL-Dokument mit leerer Tabelle erzeugen

  • Fehlermeldung erzeugen