프로젝트 이력

Parent page: Workspace 프로젝트

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

프로젝트 이력에 접근하기

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

Projects Management 페이지 자체는 메인 Projects 페이지에서 프로젝트 항목을 더블 클릭하거나, 제목을 클릭하거나, 메뉴에서 Open 옵션을 선택하여 열 수 있습니다. 자세한 내용은 특정 프로젝트 관리를 참고하십시오.

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

History 타임라인 – 개요

History 보기는 프로젝트의 진화 과정에서 발생한 기본 이벤트의 타임라인을 제시합니다. 아래 이미지와 설명처럼, 본질적으로 세 가지 핵심 요소로 나눌 수 있습니다.

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

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

지원 이벤트

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

프로젝트 생성

Related pages:새 Workspace 프로젝트 생성(브라우저 인터페이스 / Altium Designer), 기존 프로젝트를 온라인에서 사용 가능하게 만들기, 프로젝트 클로닝(브라우저 인터페이스 / Altium Designer)

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

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

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

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

프로젝트 커밋

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

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

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

– 요소 추가됨.

– 요소 제거됨.

– 요소 수정됨.

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

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

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

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

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

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

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

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

• Schematic to – 이 커밋의 Schematic 데이터를 다른 커밋 또는 릴리스 이벤트의 데이터와 비교할 수 있습니다. 하위 메뉴를 사용해 이전 커밋의 소스 데이터와 비교하거나, 가능한 모든 커밋/릴리스 중에서 선택할 수 있습니다. 비교 대상 릴리스/커밋을 선택하면 비교 결과가 Compare 보기로 표시되며, 기본 웹 브라우저의 새 탭에서 열립니다. 자세한 내용은 Schematic Comparison을 참고하십시오.
• BOM to – 이 커밋의 BOM 데이터를 다른 커밋 또는 릴리스 이벤트의 BOM 데이터와 비교할 수 있습니다. 관련 하위 메뉴를 사용해 이전 커밋의 BOM 데이터와 비교하거나, 프로젝트에 대해 생성된 모든 커밋/릴리스 중에서 선택할 수 있습니다. 비교 대상을 선택하면 비교 결과가 지정된 Commit/Release 이벤트 사이에서 변경된 항목을 나타내는 색상 코드 BOM 항목 목록으로 표시됩니다. 변경 사항의 취합 요약이 표준 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 Package(으)로 제조사에 직접 전송할 수도 있습니다. 자세한 내용은 Manufacturing Portal에서 Release Package 찾아보기를 참고하세요.

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

• Schematic to – 이 릴리스의 Schematic 데이터를 다른 릴리스 또는 커밋 이벤트의 데이터와 비교할 수 있습니다. 하위 메뉴를 사용해 이전 릴리스의 소스 데이터와 비교하거나, 가능한 모든 릴리스 및 커밋 중에서 선택할 수 있습니다. 비교할 릴리스/커밋을 선택하면 비교 결과가 Compare 뷰에 표시되며, 기본 웹 브라우저의 새 탭으로 열립니다. 자세한 내용은 Schematic Comparison을(를) 참고하세요.
• Gerber to – 이 릴리스에 대해 생성된 Gerber 데이터를 다른 Gerber 데이터 세트와 비교할 수 있습니다. 관련 하위 메뉴를 사용해 이전 릴리스의 제작(fabrication) 데이터와 비교하거나, 프로젝트에서 수행된 모든 릴리스 중에서 선택(타임라인이 Project Released 이벤트 타일만 표시되도록 필터링됨)하거나, 로컬에서 생성(및 업로드)한 파일 세트와 비교할 수 있습니다. 비교 대상을 선택하면 결과가 Gerber Compare 뷰에 표시되며, 별도의 브라우저 탭에서 열립니다. 자세한 내용은 Gerber Comparison을(를) 참고하세요.

• BOM To – 이 릴리스의 Bill of Materials(BoM) 데이터를 다른 릴리스의 데이터와 비교할 수 있습니다. 관련 하위 메뉴를 사용해 이전 릴리스의 BOM 데이터와 비교하거나, 프로젝트에서 수행된 모든 릴리스 중에서 선택할 수 있습니다. 비교 대상을 선택하면, 지정한 Commit/Release 이벤트 간 변경된 항목을 나타내는 색상 구분 BOM 엔트리 목록으로 비교 결과가 표시됩니다. 변경 사항의 취합 요약이 표준 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로 다시 푸시하면, 해당 푸시 이벤트는 Workspace의 변경을 Altium Designer로 풀(pull)한 이후 프로젝트의 히스토리 타임라인 only에서 확인할 수 있습니다.

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

필터링된 검색

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

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

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

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

현재 필터링을 해제하고 전체 타임라인으로 돌아가려면 검색 필드를 비우면 됩니다. 현재 텍스트를 선택한 뒤 Backspace 키를 누르거나, 필드 맨 오른쪽의 컨트롤을 클릭하세요. 또는(뷰 상단에서) 표시 중인 이벤트 수를 요약하는 박스의 Clear Filter 컨트롤을 클릭할 수도 있습니다.

새 이벤트로 업데이트

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

또한 수동 새로 고침 기능도 제공되며, 뷰 오른쪽 상단의 컨트롤을 클릭하여 수행할 수 있습니다.