TRIGGER
Basic trigger
Generatoes bundles with their own structure
Basic trigger는 고유한 구조를 가진 번들(bundles)을 생성하는 기본 트리거 도구 입니다.
이 트리거는 외부 이벤트 없이도 시작 조건에 따라 직접 번들을 만들어 시나리오 실행을 유도합니다.
사용 예시:
•
특정 시간마다 고정된 데이터를 테스트용으로 흘려보내고 싶을 때
•
다른 시나리오로부터 데이터를 받지 않고, 직접 데이터를 입력하여 시나리오를 수동 실행하고 싶을 때
•
예: 매일 아침 9시에 “Good morning!” 메시지를 슬랙으로 보내는 자동화 만들기
→ Basic trigger에서 "message": "Good morning!" 번들을 생성하여 시작
ACTIONS
Get multiple variables
Get values of a previously stored variables.
이전에 Variables 도구로 저장해 둔 여러 변수들의 값을 한 번에 가져오는 기능 입니다.
즉, 시나리오 실행 중에 저장해둔 값들을 나중에 다시 꺼내 쓰고 싶을 때 사용합니다.
저장된 변수는 시나리오 실행이 끝나면 사라지는 임시 데이터입니다.
사용 예시:
•
여러 개의 변수(예: name, email, userId)를 저장해 놓고, 나중에 한꺼번에 불러와서 이메일을 보내거나 데이터를 가공하고 싶을 때
•
예: 사용자가 입력한 정보를 저장해 놓고, 시나리오 후반부에서 그 정보를 기반으로 맞춤 메시지를 생성할 경우
예시 흐름:
Get variable
Get values of a previously stored variables.
이 액션은 시나리오 실행 중에 이전에 저장된 단일 변수의 값을 가져오는 기능입니다.
Set variable 모듈로 저장한 변수 중 하나만 선택하여 불러올 수 있습니다.
저장된 변수는 시나리오 실행이 끝나면 사라지는 임시 데이터입니다.
사용 예시:
예를 들어, 사용자의 이름을 name이라는 변수에 저장해두고,
시나리오 후반에서 Get variable을 사용하여 이 값을 불러온 뒤
“{{name}}님, 환영합니다!”라는 문구를 생성할 수 있습니다.
예시 시나리오:
만약 이전 모듈 연결 없이 사용하려는 경우 ‘… You need to connect it to the scenario flow’
Increment function
Returns a value of 1 after first run. Every subsequent run will increment the returned value by 1.
이 함수는 시나리오가 처음 실행될 때 1을 반환하며, 이후 실행될 때마다 반환되는 값이 1씩 증가합니다.
즉, 시나리오가 실행될 때마다 카운터처럼 작동하는 기능입니다.
이 함수는 시나리오별로 고유한 값을 유지합니다
사용 예시:
•
특정 작업이 몇 번 수행되었는지 추적하고 싶을 때
•
고유한 순번(ID)을 부여하고 싶을 때
•
테스트 시나리오에서 반복 횟수를 확인하고자 할 때
예시 시나리오:
Set multiple variables
Sets the value of multiple variables.
이 액션은 여러 개의 변수를 한 번에 저장(설정) 하는 기능입니다.
변수 이름과 값을 각각 지정하여 시나리오 실행 중 사용할 수 있도록 설정합니다.
사용 예시:
•
사용자 입력값(이름, 이메일, 전화번호 등)을 변수로 저장하고 이후 단계에서 재사용할 때
•
API에서 받은 여러 필드를 따로 저장해, 이후 조건 분기나 메시지 생성 등에 활용할 때
예시 시나리오:
Set variable
Sets the value of the variable.
이 액션은 하나의 변수에 값을 저장(설정)하는 기능입니다.
저장된 변수는 이후 시나리오 단계에서 불러와 사용할 수 있습니다.
사용 예시:
•
사용자 입력값 또는 모듈 출력값을 저장하여 후속 모듈에서 재사용할 때
•
조건 분기나 텍스트 메시지 생성 시 중복 계산을 줄이고, 데이터를 간편하게 다루기 위해 사용합니다.
예시 시나리오:
Sleep
Delays execution for a specified period of time.
이 액션은 시나리오 실행을 지정한 시간만큼 일시 중지(지연)합니다.
초(seconds), 분(minutes), 밀리초(milliseconds) 단위로 지연 시간을 설정할 수 있습니다.
사용 예시:
•
외부 API 호출 간 요청 제한(rate limit)을 피하기 위해 시간 간격을 둘 때
•
사용자에게 메시지를 전송한 후 일정 시간 기다렸다가 후속 메시지를 보내는 시나리오를 만들 때
•
두 작업 사이의 간격을 두어 순차적으로 처리되도록 할 때
예시 시나리오:
AGGREGATORS
Numeric aggregator
Applies the aggregate function to selected rows.
이 액션은 숫자 데이터가 포함된 여러 행(row)에 대해 집계 함수(aggregate function)를 적용하는 기능입니다.
합계, 평균, 최댓값, 최솟값 등과 같은 수학적 연산을 통해 데이터를 요약할 수 있습니다.
사용 예시:
•
구글 시트에서 가져온 매출 데이터를 기반으로 일일 총 매출 합계를 계산할 때
•
설문 결과에서 응답 수치의 평균값을 구하고 싶을 때
•
여러 주문의 금액 중 가장 큰 주문 값을 확인할 때
예시 시나리오:
Table aggregator
Aggregates selected values into a table.
이 액션은 여러 번들에서 선택한 필드 값들을 하나의 테이블(표) 형식으로 집계합니다.
각 번들의 특정 필드를 모아 한 줄(row)씩 구성된 테이블 데이터를 생성할 수 있습니다.
결과는 JSON 형식의 테이블 구조로 제공됩니다.
사용 예시:
•
여러 건의 주문 데이터를 표 형태로 묶어서 슬랙 메시지나 이메일에 삽입할 때
•
API 결과(예: 사용자 목록, 제품 정보 등)를 테이블로 구성하여 보고서 형식으로 만들고 싶을 때
•
Google Docs, Notion 등과 연결하여 정리된 표 데이터를 자동 기록할 때
예시 시나리오:
Text aggregator
Aggregates multiple strings into one text.
이 액션은 여러 번들에서 가져온 문자열(String)들을 하나의 텍스트로 합치는 기능입니다.
각 번들의 특정 텍스트 값을 모아 하나의 긴 문자열 또는 문단으로 결합할 수 있습니다.
사용 예시:
•
여러 사용자의 피드백을 한 번에 모아 요약 메시지로 만들고 싶을 때
•
반복된 데이터(예: 이름 목록, 알림 내용 등)를 한 줄 또는 여러 줄로 합쳐서 출력하고 싶을 때
•
여러 문장을 연결하여 이메일, 노션, 슬랙 등으로 보낼 최종 메시지 구성용으로 활용할 때
예시 시나리오:
TRANSFORMERS
Compose a string
Composes a string for easier mapping of scenarios.
이 액션은 여러 값(텍스트, 숫자, 변수 등)을 조합하여 하나의 문자열(String)을 생성하는 기능입니다.
시나리오에서 복잡한 텍스트 출력을 만들거나, 다양한 데이터를 하나의 메시지로 통합할 때 사용됩니다.
사용 예시:
•
사용자에게 보낼 안내 메시지를 만들 때, 변수와 고정 텍스트를 조합하여 자연스러운 문장을 구성하고 싶을 때
•
이메일 제목이나 메시지 본문을 동적으로 구성할 때
•
파일 이름, 경로, 태그 등을 동적으로 생성해야 할 때
예시 시나리오:
Convert the encoding of a text
Converts a text from one codepage to another.
이 액션은 문자열의 문자 인코딩을 한 형식에서 다른 형식으로 변환하는 기능입니다.
예를 들어, 텍스트 데이터를 UTF-8에서 ISO-8859-1, 또는
Windows-1252에서 UTF-8로 변환할 수 있습니다.
사용 예시:
•
외부 시스템(API, FTP 등)에서 받은 텍스트가 깨져서 보일 때, 정확한 인코딩으로 변환하여 문제를 해결하고 싶을 때
•
CSV, XML, TXT 등 파일을 생성하거나 전송할 때, 상대 시스템에서 요구하는 특정 인코딩 형식으로 맞추기 위해
•
레거시 시스템(구버전 소프트웨어)과 연동 시, 한글이나 특수문자가 깨지지 않도록 인코딩을 조정해야 할 때
예시 시나리오:
Switch
Switches the output based on the input.
이 액션은 입력값(input)에 따라 서로 다른 출력을 반환하는 기능입니다.
즉, 조건에 따라 분기 처리를 할 수 있도록 도와주는 일종의 "다중 조건 선택문"입니다.
프로그래밍의 switch-case 구조와 유사하게 동작합니다.
사용 예시:
•
특정 키워드나 상태값에 따라 다른 메시지를 보여주거나,
다른 경로로 시나리오를 흐르게 하고 싶을 때
•
국가 코드, 언어, 주문 상태 등에 따라 다양한 출력값을 정의해야 할 때
•
고객의 등급(일반, VIP, 신규)에 따라 개별 메시지를 전송하고 싶을 때
예시 시나리오: