SuitsDocs
Blocks

선택 처리 블록

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

활용 예시

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

생성 방법

방법입력
슬래시 명령어/select 또는 /선택 또는 /pos

화면 구성

선택 처리 블록은 크게 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. 가격 필드 - 가격 표시 필드 선택 (선택사항)

표시 방식

방식설명적합한 상황
카드형 (tile)카드 형태로 나열이미지가 있는 상품
목록형 (table)테이블 형태로 표시상세 정보가 많은 항목

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

데이터 타입으로는 tile, list, dropdown, search 4가지 표시 스타일이 정의되어 있지만, 현재 설정 UI에서는 카드형(tile)과 목록형(table)을 선택할 수 있습니다.


2. 합계 계산

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

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

3. 처리 실행

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

처리 방식

방식식별자사용 예시
워크플로우 실행workflow결제 처리, 알림 발송
API 호출apiPG사 연동, 외부 서비스
데이터 생성data_create주문 내역 저장
데이터 수정data_update재고 차감, 상태 변경
커스텀custom사용자 정의 액션

버튼 설정

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

사용하기

항목 선택

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

수량 조정

선택된 항목 패널에서:

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

처리 실행

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

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


워크플로우 연동

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

전달되는 데이터

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

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

활용 예시

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

[워크플로우 시작]

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

[PG사 결제 API 호출]

[결제 완료 알림]

팁과 주의사항

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

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

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


다음 단계