JavaScript
Die JavaScript API wird für Mappings und für bedingte Untervorlagen verwendet. Der Dokument-Parameter und das Scripting verwenden diese Definition noch nicht. Es wird ES5 JavaScript unterstützt.
Expressions
Expressions in Bedingungen können jeweils in zwei Formaten definiert werden:
Expression
Es kann direkt ein Ausdruck angegeben sein, z. B. "OO('forname') + ' ' + OO('lastname')"
.
Main-Funktion
Existiert eine function main()
wird diese aufgerufen und der Rückgabewert ausgewertet. So können komplexere Sachverhalte dargestellt werden, wie z. B. das Anpassen einer Schweizer Telefonnummer in das internationale Format. Das würde mittels regulärem Ausdruck (Regex) in JavaScript folgendermassen erreicht:
function main()
{
// normalisiert alle Telefonnummern
// 0715110500 => +41 71 511 05 00
// +41 71 511 05 00 => +41 71 511 05 00
var input = OO('phonenumber').replace(/ /g, '');
var patt = /((\+|00)41|0)([0-9]+)/;
var matchArray = patt.exec(input);
var number = matchArray[3];
return "+41 " + number.substring(0,2) + " " + number.substring(2,5)
+ " " + number.substring(5,7)+ " " + number.substring(7,9);
}
OO-API-Objekt
Es steht jeweils ein API-Objekt als OO
zur Verfügung. Dabei kann OO(identifier)
als Kurzform für OO.getValue(identifier)
verwendet werden. Wird ein nicht bekannter Schlüssel übergeben, wird undefined
zurückgegeben.
- Mappings
OO
gibt jeweils die Quellwerte zurück. Beispielsweise gibtOO('phone')
in der Schnittstellen-Konfiguration den Wert in der Spaltephone
zurück. - Untervorlagen
OO
gibt jeweils die Werte im OneOffixx Custom XML Part zurück, also z. B.OO('DocParam.Subject)
.