XSLT-Elemente

A | B | C | D | E | F | G | H | I | J | K | L | M | N | O | P | Q | R | S | T | U | V | W | X | Y | Z

xsl:message

Die Instruktion xsl:message gibt die Ausgabewerte ihrer Sub-Instruktionen bei einer XSLTransformation als Nachricht aus. Bei der Erzeugung des Ergebnisdokumentes wird anwendungsabhängig diese Nachricht außerhalb des Dokumentes angezeigt. Alternativ kann mit dem Attribut terminate (yes|no) angegeben werden, dass die Transformation unterbrochen werden soll (yes). Beim Defaultwert (no) wird die Nachricht nur ausgegeben, ohne die Transformation abzubrechen.

Anstelle eines Inhaltes oder zusätzlich kann auch die Sequenz ausgegeben werden, die im optionalen Attribut select angegeben wird. Besitzt ein xsl:message-Element ein solches Attribut, wird zuerst die angegebene Sequenz ausgegeben, dann der Inhalt des Elements.

Die Instruktion dient dazu Verarbeitungsfehlern vorzubeugen und gezielt mit Fehlermeldungen Abbrüche zu erzwingen oder auch um einfache Warnungen auszugeben.

Attribute

terminate, select

Beispiel 1

<?xml version="1.0"encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="2.0">
  <xsl:template match="/">
    <root>
      <xsl:for-each select="root/stadt[@land='de']">
        <xsl:if test="not(gemeinde)">
          <xsl:message terminate="no" select="(1,2,3,4)">
          Für die Stadt <xsl:value-of select="name">
          </xsl:value-of> fehlt der Gemeindeschlüssel!
          </xsl:message>
        </xsl:if>
        <gemeindeschlüssel>
          <xsl:value-of select="gemeinde"></xsl:value-of>
        </gemeindeschlüssel>
      </xsl:for-each>
    </root>
      <xsl:comment>Die angezeigte Meldung ist:  Für die Stadt 
      Ludwigshafen fehlt der Gemeindeschlüssel!
      </xsl:comment>
  </xsl:template>
</xsl:stylesheet>

<?xml version="1.0"encoding="UTF-8"?>
<root>
    <gemeindeschlüssel>11000000</gemeindeschlüssel>
    <gemeindeschlüssel>02000000</gemeindeschlüssel>
    <gemeindeschlüssel></gemeindeschlüssel>
</root>

Beispiel 2

<?xml version="1.0"encoding="UTF-8"?>
<root>
    <stadt land="de">
        <name>Berlin</name>
        <einwohner>3420786</einwohner>
        <fläche>891.85</fläche>
        <gemeinde>11000000</gemeinde>
        <bewertung>5</bewertung>
    </stadt>
    <stadt land="de">
        <name>Hamburg</name>
        <einwohner>1773218</einwohner>
        <fläche>755.264</fläche>
        <gemeinde>02000000</gemeinde>
        <bewertung>4</bewertung>
    </stadt>
    <stadt land="fr">
        <name>Paris</name>
        <einwohner>2166200</einwohner>
        <fläche>105.40</fläche>
        <bewertung>3</bewertung>
    </stadt>
    <stadt land="de">
        <name>Ludwigshafen</name>
        <einwohner>163777</einwohner>
        <fläche>77.68</fläche>
        <bewertung>-3</bewertung>
    </stadt>
</root>

<?xml version="1.0"encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="2.0">
  <xsl:template match="/">
    <root>
      <xsl:for-each select="root/stadt[@land='de']">
        <xsl:if test="not(gemeinde)">
          <xsl:message terminate="no" select="(1,2,3,4)">
           Für die Stadt <xsl:value-of select="name">
          </xsl:value-of> fehlt der Gemeindeschlüssel!
          </xsl:message>
        </xsl:if>
        <gemeindeschlüssel>
          <xsl:value-of select="gemeinde"></xsl:value-of>
        </gemeindeschlüssel>
      </xsl:for-each>
    </root>
      <xsl:comment>Die angezeigte Meldung ist:  Für die Stadt 
      Ludwigshafen fehlt der Gemeindeschlüssel!
      </xsl:comment>
  </xsl:template>
</xsl:stylesheet>

<?xml version="1.0"encoding="UTF-8"?>
<root>
    <gemeindeschlüssel>11000000</gemeindeschlüssel>
    <gemeindeschlüssel>02000000</gemeindeschlüssel>
    <gemeindeschlüssel></gemeindeschlüssel>
</root>

Beispiel 4

<?xml version="1.0"encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="2.0">
  <xsl:template match="/">
    <xsl:data2type-element>
      <xsl:fallback>
        <xsl:message>Für dieses super tolle neue Element 
        wird leider der data2type-Superprozessor benötigt.
        </xsl:message>
      </xsl:fallback>
      <xsl:fallback>
        <xsl:apply-templates></xsl:apply-templates>
      </xsl:fallback>
    </xsl:data2type-element>
  </xsl:template>
</xsl:stylesheet>

	> nach oben

	> zurück zur alphabetischen Liste der XSLT Elemente