Skip to main content

xSuite Interface Windows Prism 5.x – Online-Hilfe

Ausgabeformat "MsExcel"

Dieses Ausgabeformat generiert aus Indexdaten des Dokumentes eine Microsoft-Excel-Datei, entweder im XLSX-Format oder konvertiert ins PDF-Format.

Die Dateiendung, die in der Eigenschaft .FileName angegeben ist, bestimmt, welches der Formate generiert wird.

Eigenschaft

Beschreibung

OutputFormat[].TemplateFile

Definition der zu verwendenden Excel-Arbeitsmappendatei

Die Datei dient als Vorlage, um diese mit den auszugebenden Indexfeldinhalten zu befüllen. Die Vorlagendatei selbst bleibt dabei unverändert.

Folgende Optionen sind verfügbar:

  • Angabe eines Namensfilters, um die Vorlagendatei als am Dokument hängende Dateianlage zu identifizieren, wobei die erste gefundene Anlage herangezogen wird

  • Angabe eines absoluten oder relativen Dateipfades, um die Vorlagendatei aus dem Dateisystem zu laden

  • Weglassung der Angabe, sodass stattdessen eine leere Arbeitsmappe genutzt wird

Für die Eigenschaft OutputName gilt eine spezielle Syntax. Diese besteht aus einem Wert, der aus mehreren Parametern zusammengesetzt ist.

Der erste Parameter trägt immer den Namen ElemType und benennt die Art des Elements. Abhängig von der Elementart sind teils weitere Parameter verfügbar, um das Element zu spezifizieren.

Element

Parameter

Zelle oder Zellenbereich

  1. ElemType*: Range

  2. SheetNo: Nummer des Arbeitsblattes (Standardwert: 1)

  3. SheetName: Name des Arbeitsblattes (alternativ zu SheetNo)

  4. StartCell*: Start-Zelle

Mit StartCell ist nur eine einzelne Zelle definierbar, aber dennoch kann ein Bereich von Zellen befüllt werden. Bei multiplen Werten werden alle Folgewerte entsprechend ihrer Anzahl in die darunterliegenden Zellen ausgegeben. Wenn diese Zellen bereits einen Wert enthalten, werden automatisch neue Zeilen in das Arbeitsblatt eingefügt. Im Fall von Kopfdatenfeldern können multiple Werte Elemente eines Arrays darstellen. Bei Tabellenfeldern hingegen stellt der betreffende Wert einer jeden Zeile einen auszugebenden Einzelwert dar. Für Tabellenfelder ist die Elementart Range die einzig unterstützte Ausgabeform.

Eine Zelle kann nicht nur mit einem Textwert befüllt werden, sondern auch mit einem typisierten Wert. Daher wird implizit der Original-Wert aus dem xSuite-Interface-Dokument übergeben, wenn kein .OutputFormat für eine Textformatierung definiert ist. Zur korrekten Darstellung eines solchen Wertes in der Arbeitsmappe muss dort eine passende Zellenformatierung gesetzt sein.

Textbox

  1. ElemType*: TextBox

  2. SheetNo: Nummer des Arbeitsblattes (Standardwert 1)

  3. SheetName: Name des Arbeitsblattes (alternativ zu SheetNo)

  4. BoxNo: Nummer der Textbox (Standardwert: 1)

  5. BoxName: Name der Textbox (alternativ zu BoxNo)

Mappeneigenschaft

  1. ElemType*: Property

  2. PropName*: Name der Mappeneigenschaft (Title, Subject, Author, LastAuthor, Keywords, Comments, Company)

    Ein unbekannter Name wird als benutzerdefinierte Eigenschaft gesetzt.

In diesem Abschnitt: