SuitsDocs
레퍼런스노드 레퍼런스액션액션데이터데이터

행 조회

조건에 맞는 행을 검색하여 후속 액션에서 사용합니다.

개요

항목내용
카테고리데이터
대상데이터모델
출력조회된 행 목록

설정 옵션

옵션설명필수
데이터모델조회할 데이터모델
조건필터 조건
정렬결과 정렬 방식
제한최대 조회 개수

조건 설정

단일 조건

상태 = "진행중"

복합 조건

(상태 = "진행중") AND (담당자 = {{trigger.row.담당자}})

날짜 조건

마감일 < {{today}}
생성일 >= {{today - 7일}}

관계 조건

고객 = {{trigger.row.고객}}

정렬 및 제한

정렬

정렬: 생성일 DESC (최신순)
정렬: 우선순위 ASC, 마감일 ASC

제한

제한: 10 (최대 10개)
제한: 1 (첫 번째 행만)

출력 데이터

{{actions.query.rows}}           // 조회된 행 배열
{{actions.query.rows[0]}}        // 첫 번째 행
{{actions.query.rows[0].id}}     // 첫 번째 행의 ID
{{actions.query.count}}          // 조회된 행 개수

활용 예시

관련 데이터 조회

트리거: 고객 행 생성
액션 1: 행 조회
├── 데이터모델: 계약
├── 조건: 고객 = {{trigger.row.id}}
└── 정렬: 계약일 DESC
액션 2: 슬랙 메시지
└── 메시지: "이전 계약 {{actions.query.count}}건"

미완료 항목 리마인더

트리거: 일정 (매일 오전 9시)
액션 1: 행 조회
├── 데이터모델: 태스크
├── 조건: 상태 = "진행중" AND 마감일 = {{today}}
액션 2: 반복 ({{actions.query.rows}})
액션 3: 슬랙 메시지 (담당자에게 리마인더)

리포트 생성

트리거: 일정 (매주 월요일)
액션 1: 행 조회
├── 데이터모델: 매출
├── 조건: 날짜 >= {{지난주 월요일}} AND 날짜 <= {{지난주 일요일}}
액션 2: 코드 (합계 계산)
└── return { total: rows.reduce((sum, r) => sum + r.금액, 0) }
액션 3: 슬랙 메시지
└── 메시지: "지난주 매출: {{actions.code.total}}원"

중복 체크

트리거: 웹훅 (외부 주문)
액션 1: 행 조회
├── 데이터모델: 주문
├── 조건: 외부주문번호 = {{trigger.body.orderId}}
└── 제한: 1
액션 2: 조건 분기
├── If: {{actions.query.count}} = 0
│   └── 행 생성 (새 주문)
└── Else: (이미 존재, 스킵)

모범 사례

성능 최적화

  • 필요한 조건만 사용하여 결과를 좁히세요
  • 제한을 설정하여 불필요한 데이터 로드를 피하세요
  • 자주 조회하는 조건은 로 만들어 두세요

결과 없음 처리

조회 결과가 없을 수 있으므로 조건 분기로 처리하세요.

If: {{actions.query.count}} > 0
  → 후속 액션 실행
Else:
  → 대체 액션 또는 종료

대량 데이터 주의

조회 결과가 많을 경우 반복(Loop) 액션과 함께 사용하세요.