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 gibt OO('phone') in der Schnittstellen-Konfiguration den Wert in der Spalte phone zurück.

  • Untervorlagen OO gibt jeweils die Werte im primedocs Custom XML Part zurück, also z. B. OO('DocParam.Subject).

PrimeSoft AG, Bahnhofstrasse 4, 8360 Eschlikon, Switzerland