Prozess Designer

JobRouter bietet die Möglichkeit, per Skript das Senden eines Prozessschrittes zu verhindern. Dies kann sinnvoll sein, wenn Sie z. B. eine eigene Validierung der Eingaben durchführen. Dazu können Sie folgende Funktionen verwenden. Diese funktionieren ausschließlich beim Senden des Dialoges, also mit dem Event OnSubmit.

Bitte beachten Sie: Bei asynchroner Ausführung von JavaScript kann das korrekte Ausführen der API-Funktionen jr_enable_send, jr_disable_send und jr_allow_send aktuell nicht gewährleistet werden. API-Funktionen wie beispielsweise jr_execute_dialog_function mit anschließender Ausführungslogik in dem successCallback sollten daher vermieden werden.

jr_enable_send()

Die Funktion erlaubt das Senden des Schrittes. Standardmäßig ist das Senden für einen Schritt immer erlaubt.

Die Funktion liefert keinen Rückgabewert.

Hinweis: Zur API-Funktion jr_enable_send kann alternativ die API-Funktion jr_allow_send verwendet werden.

Beispiel: Senden eines Schrittes erlauben

var performOnSubmit = function() {

 

    // Senden des Schrittes verbieten

    jr_disable_send();

 

    // Validierung erfolgt

    var validationResult = myValidationCall();

 

    // Bei erfolgreicher Validierung wird das Senden des Schrittes wieder erlaubt

    if (validationResult) {

        jr_enable_send();

    }

}

 

jr_disable_send()

Durch Ausführen dieser Funktion wird das Senden des Schrittes verhindert. Standardmäßig ist das Senden für einen Schritt immer erlaubt.

Die Funktion liefert keinen Rückgabewert.

Hinweis: Zur API-Funktion jr_disable_send kann alternativ die API-Funktion jr_allow_send verwendet werden.

Beispiel: Senden eines Schrittes verbieten

var performOnSubmit = function() {

    jr_disable_send(); 

}

 

jr_allow_send(boolean value)

Die Funktion erlaubt oder verbietet das Senden des Schrittes abhängig vom übergebenen Parameterwert. Standardmäßig ist das Senden für einen Schritt immer erlaubt.

Die Funktion liefert keinen Rückgabewert.

Hinweis: Zur API-Funktion jr_allow_send können alternativ die API-Funktionen jr_enable_send und jr_disable_send verwendet werden.

Beispiel 1: Senden eines Schrittes erlauben

// 1. Variante

var performOnSubmit = function() {

 

    // Senden des Schrittes verbieten

    jr_allow_send(false);

 

    // Validierung erfolgt

    var validationResult = myValidationCall();

 

    // Bei erfolgreicher Validierung wird das Senden des Schrittes wieder erlaubt

    if (validationResult) {

        jr_allow_send(true); // bzw.: jr_allow_send()

    }

}

 

// 2. Variante

var performOnSubmit = function() {

 

    // Validierung erfolgt

    var validationResult = myValidationCall();

 

    // Bei erfolgreicher Validierung wird das Senden des Schrittes wieder erlaubt, ansonsten wird das Senden des Schrittes wieder verboten

    jr_allow_send(!!validationResult);

}

Beispiel 2: Senden eines Schrittes verbieten

var performOnSubmit = function() {

    jr_allow_send(false);

}