프로젝트 이력

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 이벤트 타일은 실선 파란색 연결선과 노드로 타임라인의 메인 줄기에 물리적으로 연결됩니다:

프로젝트 커밋

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

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

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

– 요소 추가됨.

– 요소 제거됨.

– 요소 수정됨.

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

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

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

• Clone – 이 명령을 사용하면 해당 프로젝트의 특정 리비전에서 클론을 생성할 수 있습니다. Clone Project 창이 열리며, 여기서 프로젝트 Name, Description를 결정하고, Advanced 옵션 아래에서 대상 Server Folder 및 Repository를 지정합니다. 창의 배너 텍스트는 어떤 프로젝트 리비전에서 클론을 생성하는지 반영합니다. 필요한 정보를 정의한 후 버튼을 클릭합니다. 프로젝트가 생성되고 Project Cloned 이벤트 타일이 타임라인에 추가됩니다.

활성 프로젝트의 어떤 특정 리비전에서든 해당 리비전의 Project Committed 이벤트 타일에서 직접 클론을 만들 수 있습니다.

• Download Snapshot – 이 명령을 사용하면 해당 프로젝트의 특정 리비전에 대한 프로젝트 소스를 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에서 릴리스 패키지 찾아보기를 참고하세요.

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

• BOM To– 이 릴리스의 BOM(Bill of Materials) 데이터를 다른 릴리스의 BOM 데이터와 비교할 수 있습니다. 연결된 하위 메뉴를 사용해 이전 릴리스의 BOM 데이터와 비교하거나, 프로젝트에 대해 생성된 모든 릴리스 중에서 선택할 수 있습니다. 데이터 비교 기능은 지정한 프로젝트 릴리스 간의 원시 BOM 데이터 차이를 감지하며, Workspace의 프로젝트 Releases view에서도 접근할 수 있습니다. 비교 결과는 CSV 파일 다운로드로 제공되며, 지정한 프로젝트 릴리스 간에 변경된 BOM 데이터(추가, 제거 또는 업데이트)를 상세히 보여줍니다.

• Download – subsequent window를 통해 릴리스 패키지에 포함된 데이터 세트 중 다운로드할 항목을 선택할 수 있습니다. 선택을 마친 후 버튼을 클릭합니다. 선택한 각 데이터 세트별 폴더가 포함된 단일 Zip 아카이브가 다운로드됩니다.
• Download Snapshot – 해당 릴리스 패키지를 생성하는 데 사용된 설계 버전의 스냅샷을 Zip 아카이브로 다운로드할 수 있습니다.

Project Cloning

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

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

Project Cloned 이벤트 타일 예시.

MCAD Exchanges

Related page: Altium MCAD CoDesigner

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

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

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

Filtered Search

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

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

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

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

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

Updating with New Events

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

수동 새로 고침도 제공되며, 뷰 오른쪽 상단의 컨트롤을 클릭해 수행합니다.