채널 관리자가 직접 정의해 여러 태스크에서 재사용할 수 있는 함수입니다. 외부 API 호출이나 JavaScript 코드 실행을 함수 단위로 만들어두면, 태스크의 함수 단계에서 입력/출력 스키마 기반으로 호출할 수 있는 기능입니다.
[채널 설정] - [연동] - [커스텀 함수] 메뉴에서 함수 만들기/수정 설정이 가능합니다.
커스텀 함수는 두 가지 타입으로 나뉩니다. 코드 타입은 JavaScript 코드를 직접 실행하며, API 타입은 외부 HTTP API를 호출합니다.
함수는 두 가지 상태를 가집니다. 초안 상태는 임시저장 상태로 편집은 가능하지만 ALF에서 호출할 수 없고, 작동중 상태는 발행 완료 상태로 ALF 태스크 함수 단계에서 호출 가능합니다.
[함수 구분자→입력 변수→API 설정→다음] 순서로 작성합니다.
URL, 헤더, 바디에 {{변수명}} 문법으로 입력값을 주입합니다. 중첩 객체는 {{user.id}}처럼 dot notation으로 접근합니다.
[테스트 실행→결과 확인→다음] 순서로 작성합니다.
[아웃풋 스키마 확인→퍼블리시] 순서로 작성합니다.
[함수 구분자→입력 변수→코드 설정→다음] 순서로 작성합니다.
자동 삽입되는 코드에 필요 변수를 기재해야합니다.
예시)
코드 안에서 사용할 수 있는 변수와 모듈은 네 가지입니다. params.input.*으로 Input Schema에 정의한 입력값에 접근하고, axios로 외부 HTTP 요청(HTTPS 전용)을 보낼 수 있습니다.
[테스트 실행→결과 확인→다음] 순서로 작성합니다.
[아웃풋 스키마 확인→퍼블리시] 순서로 작성합니다.
[AI → 설정 → 태스크] 단계에서 '함수'를 클릭해주세요.
함수 단계에서 보여지는 목록 중 원하는 함수를 선택해주세요.
목록 내의 변수를 채워주세요.
커스텀 함수의 제한 사항은 코드 노드 페이지에서 확인이 가능합니다.