Fail 워크플로 상태

상태 관리 및 데이터 변환

변수를 사용하여 상태 간 데이터 전달과 JSONata를 사용하여 데이터 변환에 대해 알아봅니다.

Fail 상태("Type": "Fail")는 Catch 블록에서 포착하지 않는 한 상태 시스템 실행을 중지하고 이를 실패로 표시합니다.

Fail 상태를 통해 공통 상태 필드 집합의 Type 및 Comment 필드만 사용할 수 있습니다. 또한 Fail 상태는 다음 필드를 허용합니다.

Cause(선택 사항)

오류 원인을 설명하는 사용자 지정 문자열입니다. 운영 또는 진단 목적으로 이 필드를 지정할 수 있습니다.

JSONata 상태에서는 JSONata 표현식을 지정할 수도 있습니다.

CausePath (선택 사항, JSONPath만 해당)

참조 경로를 사용하여 상태 입력에서 동적으로 오류 원인에 대한 자세한 설명을 제공하려면 CausePath를 사용하세요. 해결되면 참조 경로에서 문자열 값이 포함된 필드를 선택해야 합니다.

문자열을 반환하는 내장 함수를 사용하여 CausePath를 지정할 수도 있습니다. 이러한 내장 함수는 States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash 및 States.UUID입니다.

중요

• Cause 또는 CausePath를 지정할 수 있지만 Fail 상태 정의에서는 둘 다 지정할 수 없습니다.

• 정보 보안 모범 사례로 민감한 정보나 내부 시스템 세부 정보 모두 원인 설명에서 제거하는 것이 좋습니다.

Error(선택 사항)

Retry 또는 Catch 필드를 사용하여 오류를 처리하도록 제공할 수 있는 오류 이름입니다. 운영 또는 진단 목적으로 오류 이름을 제공할 수도 있습니다.

JSONata 상태에서는 JSONata 표현식을 지정할 수도 있습니다.

ErrorPath (선택 사항, JSONPath만 해당)

참조 경로를 사용하여 상태 입력에서 동적으로 오류 이름을 제공하려면 ErrorPath를 사용하세요. 해결되면 참조 경로에서 문자열 값이 포함된 필드를 선택해야 합니다.

문자열을 반환하는 내장 함수를 사용하여 ErrorPath를 지정할 수도 있습니다. 이러한 내장 함수는 States.Format, States.JsonToString, States.ArrayGetItem, States.Base64Encode, States.Base64Decode, States.Hash 및 States.UUID입니다.

중요

• Error 또는 ErrorPath를 지정할 수 있지만 Fail 상태 정의에서는 둘 다 지정할 수 없습니다.

• 정보 보안 모범 사례로 민감한 정보나 내부 시스템 세부 정보 모두 오류 이름에서 제거하는 것이 좋습니다.

Fail 상태는 항상 상태 시스템을 종료하므로 Next 필드가 없으며 End 필드도 필요하지 않습니다.

Fail 상태 정의 예제

다음 Fail 상태 정의 예제에서는 정적 Error 및 Cause 필드 값을 지정합니다.

"FailState": {
  "Type": "Fail",
  "Cause": "Invalid response.",
  "Error": "ErrorA"
}

다음 Fail 상태 정의 예제에서는 참조 경로를 동적으로 사용하여 Error 및 Cause 필드 값을 확인합니다.

"FailState": {
  "Type": "Fail",
  "CausePath": "$.Cause",
  "ErrorPath": "$.Error"
}

다음 Fail 상태 정의 예제에서는 States.Format 내장 함수를 사용하여 Error 및 Cause 필드 값을 동적으로 지정합니다.

"FailState": {
  "Type": "Fail",
  "CausePath": "States.Format('This is a custom error message for {}, caused by {}.', $.Error, $.Cause)",
  "ErrorPath": "States.Format('{}', $.Error)"
}