SuitsDocs
콘텐츠워크플로우

승인 프로세스

워크플로우 실행 중 사람의 승인을 거쳐 다음 단계를 진행하세요.

승인 프로세스란

승인 프로세스는 워크플로우 실행 중 사람의 판단이 필요한 지점에서 실행을 일시정지하고, 지정된 승인자가 승인 또는 거부한 뒤 결과에 따라 워크플로우를 재개하는 기능입니다.

트리거: 구매 요청 접수

액션: 견적 데이터 조회

승인 대기: 팀장 승인 요청       ← 워크플로우 일시정지
  ↓ (승인됨)
액션: 발주서 생성 + 슬랙 알림

승인 프로세스를 사용하면 자동화와 사람의 의사결정을 자연스럽게 결합할 수 있습니다.


승인 정책 설정

승인 정책은 누가, 어떤 조건으로 승인하는지를 미리 정의해두는 템플릿입니다. 한번 만들어두면 여러 워크플로우에서 재사용할 수 있습니다.

승인 정책 관리 위치

워크스페이스 설정 > 승인 정책 메뉴에서 관리합니다. 정책 생성, 수정, 삭제는 ADMIN 이상 권한이 필요합니다.

승인 방식

승인 정책은 두 가지 방식을 지원합니다.

방식설명적합한 상황
한 번에 승인 (parallel)모든 승인자에게 동시에 요청을 보냅니다.빠른 처리가 필요할 때
차례대로 승인 (sequential)단계별로 순서대로 승인을 진행합니다.계층적 결재가 필요할 때

승인 조건

조건설명
1명 이상 승인 (any_one)승인자 중 1명만 승인하면 완료됩니다. 모든 승인자가 거부해야 최종 거부됩니다.
전원 승인 (all)모든 승인자가 승인해야 완료됩니다. 1명이라도 거부하면 즉시 거부됩니다.

정책 생성 항목

항목필수설명
정책 이름O예: "팀장 승인", "구매 결재"
설명X정책에 대한 부가 설명
승인 방식O한 번에 승인 / 차례대로 승인
승인자O워크스페이스 멤버 중 선택
승인 조건O1명 이상 승인 / 전원 승인
승인 기한 (시간)X비워두면 기한 없이 대기합니다. 초과 시 자동 만료 처리됩니다.

차례대로 승인 (sequential) 설정

차례대로 승인 방식을 선택하면 승인 단계를 추가할 수 있습니다. 최소 2단계가 필요합니다.

각 단계별로 다음을 설정합니다.

항목설명
단계 이름예: "팀장 승인", "부서장 승인", "최종 승인"
승인자해당 단계의 승인자
승인 조건해당 단계의 승인 조건 (1명 이상 / 전원)
기한 (시간)해당 단계의 승인 기한 (선택)

차례대로 승인에서는 이전 단계가 승인 완료되어야 다음 단계 승인자에게 요청이 전달됩니다. 어느 단계에서든 거부되면 전체 승인 요청이 즉시 거부됩니다.


승인 대기 노드 사용법

워크플로우 편집 화면에서 승인 대기 노드를 추가하여 승인 프로세스를 구성합니다.

노드 설정 항목

항목설명기본값
승인 정책미리 만들어둔 승인 정책을 선택합니다. 선택하지 않으면 승인자를 직접 지정합니다.(없음)
승인자 (userId)정책을 선택하지 않았을 때, 승인자 userId를 콤마로 구분하여 입력합니다. 표현식을 지원합니다.(빈 값)
기한 (시간)승인 기한입니다. 초과 시 자동 만료 처리됩니다.48
승인자에게 전달할 메시지승인 요청과 함께 전달할 메시지입니다. 표현식을 지원합니다.(빈 값)
거부 시 워크플로우 중단승인이 거부되었을 때 워크플로우를 중단할지 여부입니다.켜짐

승인 정책을 사용하면 승인자와 조건을 중앙에서 관리할 수 있어 편리합니다. 정책 없이 직접 승인자를 지정할 수도 있습니다.

승인 결과 데이터

승인이 완료되면 다음 노드에서 승인 결과를 사용할 수 있습니다.

필드설명
decision승인 결과: APPROVED 또는 REJECTED
actorId승인/거부한 사용자 ID
comment승인자가 남긴 코멘트 (선택 입력)
approvalRequestId승인 요청 고유 ID

승인 요청 알림과 승인 카드

알림 수신

승인 대기 노드가 실행되면 지정된 승인자에게 인앱 알림이 전송됩니다.

  • 알림 카테고리: approval_requested
  • 알림 제목: "승인 요청: [노드 이름]"
  • 차례대로 승인의 경우: "승인 요청 (1/3단계: 팀장 승인): [노드 이름]" 형태로 현재 단계 정보가 포함됩니다.

승인 카드 UI

알림 목록에서 승인 요청 알림을 확인하면, 알림 내부에 승인 카드가 인라인으로 표시됩니다. 승인 카드에서 바로 승인 또는 거부를 처리할 수 있습니다.

승인 카드에서 제공하는 기능:

기능설명
승인 버튼승인을 처리합니다.
거부 버튼거부를 처리합니다.
코멘트승인/거부 시 코멘트를 남길 수 있습니다. (선택)

차례대로 승인의 경우, 승인 카드에 현재 단계 정보(예: "1/3단계")가 표시됩니다.


승인/거부 처리 후 워크플로우 재개

승인된 경우

  • 워크플로우가 승인 대기 노드의 다음 노드부터 자동으로 재개됩니다.
  • 승인 결과 데이터(decision, actorId, comment)가 다음 노드의 입력 데이터로 전달됩니다.

거부된 경우

  • "거부 시 워크플로우 중단"이 켜져 있으면: 워크플로우가 실패 상태로 종료됩니다.
  • "거부 시 워크플로우 중단"이 꺼져 있으면: 거부 결과와 함께 워크플로우가 다음 노드로 재개됩니다. 이후 노드에서 decision 값을 확인하여 분기 처리할 수 있습니다.

기한 초과

승인 기한이 지나면 해당 승인 요청은 자동으로 만료(EXPIRED) 처리됩니다.

워크플로우 실행 상태

승인 대기 중인 워크플로우는 waiting_approval 상태로 표시됩니다. 승인 또는 거부가 처리되면 running 상태로 전환되어 실행이 재개됩니다.


활용 예시

고액 구매 승인

트리거: 구매 요청 데이터 생성 시

조건: 금액이 100만원 이상인가?
  ├─ Yes → 승인 대기 (구매 결재 정책)
  │          ↓ (승인됨)
  │         발주서 자동 생성 + 알림
  └─ No  → 발주서 자동 생성 + 알림

콘텐츠 발행 승인

트리거: 콘텐츠 상태가 "검토 요청"으로 변경 시

승인 대기 (편집팀장 승인)
  ↓ (승인됨)
콘텐츠 상태를 "발행됨"으로 변경

SNS 자동 공유 + 팀 슬랙 알림

계층적 결재 (차례대로 승인)

트리거: 출장 신청서 제출 시

승인 대기 (출장 결재 정책 - 차례대로 승인)
  1단계: 팀장 승인
  2단계: 부서장 승인
  3단계: 경영지원팀 확인
  ↓ (전 단계 승인됨)
출장 일정 등록 + 담당자 알림