Workshop에서 Notepad 연결, 생성과 내보내기
Workshop의 Notepad 위젯으로 객체에 연결된 문서를 찾고, 문서를 읽거나 편집하고, 템플릿에서 새 문서를 만들 수 있습니다.
객체에 연결된 문서
Notepad가 Object card나 Object property 등으로 객체를 참조하면 문서와 객체의 링크를 기록합니다. Workshop의 Notepad: Linked documents는 선택한 객체를 참조하는 문서들을 표시합니다.
목록의 표시 스타일, 필드, 순서와 기본 정렬을 조정할 수 있습니다. 예를 들어 작성자 기준으로 정렬합니다.
이 위젯은 Active Notepad 변수를 자동으로 제공합니다. 현재 선택한 문서의 RID이며 선택이 바뀌면 갱신됩니다. 이를 Embedded document 입력에 연결하면 선택한 문서를 바로 표시할 수 있습니다.
문서 임베드
Notepad: Embedded Document에 문서 RID를 담은 Workshop 변수를 전달합니다. RID는 ri.notepad.main.notepad.로 시작하는 실제 문서 식별자입니다.
기본 표시는 읽기 전용입니다. Allow Editing을 켜면 문서 안에서 편집할 수 있지만, 임베드 편집기는 전체 Notepad 앱보다 기능이 적습니다. 모든 편집 작업이 필요하면 Notepad 앱을 엽니다.
템플릿에서 문서 생성
Notepad: New Notepad Button을 추가하여 게시한 템플릿에서 새 문서를 만듭니다.
- 오른쪽 구성 패널에서 Template(s)를 고릅니다.
+ Select로 파일 목록을 열어 템플릿을 Document templates에 추가합니다.- 추가한 템플릿을 선택하고 Template version을 고릅니다. 버전이 없으면 템플릿을 열어 게시합니다.
- 선택한 버전의 Template inputs를 Workshop 변수에 연결합니다.
선택적으로 Menu display name을 정할 수 있습니다. 지정하지 않으면 Button display의 Custom text를 사용합니다.
입력 변수
템플릿 입력과 같은 자료형의 Workshop 변수를 연결합니다. String, Number, Date, Timestamp, Object와 Object set을 사용할 수 있습니다.
단일 Object 입력에는 객체가 정확히 하나 들어 있는 Workshop 객체 집합 변수를 연결합니다. 버튼을 누르는 시점의 변수 값으로 새 문서를 생성합니다.
String 변수에서 문서 생성
템플릿 대신 Workshop String 변수로 문서를 만들려면 String 구성을 선택합니다. 값은 일반 텍스트 또는 지원하는 Markdown으로 해석할 수 있습니다.
저장 옵션
버튼에 연결한 각 템플릿 또는 String 변수에 다음 옵션을 정할 수 있습니다.
| 옵션 | 동작 |
|---|---|
| Allow users to choose save location | 생성 전에 사용자가 저장 위치와 이름을 고릅니다. 미리 정한 Default save location은 무시합니다. |
| Default save name | 새 문서의 기본 파일 이름. PDF 자동 내보내기에서도 파일 이름으로 사용합니다. |
| Default save location | 폴더를 직접 고르거나 Compass RID를 담은 String 변수로 지정합니다. 기본 위치는 생성하는 사용자의 홈 폴더입니다. |
버튼 실행 후 동작
생성 후 PDF 다운로드
Export generated Notepad as PDF를 켜면 문서 생성 후 PDF를 자동 다운로드합니다.
템플릿에서 PDF만 만드는 기본 경로는 생성한 Notepad를 Foundry에 보존하지 않습니다. 이 경우 Default save name을 제외한 저장 옵션은 무시합니다. 문서도 함께 보관하려면 Save Notepad from PDF export를 켜서 Compass에 저장합니다.
String 변수에서 생성하는 문서는 위의 기본 비보존 규칙의 예외로 보존됩니다.
새 탭과 후속 이벤트
Open generated Notepad in new tab으로 새 문서를 탭에서 열 수 있습니다.
문서가 만들어진 뒤 실행할 Workshop 이벤트나 액션도 지정할 수 있습니다. 예를 들어 Created document 출력 변수의 RID를 객체 속성에 저장하도록 연결할 수 있습니다. PDF만 내려받고 문서는 보존하지 않는 구성과 문서 RID를 장기 참조하는 구성을 구분합니다.
RID를 액션에 전달
생성된 RID를 액션 인수로 보내려면 해당 매개변수에 타입 클래스가 필요합니다. Ontology Manager에서 액션 매개변수를 열고 Details에 notepad:notepad_rid 타입 클래스를 추가합니다.
기존 문서 내보내기
Notepad: Export Button은 기존 문서를 PDF 또는 DOCX로 내보냅니다. 문서 RID 변수를 직접 만들거나 다음 위젯의 출력 RID를 사용할 수 있습니다.
- Notepad: Linked Documents
- Notepad: New Notepad Button
- Notepad: Embedded Document
| 설정 | 동작과 기본값 |
|---|---|
| Output Filename | 다운로드 파일 이름. 비어 있으면 Notepad 문서 이름 사용 |
| Export Format | PDF 또는 DOCX |
| Button Display | 내보내기 버튼의 배치 옵션 |
| Button Text | 표시 문구. 비어 있으면 Export |
Embedded Document와 함께 사용하면 Workshop 안에서 문서를 편집한 뒤 내보낼 수 있습니다. 파일 형식별 지원 범위는 Notepad 내보내기를 따릅니다.
다른 앱의 명령을 Notepad 안에서 실행하려면 Command 위젯을 사용할 수 있습니다.