스프레드시트 표시와 주석

일정한 표 구조의 Excel 자료는 Pipeline Builder의 Extract rows from an Excel file, Microsoft Excel 커넥터 또는 Transforms Excel Parser로 데이터셋화하는 데 적합합니다. 원본 XLSX를 유지해야 하거나 파일마다 구조가 다르면 Spreadsheet 미디어 집합을 사용하여 표시하고 주석을 저장할 수 있습니다.

대상 폴더의 미디어 집합 생성, 파이프라인 생성 및 배포, 온톨로지 액션 유형 생성 권한이 필요합니다. 복잡한 수식과 내장 파일 등 지원 형식 제한도 확인합니다.

파일과 객체

폴더의 New > Media set에서 이름, Spreadsheet 유형과 트랜잭션 정책을 정합니다.

.xlsx 파일을 추가하면 작성자, 제목과 크기 같은 메타데이터가 표시됩니다. 파일을 선택하여 시트와 셀을 미리 볼 수 있습니다.

All actions > Create new pipeline에서 배치 파이프라인을 만듭니다.

미디어 노드의 Add output에서 New object type을 선택합니다.

예시 이름은 Spreadsheet입니다. media reference 매핑을 유지하고 media item RID를 기본 키로 지정한 뒤 저장 및 배포합니다.

셀 내용 추출

별도 표 데이터 경로에서 미디어 노드의 Transform > Extract content from spreadsheets in JSON을 선택합니다. Media reference 입력에 해당 열을 지정하고 Output fields 및 Error handling을 구성하여 Apply합니다.

결과는 시트 이름을 키로 한 맵이며 각 값에는 선택한 Table과 Merged cells 필드가 들어갑니다. 이후 변환하거나 파이프라인 출력으로 연결할 수 있습니다.

주석 데이터 모델

아래는 가상의 주석 모델입니다. 실제 온톨로지에 맞는 객체와 액션을 만듭니다. 주석 객체에는 annotation ID 문자열 기본 키, sheet name, cell range와 Spreadsheet 객체로의 링크가 필요합니다.

이 예시는 cell range를 JSON 문자열로 저장합니다. 범위는 0부터 시작하므로 A1은 (0,0)이고 A1부터 B2는 다음과 같습니다.

{"startRow": 0, "startCol": 0, "endRow": 1, "endCol": 1}

Spreadsheet Display는 같은 이름의 정수 필드를 가진 struct도 지원합니다. 위젯의 단일 선택 결과는 JSON 객체이고 여러 범위 선택 결과는 JSON 배열이므로 액션이 기대하는 형식과 맞춰야 합니다.

주석 생성 액션에 시트 이름, 셀 범위와 현재 Spreadsheet 객체 입력을 만들고 속성 및 링크에 매핑하며 고유 주석 기본 키를 채웁니다.

Workshop 구성

배포한 객체 출력의 Create Workshop module로 모듈을 만듭니다.

Object List 또는 Object Table과 Spreadsheet Display를 추가합니다. Spreadsheet Display의 Object set with a single object에는 목록의 활성 객체를, Spreadsheet media reference property에는 파일 참조 속성을 연결합니다.

Spreadsheet annotations를 켜고 주석 레이어를 추가합니다. Annotation layer name을 정하고 Object set을 활성 스프레드시트로 필터링한 주석 집합에 연결합니다. Sheet name property와 Cell range property를 지정합니다.

Configure Interactions에서 만든 액션을 선택합니다. 위젯의 Sheet Name과 Selected Cell Range를 해당 매개변수로, 활성 Spreadsheet 객체를 링크 입력으로 연결합니다. 사용자는 범위를 선택하고 액션을 실행하여 주석을 저장합니다.