플로우 오류 핸들러

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기4분
  • 플로우가 오류를 포착할 수 있도록 합니다. 일련의 작업 및 하위 플로우를 실행하여 문제를 식별하고 수정합니다. 예를 들어 플로우가 출력 값을 기록하고, 알림을 보내고, 오류 발생 시 시정 하위 플로우를 실행하도록 할 수 있습니다.

    복지

    이러한 이점을 얻으려면 플로우 오류 핸들러를 활성화합니다.
    • 플로우 오류가 발생할 때 식별을 자동화합니다. 플로우 오류로 인해 발생한 문제를 수동으로 검색하는 대신 플로우 오류 정보를 캡처하고 푸시합니다.
    • 플로우 오류 해결을 자동화합니다. 플로우 오류의 영향을 받는 기록을 수동으로 업데이트하는 대신 작업 및 하위 플로우를 실행하여 기록을 업데이트합니다.
    • 고유한 작업 오류 처리 논리를 빌드합니다. 작업이 항상 오류를 반환하는 대신 오류를 반환하는 시기를 지정합니다.

    오류 핸들러 구성요소

    그림 1. 오류 핸들러 사용자 인터페이스 구성요소
    오류 핸들러가 활성화된 샘플 플로우. 오류 핸들러 섹션에는 로그 및 이메일 보내기 작업이 있습니다.
    플로우 오류 처리는 이러한 구성 요소로 구성됩니다.
    1. 오류 핸들러 스위치
    플로우 오류 처리를 활성화하거나 비활성화하는 옵션입니다. 활성화하면 플로우에 오류 핸들러 섹션이 표시됩니다.
    2. 오류 핸들러 섹션
    플로우에서 오류가 발생할 때 실행되는 플로우 섹션입니다. 이 섹션을 사용하여 플로우 오류의 식별 및 해결을 자동화합니다. 이 섹션에서 최대 10개의 항목을 추가할 수 있습니다.
    주:
    10개 항목 제한에는 작업, 플로우 로직 또는 하위 플로우의 조합이 포함됩니다.
    3. 오류 상태
    플로우에서 발견한 오류에 대한 세부 정보가 포함된 객체 데이터 정제입니다.
    4. 오류 상태 > 코드
    플로우에서 오류가 발생했는지 여부를 나타내는 정수 데이터 정제입니다. 기본적으로 값 1은 플로우에서 오류가 발생했음을 나타냅니다. 값이 0이면 플로우가 성공적으로 실행되었음을 나타냅니다. 사용자 지정 작업을 생성할 때 오류 코드를 직접 정의할 수 있습니다.
    5. 오류 상태 > 메시지
    작업, 단계 또는 시스템 운영에 의해 생성된 오류 메시지가 포함된 문자열 데이터 알약입니다.

    사용 가능한 오류 상태

    오류 핸들러를 활성화하면 플로우 실행 세부 정보에 보고된 상태가 변경됩니다. 오류 핸들러는 이러한 플로우 상태를 생성할 수 있습니다.

    완료됨(오류 적방)
    플로우에서 오류가 발견되고 이벤트 핸들러 섹션의 항목을 성공적으로 실행했을 때 상태가 생성됩니다. 이벤트 핸들러 섹션이 비어 있는 경우에도 플로우에서 이 상태가 생성됩니다. 이 상태는 플로우 오류 핸들러를 활성화한 경우에만 사용할 수 있습니다. 이 상태는 플로우 실행 상세 정보 페이지에서만 볼 수 있습니다. 플로우 컨텍스트 기록에는 상태가 완료로 표시됩니다.
    완료(오류 건너뜀)
    단계 실패 후에도 사용자 지정 작업이 계속 실행될 때 작성되는 상태입니다. 작업이 이 상태를 생성하면 상위 플로우로 전달됩니다. 이 상태는 플로우 오류 핸들러를 활성화한 경우에만 사용할 수 있습니다. 이 상태는 플로우 실행 상세 정보 페이지에서만 볼 수 있습니다. 플로우 컨텍스트 기록에는 상태가 완료로 표시됩니다.
    오류
    오류가 발견되지 않은 상태로 유지될 때 작성되는 상태입니다.
    • 오류 핸들러가 비활성화되어 있는 동안 플로우에서 오류가 발생합니다.
    • 오류 핸들러 섹션에서 오류가 발생합니다.

    오류가 발생한 경우

    활성 오류 핸들러가 있는 플로우에서 오류가 발생하면 플로우는 추가 작업 및 플로우 로직 실행을 중지하고 대신 오류 핸들러 섹션의 항목을 실행합니다. 오류 핸들러 섹션의 항목이 실행되면 완료됨(오류 적방) 상태로 플로우가 중지됩니다. 오류 핸들러 자체에서 오류가 발생하면 플로우가 오류 상태로 중지됩니다.

    플로우는 오류를 생성한 항목을 다시 실행하거나 오류가 발생한 단계에서 다시 시작할 수 없습니다. 를 사용하여 플로우 로직 시도 try 블록 내에서 오류가 발생하는 플로우를 계속 실행할 수 있습니다.

    플로우 및 작업 오류 처리 자원

    일반 가이드라인

    다음과 같은 일반 지침을 준수하여 플로우 오류 처리에서 제공하는 이점을 얻을 수 있습니다.

    플로우의 메인 섹션에 오류 처리 항목 추가 방지
    일반적으로 작업 또는 하위 플로우가 메인 섹션에서 오류를 반환할 때 플로우의 실행이 중지됩니다. 중지된 플로우는 오류를 반환한 지점을 지나 작업 또는 하위 플로우를 실행할 수 없습니다. 오류 핸들러 섹션에 오류 처리 작업 및 하위 플로우를 추가하면 오류가 있을 때 실행됩니다.
    오류 상태 정보 캡처
    Error Status 객체에는 오류를 생성한 작업에 대한 정보가 포함되어 있습니다. 이 정보를 사용하여 오류의 원인을 식별하고 수정이 필요할 수 있는 데이터를 기록할 수 있습니다.
    하위 플로우 오류 메시지 억제
    하위 플로우에 오류 핸들러를 사용하여 오류가 상위 플로우로 계단식으로 전달되지 않도록 할 수 있습니다. 하위 플로우 오류 핸들러 섹션을 비워 두면 항상 완료됨(오류 적방) 상태가 생성됩니다.
    하위 플로우를 사용하여 10개 항목 제한 방지
    오류 처리 프로세스를 10개 항목 제한에 맞추지 말고 더 많은 항목을 포함할 수 있는 하위 플로우를 호출하십시오. 하위 플로우 출력을 사용하여 다른 플로우에서 자동화를 트리거할 수도 있습니다.
    하위 플로우를 사용하여 수정 작업 수행
    여러 플로우에서 동일한 작업 시퀀스를 다시 만드는 대신 재사용 가능한 하위 플로우를 생성하여 기록 데이터의 오류를 수정합니다. 플로우 오류로 인해 기록 데이터가 원치 않는 상태로 유지되는 경우 하위 플로우를 사용하여 이러한 기록을 수정합니다. 오류 핸들러를 사용하여 이러한 기록 데이터를 하위 플로우 출력으로 식별할 수 있습니다.