변수값 설정 노드에서 계산식 및 함수 사용하기

변수값 설정 노드에서는 변수값으로 간단한 계산식뿐만 아니라 다양한 함수를 지정할 수 있습니다. 이를 통해 유연하고 강력한 데이터 처리가 가능합니다.

사용 방법

1. 변수값 설정 노드 생성

  • 작업 흐름 내에서 변수값 설정 노드를 추가합니다.

2. 변수 추가

  • 노드의 설정 화면에서 변수 추가 버튼을 클릭합니다.

3. 대상 변수 지정

  • 추가된 변수의 대상 변수를 지정합니다.

4. 수식 형식 선택

  • 변수값 설정 방식을 수식으로 선택합니다.

5. 계산식 입력

  • 지정될 수식 필드에 원하는 계산식을 입력합니다.

위 예시에서 알 수 있듯이 계산식에는 변수도 포함시킬 수 있습니다. 사용할 수 있는 연산과 함수는 아래와 같습니다.

기본 연산

  1. 산술 연산자

    • 덧셈: +

    • 뺄셈: -

    • 곱셈: *

    • 나눗셈: /

    • 괄호 사용 가능: ( )

  2. 나머지 연산

    • 연산자: %

    • 예시:

      • 100 % 2 = 0

      • 100 % 8 = 4

  3. 거듭제곱 연산

    • 연산자: **

    • 예시:

      • 100 ** 2 = 10,000

함수

모든 함수는 함수명(값) 형식으로 사용합니다.

  1. 형 변환

    • to_number(값)

      • 문자열을 숫자로 변환합니다.

      • 예시: to_number('4') = 4

    • to_string(값)

      • 숫자를 문자열로 변환합니다.

      • 예시: to_string(7) = '7'

    • to_boolean(값)

      • 값을 불리언(True/False)으로 변환합니다.

      • 예시: to_boolean(1) = True

  2. 문자열 함수

    • length(값)

      • 문자열의 길이를 반환합니다.

      • 예시: length('abcde') = 5

  3. 수학 함수

    • abs(값)

      • 절대값을 반환합니다.

      • 예시: abs(-5) = 5

    • 삼각 함수:

      • sin(값), cos(값), tan(값)

      • 예시: tan(90) = 1

    • 반올림 관련 함수:

      • ceil(값) (올림)

      • floor(값) (버림)

      • round(값) (반올림)

      • 예시: floor(2.1) = 2

  4. 랜덤 함수

    • random()

      • 0과 1 사이의 랜덤한 수를 반환합니다.

      • 예시: random() = 0.5423

    • random_int(min, max)

      • minmax 사이의 랜덤한 정수를 반환합니다.

      • 예시: random_int(-1, 2) = -1, 0, 1, or 2

  5. 시간 관련 함수

    • unix_timestamp()

      • 현재 시간을 Unix Timestamp 형식으로 반환합니다.

      • 예시: unix_timestamp() = 1601672447


고급 함수

고급 함수는 주로 JSON 데이터와 문자열 목록 데이터를 처리하는 데 사용됩니다. 사용 시, 데이터 형식을 일관되게 유지해야 하며, 문자열을 값으로 사용할 경우 반드시 따옴표(‘ ’)를 사용하세요.

1. dict

  • 설명: 주어진 키-값 쌍을 사용하여 JSON 형식 데이터를 생성합니다. 동일한 키가 이미 존재하면 값을 덮어씁니다.

  • 형식: dict(키1, 값1, 키2, 값2, …)

  • 결과: JSON 형식

  • 예시:


2. dict_set

  • 설명: 기존 JSON 데이터에 새로운 키-값 쌍을 추가합니다. 동일한 키가 존재하면 값을 덮어씁니다.

  • 형식: dict_set(@JSON_변수, 키1, 값1, 키2, 값2, …)

  • 결과: JSON 형식

  • 예시:


3. dict_del

  • 설명: JSON 데이터에서 특정 키를 제거합니다.

  • 형식: dict_del(@JSON_변수, 키)

  • 결과: JSON 형식

  • 예시:


4. dict_update

  • 설명: 두 JSON 데이터를 병합합니다. 동일한 키가 존재할 경우, 뒤쪽 JSON 데이터의 값을 사용합니다.

  • 형식: dict_update(@JSON_변수1, @JSON_변수2)

  • 결과: JSON 형식

  • 예시:


5. json_loads

  • 설명: 문자열로 작성된 JSON 데이터를 JSON 형식 변수로 변환합니다.

  • 형식: json_loads(‘JSON_문자열’)

  • 결과: JSON 형식

  • 예시:


6. json_dumps

  • 설명: JSON 데이터를 문자열 형식으로 변환합니다.

  • 형식: json_dumps(@JSON_변수)

  • 결과: 문자열 형식

  • 예시:


7. list

  • 설명: 주어진 문자열을 이용해 문자열 목록을 생성합니다.

  • 형식: list(문자열1, 문자열2, …)

  • 결과: 문자열 목록

  • 예시:

8. list_append

  • 설명: 기존 문자열 목록에 새로운 문자열 값을 추가합니다.

  • 형식: list_append(@문자열_목록_변수, 문자열1, 문자열2, …)

  • 결과: 문자열 목록

  • 예시:


9. list_reverse

  • 설명: 문자열 목록 변수의 순서를 역순으로 변경합니다.

  • 형식: list_reverse(@문자열_목록_변수)

  • 결과: 문자열 목록

  • 예시:


10. get_by_json_path

  • 설명: JSON 변수에서 지정된 경로의 값을 추출합니다.

  • 형식: get_by_json_path(@JSON_변수, JSON_경로)

  • 결과: 문자열

  • 예시:


11. storage_set / storage_get

  • 설명: 특정 변수값을 지정된 키에 저장하거나 불러옵니다.

    • storage_set을 사용해 값을 저장합니다.

    • storage_get을 사용해 값을 불러옵니다. 프로젝트 전역에서 키 값을 공유하여 데이터를 관리할 수 있습니다.

  • 형식:

    • 저장: storage_set('키', @변수)

    • 불러오기: storage_get('키')

  • 결과: 저장된 변수 타입과 동일

  • 예시:

12. contains

  • 설명: 특정 문자열이 문자열 목록에 포함되어 있는지 확인합니다.

  • 형식: contains(@문자열_목록_변수, 문자열)

  • 결과: Boolean (True 또는 False)

  • 예시:


13. append

  • 설명: 문자열 목록에 새로운 문자열을 추가합니다.

  • 형식: append(@문자열_목록_변수, 문자열)

  • 결과: 문자열 목록

  • 예시:


14. unique

  • 설명: 문자열 목록에서 중복된 값을 제거합니다.

  • 형식: unique(@문자열_목록_변수)

  • 결과: 문자열 목록

  • 예시:


15. urlencode

  • 설명: JSON 형식을 URL 인코딩 형식으로 변환합니다.

  • 형식: urlencode(@JSON_변수)

  • 결과: 문자열

  • 예시:


16. urldecode

  • 설명: URL 인코딩 형식의 문자열을 JSON 형식으로 변환합니다.

  • 형식: urldecode(string)

  • 결과: 문자열 또는 JSON

  • 예시:


17. regex_sub / regex_isub

  • 설명: 정규표현식을 사용하여 문자열을 다른 값으로 대체합니다.

    • regex_sub: 대소문자를 구분.

    • regex_isub: 대소문자를 구분하지 않음.

  • 형식:

    • regex_sub(정규표현식_패턴, 문자열1, 문자열2)

    • regex_isub(정규표현식_패턴, 문자열1, 문자열2)

  • 결과: 문자열

  • 예시:


18. date_format

  • 설명: 날짜를 지정된 정규표현식 형태로 변환합니다.

  • 형식: date_format(정규표현식_날짜형식, 날짜)

  • 결과: 문자열

  • 예시:

20. date_add

  • 설명: 주어진 날짜에 숫자만큼 일(day)을 더합니다.

  • 형식: date_add(날짜, 숫자)

  • 결과: 날짜

  • 예시:


21. today

  • 설명: 오늘 날짜를 반환합니다.

  • 형식: today()

  • 결과: 날짜 또는 문자열

  • 예시:


22. first_day_of_month

  • 설명: 현재 달의 첫 번째 날짜를 반환합니다.

  • 형식: first_day_of_month()

  • 결과: 날짜 또는 문자열

  • 예시:


23. last_day_of_month

  • 설명: 현재 달의 마지막 날짜를 반환합니다.

  • 형식: last_day_of_month()

  • 결과: 날짜 또는 문자열

  • 예시:


24. find_all / find_iall

  • 설명: 주어진 문자열에서 정규표현식 패턴에 일치하는 모든 값을 찾아 목록으로 반환합니다.

    • find_all: 대소문자 구분.

    • find_iall: 대소문자 구분하지 않음.

  • 형식:

    • find_all(정규표현식_패턴, 문자열)

    • find_iall(정규표현식_패턴, 문자열)

  • 결과: 문자열 목록

  • 예시:


25. substr

  • 설명: 문자열에서 앞에서부터 지정한 길이만큼의 문자를 반환합니다.

  • 형식: substr(문자열, 숫자)

  • 결과: 문자열

  • 예시:

Last updated