SuitsDocs
레퍼런스노드 레퍼런스트리거트리거

데이터 변경 트리거

데이터모델의 행이 생성/수정/삭제될 때 워크플로우를 실행합니다.

개요

항목내용
실행 방식데이터 변경 감지
이벤트생성, 수정, 삭제
입력 데이터변경된 행의 데이터

이벤트 종류

행 생성됨 (Row Created)

새 행이 추가될 때 실행됩니다.

트리거: 고객 데이터모델에 새 행 생성

액션: 환영 이메일 발송

출력 데이터

{{trigger.row}}           // 생성된 행 전체
{{trigger.row.고객명}}     // 특정 속성
{{trigger.row.id}}        // 행 ID
{{trigger.event}}         // "created"

행 수정됨 (Row Updated)

기존 행이 수정될 때 실행됩니다.

감지 옵션

옵션설명
모든 변경어떤 속성이든 변경되면 실행
특정 속성지정한 속성이 변경될 때만 실행

출력 데이터

{{trigger.row}}              // 현재 행 데이터
{{trigger.previousRow}}      // 변경 전 데이터
{{trigger.changedFields}}    // 변경된 속성 목록
{{trigger.event}}            // "updated"

예시: 상태 변경 감지

트리거: 태스크 데이터모델 - "상태" 속성 변경
조건: 새 값 = "완료"
액션:
├── 완료일 자동 기록
└── 담당자에게 알림

행 삭제됨 (Row Deleted)

행이 삭제될 때 실행됩니다.

출력 데이터

{{trigger.row}}           // 삭제된 행 데이터
{{trigger.row.id}}        // 삭제된 행 ID
{{trigger.event}}         // "deleted"

삭제된 행의 데이터는 트리거 실행 시점에만 사용 가능합니다. 이후 조회는 불가능합니다.


속성 조건 충족

특정 조건을 만족하게 될 때 실행됩니다.

트리거: 재고량 속성 변경
조건: 재고량 <= 최소재고량
액션:
├── 구매팀에 알림
└── 발주 요청 항목 생성

활용 예시

신규 고객 온보딩

트리거: 고객 데이터모델 - 행 생성
액션:
├── 환영 이메일 발송
├── 담당자에게 슬랙 알림
└── 온보딩 태스크 자동 생성

마감일 지연 감지

트리거: 태스크 - "마감일" 속성 변경
조건: 마감일 < 오늘 AND 상태 ≠ "완료"
액션:
├── 상태를 "지연"으로 변경
└── 담당자에게 리마인더

승인 프로세스

트리거: 결재 - "상태" 속성 변경
조건: 상태 = "승인"
액션:
├── 승인일, 승인자 기록
├── 요청자에게 알림
└── 다음 단계 생성

모범 사례

무한 루프 방지

워크플로우 액션이 같은 트리거를 다시 발생시키지 않도록 주의하세요.

❌ 트리거: 행 수정 → 액션: 같은 행 수정 (무한 루프!)
✅ 트리거: "상태" 변경 → 액션: "완료일" 수정 (다른 속성)

조건 명확히 하기

❌ 트리거: 모든 행 수정 (불필요한 실행 많음)
✅ 트리거: "상태" 속성 변경, 조건: 새 값 = "완료"

특정 속성만 감지

자주 변경되는 속성(조회수, 수정일 등)을 제외하고 핵심 속성만 감지하세요.