시맨틱 큐레이션 도구 사용법 편집하기 (부분)

==== 스크립트에 자동으로 적용되는 표기 ====
LST Editor는 스크립트를 기록할 때 [[온톨로지 설계 스크립트 사용법#기본 표기 규칙|기본 표기 규칙]]을 자동으로 적용합니다.
{| class="wikitable" style="background-color:white; width:100%"
! 규칙 !! 편집기에서 입력 !! 스크립트에 기록
|-
| 비어 있는 선택 필드 || (빈 칸) || <code>Null</code>
|-
| 쉼표가 들어간 값 || <code>교재 개발, 강의</code> || <code>"교재 개발, 강의"</code>
|-
| 링크의 필드 수 || source, target, relation만 입력 || <code>source, target, relation, Null, Null</code>
|}

* 원문을 직접 작성한 스크립트를 LST Editor로 처음 적용하면, 차이 보기에 바뀐 줄이 많이 나타날 수 있습니다. 위 규칙에 맞게 표기가 정리된 것이며 내용이 바뀐 것은 아닙니다.

<!--
== {{#tag:html|<img src="https://kstoryhub.visualasia.com/classics/wiki/icons/database.png" width="25px"/>}} '''DB Upload''' ==
* 위키에 '''저장된''' 온톨로지 설계 스크립트를 DB에 업로드합니다.
* 하나의 <code>.lst</code> 문서는 DB에서 하나의 '''스토리(Story)'''가 됩니다. 스토리 ID는 문서 제목에서 <code>.lst</code>를 뺀 이름입니다. 예: <code>T2602001-EX01.lst</code> → <code>T2602001-EX01</code>

=== '''준비''' ===
* 위키에 '''로그인'''해야 합니다. 업로드한 사람의 사용자 이름이 DB에 작업자로 기록됩니다.
* '''업로드 키'''가 필요합니다. 수업 담당자에게 받습니다.
* 문서를 먼저 '''[변경사항 저장]'''으로 저장합니다. 편집창에 저장하지 않은 변경이 있으면 업로드할 수 없습니다.
* 스크립트에 검증 오류가 없어야 합니다. LST Editor의 Validation 탭에서 오류를 먼저 고칩니다.

=== '''DB 업로드 설정''' ===
* 어느 DB에 올릴지는 문서 안의 <code><nowiki>{{SemanticDBUpload}}</nowiki></code> 틀로 정합니다.
<pre>
== DB Upload ==
{{SemanticDBUpload|server=kstorydata.visualasia.com|db=aiclassics2602|project=Test}}
</pre>

{| class="wikitable" style="background-color:white; width:100%"
! style="width:80px;" | 변수 !! 내용
|-
| style="text-align:center;" | '''server''' || DB 서버 주소
|-
| style="text-align:center;" | '''db''' || DB 이름
|-
| style="text-align:center;" | '''project''' || 테이블 이름의 접두어. <code>Test</code>이면 <code>TestData</code>(노드), <code>TestLinks</code>(링크), <code>TestStory</code>(스토리) 테이블에 기록합니다.
|}

* 틀이 없는 문서에서 '''DB Upload'''를 누르면 Server, DB, Project를 입력하는 창이 뜹니다. 값을 입력하고 '''[틀 넣기]'''를 누르면 편집창에 틀이 들어갑니다. 문서를 저장한 뒤 다시 '''DB Upload'''를 누릅니다.
* 틀의 값이 비어 있거나 잘못되어 있을 때도 같은 창이 뜹니다. 값을 고치고 '''[틀 넣기]'''를 누르면 기존 틀이 새 값으로 바뀝니다.

=== '''업로드하기''' ===
# 저장된 문서의 편집 화면에서 '''DB Upload'''를 누릅니다.
# 업로드 창에서 내용을 확인합니다.
#* 스토리 ID, Server, DB, Project, 작업자
#* 업로드 대상(노드 수, 링크 수)
# '''업로드 키'''를 입력합니다. '''이 브라우저에 키 기억하기'''를 선택하면 다음부터 입력하지 않아도 됩니다.
# '''[업로드]'''를 누릅니다.
# 업로드가 끝나면 테이블마다 새로 추가한 행과 그대로 둔 행의 수가 표시됩니다.

=== '''업로드 규칙''' ===
{| class="wikitable" style="background-color:white; width:100%"
! style="width:120px;" | 테이블 !! 기록 방식
|-
| style="text-align:center;" | 노드<br>(…Data) || 
* 노드의 <code>id</code>, <code>class</code>, <code>label</code>, <code>infoUrl</code>, <code>iconUrl</code>, <code>remark</code>를 기록합니다.
* 영어 번역(<code>hasEnglishTranslation</code>)이 있으면 함께 기록합니다.
* '''같은 id가 이미 DB에 있으면 바꾸지 않고 그대로 둡니다.'''
|-
| style="text-align:center;" | 링크<br>(…Links) || 
* 링크의 <code>source</code>, <code>target</code>, <code>relation</code>, <code>attribute</code>, <code>remark</code>를 기록합니다.
* '''source·target·relation이 같은 링크가 이미 DB에 있으면 바꾸지 않고 그대로 둡니다.'''
|-
| style="text-align:center;" | 스토리<br>(…Story) || 
* 같은 스토리 ID로 기록된 내용을 지우고, 이 문서의 내용으로 새로 기록합니다.
* 스토리 이름(<code>hasLabel</code>)은 <code>#Project</code>의 프로젝트 이름입니다.
* 문서의 모든 노드가 스토리의 구성 요소(<code>hasContextualElement</code>)로 기록됩니다.
|}

* 업로드는 '''한꺼번에 처리'''됩니다. 중간에 오류가 나면 아무것도 기록되지 않습니다.
* 같은 문서를 다시 업로드해도 됩니다. 노드와 링크는 새로 추가된 것만 기록되고, 스토리는 문서의 최신 내용으로 다시 기록됩니다.

=== '''업로드가 안 될 때''' ===
{| class="wikitable" style="background-color:white; width:100%"
! 메시지 !! 해결 방법
|-
| 위키에 로그인한 사용자만 업로드할 수 있습니다 || 위키에 로그인합니다.
|-
| 편집창에 저장하지 않은 변경이 있습니다 || '''[변경사항 저장]'''으로 저장한 뒤 다시 시도합니다.
|-
| 검증 오류가 n건 있어 업로드할 수 없습니다 || LST Editor에서 오류를 고치고 저장합니다.
|-
| 업로드 키가 맞지 않습니다 || 수업 담당자에게 업로드 키를 다시 확인합니다.
|-
| 업로드 서버에 등록되지 않은 DB입니다 || 틀의 <code>server</code>와 <code>db</code> 값을 확인합니다.
|-
| DB에 테이블이 없습니다 || 틀의 <code>project</code> 값을 확인합니다. 값이 맞다면 수업 담당자에게 문의합니다.
|-
| 업로드 서버에 연결하지 못했습니다 || 잠시 뒤 다시 시도하고, 계속되면 수업 담당자에게 문의합니다.
|}
-->

<br>