XML Transform

Diese Aktion wandelt ein XML-Dokument anhand der angegebenen Umwandlungsregeln in ein anderes Dokument um. Die Regeln müssen durch eine .XSLT-Definition in einer Datei oder in Form einer anderen variablen Quelle angegeben werden.

Mit dieser Aktion können Sie komplexe XML-Dokumente in XML-Dokumente mit übersichtlicherer Struktur konvertieren. XSLT steht für „XSL Transformations“. XSL steht für „Extensible Stylesheet Language“, eine Stylesheet-Sprache für XML-Dokumente.

Die Aktion „XML-Umwandlung“ speichert das konvertierte XML-Dokument in der ausgewählten Variablen. Die Originaldatei bleibt unberührt auf der Festplatte erhalten. Wenn Sie das konvertierte XML-Dokument speichern möchten, verwenden Sie die Aktion Daten in Datei speichern.

Hinweis

Normalerweise verwenden Sie die Aktion, um von der Host-Anwendung bereitgestellte XML-Dokumente zu vereinfachen. Die Definition eines XML-Filters für das komplexe XML-Dokument würde eventuell zu lang dauern, und in einigen Fällen ist es sogar einfach zu komplex für die Verarbeitung. Als Alternative können Sie Regeln für die Konvertierung des XML-Dokuments in eine Struktur festlegen, die vom XML-Filter problemlos verarbeitet werden kann oder den Filter sogar völlig überflüssig macht. Sie können ein XML-Dokument in ein nativ unterstütztes XML-Format wie Oracle XML umwandeln und dann einfach die Aktion Oracle XML-Befehlsdatei ausführen darauf anwenden.

Die Über-Gruppe gibt die ausgewählte Aktion an.

Name: ermöglicht es Ihnen, einen benutzerdefinierten Namen anzugeben. So können Sie Aktionen in der Liste der Aktionen in der Lösung leichter erkennen. Standardmäßig werden Aktionsnamen vom Typ der jeweiligen Aktion abgeleitet.
Beschreibung: benutzerdefinierte Informationen über die Aktion. Geben Sie eine Beschreibung ein, um den Zweck und die Rolle einer Aktion in einer Lösung zu erklären.
Aktionstyp: Nur-Lesen-Informationen über den ausgewählten Aktionstyp.

Die Gruppe Datenquelle definiert die umzuwandelnden XML-Daten.

Vom Trigger empfangene Daten verwenden: legt fest, dass die vom Trigger empfangenen Daten verwendet werden. Dasselbe Ergebnis kann erzielt werden, indem Sie die interne Variable DataFileName aktivieren und die Inhalte der Datei verwenden, auf die sie verweist. Weitere Informationen finden Sie im Abschnitt „Zusammengesetzte Werte verwenden“ im Loftware Automation Benutzerhandbuch.
Dateiname: definiert den Pfad und den Namen der umzuwandelnden XML-Datei. Der Inhalt der angegebenen Datei wird verwendet. Die Option Datenquelle aktiviert die dynamische Definition des Dateinamens. Wählen Sie eine Variable aus (oder erstellen Sie eine Variable), die den Pfad und/oder Dateinamen enthält. Die Aktion öffnet die angegebene Datei und wendet die Umwandlung auf den (XML-formatierten) Dateiinhalt an.
Variable: wählt die Variable aus, die den Druckdatenstrom enthält (oder erstellt diese Variable). Der Inhalt der ausgewählten Variablen wird verwendet und muss eine XML-Struktur aufweisen.

De Gruppe Umwandlungsregeln Datenquelle (XSLT) definiert die Umwandlungsregeln (.XSLT-Dokument), die auf das XML-Dokument angewandt werden.

Dateiname: definiert den Pfad und den Namen der Datei mit den Umwandlungsregeln (.XSLT).
Benutzerdefiniert: legt einen benutzerdefinierten Inhalt fest. Sie können festen Inhalt, eine Mischung aus festem und variablem Inhalt oder ausschließlich variablen Inhalt verwenden. Um variablen Inhalt einzufügen, klicken Sie auf die Schaltfläche mit dem Pfeil rechts neben dem Datenbereich und fügen Sie die Variable aus der Liste ein. Weitere Informationen finden Sie im Abschnitt „Zusammengesetzte Werte verwenden“ im Loftware Automation Benutzerhandbuch.

Die Gruppe Ergebnis in Variable speichern definiert die Variable, in der die umgewandelte Datei gespeichert werden soll.

Variable: wählt eine Variable aus (oder erstellt eine Variable), die das Ergebnis des Umwandlungsprozesses beinhalten wird. Zum Beispiel: Wenn Sie Regeln verwenden, die eine komplexe XML-Struktur in eine einfachere XML-Struktur umwandeln, ist diese einfachere Struktur der Inhalt der ausgewählten Variablen.

Aktionsausführung und Fehlerhandhabung

Jede Aktion kann als bedingungsabhängige Aktion festgelegt werden. Bedingungsabhängige Aktionen werden nur ausgeführt, wenn die festgelegten Bedingungen erfüllt sind. Um diese Bedingungen zu definieren, klicken Sie auf Optionen für Ausführung und Fehlerhandhabung anzeigen.

Die Ausführungsoptionen sind:

Aktiviert: gibt an, ob die Aktion aktiviert oder deaktiviert ist. Nur aktivierte Aktionen werden ausgeführt. Diese Funktion kann beim Testen einer Druckmaske verwendet werden.
Bedingung: definiert einen einzeiligen Programmierausdruck, welcher einen booleschen Wert bereitstellen muss (wahr oder falsch). Ist das Ergebnis des Ausdrucks wahr, wird die Aktion ausgeführt. Bedingungen sorgen dafür, dass Aktionen nicht jedes Mal ausgeführt werden müssen.

Die Fehlerhandhabung-Optionen sind:

Fehler ignorieren : gibt an, ob ein Fehler ignoriert werden soll. Wenn aktiviert, wird die Ausführung von Aktionen selbst dann fortgesetzt, wenn die aktuelle Aktion fehlschlägt.
Hinweis
Geschachtelte Aktionen, die von der aktuellen Aktion abhängig sind, werden im Fall eines Fehlers nicht ausgeführt. Die Aktionsausführung wird bei der nächsten Aktion fortgesetzt, die sich auf derselben Ebene wie die aktuelle Aktion befindet. Der Fehler wird protokolliert, führt aber nicht zu einer Unterbrechung der Ausführung von Aktionen.

Beispiel

Am Ende des Druckvorgangs möchten Sie eventuell mittels der Aktion HTTP-Anfrage einen Statusbericht an eine externe Anwendung senden. Wenn die Druckaktion fehlschlägt, wird die Aktionsverarbeitung angehalten. Um die Berichterstellung trotz fehlgeschlagener Druckaktion auszuführen, muss für die Aktion Etikett drucken die Option Fehler ignorieren aktiviert sein.

Fehler in Variable speichern : ermöglicht Ihnen, eine Variable auszuwählen oder zu erstellen, in der der Fehler gespeichert werden soll. Dieselbe Fehlerbeschreibung wird zudem in den internen Variablen ActionLastErrorId und ActionLastErrorDesc gespeichert.