Gruppe	Integration Units
Funktion	Die Integration Unit füllt eine vorhandene Excel-Datei mit Werten des Zielbaums.

Beschreibung

Einleitung: Integration Units. Setzen Sie in Phase 6 in den Inhalts-Einstellungen eines Antwortwegs den Inhalt auf Ausgabe von IU.

Wichtiger Hinweis: Bitte verwenden Sie in Antwortwegen, die die Ausgabe dieser Integration Unit nutzen, die Kodierung 8859_1.

Die Integration Unit verwendet eine vorhandene Excel-Datei als Vorlage (Template) und füllt diese mit Werten. Hinweis: Als Vorlagen dient eine .xls- oder .xlsx-Datei, also das übliche Excel-Format. Andere Formate werden nicht unterstützt! Die Ausgabe-Datei ist dann im Format .xlt, .xls oder .xlsx. Die Template-Datei wird dabei nicht verändert. Um die Ausgabe-Excel-Datei zu erzeugen, verwenden Sie einfach einen Antwortweg des Typs Datei und stellen den Inhalt auf Ausgabe von IU. Als Dateinamen verwenden Sie dann z. B. schlicht Tabelle.xls.

Fängt ein String-/Blob-Wert mit Formula: an, wird nicht der konkrete Wert, sondern die Formel, z. B. Formula:=SUM(A1,A3), in die Zelle gesetzt. Wichtiger Hinweis: Bitte beachten Sie, dass hier nur die englische Schreibweise für Formeln funktioniert, auch wenn Sie ein "deutsches" Excel verwenden. Formula:=SUMME(A1;A3) würde also nicht funktionieren. Hier finden Sie eine Liste aller unterstützten Excel-Funktionen.

Die Integration Unit erwartet den Dateinamen mit Pfad im Parameter Excel template file. Die Zeilennummer, nach der die Daten eingetragen werden sollen, wird in Parameter Append data after row angegeben, die Startspalte in Parameter Start at column.

Wenn der optionale Parameter Use multiple sheets mit dem Wert true konfiguriert ist, können mehrere Tabellenblätter erzeugt werden. Dann muss zu jedem Zielknoten, dessen Daten in das Excel-Dokument eingefügt werden sollen, die Knoteneigenschaft Optionale Zusatzkennung mit der Nummer des Tabellenblattes vorbelegt werden. Bei dieser Zusatzkennung sind nur ganzzahlige Werte, beginnend mit 1, möglich.

Der Parameter Excel password for protection kann nachträgliches Verändern der Excel-Datei verhindern. Mit dem Parameter Remove all formulars können alle Formeln nach der Berechnung gelöscht werden (weil etwa der Partner sie nicht sehen soll).

Parameterbeschreibung

Parametername	Erlaubte Werte	Default-Wert	Beschreibung
Append data after row		1	Die Zeilennummer, nach der die Daten eingetragen werden sollen.
Excel password for protection			Mit einem Passwort ein nachträgliches Verändern der Excel-Datei verhindern. Welchen Eigenschaften dabei genau gesetzt werden, finden Sie im Bereich Excel-Passwortschutz-Attribute. Hinweis: Siehe auch Parameter Protect to open file - needs password.
Excel password to open file			Passwort zum Öffnen der Excel-Datei.
Excel template file			Dateiname mit Pfad zum Excel-Template.
Export as XML	true, false	false	Erzeugt die Excel-Datei im Microsoft-XML-Format SpreadsheetML. Hinweis: Im Antwortweg ist muss der Inhalt Ausgabe von IU und die Kodierung 8859_1 eingestellt werden.
Force style	true, false	false	Siehe Parameter Use style of row.
Ignore new line in cell data	true, false	false	Bei true werden Zeilenumbrüche in Zellen ignoriert.
One sheet for each record	true, false	false	Pro Datenblatt ein Tabellenblatt.
Remove all empty rows at end of each worksheet	true, false	false	Entfernt alle leeren Zeilen am Ende jedes Tabellenblatts.
Remove all formulas	true, false	false	Mit dem Parameter können alle Formeln nach der Berechnung gelöscht werden (z. B. weil der Partner sie nicht sehen soll).
Replace variable filler	true, false	false	Zellen des Templates, in denen auf eine Variable mit {var_myVariable} verwiesen wird, werden ersetzt.
Sheet names (use semicolon to delim names)		1	Namen der Tabellenblätter, getrennt durch Semikolon, falls die Option Use multiple sheets verwendet wird.
Skip empty fields	true, false	false	Zellen im Excel werden nicht "angefasst", wenn das Empty Flag des Zielstruktur-Feldes gesetzt ist. D. h. es wird z. B. kein Leer-String geschrieben (notwendig, wenn eine Formel in der Zelle steckt und nicht überschrieben werden soll).
Start at column		1	Hiermit wird die Start-Spalte angegeben.
Use multiple sheets	true, false	false	Um in einem Excel-Dokument mehrere Tabellenblätter zu nutzen.
Use style of row		0	Das Format der spezifizierten Zeile der Template-Datei wird als Format verwendet für die neu erzeugten Zeilen. Soll für generell das Format übernommen werden (also nicht nur für neue Zeilen), dann kann man den Parameter Force style benutzen. 0 = Keine Vorlage.

Beispiel

Annahme: Die Template-Datei (.xlsx) hat vier Sheets für die vier Quartale mit den Sheet-Namen: QI,QII,QIII,QIV. Wenn man mit der Integration Unit in das Dritte Sheet (QIII) schreiben will, muss man folgende Parameterwerte setzen:
Use multiple sheets = trueSheet names (use semicolon to delim names) = QI;QII;QIII;QIV Der Knoten, der in Sheet QIII schreiben soll, muss die optionale Zusatzkennung 3 haben.