In Verbindung mit dem XSLTransform-Knoten können Sie Formatvorlagen auf zwei verschiedene Arten verwenden.
Bei Formatvorlagen, die implementiert werden sollen, muss die Dateierweiterung entweder .xsl oder .xslt lauten, und bei XML-Dateien, die implementiert werden sollen, muss sie .xml lauten.
Importieren Sie alle Formatvorlagen und XML-Dateien, die implementiert werden sollen, in das Projekt eines Eclipse-Arbeitsbereichs. Schreiben Sie standortabhängige untergeordnete Formatvorlagen oder XML-Dateien, die implementiert werden sollen, in die richtige Verzeichnisstruktur, die relativ zu den zugehörigen übergeordneten Formatvorlagen ist. Im Eclipse-Arbeitsbereich sollten sich keine standortabhängigen untergeordneten Formatvorlagen befinden, die nicht implementiert werden sollen.
Bei allen Verweisen auf eine implementierte Formatvorlage muss es sich unabhängig von ihrer Position um einen relativen Verweis handeln. Ein Verweis auf eine Principal-Formatvorlage muss relativ zu dem Stammverzeichnis des relevanten Projekts des Eclipse-Arbeitsbereichs sein.
Einzige Ausnahme: Bei der Angabe einer Principal-Formatvorlage als Eigenschaft Name der Formatvorlage in einem XSLTransform-Knoten können Sie einen absoluten Pfad verwenden, der auf die richtige Verzeichnisstruktur im Eclipse-Arbeitsbereich verweist. Wenn die Principal-Formatvorlage gefunden wurde, setzt das System die Knoteneigenschaft automatisch auf den richtigen relativen Wert.
Außerdem führt es eine automatische Implementierung der Principal-Formatvorlage und der standortabhängigen untergeordneten Formatvorlagen aus, die im relevanten Eclipse-Arbeitsbereichsprojekt verfügbar sind. Alle Verweise auf standortabhängige untergeordnete Formatvorlagen (oder XML-Dateien) einer Principal-Formatvorlage müssen relativ zum Standort der zugehörigen übergeordneten Formatvorlagen sein. Wenn beispielsweise die Formatvorlage //project1/a/b.xsl auf die Formatvorlage //project1/a/c/d.xsl verweist, muss der Verweis in c/d.xsl (oder ./c/d.xsl) geändert werden.
Formatvorlagen können auf andere Formatvorlagen verweisen. Wenn Sie eine Formatvorlage (oder XML-Datei) mit einem relativen Verweis haben, die selbst zwar nicht, aber deren übergeordnetes Element implementiert werden soll, müssen Sie sicherstellen, dass die untergeordnete Formatvorlage an die korrekte Position unter Arbeitspfad/XSL/external (Arbeitspfad/XML/external) gestellt wird. Dabei ist Arbeitspfad der vollständige Pfad zum Arbeitsverzeichnis des Brokers. Über die Umgebungsvariable MQSI_WORKPATH können Sie die Position des Arbeitspfads auf dem System ermitteln. Auf Windows XP-Systemen lautet der Standardarbeitspfad beispielsweise C:\Dokumente und Einstellungen\All Users\Anwendungsdaten\IBM\MQSI.
Ein Broker ordnet die in der Ausführungsgruppe implementierte Speicherbaumstruktur, Arbeitspfad/XSL/external, und die Baumstruktur Arbeitspfad/XML/external einander automatisch zu. Wenn also beispielsweise das Dokument b/c.xml im implementierten Speicher des Brokers nicht gefunden wird, führt der Broker im Verzeichnis Arbeitspfad/XML/external/a/b automatisch eine Suche nach einem Verweis auf das Dokument in der implementierten Principal-Formatvorlage a/style.xsl durch. Relative Pfadverweise müssen auch für Dateien verwendet werden, die bereits implementiert wurden, die im Arbeitsbereich aber noch nicht verfügbar sind.
Implementieren Sie nur die Formatvorlagen oder XML-Dateien manuell, die vom System noch nicht berücksichtigt wurden (das WebSphere Message Broker Toolkit gibt Warnungen zu diesen Dateien aus). Wenn Sie für den Knoten auf Durchsuchen klicken oder den vollständigen Pfad der Formatvorlage im Eclipse-Arbeitsbereich angeben, wird dies automatisch in die BAR-Datei eingefügt.
Fügen Sie die Dateien bei der manuellen Implementierung zu einem Brokerarchiv hinzu. Sie finden weitere Informationen hierzu in den Abschnitten Dateien zu einem Brokerarchiv hinzufügen und Schlüsselwörter zu XSL-Formatvorlagen hinzufügen.
Wenn eine Formatvorlage im Verzeichnis Arbeitspfad/XSL/external denselben Pfad und denselben Namen wie eine implementierte Formatvorlage hat, wird die implementierte Formatvorlage verwendet.