Die Funktion ecm:urlEncodeUsingCharset kodiert das spezifizierte Objekt als URL unter Verwendung eines bestimmten Zeichensatzes. Es wird ein Wert vom Typ Zeichenkette zurückgegeben.

Struktur​

ecm:urlEncodeUsingCharset(Objekt, Zeichenkette)

Parameter​

Parameter

Beschreibung

Objekt

Der Parameter spezifiziert das Zielobjekt, das kodiert werden soll.

Zeichenkette

Der Parameter spezifiziert den Zeichensatz, der zur Kodierung des Zielobjekts verwendet wird.


Beispiel

In einer Nachricht ist ein Anmeldelink enthalten, der die Informationen aus dem Benutzerattribut ​user.LastName​ als Variable an die Anmeldeseite weiterleitet. Die Nachricht selbst wird durch den Zeichensatz ISO-8859-15 kodiert.

Die URL-Kodierung bewirkt, dass Nachnamen mit Leerzeichen (de la Hoya, van der Waal) oder Sonderzeichen (Nuñez, Köhl) den Link nicht unterbrechen.

Der HTML-Code, mit dem der Link in eine Nachricht eingefügt wird, ist wie folgt aufgebaut:

​<a href="http://host/cmd.jsp?user=<%${ecm:urlEncodeUsingCharset(user['LastName']), 'ISO-8859-15'}%>">Registrieren</a>