Skill Builder::사전 작업 및 설정::편의 설정 및 기능

페이지 이동경로

편의 설정

편의 설정은 필수 사항의 설정은 아니지만, Skill을 개발할 때 편리하게 활용할 수 있는 설정들을 나타냅니다.

환경 변수 설정

메뉴바의 환경 변수 설정에서는 개별 환경에 따라 환경 변수를 다르게 구성하거나, 모든 환경에 공통으로 적용할 수 있는 글로벌 환경 변수를 설정할 수 있습니다. 이렇게 설정한 환경 변수는 API 편집 프로퍼티 팝업창에서 $변수명으로 해당 변수를 사용할 수 있도록 자동 완성(Auto Complete) 기능을 지원합니다.

설정한 환경 변수는 추후 배포 Stage(ex. Dev, Sandbox, Stg, Prod)에 자동 매핑됩니다.

개발 환경별 환경 변수

개발 편의를 위해 개발 환경별 환경 변수를 다르게 설정할 수 있습니다. 개발 환경별 환경 변수의 설정 방법은 다음과 같습니다.

  1. 좌측 메뉴바에서 설정 아이콘을 클릭 후, [환경 변수 설정] 버튼을 클릭합니다.

    환경 변수 설정 그림환경 변수 설정

  2. 환경 관리 창이 팝업하면, 우측 하단의 [추가]를 클릭합니다.

    환경 관리 창 그림환경 관리 창

  3. 환경 변수 추가 창이 팝업하면, 환경명과 환경 변수의 을 입력합니다.

    환경 변수 추가 창 그림환경 변수 추가 창

  4. 우측 하단의 [적용] 버튼을 클릭합니다.

    [적용] 버튼 그림[적용] 버튼

글로벌 환경 변수

글로벌 환경 변수란 특정 환경이 아닌 모든 환경에도 공통으로 사용할 수 있는 변수를 의미합니다. 글로벌 환경 변수의 설정 방법은 다음과 같습니다.

  1. 메뉴바에서 설정 아이콘을 클릭 후, [환경 변수 설정] 버튼을 클릭합니다.

    환경 변수 설정 그림환경 변수 설정

  2. 환경 관리 창 우측 하단의 글로벌 변수 추가를 클릭합니다.

    환경 관리 창 그림환경 관리 창

  3. 글로벌 환경 변수 추가 팝업 창이 뜨면, 을 입력합니다.

    글로벌 환경 변수 추가 창 그림글로벌 환경 변수 추가 창

  4. 우측 하단의 [적용] 버튼을 클릭합니다.

    [적용] 버튼 그림[적용] 버튼

BEAN 설정

Skill Builder에서 지원하는 블록으로는 해결하기 어려운 부분이 있을 경우, 메뉴바의 BEAN 설정 메뉴에서 Skill 개발 시 사용할 수 있는 Java 기반의 전역 Bean을 생성 및 관리할 수 있습니다.

  • BEAN 설정 메뉴에서 설정한 전역 Bean은 Skill 개발 시 Bean 또는 JSON 블록에서 활용할 수 있습니다.
  • 전역 Bean의 생성 또는 업데이트 과정에서 컴파일 오류가 없을 경우, 전역 Bean은 현재 등록된 모든 Phase에 자동 배포됩니다.

BEAN 추가

전역 Bean을 신규 생성하는 방법은 다음과 같습니다.

  1. 메뉴바에서 설정 아이콘을 클릭 후, [BEAN 설정] 버튼을 클릭합니다.

  2. BEAN 관리 창 하단의 [추가] 버튼을 클릭합니다.

  3. BEAN 추가 팝업 창이 뜨면, 이름코드를 입력합니다.

  4. 우측 하단의 [추가] 버튼을 클릭합니다.

BEAN 수정

이미 생성된 전역 Bean에 대해 이름 변경, 코드 변경 등의 수정 방법은 다음과 같습니다.

  1. 좌측 메뉴바에서 설정 아이콘을 클릭 후, [BEAN 설정] 버튼을 클릭합니다.

  2. BEAN 관리 창 좌측 목록에서 수정하고자 하는 Bean을 클릭합니다.

  3. BEAN 관리 창 하단의 편집 모드로 변경을 클릭합니다.

  4. 이름 또는 코드 편집 후 BEAN 관리 창 우측 하단의 [저장] 버튼을 클릭합니다.

편의 기능

Skill Builder에서는 사용자가 원하는 블록들을 조합해서 생성하거나 멀티 배포 등과 같은 편리하고 쉽게 활용할 수 있는 기능들을 제공하고 있습니다.

사용자 정의 블록 생성

캔버스 영역 우측 상단의 [사용자 정의 블록 생성] 버튼을 클릭하면, 하나 또는 여러 개의 블록 조합을 하나의 블록으로 만들어서 재사용할 수 있는 사용자 정의 블록을 생성할 수 있습니다. 사용자 정의 블록의 생성 방법은 다음과 같습니다.

  1. 새로운 Skill을 생성한 후 [사용자 정의 블록 생성] 버튼을 클릭합니다.

    • 사용자 정의 블록은 반드시 블록 시작점에 START(사용자) 블록을 포함해야 합니다.

    사용자 정의 블록 생성 그림사용자 정의 블록 생성

  2. 생성한 사용자 정의 블록은 좌측 내 스킬 메뉴의 사용자 정의 탭으로 이동됩니다.

    • 사용자 정의 블록에 마우스를 위치시키고 우클릭 시, 해당 블록의 기본 정보를 수정할 수 있습니다.

    사용자 정의 탭 이동 그림사용자 정의 탭 이동

  3. 생성한 사용자 정의 블록은 우측 블록 목록의 사용자 정의 탭에 위치하며, 캔버스 영역에 드래그 앤 드롭하여 사용합니다.

    사용자 정의 블록 사용하기 그림사용자 정의 블록 사용하기

환경 변수 사용

환경 변수 설정을 완료하면, 설정한 환경 변수들을 다양한 상황에서 쉽게 사용할 수 있습니다. 환경 변수 사용 시 $를 입력하면 환경변수 설정에 추가한 변수들의 리스트가 나오며, 여기에서 원하는 변수를 선택해서 사용할 수 있습니다.

  1. 환경 변수를 사용하기 위해 환경 선택을 클릭 후, 개발 환경을 선택합니다.

    환경 선택 그림환경 선택

    환경 선택을 완료하면, 아래의 경로에서 환경 변수를 사용할 수 있습니다. 환경 변수 사용 경로

    구분 설명
    REST API CALL 블록 헤더/바디 데이터 탭의 [요청하기] 버튼 클릭 시
    JDBC 블록
    LDAP 블록
    일반 탭의 [테스트] 버튼 클릭 시
  2. 만약 URI 정보에서 serverUri 환경 변수를 사용할 경우에는 $serverUri를 입력합니다.

    • 선택한 환경에 해당 변수가 설정되어 있을 경우에는 변수는 파란색, 미설정 시 빨간색으로 표시됩니다.
    • 해당 변수들은 Skill 배포 시 Phase 별로 매핑된 환경에 해당하는 변수값으로 치환됩니다.

    REST API CALL 블록에서 환경 변수 사용 그림REST API CALL 블록에서 환경 변수 사용 예

    JDBC 블록에서 환경 변수 사용 그림JDBC 블록에서 환경 변수 사용 예

멀티 배포

멀티 배포는 여러 개의 Skill을 선택하여 다수의 Phase에 동시에 배포하는 기능입니다.

  1. 메인 화면에서 [멀티 배포] 아이콘을 클릭합니다.

    멀티 배포 아이콘 클릭 그림멀티 배포 아이콘 클릭

  2. [+] 버튼을 클릭하여 배포할 Skill들을 모두 선택 후, [배포하기] 버튼을 클릭합니다.

    배포할 Skill 선택 그림배포할 Skill 선택

  3. [+] 버튼을 클릭하여 배포 대상 Phase들을 모두 선택 후, [적용하기] 버튼을 클릭합니다.

    배포 대상 Phase 선택 그림배포 대상 Phase 선택

이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 documentation@kakaoenterprise.com 으로 제보해주세요.