Unterstützung für Schematron-Dateien

"Schematron"bezieht sich auf eine regelbasierte Validierungssprache, die zum Definieren von Tests für eine XML-Datei verwendet wird. Der Web Editor unterstützt Schematron-Dateien. Sie können die Schemadateien importieren und sie auch im Web-Editor bearbeiten. Mithilfe einer Schematron-Datei können Sie bestimmte Regeln definieren und sie dann für ein DITA-Thema oder eine Zuordnung validieren.

Schemateien importieren

Führen Sie die folgenden Schritte aus, um die Schematron-Dateien zu importieren:

Validieren eines DITA-Themas oder -Map mit Schematron

Nach dem Import von Schematron-Dateien können Sie diese im Web-Editor bearbeiten. Sie können die Schematron-Dateien verwenden, um die Themen oder eine DITA-Zuordnung zu validieren. Sie können beispielsweise die folgenden Regeln für eine DITA-Zuordnung oder ein Thema erstellen:

Wenn Sie ein Thema im Web Editor öffnen, wird rechts ein Bedienfeld zur Schemavalidierung angezeigt. Führen Sie die folgenden Schritte aus, um ein Thema oder eine Zuordnung mit einer Schematron-Datei hinzuzufügen und zu validieren:
{width="300"}

Die Schemaunterstützung im Web Editor hilft Ihnen dabei, die Dateien anhand eines Regelsatzes zu validieren und Konsistenz und Korrektheit über die Themen hinweg zu gewährleisten.

Verwenden Sie Assets und Berichtanweisungen, um nach Regeln zu suchen. schematron-assert-report

AEM Guides unterstützt auch die Assert- und Berichtanweisungen in Schematron. Diese Anweisungen helfen Ihnen bei der Validierung Ihrer DITA-Themen.

Assert-Anweisung

Eine Assert-Anweisung generiert eine Meldung, wenn eine Testanweisung als "false"ausgewertet wird. Wenn Ihr Titel beispielsweise fett sein soll, können Sie eine Assert-Anweisung dafür definieren.

<sch:rule context="title">
    <sch:assert test = "b"> Title should be bold </sch:assert>
  </sch:rule>

Wenn Sie Ihre DITA-Themen mit dem Schema validieren, erhalten Sie eine Nachricht für die Themen, bei denen der Titel nicht fett dargestellt wird.

Berichtserklärung

Eine Berichtanweisung generiert eine Meldung, wenn eine Testanweisung als "true"ausgewertet wird. Wenn Sie beispielsweise eine Kurzbeschreibung von 150 Zeichen oder weniger wünschen, können Sie eine Berichtanweisung definieren, um die Themen zu überprüfen, bei denen die Kurzbeschreibung mehr als 150 Zeichen umfasst.
Wenn Sie Ihre DITA-Themen mit dem Schema validieren, erhalten Sie einen vollständigen Bericht der Regeln, für die die Berichtanweisung "true"ergibt. Sie erhalten also eine Nachricht für die Themen, bei denen die kurze Beschreibung mehr als 150 Zeichen umfasst.

<sch:rule context="shortdesc">
        <sch:let name="characters" value="string-length(.)"/>
        <sch:report test="$characters &gt; 150">
        The short description has <sch:value-of select="$characters"/> characters. It should contain more than 150 characters.
        </sch:report>
    </sch:rule>

Verwenden von Regex-Ausdrücken schematron-regex-espressions

Sie können auch Regex-Ausdrücke verwenden, um eine Regel mit der Funktion matches() zu definieren und dann mithilfe der Schematron-Datei eine Validierung durchzuführen.

Beispielsweise können Sie damit eine Nachricht anzeigen, wenn der Titel nur ein Wort enthält.

<assert test="not(matches(.,'^\w+$'))">
No one word titles.
</assert>

Abstrakte Muster definieren schematron-abstract-patterns

AEM Guides unterstützt auch abstrakte Muster in Schematron. Sie können allgemeine abstrakte Muster definieren, um diese abstrakten Muster wiederzuverwenden. Sie können Platzhalterparameter erstellen, die das tatsächliche Muster angeben.

Die Verwendung abstrakter Muster kann das Schema vereinfachen, indem die Duplizierung von Regeln reduziert und die Verwaltung und Aktualisierung Ihrer Validierungslogik vereinfacht wird. Außerdem kann es das Verständnis Ihres Schemas vereinfachen, da Sie komplexe Validierungslogik in einem einzigen abstrakten Muster definieren können, das im gesamten Schema wiederverwendet werden kann.

Beispielsweise erstellt der folgende XML-Code ein abstraktes Muster und das eigentliche Muster verweist mithilfe der ID auf dieses Muster.

<sch:pattern abstract="true" id="LimitNoOfWords">

<sch:rule context="$parentElement">

<sch:let name="words" value="string-length(.)"/>

<sch:assert test="$words &lt; $maxWords">

You have <sch:value-of select="$words"/> letters. This should be lesser than <sch:value-of select="$maxWords"/>.

</sch:assert>

<sch:assert test="$words &gt; $minWords">

You have <sch:value-of select="$words"/> letters. This should be greater than <sch:value-of select="$minWords"/>.

</sch:assert>

</sch:rule>

</sch:pattern>

<sch:pattern is-a="LimitNoOfWords" id="extend-LimitNoOfWords">

<sch:param name="parentElement" value="title"/>

<param name="minWords" value="1"/>

<param name="maxWords" value="8"/>

</sch:pattern>