make-error-result
Diese Ausdrucksfunktion erzeugt ein Ergebnisobjekt mit leerem stdout und stderr, dem Exit-Code, wie angegeben (der Standardwert ist 1, was für einen Fehler steht) und der Fehlermeldung, wie definiert (der Standardwert ist ein leerer String) und keinen Ergebnisdateien. Die make-error-result-Funktion wird in Wiederaufnahmeschritten verwendet. Nähere Informationen dazu finden Sie unter Wiederaufnahmeschritte.
Signatur
make-error-result (exit-code:number=1, error-message:string="") -> result |
Beispiel
In diesem Beispiel wird gezeigt, wie Sie die make-error-result-Funktion in einem Auftrag verwenden können. Der unten gezeigte Beispielauftrag besteht aus einem Error/Success-Handler-Block, der ein MapForce Mapping ausführt und einem Ausführungsschritt, der einen Ausdruck berechnet. Im Error/Success-Handler-Block gibt es auch einen Bei Fehler-Handler, der einen Wiederaufnahmeschritt enthält. Falls bei der Mapping-Ausführung ein Fehler auftritt, soll der Auftrag nicht fehlschlagen. Wir gehen daher folgendermaßen vor:
1.Wir definieren einen Wiederaufnahmeschritt, der das Ergebnis des fehlgeschlagenen Schritts durch ein neu erstelltes Ergebnisobjekt ersetzt und setzen das Ergebnis des geschützten Blocks auf den berechneten Ausdruck.
2.Außerdem soll das Ergebnis der make-error-result-Funktion im nächsten Schritt verwendet werden. Dazu weisen wir es Map zu.
3.In nächsten Schritt extrahieren wir den Exit-Code und die Fehlermeldung mit dem folgenden Ausdruck für die Funktion compute-string aus Map: {string(exitcode(Map))}, {error-message(Map)}. Dieser Ausdruck konvertiert den Exit-Code in einen String und verkettet diesen String mit der Fehlermeldung. Die Werte des Exit-Codes und die Fehlermeldung sind die Argumente, die im Wiederaufnahmeschritt an die make-error-result-Funktion übergeben werden.
Unser Beispielauftrag ist als Web-Dienst konfiguriert. Bei Auftreten eines Fehlers wird im Browser-Fenster das folgende Ergebnis angezeigt:
1, Mapping has failed!
Falls Sie den im Wiederaufnahmeschritt berechneten Ausdruck nicht aufrufen möchten, müssen Sie das Schrittergebnis nichts zuweisen. Stattdessen können Sie außerhalb des Error/Success Handler-Schritts einen oder mehrere Schritte hinzufügen. Der/Die neuen Schritt(e) wird/werden nach Ausführung des Wiederaufnahmeschritts verarbeitet.
