라이브러리 기능

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 1분
  • 라이브러리 함수는 규칙 전반에 걸쳐 코드 재사용을 활성화하여 구현 속도를 높이고 유지관리 비용을 절감할 수 있습니다.

    라이브러리 함수를 사용하면 규칙 및 보강 전반에 걸쳐 코드를 효율적으로 재사용할 수 있습니다. 특히 높은 SKU 또는 물리 기반 구성이 포함된 복잡한 시나리오에서 중복 논리를 최소화하고, 구현 속도를 높이며, 유지 관리 비용을 절감하도록 설계되었습니다.

    속성 및 기능

    중앙 집중식 관리: 전용 UI를 통해 라이브러리 기능을 검색하고 관리합니다.

    재사용 가능 및 네임스페이스: 라이브러리 함수를 한 번 정의하고 fn.functionName(params)을 사용하여 호출합니다.

    구성 가능한 매개변수: 데이터 유형 및 기본값을 사용하여 입력 매개변수를 정의합니다. 매개변수 스키마는 생성 후 수정할 수 있으므로 함수 입력을 유연하게 관리할 수 있습니다.

    사용자 지정 출력: 반환 유형을 지정합니다.

    모듈 간 호출 가능: 라이브러리 함수는 구성기와 트랜잭션 관리자 모두에서 호출할 수 있습니다.

    관리되는 테이블 쿼리: 라이브러리 함수는 관리되는 테이블 조회를 지원합니다.

    라이브러리 기능 활성화

    지원 티켓을 제출하여 라이브러리 기능을 활성화하십시오. 지원 티켓이 완료되면 다음으로 이동하여 새 UI를 활성화합니다. 유틸리티 > 설정 > 관리자 버전 > 신규을 클릭하고 저장을 클릭합니다.

    이 설정은 언제든지 전환할 수 있습니다.

    지원되는 입력/출력 데이터 유형

    표 1. 지원되는 입력/출력 데이터 유형
    유형 설명
    TEXT 일반 텍스트 문자열
    번호 숫자 값
    부울 논리적 참/거짓 값
    날짜 날짜(시간 구성요소 제외)
    JSON 객체 JSON 형식의 객체
    배열 정렬된 값 컬렉션
    주:
    비어 있는 MAP 또는 ARRAY 유형은 지원되지 않습니다. 지원되지 않는 유형은 기본적으로 TEXT입니다.

    사용 예시

    라이브러리 함수는 함수 라이브러리(유틸리티 섹션)에서 찾을 수 있습니다.

    함수 라이브러리

    기능을 추가하려면 다음을 수행합니다.

    1. 함수 라이브러리 탭에서 함수 추가를 클릭합니다.
    2. 함수의 이름을 지정하고 반환 유형을 지정한 후 설명을 입력합니다.

    스크립트 내용:

    Sccript 매개변수

    함수 호출:

    코드

    제한

    • 재귀 호출은 지원되지 않습니다.
    • 외부 API 호출 및 비동기 작업은 지원되지 않습니다.
    • 매개변수는 참조가 아닌 복사로 전달됩니다.
    • 함수에는 부작용, 외부 호출 및 Logik 필드 참조가 없어야 합니다.

    일반 가이드라인

    • 라이브러리 기능이 변경되면 영향을 받는 Blueprint를 재배포합니다.
    • 기능을 정의할 때 입력의 이름을 지정하고 설명하여 사용에 대한 가시성을 제공합니다.