Einführung
Einführung

Einführung / FirstSpirit ServerManager / Server-Eigenschaften / Konvertierungs-Regeln

Konvertierungs-Regeln

Konvertierungs-Regeln

In diesem Bereich werden die Konvertierungsregeln des Servers definiert. Die hier definierten Konvertierungsregeln können im Projekt innerhalb der Formatvorlagen für jeden Präsentationskanal aus einer Klappliste ausgewählt werden. Standardmäßig wird die Konvertierungsregel „Convert HTML“ mit folgendem Inhalt mit ausgeliefert:

[convert]

0x3c="<"
0x3e=">"
0x22="""
0x26="&"
0x27="'"

Für jeden Ausgabekanal kann genau eine Konvertierungsregel festgelegt werden. Innerhalb eines Projekts können jedoch mehrere Konvertierungsregeln verwendet werden.

Konvertierungsregeln dienen dazu, eingegebene Zeichen zu konvertieren. Dabei kann entweder:

  • ein Zeichen gegen ein anderes Zeichen getauscht werden oder
  • ein Zeichen gegen eine Zeichenkette getauscht werden

Eine Konvertierungsregel besteht aus zwei Teilen:

  • convert: Der Bereich „convert“ bewirkt, dass nicht-HTML-konforme Zeichen durch HTML-konforme Zeichen ersetzt werden. Die Methode .convert kann im Präsentationskanal (z. B. HTML-Kanal) und/oder in einer Formatvorlage aufgerufen werden.
  • quote: Über den Bereich „quote“ können HTML- bzw. XML-eigene Zeichen zusätzlich quotiert werden. Hier sollte sollte sichergestellt werden, dass mindestens die Zeichen: <, >, ', " quotiert werden bzw. in der verwendeten Konvertierungsregel (für den Präsentationskanal) enthalten sind (siehe Sicherheit (→Online Dokumentation FirstSpirit)).

Beispiel: Konvertierungsregel test

[convert]
0x21="ein Ausrufungszeichen"
0x23=0x24
[quote]
0x25=0x22

0x21 ist das Ausrufungszeichen (!),
0x22 is das Anführungszeichen (")
0x23 ist das Nummernzeichen (#),
0x24 ist das Dollar-Zeichen ($) und
0x25 ist das Prozentzeichen.

Beispiel: Anwendung der Konvertierungsregeln test im Projekt (Formatvorlage):    

<pre>
convert:  $CMS_VALUE(":::!:::#:::%:::".convert("test"))$
convert2: $CMS_VALUE(":::!:::#:::%:::".convert2("test"))$
</pre>

Beispiel: Ergebnis der Konvertierung test im Projekt (Ausgabekanal):

convert:  :::ein Ausrufungszeichen:::$:::%:::
convert2: :::ein Ausrufungszeichen:::$:::":::

Weiterführende Informationen zu Formatvorlagen siehe Formatvorlagen (→Online Dokumentation FirstSpirit).

Hinzufügen: Es öffnet sich ein Auswahldialog, in dem die lokale Dateistruktur des Rechners durchsucht werden kann. Eine neue Konvertierungsregel muss zuvor als Textdatei angelegt worden sein.

Bearbeiten: Über den Dialog "„Konvertierungs-Regel editieren“" kann eine bestehende Konvertierungsregel bearbeitet werden.

Löschen: Mit einem Klick auf den Button können bestehende Konvertierungsregeln vom Server gelöscht werden. Vor dem Löschen erfolgt eine Sicherheitsabfrage.

© 2005 - 2020 e-Spirit AG | Alle Rechte vorbehalten. | FirstSpirit 2020-01 | Datenschutz | Impressum | Kontakt