Zum Inhalt

Fehlerbehandlung#

Beim Entwurf Ihrer Ablauflogik ist es eine gute Vorgehensweise, potenzielle Fehler zu berücksichtigen und Methoden einzurichten, um diese ordnungsgemäß zu behandeln. Mit einem Fehler-Workflow können Sie steuern, wie Localmind Automate auf einen Fehler bei der Workflow-Ausführung reagiert.

Untersuchung von Fehlern

Um fehlgeschlagene Ausführungen zu untersuchen, können Sie:

Erstellen und Festlegen eines Fehler-Workflows#

Für jeden Workflow können Sie in den Workflow-Einstellungen einen Fehler-Workflow festlegen. Dieser wird ausgeführt, wenn eine Ausführung fehlschlägt. Dies bedeutet, dass Sie beispielsweise E-Mail- oder Slack-Benachrichtigungen senden können, wenn bei einer Workflow-Ausführung ein Fehler auftritt. Der Fehler-Workflow muss mit dem Fehler-Trigger beginnen.

Sie können denselben Fehler-Workflow für mehrere Workflows verwenden.

  1. Create a new workflow, with the Error Trigger as the first node.
  2. Give the workflow a name, for example Error Handler.
  3. Select Save.
  4. In the workflow where you want to use this error workflow:
    1. Select Options > Settings.
    2. In Error workflow, select the workflow you just created. For example, if you used the name Error Handler, select Error handler.
    3. Select Save. Now, when this workflow errors, the related error workflow runs.

Fehlerdaten#

The default error data received by the Error Trigger is:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
[
	{
		"execution": {
			"id": "231",
			"url": "https://lma.example.com/execution/231",
			"retryOf": "34",
			"error": {
				"message": "Example Error Message",
				"stack": "Stacktrace"
			},
			"lastNodeExecuted": "Node With Error",
			"mode": "manual"
		},
		"workflow": {
			"id": "1",
			"name": "Example Workflow"
		}
	}
]

All information is always present, except:

  • execution.id: requires the execution to be saved in the database. Not present if the error is in the trigger node of the main workflow, as the workflow doesn't execute.
  • execution.url: requires the execution to be saved in the database. Not present if the error is in the trigger node of the main workflow, as the workflow doesn't execute.
  • execution.retryOf: only present when the execution is a retry of a failed execution.

If the error is caused by the trigger node of the main workflow, rather than a later stage, the data sent to the error workflow is different. There's less information in execution{} and more in trigger{}:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "trigger": {
    "error": {
      "context": {},
      "name": "WorkflowActivationError",
      "cause": {
        "message": "",
        "stack": ""
      },
      "timestamp": 1654609328787,
      "message": "",
      "node": {
        . . . 
      }
    },
    "mode": "trigger"
  },
  "workflow": {
    "id": "",
    "name": ""
  }
}

Verursachen Sie einen Workflow-Ausführungsfehler mit Stop And Error#

Wenn Sie einen Fehler-Workflow erstellen und festlegen, führt Localmind Automate diesen aus, wenn eine Ausführung fehlschlägt. Normalerweise liegt dies an Dingen wie Fehlern in den Knoteneinstellungen oder daran, dass der Workflow nicht mehr genügend Speicher hat.

Sie können den Knoten Stop And Error zu Ihrem Workflow hinzufügen, um zu erzwingen, dass Ausführungen unter Ihren gewählten Umständen fehlschlagen, und den Fehler-Workflow auslösen.