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

일정 트리거

지정한 시간에 정기적으로 워크플로우를 실행합니다.

개요

항목내용
실행 방식시간 기반 자동 실행
설정 방식간격, 특정 시간, CRON
입력 데이터실행 시점 정보

설정 옵션

간격 실행

옵션설명예시
N초마다초 단위 반복매 30초
N분마다분 단위 반복매 30분
N시간마다시간 단위 반복매 2시간
N일마다일 단위 반복매 3일

특정 시간

옵션설명예시
시간매일 특정 시간 (0-23시)매일 오전 9시
특정 분 (0-59분)9시 30분
요일실행할 요일 선택 (복수 선택 가능)월,수,금

CRON 표현식

고급 스케줄링을 위해 CRON 표현식을 직접 입력할 수 있습니다.

형식

┌───────────── 분 (0-59)
│ ┌─────────── 시 (0-23)
│ │ ┌───────── 일 (1-31)
│ │ │ ┌─────── 월 (1-12)
│ │ │ │ ┌───── 요일 (0-6, 일요일=0)
│ │ │ │ │
* * * * *

예시

CRON의미
0 9 * * *매일 오전 9시
0 9 * * 1-5평일(월~금) 오전 9시
0 0 1 * *매월 1일 자정
*/30 * * * *30분마다
0 9,18 * * *매일 오전 9시, 오후 6시
0 10 * * 1매주 월요일 오전 10시

특수 문자

문자의미예시
*모든 값* * * * * (매분)
,여러 값0,30 * * * * (0분, 30분)
-범위1-5 (월~금)
/간격*/15 (15분마다)

출력 데이터

// 실행 시점 정보
{{trigger.timestamp}}      // 실행 시각
{{trigger.scheduledTime}}  // 예정된 시각

활용 예시

일일 리포트

트리거: 매일 오전 9시
액션:
├── 전일 매출 데이터 조회
├── 리포트 생성
└── 팀 채널에 공유

주간 정리

트리거: 매주 월요일 오전 9시
액션:
├── 미완료 태스크 조회
├── 담당자별 리마인더 발송
└── 주간 현황 리포트 생성

월간 청구

트리거: 매월 1일 오전 10시
액션:
├── 청구 대상 고객 조회
├── 세금계산서 발행
└── 청구 이메일 발송

모범 사례

타임존 주의: 타임존을 직접 설정할 수 있습니다. 지원 타임존: 서울 (KST), UTC, 도쿄 (JST), 로스앤젤레스 (PST), 뉴욕 (EST), 런던 (GMT). 기본값은 서울 (KST)입니다.

피크 시간 피하기

많은 스케줄이 정각에 몰리지 않도록 분산하세요.

❌ 0 9 * * *     (정각)
✅ 5 9 * * *     (9시 5분)

재시도 고려

일정 트리거는 놓친 실행을 자동 재시도하지 않습니다. 중요한 작업은 실패 알림을 설정하세요.