Serverseitige XSL-Transformationen in Dreamweaver durchführen

Zuletzt aktualisiert am 20. Dezember 2021

Hier erfahren Sie, wie Sie in Dreamweaver serverseitige XSL-Transformationen durchführen, XSLT-Seiten erstellen und HTML- in XSLT-Seiten konvertieren.

Die Benutzeroberfläche wurde in Dreamweaver vereinfacht. Daher kann es sein, dass einige der in diesem Artikel beschriebenen Optionen in Ihrer Version von Dreamweaver nicht vorhanden sind. Weitere Informationen finden Sie in diesem Artikel.

Workflow für die Durchführung Server-seitiger XSL-Transformationen

Du kannst serverseitige XSL-Transformationen durchführen.Lies über Server-seitige und Client-seitige XSL-Transformationen und über die Verwendung von XML und XSL mit Web-Seiten, bevor du Seiten erstellst, die XML-Daten anzeigen.

Bevor Sie serverseitige Transformationen durchführen können, müssen Sie Ihren Server entsprechend konfigurieren. Wenden Sie sich an Ihren Serveradministrator, um weitere Informationen zu erhalten.

Der allgemeine Workflow für die Durchführung serverseitiger XSL-Transformationen ist wie folgt (jeder Schritt wird in anderen Themen beschrieben):

1.Richte einen Dreamweaver-Bereich ein.

2.Wähle eine Server-Technologie und richte einen Anwendungsserver ein.

3.Teste den Anwendungsserver.

Erstelle zum Beispiel eine Seite, die Verarbeitung erfordert, und stelle sicher, dass der Anwendungsserver die Seite verarbeitet.

4.Erstelle ein XSLT-Fragment oder eine Seite, oder konvertiere eine HTML-Seite in eine XSLT-Seite.

  • Erstelle in deinem Dreamweaver-Bereich ein XSLT-Fragment oder eine vollständige XSLT-Seite.

  • Wandeln Sie eine bestehende HTML-Seite in eine ganze XSLT-Seite um.

5.Füge eine XML-Datenquelle an die Seite an.

6.Zeige XML-Daten an, indem du die Daten an das XSLT-Fragment oder an die vollständige XSLT-Seite bindest.

7.Falls angemessen, füge ein Repeating Region XSLT-Objekt zur Tabelle oder Tabellenzeile hinzu, die die XML-Daten-Platzhalter enthält.

8.Füge Referenzen ein.

  • Um eine Referenz zum XSLT-Fragment in deine dynamische Seite einzufügen, verwende das XSL Transformation Server-Verhalten.

  • Um eine Referenz zur vollständigen XSLT-Seite in die dynamische Seite einzufügen, lösche den gesamten HTML-Code von einer dynamischen Seite und verwende dann das XSL Transformation Server-Verhalten.

9.Poste die Seite und das Fragment.

Poste sowohl die dynamische Seite als auch das XSLT-Fragment (oder die vollständige XSLT-Seite) auf deinen Anwendungsserver. Falls du eine lokale XML-Datei verwendest, musst du diese ebenfalls posten.

10. Rufe die dynamische Seite in einem Browser auf.

Wenn du das tust, transformiert der Anwendungsserver die XML-Daten, fügt sie in die dynamische Seite ein und zeigt sie im Browser an.

XSLT-Seiten erstellen

Du kannst XSLT-Seiten erstellen, mit denen du XML-Daten auf Web-Seiten anzeigen kannst. Du kannst entweder eine vollständige XSLT-Seite erstellen—eine XSLT-Seite, die ein <body>-Tag und ein <head>-Tag enthält—oder du kannst ein XSLT-Fragment erstellen. Wenn du ein XSLT-Fragment erstellst, erstellst du eine unabhängige Datei, die keinen Body- oder Head-Tag enthält—ein einfaches Stück Code, das später in eine dynamische Seite eingefügt wird.

Wenn Sie eine bestehende XSLT-Seite als Ausgangspunkt nehmen, müssen Sie eine XML-Datenquelle an diese anfügen.

Wählen Sie „Datei“ > „Neu“.
In der Kategorie Leere Seite des Dialogfelds Neues Dokument wählst du eines der folgenden aus der Spalte Seitentyp aus:
  • Wähle XSLT (Gesamte Seite) aus, um eine gesamte XSLT-Seite zu erstellen.

  • „XSLT (Fragment)“, um ein XSLT-Fragment zu erstellen.

Klicke auf Anlegen und führe eine der folgenden Aktionen im Dialogfeld XML-Quelle suchen aus:
  • Wählen Sie „Lokale Datei anhängen“ aus, klicken Sie auf die Schaltfläche „Durchsuchen“, navigieren Sie zu einer XML-Datei auf Ihrem Computer und klicken Sie auf „OK“.
  • Wählen Sie „Remote-Datei anhängen“ aus, geben Sie die URL einer XML-Datei im Internet ein (z. B. eine Datei aus einem RSS-Datenstrom) und klicken Sie auf „OK“.

Durch Klicken auf die Schaltfläche „Abbrechen“ wird eine neue XSLT-Seite ohne angefügte XML-Datenquelle erstellt.

Das Bedienfeld „Bindungen“ wird mit dem Schema Ihrer XML-Datenquelle gefüllt

Bedienfeld „Bindungen“

In der folgenden Tabelle werden die verschiedenen Elemente im Schema erklärt, die möglicherweise angezeigt werden:

Element

Bedeutung

Details

<>

Nicht wiederholtes XML-Element erforderlich

Ein Element, das im übergeordneten Code genau einmal vorkommt

<>+

Wiederholtes XML-Element

Ein Element, das im übergeordneten Code ein- oder mehrmals vorkommt

<>+

Optionales XML-Element

Ein Element, das im übergeordneten Code nicht, einmal oder mehrmals vorkommt

Elementknoten mit Fettformatierung

Aktuelles Kontextelement

Normalerweise das wiederholte Element, wenn die Einfügemarke sich in einem wiederholten Bereich befindet

@

XML-Attribut

 

 

Speichere deine neue Seite (Datei > Speichern) mit der Erweiterung .xsl oder .xslt (.xsl ist die Standarderweiterung).

HTML-Seiten in XSLT-Seiten konvertieren

Du kannst auch vorhandene HTML-Seiten in XSLT-Seiten konvertieren.Wenn du beispielsweise eine vorgefertigte statische Seite hast, der du XML-Daten hinzufügen möchtest, kannst du die Seite in eine XSLT-Seite konvertieren, anstatt eine XSLT-Seite zu erstellen und die Seite von Grund auf neu zu gestalten.

Öffnen Sie die HTML-Seite, die Sie umwandeln möchten.
Wähle Datei > Konvertieren > XSLT 1.0 aus.

Eine Kopie der Seite wird im Dokumentfenster geöffnet. Die neue Seite ist ein XSL-Stylesheet, das mit der Erweiterung .xsl gespeichert wird.

XML-Datenquellen anhängen

Wenn du mit einer vorhandenen XSLT-Seite beginnst oder keine XML-Datenquelle anhängst, wenn du eine neue XSLT-Seite mit Dreamweaver erstellst, musst du eine XML-Datenquelle über das Bindungen-Bedienfeld anhängen.

Klicke im Bindungen-Bedienfeld (Fenster > Bindungen) auf den XML-Link.
Klicken Sie im Bedienfeld „Bindungen“ auf „XML“

Sie können auch auf den Quellenhyperlink oben rechts im Bedienfeld „Bindungen“ klicken, um eine XML-Datenquelle hinzuzufügen.

Führen Sie einen der folgenden Schritte aus:
  • Wähle Lokale Datei anhängen aus, klicke auf den Button Durchsuchen, navigiere zu einer lokalen XML-Datei auf deinem Computer und klicke auf OK.

  • Wähle Remote-Datei anhängen aus und gib die URL einer XML-Datei im Internet ein (z. B. von einem RSS-Feed).

Klicken Sie auf „OK“, um das Dialogfeld „XML-Quelle suchen“ zu schließen.

Das Bindungen-Bedienfeld wird mit dem Schema deiner XML-Datenquelle gefüllt.

XML-Daten in XSLT-Seiten anzeigen

Nachdem du eine XSLT-Seite erstellt und eine XML-Datenquelle angehängt hast, kannst du Daten an die Seite binden.Dazu fügst du einen XML-Daten-Platzhalter zu deiner Seite hinzu und verwendest dann den XPath Expression Builder oder das Eigenschaften-Bedienfeld, um ausgewählte Daten zu formatieren, die auf der Seite angezeigt werden.

Öffnen Sie eine XSLT-Seite mit angehängter XML-Datenquelle.
(Optional) Wähle Einfügen > Tabelle aus, um eine Tabelle zur Seite hinzuzufügen.Mit einer Tabelle können Sie XML-Daten leichter verwalten.
Anmerkung

In den meisten Fällen verwendest du das XSLT-Objekt Wiederholungsregion, um wiederholende XML-Elemente auf einer Seite anzuzeigen.In diesem Fall möchtest du möglicherweise eine einzeilige Tabelle mit einer oder mehreren Spalten oder eine zweizeilige Tabelle erstellen, wenn du einen Tabellenkopf einfügen möchtest.

Wähle im Bindings-Bedienfeld ein XML-Element aus und ziehe es an die Stelle auf der Seite, an der du Daten einfügen möchtest.
Auswahl eines XML-Elements im Bedienfeld „Bindungen“

Ein XML-Datenplatzhalter wird auf der Seite angezeigt.Der Platzhalter ist hervorgehoben und in geschweiften Klammern dargestellt.Er verwendet die XPath-Syntax (XML Path Language), um die hierarchische Struktur des XML-Schemas zu beschreiben.Wenn du beispielsweise das untergeordnete Element title auf die Seite ziehst und dieses Element die übergeordneten Elemente rss, channel und item hat, lautet die Syntax für den dynamischen Content-Platzhalter {rss/channel/item/title}.

Doppelklicke auf den XML-Daten-Platzhalter auf der Seite, um den XPath Expression Builder zu öffnen.Der XPath Expression Builder ermöglicht es dir, ausgewählte Daten zu formatieren oder andere Elemente aus dem XML-Schema auszuwählen.

(Optional) Wende Stile auf deine XML-Daten an, indem du einen XML-Datenplatzhalter auswählst und Stile darauf anwendest wie auf jeden anderen Inhalt über das Eigenschaften-Panel oder das CSS-Stile-Panel.Alternativ kannst du Design-Time-Stylesheets verwenden, um Stile auf XSLT-Fragmente anzuwenden.Jede dieser Methoden hat ihre eigenen Vorteile und Einschränkungen.
Teste deine Arbeit in einem Browser (Datei > Vorschau im Browser).

Wenn Sie Ihre Seite in einer Browservorschau anzeigen, führt Dreamweaver eine interne XSL-Transformation ohne Rückgriff auf einen Anwendungsserver durch.

Wiederholte XML-Elemente anzeigen

Das Wiederholungsbereich-XSLT-Objekt ermöglicht es dir, sich wiederholende Elemente aus einer XML-Datenquelle auf einer Web-Seite anzuzeigen. Wenn du beispielsweise Artikeltitel und -beschreibungen aus einem Newsfeed anzeigst und dieser Newsfeed zwischen 10 und 20 Artikel enthält, wäre jeder Titel und jede Beschreibung in der XML-Datei wahrscheinlich ein untergeordnetes Element eines sich wiederholenden Elements.

Jeder Bereich in der Design- Ansicht, der einen XML-Daten-Platzhalter enthält, kann in einen wiederholten Bereich geändert werden.Die häufigsten Bereiche sind jedoch Tabellen, Tabellenzeilen oder eine Reihe von Tabellenzeilen.

Wähle in der Design-Ansicht einen Bereich aus, der einen XML-Daten-Platzhalter oder mehrere Platzhalter enthält.

Die Auswahl kann alles sein, einschließlich einer Tabelle, einer Tabellenzeile oder sogar eines Textabsatzes.

Entwurfsansicht

Sie können den Tag-Selektor links unten im Dokumentfenster verwenden, um einen Bereich auf der Seite präzise auszuwählen. Handelt es sich bei dem Bereich z. B. um eine Tabelle, klicken Sie auf der Seite in der Tabelle. Klicken Sie dann im Tag-Selektor auf das <table>-Tag.

Führen Sie einen der folgenden Schritte aus:
  • Wähle Einfügen > XSLT-Objekte > Wiederholungsbereich.

  • Klicke in der XSLT-Kategorie des Einfügen-Bedienfelds auf den Wiederholungsbereich-Button.

Wähle im XPath Expression Builder das sich wiederholende Element aus, das durch ein kleines Pluszeichen gekennzeichnet ist.
XPath-Ausdrucksgenerator

Klicken Sie auf „OK“.

Im Dokumentfenster erscheint eine dünne, mit Registerkarte versehene, graue Kontur um den wiederholten Bereich.Wenn du deine Arbeit in einem Browser testest (Datei > Vorschau im Browser), verschwindet die graue Kontur und die Auswahl erweitert sich, um die angegebenen sich wiederholenden Elemente in der XML-Datei anzuzeigen.

Wenn du das Wiederholungsbereich-XSLT-Objekt zur Seite hinzufügst, wird der XML-Daten-Platzhalter im Dokumentfenster abgeschnitten.Das liegt daran, dass Dreamweaver den XPath für den XML-Daten-Platzhalter abschneidet, sodass er relativ zum Pfad des sich wiederholenden Elements ist.

Eigenschaften wiederholender Bereiche (XSL) festlegen

Im Eigenschafteninspektor kannst du einen anderen XML-Knoten auswählen, um den Wiederholungsbereich zu erstellen.

Gib im Auswahlfeld einen neuen Knoten ein und drücke dann das Blitz-Symbol und wähle den Knoten aus dem XML-Schema- Baum aus, der angezeigt wird.

XSLT-Objekte vom Typ „Wiederholender Bereich“ bearbeiten

Nachdem du ein Wiederholungsbereich-XSLT- Objekt zu einem Bereich hinzugefügt hast, kannst du es mit dem Eigenschafteninspektor bearbeiten.

Wähle das Objekt aus, indem du auf die graue Registerkarte klickst, die den wiederholten Bereich umgibt.
Klicke im Eigenschafteninspektor (Fenster > Eigenschaften) auf das dynamische Symbol neben dem Auswahltext-Feld.
Nimm deine Änderungen im XPath Expression Builder vor und klicke auf OK.

XSLT-Fragmente in dynamische Seiten einfügen

Nachdem du ein XSLT-Fragment erstellt hast, kannst du es mit dem XSL-Transformation-Server-Verhalten in eine dynamische Web-Seite einfügen.Wenn du das Server- Verhalten zu deiner Seite hinzufügst und die Seite in einem Browser anzeigst, führt ein Anwendungs- Server eine Transformation durch, die die XML-Daten aus dem ausgewählten XSLT-Fragment anzeigt.Dreamweaver unterstützt XSL-Transformationen für ColdFusion-, ASP- oder PHP-Seiten.

Wenn Sie den Inhalt einer ganzen XSLT-Seite in eine dynamische Seite einfügen möchten, verfahren Sie genau so. Löschen Sie zunächst den gesamten HTML-Code aus der dynamischen Seite, bevor Sie die vollständige XSLT-Seite mithilfe des Serververhaltens „XSL-Transformation“ einfügen.

Öffnen Sie eine vorhandene ColdFusion-, ASP- oder PHP-Seite.
Platziere in der Designansicht die Einfügemarke an der Stelle, an der du das XSLT-Fragment einfügen möchtest.

Beim Einfügen von XSLT-Fragmenten sollten Sie immer auf die Schaltfläche „Code- und Entwurfsansicht anzeigen“ klicken, nachdem Sie die Einfügemarke auf die Seite gesetzt haben, um sicherzustellen, dass sich diese an der richtigen Stelle befindet. Ist dies nicht der Fall, müssen Sie in der Codeansicht auf eine andere Stelle klicken, um die Einfügemarke an der gewünschten Position zu platzieren.

Klicke im Bedienfeld Serververhalten (Fenster > Serververhalten) auf den Plus-Button (+) und wähle XSL-Transformation aus.
Bedienfeld „Serververhalten“

Klicke im Dialogfeld XSL-Transformation auf den Button Durchsuchen und durchsuche zu einem XSLT-Fragment oder einer vollständigen XSLT-Seite.

Dreamweaver füllt das nächste Textfeld mit dem Dateipfad oder der URL der XML-Datei aus, die an das angegebene Fragment angehängt ist.Um es zu ändern, klicke auf den Button Durchsuchen und durchsuche zu einer anderen Datei.

Optional: Klicken Sie auf die Schaltfläche mit dem Pluszeichen (+), um einen XSLT-Parameter hinzuzufügen.
Klicke auf OK, um eine Referenz zum XSLT-Fragment in die Seite einzufügen. Das Fragment kann nicht bearbeitet werden. Du kannst doppelt auf das Fragment klicken, um die Quelldatei des Fragments zu öffnen und zu bearbeiten.

Ein includes/MM_XSLTransform/ Ordner wird auch im Hauptordner der Website erstellt, der eine Laufzeitbibliotheksdatei enthält. Der Anwendungsserver verwendet die in dieser Datei definierten Funktionen, um die Transformation durchzuführen.

Lade die dynamische Seite auf deinen Server hoch (Website > Übertragen) und klicke auf Ja, um abhängige Dateien einzuschließen. Die Datei mit dem XSLT-Fragment, die XML-Datei mit deinen Daten und die generierte Laufzeitbibliotheksdatei müssen sich alle auf dem Server befinden, damit deine Seite korrekt angezeigt wird. (Wenn du eine Remote-XML-Datei als Datenquelle ausgewählt hast, muss sich diese Datei an einem anderen Ort im Internet befinden.)

XSLT-Fragmente aus dynamischen Seiten löschen

Du kannst ein XSLT-Fragment aus einer Seite entfernen, indem du das XSL-Transformations-Serververhalten löschst, das zum Einfügen des Fragments verwendet wurde. Das Löschen des Serververhaltens löscht nur das XSLT-Fragment – es löscht nicht die zugehörigen XML-, XSLT- oder Laufzeit-Bibliotheksdateien.

Wähle im Bedienfeld Serververhalten (Fenster > Serververhalten) das XSL-Transformations-Serververhalten aus, das du löschen möchtest.
Klicken Sie auf das Minuszeichen (–).

Sie sollten Serververhalten immer auf diese Weise entfernen. Beim manuellen Löschen des generierten Codes wird das Serververhalten nur teilweise entfernt, auch wenn das Serververhalten nicht mehr im Bedienfeld „Serververhalten“ angezeigt wird.

XSL-Transformations-Serververhalten bearbeiten

Nachdem du ein XSLT-Fragment zu einer dynamischen Web-Seite hinzugefügt hast, kannst du das XSL-Transformations-Serververhalten jederzeit bearbeiten.

Doppelklicke im Bedienfeld Serververhalten (Fenster > Serververhalten) auf das XSL-Transformations-Serververhalten, das du bearbeiten möchtest.
Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf „OK“.

Du kannst einen dynamischen Link auf deiner XSLT-Seite erstellen, der zu einer bestimmten URL führt, wenn der Benutzer auf ein bestimmtes Wort oder eine Gruppe von Wörtern aus deinen XML-Daten klickt.Vollständige Anweisungen findest du in den Dreamweaver-Errata unter www.adobe.com/go/dw_documentation.

Stile auf XSLT-Fragmente anwenden

Wenn du eine gesamte XSLT-Seite erstellst (d. h. eine XSLT-Seite, die <body>- und <head>-Tags enthält), kannst du XML-Daten auf der Seite anzeigen und die Daten dann wie jeden anderen Inhalt mit dem Eigenschafteninspektor oder dem CSS- Bedienfeld für Stile formatieren. Wenn du jedoch ein XSLT-Fragment zum Einfügen in eine dynamische Seite erstellst (z. B. ein Fragment zum Einfügen in eine ASP-, PHP- oder Cold Fusion-Seite), wird das Rendern von Stilen im Fragment und in der dynamischen Seite komplizierter. Obwohl du an einem XSLT-Fragment getrennt von der dynamischen Seite arbeitest, ist es wichtig zu bedenken, dass das Fragment für die Verwendung innerhalb der dynamischen Seite bestimmt ist und dass die Ausgabe des XSLT-Fragments letztendlich irgendwo innerhalb der <body>-Tags der dynamischen Seite platziert wird. Bei diesem Workflow ist es wichtig sicherzustellen, dass du\nkeine <head>-Elemente (wie Stildefinitionen\noder Links zu externen Stylesheets) in XSLT-Fragmente einschließt.Dadurch wird der Anwendungs-Server veranlasst, diese Elemente in den <body> der dynamischen Seite zu platzieren, wodurch ungültiges Markup generiert wird.

Du möchtest beispielsweise ein XSLT-Fragment für das Einfügen\nin eine dynamische Seite erstellen und das Fragment mit demselben externen\nStylesheet wie die dynamische Seite formatieren.Wenn du dasselbe Stylesheet\ndem Fragment anhängst, enthält die resultierende HTML-Seite einen doppelten Link\nzum Stylesheet (einen im <head>-Bereich\nder dynamischen Seite und einen weiteren im <body>-Bereich\nder Seite, wo der Inhalt des XSLT-Fragments erscheint).Anstelle\ndieses Ansatzes solltest du Design-time-Stylesheets verwenden, um\ndas externe Stylesheet zu referenzieren.

Verwende beim Formatieren des Inhalts von XSLT-Fragmenten den folgenden\nWorkflow:

  • Als Erstes hängen Sie ein externes Stylesheet an die dynamische Seite an. (Dies ist eine der besten Methoden, um Stile auf den Inhalt einer beliebigen Webseite anzuwenden.)

  • Als Nächstes hängen Sie das gleiche externe Stylesheet als Entwurfszeit-Stylesheet an das XSLT-Fragment an. Wie der Name vermuten lässt, können Sie nur in der Entwurfsansicht von Dreamweaver mit Entwurfszeit-Stylesheets arbeiten.

    Nachdem Sie die ersten beiden Schritte ausgeführt haben, können Sie anhand des Stylesheets, das Sie bereits an die dynamische Seite angehängt haben, in Ihrem XSLT-Fragment neue Stile erstellen. Das Resultat ist eine übersichtlichere HTML-Ausgabe (da der Verweis auf das Stylesheet nur während der Arbeit in Dreamweaver gültig ist) und das Fragment zeigt die entsprechenden Stile weiterhin in der Entwurfsansicht an. Darüber hinaus werden alle Stile sowohl auf das Fragment als auch auf die dynamische Seite angewendet, wenn Sie die dynamische Seite in der Entwurfsansicht oder eine Vorschau dieser in einem Browser anzeigen.

Bei der Anzeige des XSLT-Fragments in einem Browser werden die Stile nicht angezeigt. Sie sollten stattdessen die dynamische Seite im Browser anzeigen, um das XSLT-Fragment im Kontext dieser anzuzeigen.

Parameter mit XSL-Transformationen verwenden

Du kannst Parameter für deine\nXSL-Transformation definieren, wenn du das XSL-Transformation-Server-Verhalten\neiner Web-Seite hinzufügst.Ein Parameter steuert, wie XML-Daten verarbeitet und\nangezeigt werden.Du könntest beispielsweise einen Parameter verwenden, um einen bestimmten Artikel aus einem Newsfeed zu identifizieren und\naufzulisten.Wenn die Seite in\neinem Browser geladen wird, erscheint nur der Artikel, den du mit dem Parameter angegeben hast.

Füge einen XSLT-Parameter zu einer XSL-Transformation hinzu

Öffnen Sie das Dialogfeld „XSL-Transformation“. Du kannst dies tun, indem du auf ein XSL-Transformation-Server-Verhalten im Bedienfeld Server-Verhalten (Fenster > Server-\nVerhalten) doppelklickst oder ein neues XSL-Transformation-Server-Verhalten hinzufügst.
Klicke im Dialogfeld XSL-Transformation auf den Plus-\n(+)-Button neben XSLT-Parameter.
Dialogfeld „XSL-Transformation“

Gib im Dialogfeld Parameter hinzufügen einen Namen für den\nParameter in das Feld Name ein.Der Name kann nur alphanumerische\nZeichen enthalten.Leerzeichen sind nicht zulässig.
Führen Sie einen der folgenden Schritte aus:
  • Wenn du einen statischen Wert verwenden möchtest, gib\nihn in das Feld Wert ein.

  • Wenn du einen dynamischen Wert verwenden möchtest, klicke auf das Dynamik-\nSymbol neben dem Feld Wert, vervollständige das Dialogfeld Dynamische Daten\nund klicke auf OK.Für weitere Informationen klicke auf den Hilfe-Button im\nDialogfeld Dynamische Daten.

Gib im Feld Standardwert den Wert ein, den der\nParameter verwenden soll, wenn die Seite keinen Laufzeitwert erhält, und klicke\nauf OK.

XSLT-Parameter bearbeiten

Öffnen Sie das Dialogfeld „XSL-Transformation“. Du kannst dies tun, indem du auf ein XSL-Transformation-Server-Verhalten im Bedienfeld Server-Verhalten (Fenster > Server-\nVerhalten) doppelklickst oder ein neues XSL-Transformation-Server-Verhalten hinzufügst.
Wählen Sie einen Parameter in der XSLT-Parameterliste aus.
Klicken Sie auf die Schaltfläche „Bearbeiten“.
Nehmen Sie die gewünschten Änderungen vor und klicken Sie auf „OK“.

XSLT-Parameter löschen

Öffnen Sie das Dialogfeld „XSL-Transformation“. Du kannst dies tun, indem du auf ein XSL-Transformation-Server-Verhalten im Bedienfeld Server-Verhalten (Fenster > Server-\nVerhalten) doppelklickst oder ein neues XSL-Transformation-Server-Verhalten hinzufügst.
Wählen Sie einen Parameter in der XSLT-Parameterliste aus.
Klicken Sie auf das Minuszeichen (–).

Bedingte XSLT-Regionen erstellen und bearbeiten

Du kannst einfache bedingte Regionen oder mehrere bedingte Regionen auf einer XSLT-Seite erstellen.Du kannst entweder ein Element in der Designansicht auswählen und eine bedingte Region auf die Auswahl anwenden, oder du kannst eine bedingte Region einfügen, wo sich der Einfügepunkt im Dokument befindet.

Wenn\ndu beispielsweise das Wort „Nicht verfügbar" neben\ndem Preis eines Artikels anzeigen möchtest, wenn der Artikel nicht verfügbar ist, gibst du den\nText „Nicht verfügbar" auf der Seite ein, wählst ihn aus und wendest dann eine bedingte\nRegion auf den ausgewählten Text an.Dreamweaver umschließt die Auswahl mit <xsl:if>-Tags und zeigt nur das Wort „Nicht verfügbar" auf der Seite an, wenn die Daten den Bedingungen des bedingten Ausdrucks entsprechen.

Bedingten XSLT-Bereich anwenden

Du kannst einen einfachen bedingten Ausdruck schreiben, um ihn in deine XSLT-Seite einzufügen.Wenn Inhalt ausgewählt ist, wenn du das Dialogfeld Bedingte Region öffnest, wird der Inhalt in einen <xsl:if>-Block eingeschlossen. Falls du Inhalte nicht auswählst, wird der <xsl:if>-Block an der Einfügemarke auf der Seite hinzugefügt. Es ist eine gute Idee, das Dialogfeld zu verwenden, um loszulegen, und dann den Ausdruck in der Code-Ansicht anzupassen.

Das <xsl:if>-Element ist vergleichbar mit der if-Anweisung in anderen Sprachen. Das Element bietet dir eine Möglichkeit, eine Bedingung zu testen und basierend auf dem Ergebnis eine Handlung auszuführen. Das <xsl:if>-Element ermöglicht es dir, einen Ausdruck auf einen einzelnen wahren oder falschen Wert zu testen.

Wähle Einfügen > XSLT-Objekte > Bedingte Region aus oder klicke auf das Symbol Bedingte Region in der XLST-Kategorie des Bedienfelds Einfügen.
Gib im Dialogfeld „Bedingte Region" den bedingten Ausdruck ein, der für die Region verwendet werden soll.

Im folgenden Beispiel möchtest du testen, ob der Wert des Attributs @available des Kontextknotens wahr ist.

Dialogfeld „Bedingter Bereich“

Klicken Sie auf „OK“.

Der folgende Code wird in Ihre XSLT-Seite eingefügt:

<xsl:if test="@available=&apos;true&apos;">

    Inhalt hier einfügen 

</xsl:if>

Sie müssen String-Werte wie beispielsweise „true“ in Anführungszeichen setzen. Dreamweaver kodiert die Anführungszeichen für dich (&apos;), sodass sie als gültiges XHTML eingegeben werden.

Zusätzlich zum Testen von Knoten auf Werte kannst du jede der unterstützten XSLT-Funktionen in jeder bedingten Anweisung verwenden. Die Bedingung wird für den aktuellen Knoten in Ihrer XML-Datei getestet. Im folgenden Beispiel möchtest du auf den letzten Knoten im Ergebnissatz testen:

Den letzten Knoten in der Ergebnismenge testen

Weitere Informationen und Beispiele zum Schreiben bedingter Ausdrücke findest du im Abschnitt <xsl:if> im Referenz-Bedienfeld (Hilfe > Referenz).

Mehrere bedingte XSLT-Regionen anwenden

Du kannst einen einfachen bedingten Ausdruck schreiben, um ihn in deine XSLT-Seite einzufügen.Wenn Inhalt ausgewählt ist, während du das Dialogfeld „Bedingte Region" öffnest, wird der ausgwählte Inhalt von einem <xsl:choose>-Block umschlossen.Wenn du keinen Inhalt auswählst, wird der <xsl:choose>-Block an der Einfügemarke auf der Seite hinzugefügt.Es ist eine gute Idee, das Dialogfeld zu verwenden, um loszulegen, und dann den Ausdruck in der Code-Ansicht anzupassen.

Das <xsl:choose>-Element ähnelt der case-Anweisung in anderen Sprachen. Das Element bietet eine Möglichkeit, eine Bedingung zu testen und basierend auf dem Ergebnis eine Aktion auszuführen. Das <xsl:choose>-Element ermöglicht es dir, mehrere Bedingungen zu testen.

Wähle Einfügen > XSLT-Objekte > Bereich mit mehreren Bedingungen oder klicke auf das Symbol „Bereich mit mehreren Bedingungen" in der XLST-Kategorie des Bedienfelds „Einfügen".
Gib im Dialogfeld „Mehrere bedingte Regionen" die erste Bedingung ein.

Im folgenden Beispiel möchtest du testen, ob das price-Subelement des Kontextknotens kleiner als 5 ist.

Dialogfeld „Mehrere bedingte Bereiche“

Klicken Sie auf „OK“.

Im Beispiel wird der folgende Code in deine XSLT-Seite eingefügt:

<xsl:choose>

<xsl:when test="price<5">

        Inhalt hier einfügen 

</xsl:when>

<xsl:otherwise>

        Inhalt hier einfügen 

</xsl:otherwise>

</xsl:choose>

Um eine weitere Bedingung einzufügen, platziere den Einfügepunkt in der Codeansicht zwischen <xsl:when>-Tag-Paaren oder direkt vor dem <xsl:otherwise>-Tag und füge dann eine bedingte Region ein (Einfügen > XSLT-Objekte > Bedingte Region).

Nachdem du die Bedingung spezifiziert und auf OK geklickt hast, wird ein weiterer <xsl:when>-Tag in den <xsl:choose>-Block eingefügt.

Für weitere Informationen und Beispiele zum Schreiben von Bedingungsausdrücken siehe die <xsl:choose> Abschnitte im Referenz-Bedienfeld (Hilfe > Referenz).

Eigenschaften bedingter Bereiche (If) festlegen

Der Zweck des Eigenschafteninspektors für bedingte Regionen ist es, die Bedingung zu ändern, die in einer bedingten Region in deiner XSL-Seite verwendet wird.Die bedingte Region testet die Bedingung und führt basierend auf dem Ergebnis eine Aktion aus.

Gib im Testfeld eine neue Bedingung ein und drücke dann die Eingabetaste.

Eigenschaften bedingter Bereiche (When) festlegen

Der Zweck des Eigenschaftsinspektors für das Festlegen bedingter Regionen ist es, die Bedingung zu ändern, die in einer mehrfachen bedingten Region in deiner XSL-Seite verwendet wird. Die mehrfache bedingte Region testet die Bedingung und führt eine Aktion basierend auf dem Ergebnis aus.

Gib im Test-Feld eine neue Bedingung ein und drücke dann die Eingabetaste.

XSL-Kommentare einfügen

Du kannst XSL-Kommentar-Tags zu einem Dokument hinzufügen, oder du kannst eine Auswahl in XSL-Kommentar-Tags einschließen.

XSL-Kommentar-Tags in ein Dokument einfügen

Führen Sie einen der folgenden Schritte aus:
  • Wähle in der Designansicht Einfügen > XSLT-Objekte > XSL-Kommentar, gib den Inhalt des Kommentars ein (oder lasse das Feld leer) und klicke auf OK.

  • Wähle in der Codeansicht Einfügen > XSLT-Objekte > XSL-Kommentar.

Anmerkung

Du kannst auch auf das XSL-Kommentar-Symbol in der XSLT-Kategorie des Einfügen-Bedienfelds klicken.

Eine Auswahl in XSL-Kommentar-Tags einschließen

Wechsle zur Codeansicht (Ansicht > Code).
Wählen Sie den Code aus, den Sie kommentieren möchten.
Klicke in der Coding-Symbolleiste auf den Button „Kommentar anwenden"\nund wähle „<xsl:comment></xsl:comment> Kommentar anwenden".

Verwende den XPath Expression Builder,\num Ausdrücke für XML-Daten hinzuzufügen

XPath (XML Path Language) ist eine Nicht-XML-Syntax\nzur Adressierung von Teilen eines XML-Dokuments.Sie wird hauptsächlich als\nAbfragesprache für XML-Daten verwendet, genau wie die SQL-Sprache\nzur Abfrage von Datenbanken verwendet wird.Weitere Informationen zu XPath findest du in der XPath-\nSprachspezifikation auf der W3C-Website unter www.w3.org/TR/xpath.

Der\nXPath Expression Builder ist eine Dreamweaver-Funktion,\ndie es dir ermöglicht, einfache XPath-Ausdrücke zur Identifizierung bestimmter\nDatenknoten und für sich wiederholende Regionen zu erstellen.Der Vorteil dieser\nMethode gegenüber dem Ziehen von Werten aus dem XML-Schema-Baum\nist, dass du den angezeigten Wert formatieren kannst.Der aktuelle Kontext\nwird basierend auf der Position der Einfügemarke in der\nXSL-Datei identifiziert, wenn das Dialogfeld XPath Expression Builder geöffnet wird.\nDer aktuelle Kontext wird in der XML-Schemastruktur fett markiert. Während du Auswahlen in diesem Dialogfeld triffst, werden die korrekten XPath-\nAnweisungen relativ zu deinem aktuellen Kontext generiert.Dies\nvereinfacht den Prozess des Schreibens korrekter XPath-Ausdrücke für Anfänger\nund fortgeschrittene Benutzer.

Diese Funktion soll Ihnen helfen, einfache XPath-Ausdrücke für die Identifikation eines bestimmten Knotens oder für wiederholende Bereiche zu erstellen. Es ist nicht möglich, die Ausdrücke hier manuell zu ändern. Wenn Sie komplexe Ausdrücke erstellen möchten, verwenden Sie den XPATH-Ausdrucksgenerator für die ersten Schritte und passen Sie die Ausdrücke dann in der Codeansicht oder mit dem Eigenschafteninspektor an.

Erstelle einen XPath-Ausdruck zur Identifizierung\neines bestimmten Knotens

Doppelklicke auf den XML-Daten-Platzhalter\nauf der Seite, um den XPath Expression Builder zu öffnen.
Wähle im Dialogfeld XPath Expression Builder (Dynamischer Text)\neinen beliebigen Knoten im XML-Schema-Baum aus.

Der korrekte XPath-Ausdruck wird im Ausdrucksfeld geschrieben, um den Knoten zu identifizieren.

Anmerkung

Wenn du einen anderen Knoten\nim XML-Schema-Baum auswählst, ändert sich der Ausdruck entsprechend deiner Wahl.

Im\nfolgenden Beispiel möchtest du das price-Unterelement\ndes item-Knotens anzeigen:

Dialogfeld „XPATH-Ausdrucksgenerator (Dynamischer Text)“

Diese\nAuswahl würde den folgenden Code in deine XSLT-Seite einfügen:

<xsl:value-of select="price"/>

(Optional) Wähle eine Formatierungsoption aus dem Format-\nPopup-Menü.

Die Formatierung einer Auswahl ist nützlich, wenn der Wert deines\nKnotens eine Zahl zurückgibt.Dreamweaver stellt\neine vordefinierte Liste von Formatierungsfunktionen bereit.Eine vollständige Liste der\nverfügbaren Formatierungsfunktionen und Beispiele findest du im Referenz-Bedienfeld.

Im\nfolgenden Beispiel möchtest du das price-Unterelement\nals Währung mit zwei Dezimalstellen formatieren:

Das Teilelement „price“ als Währung mit zwei Dezimalstellen formatieren

Diese\nOptionen würden den folgenden Code in deine XSLT-Seite einfügen:<xsl:value-of select=\"format-number(provider/store/items/item/price,'$#.00')\"/>

Klicken Sie auf „OK“.
Um den Wert jedes Knotens in der XML-Datei anzuzeigen, wende\neine sich wiederholende Region auf das Element an, das den dynamischen Text enthält (zum\nBeispiel eine HTML-Tabellenzeile oder einen Absatz).

Weitere Informationen und Beispiele zur Auswahl von Knoten, um einen Wert zurückzugeben, findest du im Abschnitt <xsl:value-of/> im Bedienfeld Referenz.

Zu wiederholenden Knoten auswählen

Du kannst einen Knoten auswählen, über den wiederholt werden soll, und optional die Ergebnisse filtern.Im Dialogfeld XPath Expression Builder wird der ausgewählte Inhalt in einen <xsl:for-each>-Block eingeschlossen. Falls du keinen Inhalt ausgewählt hast, wird der <xsl:for-each>-Block an der Einfügemarke deines Cursors eingegeben.

Doppelklicke auf den XML-Datenplatzhalter auf der Seite, um den XPath Expression Builder zu öffnen.
Wähle im Dialogfeld XPath Expression Builder (Repeating Region) das Element aus, das im XML-Schema-Baum wiederholt werden soll.

Der korrekte XPath-Ausdruck steht im Ausdrucksfeld, um den Knoten zu identifizieren.

Anmerkung

Wiederholende Elemente werden mit einem Plus-Symbol (+) im XML-Schema-Baum gekennzeichnet.

Im folgenden Beispiel möchtest du jeden item-Knoten in der XML-Datei wiederholen.

Dialogfeld „XPATH-Ausdrucksgenerator (Bereich wiederholen)

Wenn du auf OK klickst, wird folgender Code in deine XSLT-Seite eingefügt:

<xsl:for-each select="provider/store/items/item">

 Inhalt hier einfügen 

</xsl:for-each>

In manchen Fällen möchtest du möglicherweise mit einer Teilmenge der wiederholenden Knoten arbeiten – beispielsweise möchtest du nur Elemente, bei denen ein Attribut einen bestimmten Wert hat.In diesem Fall musst du einen Filter anlegen.

Zu wiederholende Daten filtern

Verwende einen Filter, um wiederholende Knoten zu identifizieren, die bestimmte Attributwerte haben.

Wählen Sie in der XML-Schemastruktur einen zu wiederholenden Knoten aus.
Klicken Sie auf die Erweiterungsschaltfläche von „Filter erstellen“.
Klicken Sie auf die Schaltfläche mit dem Pluszeichen (+), um einen leeren Filter zu erstellen.
Geben Sie die Filterkriterien in die folgenden Felder ein:

Filtern nach

Gibt den wiederholenden Knoten an, der die Daten enthält, nach denen du filtern möchtest.Das Popup-Menü stellt eine Liste von Vorgängerknoten relativ zu dem Knoten bereit, den du im XML-Schema-Baum ausgewählt hast.

Wo

Gibt das Attribut oder Unterelement des Filter By- Knotens an, das zur Begrenzung der Ergebnisse verwendet wird.Du kannst ein Attribut oder Unterelement aus dem Popup-Menü auswählen oder deinen eigenen XPath- Ausdruck in dieses Feld eingeben, um untergeordnete Elemente zu identifizieren, die tiefer im Schema-Baum vorhanden sind.

Operator

Gibt den Vergleichsoperator an, der im Filter- Ausdruck verwendet werden soll.

Wert

gibt den Wert an, nach dem der Knoten Filtern nach überprüft werden soll. Geben Sie den Wert ein. Falls dynamische Parameter für deine XSLT- Seite definiert sind, kannst du einen aus dem Popup-Menü auswählen.

Um einen weiteren Filter anzugeben, klicke erneut auf den Plus-Button (+).

Während du Werte eingibst oder Auswahlen in den Popup-Menüs triffst, ändert sich der XPath-Ausdruck im Ausdrucksfeld.

Im folgenden Beispiel möchtest du das Ergebnisset auf die item-Knoten beschränken, bei denen der Wert des @available-Attributs true ist.

Die Ergebnismenge wird auf die item-Knoten beschränkt, bei denen das @available-Attribut den Wert „true“ hat

Wenn du auf OK klickst, wird folgender Code in deine XSLT-Seite eingefügt:<xsl:for-each select="provider/store/items/item[@available = &apos;true&apos;]"> Content goes here </xsl:for-each>

Sie müssen String-Werte wie beispielsweise „true“ in Anführungszeichen setzen. Dreamweaver codiert die Anführungszeichen für dich (&apos;), damit sie als gültiges XHTML eingegeben werden.

Du kannst komplexere Filter erstellen, mit denen du übergeordnete Knoten als Teil deiner Filterkriterien festlegen kannst.In dem folgenden Beispiel möchtest du die Ergebnismenge auf die item-Knoten beschränken, bei denen das @id-Attribut des Webstore gleich 1 ist und der price-Knoten des item größer als 5 ist.

Die Ergebnismenge wird auf die item-Knoten beschränkt, bei denen das @id-Attribut von store den Wert „1“ hat und der price-Knoten von item größer als 5 ist

Wenn du auf OK klickst, wird der folgende Code in deine XSLT-Seite eingefügt:<xsl:for-each select="provider/store[@id = 1]/items/item[price > 5]"> Content goes here </xsl:for-each>

Weitere Informationen und Beispiele für wiederholende Regionen findest du im Abschnitt <xsl:for-each> im Referenzbedienfeld.