Ausgabe – Generelles

Die nachfolgenden Ausgabeformate und Ausgabesysteme werden in separaten Arrays konfiguriert, können aber gemischt in frei definierbarer Reihenfolge nacheinander ausgeführt werden.

Die gemeinsame Sortierreihenfolge für diese beiden Objekttypen wird über die numerische Eigenschaft .Order festgelegt. Mit dieser Eigenschaft findet über beide Objekttypen hinweg findet eine Sortierung statt, die die Ausführungsreihenfolge bestimmt. Bei gleich vergebener Nummer hat ein Ausgabeformat Vorrang vor einem Ausgabesystem.

Für Ausgabeformate und Ausgabesysteme gelten die folgenden Eigenschaften:

Eigenschaft	Beschreibung
OutputFormat[].Order OutputSystem[].Order	numerische Angabe der Ausführungsreihenfolge Die Zählung beginnt bei 1. Als Standardwert gilt die Reihenfolge der Auflistung innerhalb der Arrays `OutputFormat[]` und `OutputSystem[]`.
OutputFormat[].ConditionMacro OutputSystem[].ConditionMacro	optionaler Feldmakroausdruck, wenn die Verarbeitung eines Ausgabeformats oder Ausgabesystems nur unter bestimmten Bedingungen ausgeführt werden soll Der Feldmakroausdruck muss einen entsprechenden Wahrheitswert zurückliefern. Bei fehlendem Eigenschaftswert gilt die Bedingung implizit als erfüllt.
OutputFormat[].MultiValueSep OutputSystem[].MultiValueSep	optionales Trennzeichen, wenn multiple Feldinhalte (Array-Werte oder Tabellenfelder) über dieses Zeichen getrennt als ein zusammengesetzter String in ein einzelnes Ausgabefeld übernommen werden sollen Standardmäßig ist das Trennzeichen nicht definiert. Sofern das Zielsystem nicht explizit die Übernahme multipler Werte unterstützt, wird im Standard nur der erste Wert aus einem Mehrfachfeld herangezogen. Diese Eigenschaft greift zudem nur, wenn die Ausgabe eines Feldinhalts als String erfolgt, d.h. wenn der Feldinhalt vom Typ "String" ist, per `OutputFormat` in den Typ "String" konvertiert wird oder das Ausgabeformat / Ausgabesystem nur den Typ "String" unterstützt und daher implizit immer eine Konvertierung stattfindet.
OutputFormat[].Field[].Name* OutputFormat[].Field[].OutputName OutputFormat[].Field[].OutputFormat OutputSystem[].Field[].Name* OutputSystem[].Field[].OutputName OutputSystem[].Field[].OutputFormat	Definition der Zuordnung von Quellfeldern aus dem Feldkatalog zu den Zielfeldern, die in ein Ausgabeformat übernommen oder an ein Ausgabesystem übergeben werden Unter `.Name` ist der Name des Quellfeldes analog zur gleichnamigen Eigenschaft im Feldkatalog anzugeben. Unter `.OutputName` ist die Definition des betreffenden Zielfeldes in den Ausgabedaten anzugeben. Die zu verwendende Syntax variiert und wird in den Abschnitten des jeweiligen Ausgabeformats oder Ausgabesystems beschrieben. Wenn der Name des Quellfelds im Feldkatalog identisch mit dem Namen des Zielfelds ist, kann die Eigenschaft `.OutputName` weggelassen werden. Der Name des Quellfeldes wird dann als Standardwert herangezogen. Dies ist allerdings nur möglich, wenn der `.OutputName` abhängig vom Ausgabeformat / Ausgabesystem keine spezielle Syntax erfordert, sondern analog zum Quellfeld aus einem einfachen Feldnamen besteht. Hinweis Eine spezielle Konstellation liegt vor, wenn bedingungsabhängig alternative Feldkataloge mit unterschiedlichen Felddefinitionen verwendet werden, für die im Ausgabeformat oder Ausgabesystem aber nur eine Zuordnungsliste zu den Ausgabefeldern definiert werden kann. In diesem Fall sind 2 Vorgehensweisen möglich: bedingungsabhängige Definition von 2 Varianten des Ausgabeformats / des Ausgabesystems, die jeweils nur die Zuordnungen für die im aktiven Feldkatalog enthaltenen Felder umfassen Definition aller Ausgabefelder über alle Kataloge hinweg in nur einem Ausgabeformat / Ausgabesystem Felder, die im tatsächlich genutzten Katalog nicht vorhanden sind, führen nicht zu einem Fehler bei der Ausgabe, sondern werden einfach übersprungen. In den meisten Anwendungsfällen kann daher die zweite Vorgehensweise genutzt werden. Die Eigenschaft `OutputFormat` ist nur relevant, wenn im Quellfeld ein typisierter Wert vorliegt, dieser aber als String-Wert in das Zielfeld übernommen werden soll. Die Eigenschaft definiert die Syntax für die Formatierung des Zielwertes. Wenn der Quellwert bereits ein String ist, findet keine neue Formatierung statt. Die Syntax für die Eigenschaft `.OutputFormat` ist abhängig vom Zieldatentyp. Wenn kein Ausgabeformat angegeben ist, aber das Zielfeld zwingend einen String-Wert benötigt, weil das Ausgabeformat/Ausgabesystem nur diesen Typ unterstützt, wird eine Standardformatierung genutzt. Diese Formatierung ist entweder systemspezifisch, z. B. `yyyyMMdd` für ein SAP-Datumsformat, oder entspricht der internen Textdarstellung typisierter Werte, d.h. `yyy-MM-dd HH:mm:ss` für Datumsangaben und ein Punkt als Dezimaltrenner für numerische Werte. Abhängig vom Zieldatentyp ist die folgende Syntax zu verwenden: `Number`: Die folgenden Zeichen sind im Formatierungsmuster nutzbar: `.` (Trennzeichen Punkt) `,` (Trennzeichen Komma) `0` (feste Stelle) `#` (variable Stelle) Hinweis Wenn nur ein Trennzeichen im Muster enthalten ist, wird dieses Trennzeichen als Dezimaltrenner angesehen. Wenn 2 unterschiedliche Trennzeichen enthalten sind, wird das erste der beiden Zeichen als Tausender-Trennzeichen interpretiert. Beispiele finden Sie unter Anwendungsbeispiele. `Date`: Für den Aufbau des Datumsformats muss ein Muster angegeben werden, z. B. `yyyy-MM-dd` für ein Datum der Form "2021-12-31" (siehe auch Eigenschaft `ProcessReadIndex[].Field[].InputFormat` unter Allgemeine Eigenschaften). `Bool`: Dieser Datentyp ist nicht konfigurierbar. Die Ausgabe ist immer `TRUE` oder `FALSE`.

Eigenschaft

Beschreibung

OutputFormat[].Order

OutputSystem[].Order

numerische Angabe der Ausführungsreihenfolge

Die Zählung beginnt bei 1.

Als Standardwert gilt die Reihenfolge der Auflistung innerhalb der Arrays OutputFormat[] und OutputSystem[].

OutputFormat[].ConditionMacro

OutputSystem[].ConditionMacro

optionaler Feldmakroausdruck, wenn die Verarbeitung eines Ausgabeformats oder Ausgabesystems nur unter bestimmten Bedingungen ausgeführt werden soll

Der Feldmakroausdruck muss einen entsprechenden Wahrheitswert zurückliefern. Bei fehlendem Eigenschaftswert gilt die Bedingung implizit als erfüllt.

OutputFormat[].MultiValueSep

OutputSystem[].MultiValueSep

optionales Trennzeichen, wenn multiple Feldinhalte (Array-Werte oder Tabellenfelder) über dieses Zeichen getrennt als ein zusammengesetzter String in ein einzelnes Ausgabefeld übernommen werden sollen

Standardmäßig ist das Trennzeichen nicht definiert. Sofern das Zielsystem nicht explizit die Übernahme multipler Werte unterstützt, wird im Standard nur der erste Wert aus einem Mehrfachfeld herangezogen.

Diese Eigenschaft greift zudem nur, wenn die Ausgabe eines Feldinhalts als String erfolgt, d.h. wenn der Feldinhalt vom Typ "String" ist, per OutputFormat in den Typ "String" konvertiert wird oder das Ausgabeformat / Ausgabesystem nur den Typ "String" unterstützt und daher implizit immer eine Konvertierung stattfindet.

OutputFormat[].Field[].Name*

OutputFormat[].Field[].OutputName

OutputFormat[].Field[].OutputFormat

OutputSystem[].Field[].Name*

OutputSystem[].Field[].OutputName

OutputSystem[].Field[].OutputFormat

Definition der Zuordnung von Quellfeldern aus dem Feldkatalog zu den Zielfeldern, die in ein Ausgabeformat übernommen oder an ein Ausgabesystem übergeben werden

Unter .Name ist der Name des Quellfeldes analog zur gleichnamigen Eigenschaft im Feldkatalog anzugeben. Unter .OutputName ist die Definition des betreffenden Zielfeldes in den Ausgabedaten anzugeben. Die zu verwendende Syntax variiert und wird in den Abschnitten des jeweiligen Ausgabeformats oder Ausgabesystems beschrieben.

Wenn der Name des Quellfelds im Feldkatalog identisch mit dem Namen des Zielfelds ist, kann die Eigenschaft .OutputName weggelassen werden. Der Name des Quellfeldes wird dann als Standardwert herangezogen. Dies ist allerdings nur möglich, wenn der .OutputName abhängig vom Ausgabeformat / Ausgabesystem keine spezielle Syntax erfordert, sondern analog zum Quellfeld aus einem einfachen Feldnamen besteht.

Hinweis

Eine spezielle Konstellation liegt vor, wenn bedingungsabhängig alternative Feldkataloge mit unterschiedlichen Felddefinitionen verwendet werden, für die im Ausgabeformat oder Ausgabesystem aber nur eine Zuordnungsliste zu den Ausgabefeldern definiert werden kann.

In diesem Fall sind 2 Vorgehensweisen möglich:

bedingungsabhängige Definition von 2 Varianten des Ausgabeformats / des Ausgabesystems, die jeweils nur die Zuordnungen für die im aktiven Feldkatalog enthaltenen Felder umfassen
Definition aller Ausgabefelder über alle Kataloge hinweg in nur einem Ausgabeformat / Ausgabesystem

Felder, die im tatsächlich genutzten Katalog nicht vorhanden sind, führen nicht zu einem Fehler bei der Ausgabe, sondern werden einfach übersprungen. In den meisten Anwendungsfällen kann daher die zweite Vorgehensweise genutzt werden.

Die Eigenschaft OutputFormat ist nur relevant, wenn im Quellfeld ein typisierter Wert vorliegt, dieser aber als String-Wert in das Zielfeld übernommen werden soll. Die Eigenschaft definiert die Syntax für die Formatierung des Zielwertes. Wenn der Quellwert bereits ein String ist, findet keine neue Formatierung statt.

Die Syntax für die Eigenschaft .OutputFormat ist abhängig vom Zieldatentyp. Wenn kein Ausgabeformat angegeben ist, aber das Zielfeld zwingend einen String-Wert benötigt, weil das Ausgabeformat/Ausgabesystem nur diesen Typ unterstützt, wird eine Standardformatierung genutzt. Diese Formatierung ist entweder systemspezifisch, z. B. yyyyMMdd für ein SAP-Datumsformat, oder entspricht der internen Textdarstellung typisierter Werte, d.h. yyy-MM-dd HH:mm:ss für Datumsangaben und ein Punkt als Dezimaltrenner für numerische Werte. Abhängig vom Zieldatentyp ist die folgende Syntax zu verwenden:

Number: Die folgenden Zeichen sind im Formatierungsmuster nutzbar:
- . (Trennzeichen Punkt)
- , (Trennzeichen Komma)
- 0 (feste Stelle)
- # (variable Stelle)
Hinweis
Wenn nur ein Trennzeichen im Muster enthalten ist, wird dieses Trennzeichen als Dezimaltrenner angesehen. Wenn 2 unterschiedliche Trennzeichen enthalten sind, wird das erste der beiden Zeichen als Tausender-Trennzeichen interpretiert.
Beispiele finden Sie unter Anwendungsbeispiele.
Date: Für den Aufbau des Datumsformats muss ein Muster angegeben werden, z. B. yyyy-MM-dd für ein Datum der Form "2021-12-31" (siehe auch Eigenschaft ProcessReadIndex[].Field[].InputFormat unter Allgemeine Eigenschaften).
Bool: Dieser Datentyp ist nicht konfigurierbar. Die Ausgabe ist immer TRUE oder FALSE.

Anwendungsbeispiele

Die folgende Tabelle zeigt Beispiele für die Formatierung numerischer Werte.

Hinweis

Ein Runden auf eine vorgegebene Stellenanzahl gilt nur für Nachkommastellen. Vorkommastellen werden immer vollständig ausgegeben.

Zahlenwert	Formatierungsmuster	Ausgabewert
123,45	0	123
1,2	000.00	001.20
1,2	0.##	1.2
0	#.##	(leer)
0,123	0.00	0.12
0,123	#.##	.12
1234,5	#,##0.00	1,234.50

In diesem Abschnitt:

xSuite Interface Windows Prism 5.x – Online-Hilfe