통제 및 검토
Artifact로서의 Word 및 PDF 파일
Word 문서와 PDF를 Artifact로 프로젝트에 추가하고, 페이지를 검토하고 댓글을 달고, 모든 버전을 보관하고, 이전 버전의 파일을 제거하여 저장 공간을 확보합니다.
이 페이지의 내용
Word 문서나 PDF는 프로젝트 안에 Artifact로 둘 수 있습니다. 검토자는 Holarch에서 이를 읽고, 페이지에 댓글을 달고, 다른 항목처럼 승인합니다. 같은 문서를 새로 업로드할 때마다 새 버전이 되며, 이전 버전도 계속 읽을 수 있습니다.
호스팅 서비스에서는 Word 파일을 추가하면 PDF로 변환되고 PDF는 압축됩니다. 모든 사람이 읽고 다운로드하고 댓글을 다는 것은 이 PDF입니다.
개념
- 파일 Artifact: 파일을 담은 Artifact입니다. 페이지 맨 위에 뷰어, 버전, 파일 도구가 있는 파일 섹션이 있습니다.
- 버전: 문서의 업로드 한 번입니다. 각 버전은 PDF, 업로드한 사람, 날짜, 선택적 메모를 유지합니다. 기본적으로 최신 버전이 표시됩니다.
- 변환: Word 파일을 PDF로 바꾸고 PDF를 압축하는 작업입니다. 모든 사람을 통틀어 한 번에 파일 하나씩 변환하며, 서로 다른 계정의 파일은 차례로 처리되므로 큰 일괄 작업 하나가 다른 작업을 붙잡아 두지 않습니다.
- 고정된 댓글: 한 버전의 특정 위치, 즉 선택한 단어, 점, 상자 또는 페이지 전체(또는 Word 보기에서는 단락)에 속하는 댓글입니다. 토론에는 그 위치가 표시됩니다(예: "버전 2, 3페이지").
사용 방법
사용 시기와 이유
산출물을 Holarch 밖에서 작성할 때 파일 Artifact를 사용합니다: 설계 검토 패키지, 공급업체의 인터페이스 제어 문서, 테스트 보고서 등입니다. 프로젝트 안에 두면 그것이 다루는 요구사항 및 항목 옆에 놓입니다. 검토자는 한곳에서 댓글을 달고, 베이스라인은 어떤 버전이 승인되었는지 기록합니다.
Word 또는 PDF 파일 추가
- LML 프로젝트의 데이터베이스를 엽니다.
- + 새 항목을 클릭한 다음 이름 필드 아래의 Word 또는 PDF 파일에서 Artifact 만들기…를 클릭합니다. 데이터베이스에 Artifact만 표시될 때는 버튼이 + 새 Artifact이고 대화 상자의 버튼은 Word 또는 PDF 파일에서…입니다. 대화 상자가 닫히고 파일 선택기가 열립니다.
같은 버튼은 새 항목 대화 상자가 열리는 모든 곳에 있습니다. 예: ⌘K / Ctrl+K → 새 항목…. .docx와 .pdf 파일을 데이터베이스 표에 끌어다 놓거나, 프로젝트의 아무 페이지에서 ⌘K / Ctrl+K를 누르고 파일에서 Artifact 만들기…를 실행할 수도 있습니다.
- 파일을 하나 이상 선택합니다.
표 위에 추가 중인 파일이 각 파일의 상태와 함께 표시됩니다: "대기 중(앞에 2개)", 변환하는 중…, 압축하는 중… 또는 저장하는 중….
- 기다리거나 계속 작업합니다. 탭을 닫아도 됩니다.
파일이 완료되면 Holarch가 알려 줍니다: "Design Review.docx가 Artifact로 준비되었습니다." 열려 있는 Holarch 탭이 없으면 이메일로 메시지가 옵니다.
각 파일은 확장자를 뺀 파일 이름을 딴 Artifact 하나가 됩니다. 알림에는 저장된 크기가 표시됩니다(예: "15 MB에서 압축되어 2.1 MB로 저장됨.").
새 버전 업로드
- Artifact를 엽니다.
- 파일 섹션에서 새 버전 업로드…를 클릭하고 파일을 선택합니다.
- 필요하면 새 버전에 대한 메모(예: "설계 검토 의견 반영")를 입력하고 새 버전으로 업로드를 클릭합니다.
준비될 때까지 페이지에 "새 버전 Design Review.docx: 변환하는 중…"이 표시됩니다.
이미 같은 이름의 파일로 만든 Artifact와 이름이 일치하는 파일을 추가하면 파일이 이미 프로젝트에 있음이 어떻게 할지 묻습니다.
- 새 버전으로 업로드(기본값): 파일이 그 Artifact의 다음 버전이 됩니다.
- 둘 다 유지: 이름에 " (2)"가 붙은 별도의 Artifact.
- 취소: 아무것도 추가되지 않습니다.
검토 및 댓글
- Artifact를 엽니다. 페이지는 문서 뷰어에 PDF를 표시합니다: 도구 모음, 페이지, 그리고 옆의 댓글 패널.
- 도구 모음으로 문서를 이동합니다: 12페이지 중 3페이지(페이지 번호를 입력하고 Enter 누름), 이전 및 다음 페이지 버튼, 미리 보기 이미지, 확대/축소(너비 맞춤, 페이지 맞춤 또는 고정 크기), 찾기(⌘F / Ctrl+F). 키: ←와 →는 페이지를 넘기고, Home과 End는 첫 페이지와 마지막 페이지로 이동하며, +와 −는 확대/축소합니다.
- 다음 네 가지 방법 중 하나로 댓글을 답니다.
- 텍스트 선택: 페이지에서 단어를 선택한 다음(복사할 수도 있음) 선택 영역에 댓글 달기를 클릭합니다. 단어가 강조 표시됩니다.
- 점: 댓글이 속할 페이지의 위치를 클릭합니다.
- 상자: 그림이나 표 같은 영역 주위로 상자를 끕니다.
- 페이지에 댓글 달기: 표시된 페이지 전체에 대한 댓글.
패널에 댓글을 입력하고 댓글 추가(⌘Enter / Ctrl+Enter)를 클릭합니다. 누군가를 언급하려면 @와 이름을 입력합니다.
- 댓글 패널은 스레드를 페이지 순서대로, 페이지의 표시와 같은 번호로 나열합니다. 스레드를 클릭하면 그 위치로 이동하고, 표시나 강조를 클릭하면 스레드가 열립니다. 답글, 해결, 다시 열기는 토론에서와 같이 작동하며, 해결됨 표시는 해결된 스레드를 보여 줍니다.
- 공간이 더 필요하면 검토 보기(창 전체에 버전 표시) 또는 별도 창으로 분리(예: 두 번째 화면의 별도 창)를 클릭합니다. 둘 다 사람들이 댓글을 다는 대로 최신 상태를 유지합니다.
각 댓글은 작성된 버전에 속하며, 토론에도 표시됩니다(예: "버전 2, 3페이지"). 댓글을 달아도 파일은 절대 변경되지 않으므로 서명된 PDF는 서명을 유지합니다.
이후 버전의 댓글
새 버전이 추가되면 열린 스레드가 새 버전으로 옮겨지므로 검토가 버전을 넘어 이어집니다.
- Holarch는 새 버전에서 각 스레드의 단어를 찾으며, 단어가 다른 페이지로 옮겨졌거나 주변 텍스트의 줄바꿈이 바뀐 경우에도 찾습니다. 스레드는 그 위치에 버전 1에서(작성된 버전)라는 레이블과 함께 표시됩니다.
- 단어가 편집되었으면 스레드에 이후 텍스트 변경됨 표시도 붙고, 이전 버전의 내용이 표시됩니다(예: "버전 1의 내용: “reject 40 W”").
- 단어가 사라졌으면 스레드는 댓글 패널 끝의 이전 버전 아래에, 인용된 단어와 버전 1에서 표시(그 단어가 있는 마지막 버전)와 함께 나열됩니다.
- 점이나 상자는 가장 가까운 텍스트 줄을 따라갑니다. 텍스트가 없는 페이지(도면이나 스캔)에서는 새 버전에서 페이지가 똑같이 보이면 원래 위치에 머물고, 그렇지 않으면 이전 버전 아래로 갑니다.
- 해결된 스레드는 원래 있던 버전에 남습니다. 새 버전으로 옮기려면 스레드를 다시 엽니다.
- 작성 버전(둘 이상의 버전에서 온 스레드가 있으면 스레드 위에 표시됨)은 한 버전에서 작성된 스레드만, 또는 모든 스레드를 보여 줍니다.
- Word에서 온 스레드도 같은 규칙을 따릅니다.
이 처리는 새 버전이 추가될 때 일어납니다. 이 기능 이전의 댓글이 있는 프로젝트는 새 버전이 처음 표시될 때 같은 처리를 받습니다. 토론에서 이전 버전의 댓글은 현재 위치를 알려 줍니다(예: "버전 1, 2페이지, “radiator” · 버전 3으로 옮겨짐" 또는 "· 버전 3에 없음").
댓글은 인용된 단어를 유지하므로 이전 버전의 파일이 제거된 후에도 읽을 수 있습니다. 편집된 댓글은 이전 텍스트를 유지합니다. 댓글 아래의 이전 텍스트에는 이전의 각 문구가 작성자 및 작성 시간과 함께 나열됩니다.
베이스라인은 파일 버전과 그 댓글 스레드를 당시 상태대로 기록합니다. 이를 보려면 베이스라인에 포함 아래의 베이스라인 이름을 클릭합니다.
Word의 댓글과 변경 내용 추적
호스팅 서비스에서는 Word 파일을 추가하면 그 파일 자체의 검토 표시가 함께 들어옵니다.
- 댓글은 작성된 단어 위에 답글과 함께 PDF의 댓글 스레드가 됩니다. 각 스레드는 Word의 작성자와 날짜를 유지하며 Word에서로 표시됩니다. Word에서 완료로 표시된 댓글은 해결된 상태로 들어옵니다.
- 변경 내용 추적은 작성한 사람의 제안으로 나열됩니다: "제안된 삽입: …" 또는 "제안된 삭제: …".
- PDF에는 여백에 댓글이, 빨간 줄로 변경 내용 추적이 표시됩니다.
업로드 후 알림은 무엇이 들어왔는지 알려 줍니다(예: "Word에서 댓글 3개와 변경 내용 추적 2개가 들어왔습니다."). 가져온 스레드는 업로드한 사람의 소유이므로 해결하거나 삭제할 수 있습니다. 항목을 지켜보는 사람은 가져온 댓글마다 알림을 받지 않습니다.
두 버전 비교
- Artifact를 엽니다. 파일 섹션에서 버전 비교…(Artifact에 버전이 두 개 이상이면 표시됨)를 클릭합니다.
- 이전 버전과 최신 버전을 선택합니다. 기본적으로 표시된 버전을 그 앞의 버전과 비교합니다.
두 버전이 페이지별로 나란히 표시됩니다.
- 삽입됨 단어는 최신 버전에서 녹색입니다.
- 삭제됨 단어는 이전 버전에서 빨간색입니다.
- 이동됨 문장과 단락은 두 위치 모두 보라색입니다. 이동하면서 편집된 블록은 단어 변경도 표시합니다. 변경 목록에는 두 페이지가 모두 표시됩니다(예: "2페이지 → 5페이지").
- 텍스트가 없는 페이지(도면, 스캔)는 그림으로 비교합니다. 변경된 페이지에는 윤곽선이 그려지며, 최신 페이지에서 차이는 이전 버전에만 잉크가 있는 곳을 빨간색으로, 최신 버전에만 있는 곳을 녹색으로 표시합니다.
- 목록에서 변경을 선택하거나 이전과 다음(F7 및 Shift+F7)을 클릭하면 양쪽에 표시됩니다. 스크롤 동기화는 스크롤하는 동안 같은 텍스트를 나란히 유지합니다.
텍스트는 문서 전체에 걸쳐 비교되므로 다른 페이지로 옮겨졌거나 다른 줄로 줄바꿈된 텍스트도 일치시킵니다. 변환 없이 유지된 Word 파일은 페이지 없이 텍스트로 비교합니다. 긴 문서는 읽는 동안 진행률 표시줄이 표시됩니다.
같은 비교가 다른 곳의 텍스트 변경도 표시합니다. 변경 요청 검토, 항목 기록, 문서 변경, 라이브러리 차이에서 이동한 문장은 이동으로 표시되며, 두 위치 사이에 이동 후 위치 / 이동 전 위치 링크가 있습니다.
실전 예: CubeSat EO-1 데모의 설계 검토
- CubeSat EO-1 데모에서 데이터베이스를 열고 + 새 항목을 클릭한 다음 Word 또는 PDF 파일에서 Artifact 만들기…로 "EO-1 CDR Package.docx"를 추가합니다.
- 준비되면 EO-1 CDR Package를 열고 그것이 다루는 요구사항과 관계 짓습니다.
- 검토자가 이를 열고 12페이지에 페이지에 댓글 달기…를 사용합니다: "Thermal margin table is missing the eclipse case."
- 수정한 후 "EO-1 CDR Package.docx"를 다시 업로드하고 메모 "CDR 의견 반영"과 함께 새 버전으로 업로드를 선택합니다.
- 베이스라인을 만듭니다. Artifact 페이지에 버전 2에 대해 베이스라인 이름과 함께 베이스라인에 포함이 표시됩니다.
팁과 모범 사례
- 새 버전마다 같은 파일 이름으로 업로드합니다. 그러면 Artifact 하나가 전체 기록을 담습니다.
- 레이아웃이 Word와 정확히 일치해야 하면 Word 파일 대신 PDF를 업로드합니다. 변환하면 줄바꿈 위치가 달라질 수 있습니다.
- 서명된 PDF, PDF 양식, PDF/A 파일, 암호화된 PDF는 업로드한 그대로 유지됩니다. 압축하면 서명, 양식 또는 적합성이 깨지기 때문입니다.
흔한 실수
- 두 번째 Artifact가 나타남: 둘 다 유지를 선택한 경우입니다. 그것을 삭제한 다음 파일을 다시 업로드하고 새 버전으로 업로드를 선택합니다.
- 100 MB가 넘는 Word 파일이 거부됨: Word에서 파일 → 다른 이름으로 저장 → PDF를 선택한 다음 PDF를 업로드합니다.
연결 방식
- 댓글과 검토: 고정된 댓글은 일반 댓글이며, 답글, 언급, 승인은 다른 항목과 같이 작동합니다. 댓글과 검토를 참조합니다.
- 베이스라인: 베이스라인은 각 파일 Artifact의 당시 버전을 기록합니다. 변경 요청을 참조합니다.
- 저장 공간: 모든 버전의 PDF가 프로젝트와 사용자의 저장 공간에 포함됩니다. 첨부 파일, 저장 공간 및 제한을 참조합니다.
파일 섹션
| 컨트롤 | 기능 |
|---|---|
| 버전 | 버전을 표시합니다: "버전 3(최신) · 날짜 · 업로드한 사람". 파일이 제거된 버전에는 "파일 제거됨"이 표시됩니다. |
| 다운로드(PDF) | 표시된 버전의 PDF를 저장합니다. 변환 없이 표시된 Word 파일은 다운로드(.docx)를 제공합니다. |
| 최신으로 복원 | 표시된 버전을 새 버전으로서 다시 최신으로 만듭니다. 아무것도 덮어쓰지 않습니다. 편집자만 가능하며 최신 버전에서는 사용할 수 없습니다. |
| 새 버전 업로드… | 다음 버전을 추가합니다. 편집자만 가능합니다. |
| 버전 비교… | 삽입, 삭제, 이동된 텍스트가 표시된 두 버전을 나란히 보여 줍니다. "두 버전 비교"를 참조합니다. |
| 이전 버전의 파일 제거… | 선택한 이전 버전의 파일을 삭제합니다. 아래를 참조합니다. |
| 페이지 / PDF 뷰어 | 문서 뷰어(페이지, 찾기, 댓글) 또는 브라우저 자체의 PDF 뷰어(인쇄). |
| 검토 보기 / 별도 창으로 분리 | 창 전체 또는 별도 창에 표시되는 문서 뷰어. |
| 페이지에 댓글 달기… / 댓글 고정 | Word 보기(변환 없이 유지된 Word 파일)에서: 페이지 번호로 지정한 페이지 또는 클릭한 단락에 대한 댓글. 끝내려면 고정 중지를 클릭합니다. PDF는 뷰어 자체의 도구를 사용합니다(검토 및 댓글 참조). |
도구 아래에 버전 정보가 표시됩니다: 업로드(누가, 언제), 업로드한 파일(원래 이름), 메모, 저장됨(크기와 절감량), 베이스라인에 포함(베이스라인 이름을 클릭하면 기록된 댓글 스레드를 볼 수 있음).
이전 버전의 파일 제거
이전 버전의 PDF는 저장 공간을 차지합니다. 아무도 필요로 하지 않는 것을 제거합니다.
- Artifact에서 이전 버전의 파일 제거…를 클릭합니다.
- 버전을 선택합니다.
"버전 2의 파일을 영구적으로 제거합니다. 버전은 기록에 남습니다."가 표시됩니다.
- 파일 제거를 클릭합니다.
"버전 1개의 파일을 제거했습니다(12.4 MB 확보)."가 표시됩니다.
- 제거할 수 있는 사람: 개인 요금제에서는 계정 소유자(프로젝트 소유자), Team 요금제에서는 조직 관리자. 조직 관리자는 프로젝트 편집 권한이 필요 없으며, 제거 기록에는 관리자의 이름이 남습니다.
- 최신 버전은 이 방법으로 제거할 수 없습니다. 제거하려면 Artifact를 삭제합니다.
- 버전은 목록에 남으며 "날짜에 이름이(가) 파일을 제거함"으로 표시됩니다. 그 댓글은 토론에 텍스트로 남습니다.
- 제거는 버전과 확보된 공간과 함께 감사 로그에 기록됩니다.
추가 중인 파일
업로드가 진행 중인 동안 데이터베이스에 추가 중인 파일이 표시됩니다.
- 업로드하는 중…: 파일을 보내는 중입니다. 취소하면 중지되고 아무것도 추가되지 않습니다.
- 대기 중(앞에 n개) 또는 대기 중(다음): 파일이 차례를 기다립니다. 취소하면 대기열에서 제거됩니다.
- 변환하는 중…, 압축하는 중…, 저장하는 중…: 파일을 처리하는 중입니다.
- 추가할 수 없었던 파일은 닫기를 클릭할 때까지 메시지와 함께 목록에 남습니다.
변환 중에 서버가 다시 시작되면 파일은 대기열로 돌아가 한 번 더 시도됩니다.
변환 없이
서버에 변환기가 없으면 파일은 업로드한 그대로 저장됩니다.
- PDF는 압축 없이 저장됩니다.
- Word 파일은 브라우저에 읽기 전용으로 표시됩니다: "브라우저에 읽기 전용으로 표시됩니다(이 서버에는 PDF 변환이 없음). 레이아웃이 Word와 다를 수 있습니다." 이때 댓글 고정은 댓글을 단락에 고정합니다.
메시지
| 메시지 | 할 일 |
|---|---|
| "file은(는) 140 MB입니다. 100 MB가 넘는 Word 파일은 변환할 수 없습니다. Word에서 파일 → 다른 이름으로 저장 → PDF를 선택한 다음 PDF를 업로드합니다." | Word에서 문서를 PDF로 저장하고 PDF를 업로드합니다. |
| "file을(를) 변환할 수 없습니다: 파일이 암호로 보호되어 있습니다. 암호를 제거하고 다시 업로드합니다." | Word에서 파일을 열고 열기 암호를 제거한 다음 저장하고 다시 업로드합니다. |
| "file을(를) 변환할 수 없습니다: 파일이 손상되었거나 Word 문서가 아닙니다." | Word에서 파일을 열어 저장하거나 PDF를 업로드합니다. |
| "file을(를) 변환할 수 없습니다: 5분 넘게 걸렸습니다(매우 크거나 복잡함). 파일을 나누거나 PDF로 저장하여 PDF를 업로드합니다." | 문서를 나누거나 Word에서 PDF로 저장하여 PDF를 업로드합니다. |
| "file을(를) 변환할 수 없습니다: 변환기가 가진 것보다 많은 메모리가 필요합니다(큰 이미지가 많음). 이미지를 줄이거나 PDF를 업로드합니다." | Word에서 그림을 압축하거나(그림 서식 → 그림 압축) PDF를 업로드합니다. |
| "file을(를) 저장할 수 없습니다: 파일이 손상되었거나 PDF가 아닙니다." | PDF를 만든 프로그램에서 PDF를 다시 저장합니다. |
| "Word 문서(.docx)와 PDF만 Artifact가 됩니다. 추가되지 않음: files." | 다른 형식은 먼저 .docx 또는 PDF로 저장합니다. |
| 파일당 한도 메시지 | 파일이 요금제의 파일당 한도를 넘습니다. Word 파일에는 PDF로 저장하라는 안내도 표시됩니다. |
파일을 추가할 수 없으면 아무것도 남지 않습니다: Artifact도, 버전도 없으며 업로드한 파일은 삭제됩니다.
제한 사항
| 요금제 | 파일당 |
|---|---|
| Free / Academic | 10 MB |
| Individual | 25 MB |
| Team | 100 MB |
- 100 MB가 넘는 Word 파일은 어떤 요금제에서도 변환할 수 없습니다.
- 파일당 한도는 업로드하는 파일에 적용됩니다. 저장된 PDF는 프로젝트와 사용자의 저장 공간에 포함됩니다.
- Word 및 PDF Artifact는 LML 프로젝트에서 사용할 수 있습니다.