SuitsDocs
Blocks

선택 처리 블록

데이터를 선택하고 일괄 처리하는 인터랙티브 블록을 알아보세요.

활용 예시

시나리오설명
POS 판매상품 선택 → 수량 조정 → 결제 처리
PT 세션 정산회원 선택 → 세션 종류 선택 → 정산 완료
재료 발주재료 선택 → 수량 입력 → 발주 요청
이벤트 참가자참가자 선택 → 등록 유형 선택 → 등록 완료

생성 방법

방법입력
슬래시 명령어/selectprocess

화면 구성

선택 처리 블록은 크게 3개 영역으로 구성됩니다.

┌─────────────────────────────────────────────────────────────────┐
│  판매 처리                                                  [⚙️] │
├─────────────────────────────────────────────────────────────────┤
│  [대상 선택]  고객: 김철수 ▼                                     │
├───────────────────────────────────────┬─────────────────────────┤
│                                       │                         │
│  [상품 선택 영역]                       │  [선택된 항목]           │
│                                       │                         │
│  ┌────────┐ ┌────────┐ ┌────────┐    │  아메리카노    x1  ₩4,500 │
│  │ 아메리 │ │ 카페라 │ │ 카푸치 │    │  카페라떼      x2  ₩10,000│
│  │ 카노   │ │ 떼     │ │ 노     │    │                         │
│  │ ₩4,500│ │ ₩5,000│ │ ₩5,000│    │  ──────────────────     │
│  └────────┘ └────────┘ └────────┘    │  총계         ₩14,500  │
│                                       │                         │
│  ┌────────┐ ┌────────┐ ┌────────┐    │  [결제하기]              │
│  │ 녹차   │ │ 홍차   │ │ 주스   │    │                         │
│  │ ₩4,000│ │ ₩4,000│ │ ₩5,500│    │                         │
│  └────────┘ └────────┘ └────────┘    │                         │
│                                       │                         │
└───────────────────────────────────────┴─────────────────────────┘
영역설명
대상 선택고객, 회원 등 처리 대상을 선택하는 드롭다운
상품 선택상품, 서비스 등 메인 항목을 선택하는 영역
선택된 항목장바구니처럼 선택한 항목과 총계 표시

설정하기

블록 우측 상단의 설정 버튼(⚙️)을 클릭하면 설정 패널이 열립니다.

1. 데이터 선택

선택할 데이터를 단계별로 설정합니다.

단계 추가

+ 데이터 추가 버튼을 클릭하여 새 선택 단계를 추가합니다.

역할 설정

각 단계의 역할을 지정합니다.

역할설명표시 방식
상품 선택판매할 상품, 서비스 등 메인 항목카드형/목록형
대상 선택고객, 회원 등 처리 대상드롭다운
추가 옵션할인, 쿠폰 등 부가 설정카드형/드롭다운

데이터 연결

선택 단계를 데이터모델과 연결합니다.

  1. 데이터 항목에서 데이터모델 선택
  2. 제목 필드 - 항목 이름으로 표시할 필드 선택
  3. 이미지 필드 - 썸네일 이미지 필드 선택 (선택사항)
  4. 가격 필드 - 가격 표시 필드 선택 (선택사항)

표시 방식

방식설명적합한 상황
카드형카드 형태로 나열이미지가 있는 상품
목록형테이블 형태로 표시상세 정보가 많은 항목
드롭다운선택 목록대상 선택 (고객, 회원)

카드형에서는 열 수(2~5열)와 카드 크기(작게/보통/크게)를 조정할 수 있습니다.


2. 합계 계산

선택한 항목들의 합계를 자동 계산합니다.

설정설명
계산할 데이터합계를 계산할 단계 선택
계산할 필드합산할 필드 (예: 가격)
계산 방식합계, 평균, 개수, 최소, 최대
표시 단위원(₩), 달러($), 유로(€) 등

3. 처리 실행

선택 완료 후 실행할 동작을 설정합니다.

처리 방식

방식설명사용 예시
워크플로우 실행설정된 워크플로우 실행결제 처리, 알림 발송
데이터 생성새 데이터 레코드 생성주문 내역 저장
데이터 수정기존 데이터 업데이트재고 차감, 상태 변경
API 호출외부 시스템 연동PG사 연동, 외부 서비스

버튼 설정

설정설명
버튼 텍스트실행 버튼에 표시할 텍스트 (예: 결제하기, 등록완료)
확인 메시지실행 전 확인 팝업 메시지 (비워두면 바로 실행)

사용하기

항목 선택

  1. 대상 선택: 드롭다운에서 고객/회원 선택 (설정된 경우)
  2. 상품 클릭: 카드를 클릭하여 항목 추가
  3. 반복 클릭: 같은 항목을 다시 클릭하면 수량 증가

수량 조정

선택된 항목 패널에서:

  • + / - 버튼: 수량 1씩 증가/감소
  • 휴지통 아이콘: 항목 제거

처리 실행

  1. 원하는 항목 모두 선택
  2. 총계 확인
  3. 처리 버튼(예: 결제하기) 클릭
  4. 확인 메시지가 설정된 경우 확인 후 실행

처리 완료 후 설정에 따라 선택이 자동으로 초기화되거나 특정 페이지로 이동할 수 있습니다.


워크플로우 연동

선택 처리 블록은 워크플로우와 연동하여 복잡한 업무를 자동화할 수 있습니다.

전달되는 데이터

워크플로우로 전달되는 정보:

데이터설명
selectedItems선택된 항목 배열 (항목ID, 수량, 가격 등)
contextSelections대상 선택 정보 (고객, 회원 등)
aggregatedTotal계산된 총합계

활용 예시

[선택 처리 블록에서 결제 실행]

[워크플로우 시작]

[주문 데이터 생성] → [재고 차감] → [영수증 이메일 발송]

[PG사 결제 API 호출]

[결제 완료 알림]

팁과 주의사항

검색 기능: 상품이 많을 경우 상단 검색창에서 이름이나 키워드로 검색할 수 있습니다.

필수 선택: 단계가 '필수'로 설정된 경우, 해당 단계에서 항목을 선택해야 처리 버튼이 활성화됩니다.

실시간 동기화: 데이터모델의 변경 사항(가격 변경, 신규 상품 등)은 블록에 실시간으로 반영됩니다.


다음 단계