Altium On-Prem Enterprise Server의 프로젝트 히스토리

Enterprise Server Workspace는 전용의 대화형 Historyview 형태로 프로젝트 활동에 대한 이력 개요를 제공해야 하는 요구를 우아하게 해결합니다. Workspace's browser interface를 통해서 또는 Altium Designer 내부에서 접근할 수 있으며, 프로젝트 History view는 프로젝트와 관련된 주요 이벤트의 진행형 타임라인을 제공합니다. 이벤트에는 프로젝트 생성, 커밋, 릴리스, 클론, MCAD 교환이 포함되며, 해당되는 경우 이벤트 작업 명령도 함께 제공됩니다.

프로젝트 히스토리 접근하기

프로젝트의 History view는 해당 프로젝트의 상세 CAD 중심 관리 페이지인 Projects Management page에서 접근할 수 있습니다. 왼쪽 패널에서 History 옵션을 클릭합니다.

Projects Management page 자체는 메인 Projects page에서 프로젝트 항목을 더블 클릭하거나, 제목을 클릭하거나, 메뉴에서 Open 옵션을 선택하여 열 수 있습니다. 자세한 내용은 Management of a Specific Project를 참고하세요.

해당 프로젝트의 상세 관리 페이지에서 프로젝트 히스토리에 접근합니다.

히스토리 타임라인 – 개요

History view는 프로젝트가 발전하는 동안 발생한 기본 이벤트의 타임라인을 제시합니다. 아래 이미지와 설명에 표시된 것처럼, 본질적으로 세 가지 핵심 요소로 나눌 수 있습니다.

History view의 세 가지 핵심 구성 요소 식별.

1. Main trunk of the timeline. 이벤트의 시간 흐름 방향은 아래에서 위로입니다. 첫 번째 이벤트(프로젝트 생성)는 타임라인 맨 아래에 표시됩니다. 이후 이벤트는 그 위에 표시되며, 최신 이벤트(가장 최근 이벤트)는 타임라인 맨 위에 표시됩니다.
2. Events. 프로젝트와 연관된 지원 이벤트(아래 참조)가 발생할 때마다, 해당 이벤트는 전용 타일 형태로 타임라인에 추가됩니다. 이벤트 유형마다 타일 색상이 다르며, 타임라인의 메인 줄기(trunk)에 직접 연결되거나, 옆에 연관 아이콘이 표시됩니다(MCAD Exchange 이벤트의 경우처럼; ).
3. Search. view 오른쪽 상단의 컨트롤을 클릭하면 프로젝트 히스토리를 기본적으로 검색할 수 있는 검색 필드에 접근할 수 있습니다. 검색 문자열을 입력하는 동안 타임라인에 필터링이 적용되어 해당 검색과 관련된 이벤트만 표시됩니다. 자세한 내용은 Filtered Searching를 참고하세요.

지원 이벤트

타임라인은 프로젝트 수명 주기 동안 발생하는 이벤트의 진행을 보여줍니다. 각 이벤트는 타임라인을 따라 전용 ‘이벤트 타일’로 표시됩니다. 다음 섹션에서는 현재 지원되며 프로젝트의 이력 타임라인 일부로 표시 가능한 이벤트 범위를 살펴봅니다.

프로젝트 생성

Related pages:새 Workspace 프로젝트 생성(browser interface / Altium Designer), Making an Existing Project Available Online, 프로젝트 클로닝(browser interface / Altium Designer)

프로젝트가 생성되면 Project Created 이벤트 타일이 타임라인에 추가됩니다. 이 이벤트는 해당 프로젝트 이력 타임라인의 시작을 의미합니다. 따라서 항상 타임라인 맨 아래 항목으로 찾을 수 있습니다. 이 이벤트의 타일은 두 가지 서로 다른 형태로 표시될 수 있습니다:

• Workspace 내에서 새로 프로젝트가 생성된 경우. 프로젝트 생성자가 이름(및 사진/기호)과 함께 표시되며, 프로젝트 생성 시간도 함께 표시됩니다. 생성 시 프로젝트 설명을 입력했다면 해당 설명도 타일 내에 표시됩니다.

• 프로젝트가 기존 프로젝트의 클론인 경우. 클론 프로젝트를 생성한 사람이 이름(및 사진/기호)과 함께 표시되며, 프로젝트 생성 시간도 함께 표시됩니다. 클로닝 시 프로젝트 설명을 입력했다면 해당 설명도 타일 내에 표시됩니다. 원본 소스 프로젝트로 이동하는 링크가 제공되며, 이를 클릭하면 해당 프로젝트의 상세 관리 페이지로 이동하고 브라우저의 별도 탭에서 열립니다.

Project Created 이벤트 타일은 파란색 실선 연결선과 노드를 통해 타임라인의 메인 줄기(trunk)에 물리적으로 연결됩니다:

프로젝트 커밋

프로젝트를 Worskpace에 저장할 때마다(프로젝트는 Worskpace 내부 Versioned Storage Git repository에서 관리됨) Project Committed 이벤트 타일이 타임라인에 추가됩니다. 커밋 및 푸시를 수행한 사람이 이름(및 사진)과 함께 표시되며, 날짜와 시간도 함께 표시됩니다. 커밋 및 푸시 시 Save to Server dialog를 통해 코멘트를 추가했다면, 해당 코멘트도 타일 내에 표시됩니다.

초기 Project Committed 이벤트 타일 예시.

또한 이 타일은 디자인 diff 정보도 지원 및 표시하여, 현재 커밋과 이전 커밋 사이에서 무엇이 변경되었는지에 대한 더 상세한 정보를 보여줍니다. 지원되는 요소에는 파일, 컴포넌트, 넷, 변형(variants), PCB 구조가 포함됩니다. 타일의 diff 섹션은 커밋 이벤트로 인해 영향을 받은 다양한 요소를 다음 상태로 그룹화하여 요약합니다:

– 요소 추가됨.

– 요소 제거됨.

– 요소 수정됨.

타일에서 컨트롤을 클릭하면 이 diff 섹션이 확장되어 영향을 받은 요소가 이름과 함께 표시됩니다.

각 요소 유형에 대한 전체 목록을 확인하려면 제공되는 Show More 및 Show Less 컨트롤을 사용합니다. 요약 표시로 돌아가려면 타일에서 컨트롤을 클릭합니다.

타일 오른쪽 상단의 컨트롤을 클릭하면 다음 명령이 포함된 메뉴에 접근할 수 있습니다:

• View – 이 명령을 사용하면 선택한 커밋의 소스 설계 데이터를 Web Viewer에서 해당 시점의 설계 스냅샷으로 열 수 있습니다.
• Create Tag – 현재 선택된 커밋에 VCS 태그 이름을 추가합니다. 커밋에 연결된 태그는 해당 커밋의 History view 타일, Web Viewer의 스냅샷 view 헤더, 그리고 그 스냅샷 view에 첨부된 모든 코멘트에 표시됩니다. 커밋에 Tag가 추가되면 타일의 메뉴 명령은 Tag로 변경되며, 커밋 태그를 수정(Edit)하거나 삭제(Remove)하는 하위 옵션을 제공합니다.

Create Tag 메뉴 옵션을 선택하여 커밋 History 이벤트에 태그 이름을 추가합니다.

태그가 지정된 History 커밋 이벤트의 스냅샷 view에는 태그 이름 라벨이 표시됩니다.

라이브 WIP 설계에서 코멘트를 볼 때, 태그가 지정된 커밋의 설계 스냅샷에서 생성된 코멘트에는 연관된 태그 이름이 포함됩니다. 태그 이름 링크를 선택하면 관련 커밋 스냅샷이 열립니다. 코멘트 작업에 대한 자세한 내용은 Web Viewer Comments를 참고하세요.

태그가 지정된 커밋 이벤트의 스냅샷에 추가된 코멘트에는 연관된 태그 이름이 포함됩니다.

• Schematic to – 이 커밋의 Schematic 데이터를 다른 커밋 또는 릴리스 이벤트의 데이터와 비교할 수 있습니다. 하위 메뉴를 사용해 이전 커밋의 소스 데이터와 비교하거나, 가능한 모든 커밋 또는 릴리스 중에서 선택할 수 있습니다. 비교 대상 릴리스/커밋을 선택하면 비교 결과가 Compare view에 표시되며, 기본 웹 브라우저의 새 탭에서 열립니다. 자세한 내용은 Schematic Comparison을 참고하세요.
• PCB to – 이 커밋의 PCB 데이터를 다른 커밋 또는 릴리스 이벤트의 데이터와 비교할 수 있습니다. 하위 메뉴를 사용해 이전 커밋의 소스 데이터와 비교하거나, 가능한 모든 커밋 또는 릴리스 중에서 선택할 수 있습니다. 비교 대상 릴리스/커밋을 선택하면 비교 결과가 Compare view에 표시되며, 기본 웹 브라우저의 새 탭에서 열립니다. 자세한 내용은 PCB Comparison을 참고하세요.
• BOM to – 이 커밋의 BOM 데이터를 다른 커밋 또는 릴리스 이벤트의 데이터와 비교할 수 있습니다. 관련 하위 메뉴를 사용해 이전 커밋의 BOM 데이터와 비교하거나, 프로젝트에 대해 생성된 모든 커밋/릴리스 중에서 선택할 수 있습니다. 비교 대상을 선택하면 비교 결과가 색상으로 구분된 BOM 항목 목록으로 표시되며, 지정된 Commit/Release 이벤트 간 변경된 항목을 나타냅니다. 변경 사항의 취합 요약이 표준 CSV 형식으로 생성되며, ZIP 아카이브 파일로 다운로드할 수 있도록 제공됩니다. 자세한 내용은 BOM Comparison을 참고하세요.
• Clone– 이 명령을 사용하면 프로젝트의 해당 특정 리비전에서 클론을 생성할 수 있습니다. 프로젝트 Name, Description을(를) 지정하고, Advanced 옵션에서 대상 Server Folder 및 Repository을(를) 결정할 수 있는 Clone Project 창이 표시됩니다. 창의 배너 텍스트에는 어떤 프로젝트 리비전에서 클론이 생성되는지가 반영됩니다. 필요한 정보를 정의한 후 버튼을 클릭합니다. 프로젝트가 생성되고 타임라인에 Project Cloned 이벤트 타일이 추가됩니다.

활성 프로젝트의 어떤 특정 리비전에서든 클론을 만들 수 있으며, 해당 리비전에 대응하는 Project Committed 이벤트 타일에서 바로 수행할 수 있습니다.

• Download Sources – 이 명령을 사용하면 프로젝트의 해당 특정 리비전에 대한 프로젝트 소스를 Zip 아카이브로 다운로드할 수 있습니다. Zip 파일 이름과 PCB 프로젝트 파일에는 해당 프로젝트 리비전이 Workspace에 커밋 및 푸시된 날짜와 시간(UTC)이 포함됩니다.

Project Committed 이벤트 타일은 파란색 실선 연결선과 노드()로 타임라인의 메인 트렁크에 물리적으로 연결됩니다. 프로젝트의 최신 리비전(즉, 마지막 커밋)은 노드가 흰색으로 채워져() 구분됩니다.

프로젝트 릴리스

Related page: 디자인 프로젝트 릴리스

Altium Designer의 Project Releaser를 사용하여 프로젝트를 릴리스할 때마다 타임라인에 Project Released 이벤트 타일이 추가됩니다. 릴리스를 수행한 사람의 이름(및 사진)과 날짜/시간이 표시됩니다. 생성된 데이터를 Workspace에 릴리스할 때 Confirm Release dialog를 통해 릴리스 노트를 추가했다면, 해당 내용도 타일에 표시됩니다. 또한 릴리스에 포함된 각 데이터 세트도 나열됩니다.

Project Released 이벤트 타일 예시.

타일 오른쪽 상단의 컨트롤을 클릭하면 다음 명령이 있는 메뉴에 접근할 수 있습니다:

• View– 릴리스된 데이터를 더 자세히 검사할 수 있는 전용 제조 포털(별도의 브라우저 탭)을 엽니다. 이 포털에서 릴리스된 파일 데이터를 보고 탐색할 수 있으며, BOM을 검사하고, 설계 자체의 스냅샷(즉, 해당 릴리스 데이터의 소스)을 보고 코멘트를 달 수 있습니다. 또한 전체 데이터 세트부터 개별 생성 출력 파일까지 다양한 세분화 수준으로 제조 데이터를 다운로드하는 컨트롤에도 접근할 수 있습니다. 자세한 내용은 Manufacturing Portal에서 Release Package 찾아보기를 참고하십시오.

프로젝트 릴리스를 더 자세히 검사할 수 있는 전용 Manufacturing Portal 탭에 접근하는 모습.

• Schematic to– 이 릴리스의 Schematic 데이터를 다른 릴리스 또는 커밋 이벤트의 데이터와 비교할 수 있습니다. 하위 메뉴를 사용해 이전 릴리스의 소스 데이터와 비교하거나, 가능한 모든 릴리스 및 커밋 중에서 선택할 수 있습니다. 비교할 릴리스/커밋을 선택하면 비교 결과가 Compare 보기로 표시되며, 기본 웹 브라우저에서 새 탭으로 열립니다. 자세한 내용은 Schematic Comparison을(를) 참고하십시오.
• PCB to– 이 릴리스의 PCB 데이터를 다른 릴리스 또는 커밋 이벤트의 데이터와 비교할 수 있습니다. 하위 메뉴를 사용해 이전 릴리스의 소스 데이터와 비교하거나, 가능한 모든 릴리스 및 커밋 중에서 선택할 수 있습니다. 비교할 릴리스/커밋을 선택하면 비교 결과가 Compare 보기로 표시되며, 기본 웹 브라우저에서 새 탭으로 열립니다. 자세한 내용은 PCB Comparison을(를) 참고하십시오.
• Gerber to– 이 릴리스에 대해 생성된 Gerber 데이터를 다른 Gerber 데이터 세트와 비교할 수 있습니다. 관련 하위 메뉴를 사용해 이전 릴리스의 제작(fabrication) 데이터와 비교하거나, 프로젝트에 대해 수행된 모든 릴리스 중에서 선택(타임라인이 Project Released 이벤트 타일만 표시되도록 필터링됨)하거나, 로컬에서 생성(및 업로드)한 파일 세트와 비교할 수 있습니다. 비교 대상을 선택하면 결과가 Gerber Compare 보기로 표시되며, 별도의 브라우저 탭에서 열립니다. 자세한 내용은 Gerber Comparison을(를) 참고하십시오.
• BOM To– 이 릴리스의 Bill of Materials(BoM) 데이터를 다른 릴리스의 데이터와 비교할 수 있습니다. 관련 하위 메뉴를 사용해 이전 릴리스의 BOM 데이터와 비교하거나, 프로젝트에 대해 수행된 모든 릴리스 중에서 선택할 수 있습니다. 비교 대상을 선택하면 비교 결과가 색상으로 구분된 BOM 항목 목록으로 표시되며, 지정한 Commit/Release 이벤트 간 변경된 항목을 나타냅니다. 변경 사항의 취합 요약이 표준 CSV 형식으로 생성되며 ZIP 아카이브 파일로 다운로드할 수 있습니다. 자세한 내용은 BOM Comparison을(를) 참고하십시오.
• Download Outputs– subsequent window를 통해 릴리스 패키지에서 다운로드할 데이터 세트를 선택할 수 있습니다. 선택을 마친 후 버튼을 클릭합니다. 선택한 각 데이터 세트에 대한 폴더가 포함된 단일 Zip 아카이브가 다운로드됩니다.
• Download Sources– 해당 릴리스 패키지를 생성하는 데 사용된 설계 버전의 스냅샷을 Zip 아카이브로 다운로드할 수 있습니다.

프로젝트 클로닝

Related page:프로젝트 클로닝(browser interface / Altium Designer)

Workspace의 브라우저 인터페이스 또는 Altium Designer 내부에서 프로젝트를 클론할 때마다 타임라인에 Project Cloned 이벤트 타일이 추가됩니다. 클론을 수행한 사람의 이름(및 사진)과 날짜/시간이 표시됩니다. 클로닝 시점에 생성된 설명이 타일에 추가되며, 새 설명을 입력하여 이를 재정의할 수 있습니다. 클론된 프로젝트로 이동하는 링크가 제공되며, 이를 클릭하면 해당 프로젝트의 상세 관리 페이지가 브라우저의 별도 탭에서 열립니다.

Project Cloned 이벤트 타일 예시.

MCAD 교환

Related page: Altium MCAD CoDesigner

전자 설계와 기계 설계 도메인 간에 작업할 때 Workspace는 두 영역 사이의 브리지 역할을 하며 direct ECAD-MCAD codesign을(를) 지원합니다. 프로젝트의 PCB 설계에 변경이 발생하고 관련 CoDesigner 패널을 통해 해당 변경이 Workspace로 푸시될 때마다 타임라인에 MCAD Changes Suggested 이벤트 타일이 추가됩니다. 푸시를 수행한 사람의 이름(및 사진)과 날짜/시간이 표시됩니다. 푸시 시점에 MCAD CoDesigner 패널(Altium Designer) 또는 Altium CoDesigner 패널(supported MCAD software에서)에서 메시지를 게시했다면, 해당 내용도 타일에 표시됩니다.

MCAD 엔지니어가 지원되는 MCAD 소프트웨어에서 PCB를 변경하고 이를 Workspace로 다시 푸시하면, Altium Designer에서 Workspace의 변경 사항을 풀(pull)한 후 프로젝트의 히스토리 타임라인 only에서 해당 푸시 이벤트를 확인할 수 있습니다.

MCAD 관련 이벤트 두 개를 보여주는 예. 타임라인 트렁크의 아래쪽 이벤트는 ECAD 측의 푸시 이벤트를 나타내며, 위쪽 이벤트는 MCAD 측에서 다시 푸시한 이벤트입니다.

필터링된 검색

보기 오른쪽 상단의 컨트롤을 클릭하면 타임라인에서 관심 있는 이벤트를 빠르게 찾을 수 있는 검색 필드에 접근할 수 있습니다. 검색 기능은 프로젝트 히스토리에 대한 기본 검색을 지원하며, 검색 문자열을 입력하는 동안 동적 필터링이 적용되어 해당 검색과 관련된 이벤트만 페이지에 표시됩니다. 이벤트 타일 내에서 일치하는 텍스트는 강조 표시됩니다.

프로젝트 히스토리 검색 예시. (대/소문자 구분 없이) 검색어를 입력하는 동안 타임라인이 동적으로 필터링되며, 각 관련 이벤트 타일에서 일치 항목이 강조 표시됩니다.

검색 기능은 다음 정보를 대상으로 동작합니다:

• 이벤트 타일 제목.
• 이벤트를 수행한 사람의 이름.
• 설명 텍스트(해당 이벤트 발생 시 코멘트/노트/설명에서 가져온 텍스트).
• Diffing 데이터 텍스트 – Project Committed 이벤트 타일에서.
• 데이터 세트 이름 – Project Released 이벤트 타일에서.
• 프로젝트 이름 – Project Cloned 이벤트 타일 및 Project Created 이벤트 타일(클로닝으로 생성된 경우)에서.

현재 적용된 필터링을 해제하고 전체 타임라인으로 돌아가려면 검색 필드를 비우면 됩니다. 방법은 두 가지입니다. 현재 텍스트를 선택한 다음 Backspace 키를 누르거나, 필드 맨 오른쪽에 있는 컨트롤을 클릭합니다. 또는(대안으로) 화면 상단의 보기에서 표시 중인 이벤트 수를 요약해 보여주는 상자에 있는 Clear Filter 컨트롤을 클릭합니다.

새 이벤트로 업데이트

프로젝트와 관련하여 지원되는 이벤트가 발생하면 해당 이벤트가 감지되어 History 보기에서 자동으로 사용할 수 있게 됩니다. 이벤트가 발생한 직후 보기 하단에 알림이 표시되며, 컨트롤을 클릭하면 타임라인이 새 이벤트로 업데이트됩니다.

수동 새로 고침 기능도 제공되며, 보기의 오른쪽 상단에 있는 컨트롤을 클릭하여 수행합니다.