Lịch sử dự án

Sơ lược

Khám phá cách chế độ xem Project History của Altium Designer giúp bạn theo dõi quá trình phát triển của một dự án trong Workspace được kết nối thông qua dòng thời gian đồ họa, từ khi tạo dự án, ghi nhận các commit, phát hành, sao chép đến trao đổi dữ liệu MCAD. Bài viết này giải thích cách truy cập và điều hướng dòng thời gian, hiểu các ô sự kiện và sử dụng các thao tác với commit để kiểm tra thay đổi, xem các phiên bản trước, so sánh dữ liệu thiết kế và quản lý thẻ. Bài viết cũng làm rõ lý do cần sử dụng hệ thống quản lý phiên bản tích hợp sẵn trong Workspace để truy cập lịch sử commit. Hãy đọc tiếp để khai thác hiệu quả hơn lịch sử dự án của bạn.

- Tìm hiểu cách mở lịch sử dự án và tệp, điều hướng giữa các sự kiện và lọc dòng thời gian bằng tính năng tìm kiếm.
- Nắm rõ các yêu cầu thiết lập, bao gồm tiện ích mở rộng Project History và hệ thống quản lý phiên bản Git tích hợp sẵn trong Workspace.
- Khám phá cách xem lại các thay đổi trong commit, mở các phiên bản ở chế độ chỉ đọc, so sánh dữ liệu sơ đồ nguyên lý, PCB và BOM, cũng như quản lý thẻ commit.
Tìm hiểu sâu hơn với AI:

Altium Designer, kết hợp với một Workspace được kết nối, cho phép bạn xem và tương tác với dòng thời gian Project History nâng cao theo dạng đồ họa. Chế độ xem History chuyên dụng cung cấp dòng thời gian thể hiện diễn tiến các sự kiện chính liên quan đến dự án PCB, Multi-board hoặc Harness – tạo dự án, commit, phát hành, sao chép và trao đổi MCAD – đồng thời hỗ trợ nhiều thao tác khi phù hợp.

Để khai thác tối đa tính năng này, dự án của bạn cần được quản lý hoàn toàn bằng cách đảm bảo dự án nằm trong hệ thống kiểm soát phiên bản (VCS) tích hợp sẵn của Workspace (Git).

Nếu dự án của bạn đang sử dụng hệ thống kiểm soát phiên bản bên ngoài, bạn có thể chuyển đổi dự án thành dự án được quản lý hoàn toàn trên Altium 365 Workspace bằng cách di chuyển dự án sang VCS gốc của Workspace. Để biết thông tin chi tiết về cách thực hiện, hãy xem Chuyển từ VCS bên ngoài sang VCS gốc của Workspace.

Để biết thông tin về cách làm việc với chế độ xem History của một dự án thông qua giao diện trình duyệt của Workspace, hãy xem Lịch sử dự án.

Để truy cập các chức năng lịch sử dự án trong Altium Designer, bạn phải cài đặt tiện ích mở rộng phần mềm Project History . Tiện ích mở rộng này được cài đặt mặc định cùng với Altium Designer. Bạn có thể cài đặt hoặc gỡ bỏ tiện ích này theo cách thủ công.

Để biết thêm thông tin về cách quản lý tiện ích mở rộng, hãy tham khảo trang Extending Your Installation (Altium Designer Develop, Altium Designer Agile, Altium Designer).

Truy cập lịch sử dự án

Để truy cập chế độ xem History cho một dự án Workspace từ bên trong Altium Designer, hãy nhấp chuột phải vào mục tương ứng của dự án trong bảng Projects và chọn lệnh History & Version Contol » Show Project History từ menu ngữ cảnh. Ngoài ra, hãy chọn lệnh History & Version Control » Show Project History  từ menu chính Project để mở chế độ xem Lịch sử cho dự án Workspace đang hoạt động. Chế độ xem History được hiển thị dưới dạng một tài liệu dạng thẻ riêng biệt (<ProjectName>.PrjPcb History).

Đối với một dự án trong Workspace đã tồn tại trước khi tính năng Lịch sử dự án ra mắt, lịch sử của dự án ban đầu sẽ chưa đầy đủ. Dữ liệu sự kiện của dự án đó sẽ tự động được lập chỉ mục lại khi bạn truy cập chế độ xem History của dự án lần đầu tiên. Một thông báo sẽ xuất hiện ở cuối chế độ xem sau khi quá trình lập chỉ mục lại hoàn tất – hãy nhấp vào nút điều khiển để cập nhật dòng thời gian với đầy đủ dữ liệu sự kiện trong quá khứ.
Để truy cập chế độ xem History cho một tệp của dự án Workspace, tức là dòng thời gian thể hiện các sự kiện chính của dự án liên quan đến tệp đó, hãy nhấp chuột phải vào tệp trong bảng Projects , sau đó chọn lệnh History & Version Control » Show File History  từ menu ngữ cảnh.

Dòng thời gian lịch sử – Tổng quan

Chế độ xem History trình bày dòng thời gian gồm các sự kiện cơ bản đã diễn ra trong quá trình phát triển dự án. Về cơ bản, chế độ xem này có thể được chia thành ba phần chính, như minh họa trong hình và phần mô tả chi tiết bên dưới.

Nhận diện ba thành phần chính của chế độ xem History .Nhận diện ba thành phần chính của chế độ xem History .

  1. Main trunk of the timeline. Thứ tự thời gian của các sự kiện đi từ dưới lên trên. Sự kiện đầu tiên – tạo dự án – sẽ xuất hiện ở cuối dòng thời gian. Các sự kiện tiếp theo xuất hiện ở phía trên, với sự kiện mới nhất (hiện tại nhất) nằm ở đầu dòng thời gian.
  2. Events. Mỗi khi một sự kiện được hỗ trợ (xem bên dưới) xảy ra liên quan đến dự án, sự kiện đó sẽ được thêm vào dòng thời gian dưới dạng một ô riêng. Mỗi loại sự kiện sẽ có ô màu khác nhau và được liên kết trực tiếp với trục chính của dòng thời gian hoặc có thêm biểu tượng bên cạnh (như đối với các sự kiện Trao đổi MCAD).
  3. Search. Nhấp vào nút điều khiển ở góc trên bên phải của chế độ xem để truy cập trường tìm kiếm, cho phép tìm kiếm cơ bản trong lịch sử dự án. Khi bạn nhập chuỗi tìm kiếm, bộ lọc sẽ được áp dụng cho dòng thời gian để chỉ hiển thị các sự kiện liên quan đến nội dung tìm kiếm đó. Để biết thêm thông tin, hãy xem Tìm kiếm có lọc.

Các sự kiện được hỗ trợ

Dòng thời gian thể hiện diễn tiến của các sự kiện xảy ra trong vòng đời dự án. Mỗi sự kiện này xuất hiện dọc theo dòng thời gian dưới dạng một “ô sự kiện” riêng. Các mục có thể mở rộng bên dưới trình bày những loại sự kiện hiện được hỗ trợ và có thể hiển thị trong dòng thời gian lịch sử của dự án.

Tìm kiếm có lọc

Nhấp vào nút điều khiển ở góc trên bên phải của chế độ xem để truy cập trường tìm kiếm, giúp nhanh chóng tìm các sự kiện bạn quan tâm trên dòng thời gian. Chức năng tìm kiếm hỗ trợ tìm kiếm cơ bản trong lịch sử dự án, với bộ lọc được áp dụng linh hoạt khi bạn nhập chuỗi tìm kiếm – chỉ những sự kiện liên quan đến nội dung tìm kiếm đó được hiển thị trên trang. Văn bản khớp trong ô sự kiện được tô sáng.

Chức năng tìm kiếm không phân biệt chữ hoa và chữ thường.

Ví dụ tìm kiếm trong lịch sử dự án. Dòng thời gian được lọc linh hoạt khi bạn nhập từ khóa tìm kiếm (không phân biệt chữ hoa và chữ thường), với các nội dung khớp được tô sáng trong từng ô sự kiện liên quan.Ví dụ tìm kiếm trong lịch sử dự án. Dòng thời gian được lọc linh hoạt khi bạn nhập từ khóa tìm kiếm (không phân biệt chữ hoa và chữ thường), với các nội dung khớp được tô sáng trong từng ô sự kiện liên quan.

Một hộp được hiển thị phía trên các kết quả đã lọc, tóm tắt số sự kiện hiện đang được hiển thị, cùng với các nút điều khiển để nhanh chóng xóa bộ lọc/chuỗi tìm kiếm.

Chức năng tìm kiếm hoạt động với các thông tin sau:

  • Tiêu đề ô sự kiện.
  • Tên người thực hiện sự kiện.
  • Văn bản mô tả (văn bản lấy từ bình luận/ghi chú/mô tả khi sự kiện tương ứng xảy ra).
  • Văn bản dữ liệu so sánh khác biệt – trong ô sự kiện Project Committed.
  • Tên tập dữ liệu – trong ô sự kiện Project Released.
  • Tên dự án – trong ô sự kiện Project Copied và ô sự kiện Project Created (khi được tạo bằng cách sao chép).
Để xóa bộ lọc hiện tại và quay lại dòng thời gian đầy đủ, hãy xóa nội dung trường tìm kiếm – bằng cách chọn văn bản hiện tại rồi nhấn phím Backspace hoặc nhấp vào nút điều khiển ở ngoài cùng bên phải của trường. Ngoài ra, hãy nhấp vào nút điều khiển Clear Filter trong hộp tóm tắt số sự kiện đang được hiển thị (ở đầu chế độ xem).

Cập nhật sự kiện mới

Bất cứ khi nào một sự kiện được hỗ trợ xảy ra liên quan đến dự án, sự kiện đó sẽ được phát hiện và tự động cung cấp cho chế độ xem History . Thông báo sẽ xuất hiện ở cuối chế độ xem ngay sau khi sự kiện diễn ra – nhấp vào nút điều khiển để cập nhật dòng thời gian với sự kiện mới.

Bạn cũng có thể làm mới thủ công bằng cách nhấp vào nút điều khiển ở góc trên bên phải của chế độ xem.

Tạo báo cáo lịch sử dự án

Bạn có thể tạo báo cáo Lịch sử dự án ở định dạng PDF cho một dự án Workspace. Báo cáo hiển thị toàn bộ thông tin về lịch sử dự án, bao gồm quá trình tạo, các lần commit và phát hành, cũng như mô tả các thay đổi so với sự kiện trước đó. Bạn cũng có thể đặt khoảng thời gian cho báo cáo (được mô tả bên dưới) để có được báo cáo đầy đủ theo đúng nhu cầu.

Từ OutJob

Để tạo báo cáo, trong tệp OutputJob (*.OutJob), nhấp chuột phải vào [Add New Report Output] tương ứng với mục Report Outputs rồi chọn Project History, như minh họa bên dưới.

Kết nối báo cáo vừa tạo với một bộ chứa đầu ra PDF. Đặt khoảng thời gian cho báo cáo bằng cách nhấp chuột phải vào đầu ra đã tạo rồi chọn Configure. Bật tùy chọn thời gian Period mong muốn: For all time (từ khi tạo dự án đến hiện tại), hoặc Specific releases (sử dụng danh sách thả xuống của trường From/To để đặt các bản phát hành mong muốn). Báo cáo được xuất sẽ chứa thông tin cho khoảng thời gian bạn đã chọn.

Sau khi báo cáo được tạo, liên kết với bộ chứa đầu ra PDF và cấu hình xong, trong vùng bộ chứa PDF, nhấp vào Generate content, hoặc nếu muốn, bạn có thể tạo báo cáo lịch sử dự án như một phần của quy trình phát hành dự án.

Từ menu Reports

Bạn có thể xuất Lịch sử dự án thành tệp PDF bằng cách chọn Reports » Project History từ các menu chính. Hộp thoại Project History Report Configuration mở ra, cho phép bạn đặt Period để xuất báo cáo: toàn bộ lịch sử dự án hoặc từ/đến một bản phát hành dự án cụ thể (hoặc mới nhất). Nhấp vào Export rồi nhập tên cho tệp PDF được xuất trong cửa sổ Explorer vừa mở, sau đó nhấp vào Save. Báo cáo PDF sẽ mở trong trình duyệt.
AI-LocalizedBản địa hóa bằng AI
Nếu bạn phát hiện vấn đề, hãy chọn văn bản/hình ảnh và nhấnCtrl + Enterđể gửi phản hồi cho chúng tôi.
Nav
Contents
Tính khả dụng của tính năng

Các tính năng bạn có thể sử dụng phụ thuộc vào giải pháp Altium mà bạn đang có – Altium Develop, Altium Agile Teams, Altium Agile Enterprise, hoặc Altium Designer (đang trong thời hạn hiệu lực).

Nếu bạn không thấy một tính năng được nêu trong tài liệu có trong phần mềm thực tế của mình, liên hệ Bộ phận Kinh doanh của Altium để tìm hiểu thêm.

Tài liệu cũ

Tài liệu Altium Designer không còn được phân phiên bản. Nếu bạn cần truy cập tài liệu cho các phiên bản cũ hơn của Altium Designer, hãy truy cập mục Tài liệu cũ trên trang Trình cài đặt khác.

Contents