코드 템플릿의 매개변수와 배포

템플릿은 코드의 일부를 입력 폼으로 바꾸어 반복 사용하는 변환입니다. 사용자가 선택한 값을 코드에 넣어 일반 변환처럼 실행합니다. 표 처리뿐 아니라 Matplotlib이나 Plotly 시각화도 템플릿으로 만들 수 있습니다.

검색과 실행

+ New Transform > Templates 또는 기존 노드의 + > Templates로 브라우저를 엽니다.

최근 사용한 템플릿을 보거나 키워드, 작성자와 태그 등으로 검색합니다.

그래프의 템플릿 노드를 선택하면 코드 편집기 대신 매개변수 폼이 열립니다. 값을 채우고 Run을 선택합니다. Toggle View로 실제 생성한 코드를 볼 수 있습니다.

입력 유형

열 선택은 원천 데이터셋이 먼저 지정되어야 합니다. 고정 데이터셋을 쓰는 템플릿도 해당 자산과 프로젝트 참조에 대한 접근이 필요합니다.

코드에서 템플릿 생성

코드 편집기 머리글의 Create/Edit template을 선택합니다. 전체 화면에서 왼쪽은 매개변수로 바꿀 코드, 오른쪽은 매개변수의 메타데이터를 편집합니다.

처음에는 함수의 데이터셋 입력이 Dataset 매개변수로 자동 전환됩니다. 템플릿 제목과 설명을 적고 각 입력의 이름과 의미를 정합니다.

Add new parameter를 선택하고 값으로 치환할 코드 부분을 강조합니다. 같은 매개변수가 여러 위치에 있으면 인스턴스 목록의 Add로 해당 위치를 추가합니다.

유형은 Dataset, Column 또는 Variable로 정합니다. Variable이면 Text, Number, Select, Multiselect, Boolean, List 중 구체 유형도 선택합니다. Column은 복수 열 목록으로, Dataset은 기본 고정 입력으로 구성할 수 있습니다.

설명과 기본값을 제공하면 사용자가 입력의 조건을 이해하기 쉽습니다. 특히 Variable에는 가능한 기본값을 지정하고, 코드가 요구하는 자료형과 범위를 설명합니다.

Global Code와 버전

템플릿을 처음 만든 Workbook의 전역 함수는 템플릿 코드 내용에 자동으로 포함됩니다. 나중에 적용하는 다른 Workbook의 Global Code에는 접근하지 않습니다. 원래 작성 환경의 함수 포함과 대상 환경의 라이브러리 설치는 별도 조건입니다.

템플릿을 수정하면 새 버전으로 저장합니다. 기존 사용 인스턴스는 자동으로 새 버전으로 바뀌지 않으며 오래된 버전이면 업데이트 안내가 나타납니다. 각 인스턴스에서 변경을 검토하고 갱신합니다.

공유할 템플릿은 업무별 폴더로 정리하고 검토한 템플릿을 찾기 쉬운 공개 폴더에 둘 수 있습니다. 기본 템플릿 폴더도 구성할 수 있습니다. 접근 권한이 있는 사용자만 발견하고 사용할 수 있습니다.

입력 태그로 템플릿 추천

비슷한 데이터셋에 맞는 템플릿을 Suggested에 노출할 수 있습니다. 예를 들어 월별 주식 수익률 데이터셋에는 연환산 계산 템플릿을 추천할 수 있습니다.

템플릿을 만들거나 편집할 때 Input Tags에 Finance:MonthlyReturns 같은 태그를 넣습니다. 여러 태그를 지정할 수 있습니다. 해당 태그가 있는 데이터셋에서 새 하위 변환을 만들면 Suggested에서 찾을 수 있습니다.

태그는 Dataset 애플리케이션에서 실제 데이터셋에 붙입니다. 저장하지 않은 Workbook 노드는 데이터셋 자산이 아니므로 태그를 붙일 수 없고 Suggested templates도 지원하지 않습니다.

여러 노드 템플릿에서는 Output tags로 생성 데이터셋에 붙일 태그를 정할 수 있습니다. 템플릿을 적용하면 해당 출력 데이터셋에 즉시 추가됩니다.

막대 차트 템플릿에서 단일 노드의 생성과 사용을, 여러 노드와 공유 매개변수에서 함께 바뀌는 구성 요소를 다룹니다. 그림 출력 방식은 시각화를 따릅니다.