Javascript Im Freigabeworkflow Verwenden - X-Rite Pantone Vlbde-500 Benutzerhandbuch

3. JavaScript im Freigabeworkflow verwenden

Mit JavaScript können Sie den Freigabeworkflow an Ihre Bedürfnisse anpassen. Sie können zum
Beispiel verschiedene individuelle Workflows integrieren, quasi ein Freigabeprozess mit
mehreren Schritten.
Der generelle Vorgang mit JavaScript ist wie folgt:
Item {
function validateInputs(lApprovalFields) {
...
return result;
}
function evaluateApproval(lApprovalFields) {
...
return [state, message, color];
}
}
Sie müssen ein Element mit zwei Methoden deklarieren: validateInputs und evaluateApproval.
Beide erhalten eine Liste der Metadatenfelder, wie in der XML-Datei definiert und mit den
aktuellen Werten. Auf die ID der Felder mit Index i kann mit lApprovalFields[i].strFieldID
zugegriffen werden und auf die Werte mit lApprovalFields[i].value. Die Feld-ID entspricht dem
Wert des ID-Attributs, wie für die entsprechende Eigenschaft in der Definitions-XML festgelegt.
Aus validateInputs muss entweder true oder false zurückgegeben werden, je nachdem ob die
Eingabewerte des Benutzers möglich sind. Mit dieser Methode können Sie Abhängigkeiten
zwischen verschiedenen Feldern erstellen. Beispiel: bei Aktivierung eines Kontrollkästchens
muss der Benutzer ein Kommentarfeld ausfüllen. Falls false zurückgegeben wird, dann
unterbindet die VLB-Software die Speicherung der eingegebenen Daten.
Aus evaluateApproval muss ein 3-Tupel aus Werten zurückgegeben werden. Es müssen
Ganzzahlen sein, die drei verschiedene Werte haben können:
0: nicht geprüft, Prüfung nicht möglich da zum Beispiel der Benutzer keine ausreichenden
•
Daten eingegeben hat
• 1: freigegeben
• -1: zurückgewiesen
• 2: benutzerdefinierter Status
Falls der Status 2 / custom ist, dann werden die anderen beiden Tupel benötigt: message und
color. Die VLB zeigt dann die angegebene Meldung in der angegebenen Farbe im linken Feld
der Freigabe-UI. Für andere Status-Anzeigen zeigt die VLB-Software die Standardmeldung und
nicht die benutzerdefinierte Information an.
Bitte achten Sie darauf, dass Ihr eigenes JavaScript in der XML-Datei korrekt ist. Verwenden Sie
hierzu einen JavaScript-Softwareeditor.
In der ExampleApprovalMetaDataDefinitions.xml finden Sie ein Beispiel-Script, dass alle oben
beschriebenen Funktionen zeigt.
Der Freigabestatus wechselt von Rejected (Zurückgewiesen) auf Approved (Freigegeben),
-
wenn die Toleranzen eingehalten werden.
V i r t u e l l e L i c h t k a b i n e
31