Lịch sử dự án
Sơ lược
- 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.
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.
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).
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 .
- 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.
- 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).
-
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ạo dự án
Refer to: Tạo dự án, Đưa dự án hiện có lên trực tuyến
Khi một dự án được tạo, ô sự kiện Project Created sẽ được thêm vào dòng thời gian. Sự kiện này đánh dấu điểm bắt đầu của dòng thời gian lịch sử dự án. Vì vậy, bạn luôn có thể tìm thấy sự kiện này ở cuối dòng thời gian. Ô dành cho sự kiện này có thể xuất hiện dưới hai dạng riêng biệt:
- Khi một dự án được tạo mới trong Workspace. Người tạo dự án được hiển thị bằng tên (và ảnh), cùng với ngày giờ tạo dự án. Mô tả dự án cũng được hiển thị trong ô nếu đã được nhập khi tạo dự án.
- Khi dự án là bản sao của một dự án hiện có. Người tạo bản sao dự án được hiển thị bằng tên, cùng với ngày giờ tạo dự án. Mô tả dự án cũng được hiển thị trong ô nếu đã được nhập khi sao chép. Một liên kết đến dự án gốc được cung cấp; nhấp vào liên kết này sẽ mở trang quản lý chi tiết của dự án đó thông qua giao diện trình duyệt của Workspace.
Commit dự án
Mỗi lần bạn commit một dự án lên Workspace (nơi dự án được quản lý trong Versioned Storage kho lưu trữ Git nội bộ của Workspace), một thẻ sự kiện Project Committed sẽ được thêm vào dòng thời gian. Người thực hiện commit (Save to Server) được hiển thị bằng tên (và ảnh), cùng với ngày giờ thực hiện. Nếu nhận xét được thêm vào lúc commit và được đẩy lên – bằng hộp thoại Commit to Version Control – thì nhận xét đó cũng sẽ được hiển thị trong thẻ.
Ví dụ về thẻ sự kiện Project Committed ban đầu.
Thẻ cũng hỗ trợ và hiển thị thông tin so sánh khác biệt thiết kế, cung cấp thông tin chi tiết hơn về những thay đổi giữa commit hiện tại và commit trước đó. Các phần tử được hỗ trợ bao gồm tệp, linh kiện, net, biến thể và cấu trúc PCB. Phần so sánh khác biệt của thẻ tóm tắt các phần tử bị ảnh hưởng bởi sự kiện commit, được nhóm theo các trạng thái sau:
– phần tử được thêm.
– phần tử bị xóa.
– phần tử được sửa đổi.
Nhấp vào nút điều khiển
trong thẻ để mở rộng phần so sánh khác biệt này và hiển thị tên các phần tử bị ảnh hưởng.
Nhấp vào nút điều khiển
ở góc trên bên phải của thẻ để truy cập menu có các lệnh sau:
-
Download Sources - uDùng để tải xuống và mở phiên bản cụ thể đó của dự án PCB hoặc Harness trong bảng Projects. Tên dự án sẽ bao gồm ngày giờ commit phiên bản đó. Lưu ý rằng phiên bản này ở chế độ chỉ đọc; bạn có thể xem nhưng không thể chỉnh sửa.

Bạn có thể mở (chỉ để xem) bất kỳ phiên bản cụ thể nào của dự án – trực tiếp từ thẻ sự kiện Project Committed tương ứng với phiên bản đó. -
Compare: Schematic to, PCB to, BOM to – cho phép bạn so sánh dữ liệu sơ đồ nguyên lý, PCB hoặc BOM của dự án PCB trong commit này với dữ liệu của một commit hoặc sự kiện phát hành khác. Sử dụng menu con để so sánh với commit trước đó hoặc chọn trong số tất cả các bản phát hành và commit có thể so sánh. Sau khi chọn dữ liệu để so sánh, kết quả so sánh được trình bày trong chế độ xem khác biệt tương ứng, mở dưới dạng một tab mới trong trình duyệt mặc định của bạn. Để biết thêm thông tin, hãy xem Design Data Comparisons (Workspace Altium 365, Workspace Enterprise Server).
-
Create Tag – thêm một thẻ duy nhất có tên tùy chỉnh vào bất kỳ commit nào của dự án thiết kế (và chỉ khi dự án đó được lưu trữ trong Workspace bằng hệ thống Git VCS nội bộ). Bạn chỉ có thể tạo thẻ cho commit đã được lưu trong Workspace. Sau khi chạy lệnh, hộp thoại Create Tag sẽ mở ra. Nhập thẻ mong muốn rồi nhấp vào Create.
Khi thẻ được nhập có chứa ký tự không hợp lệ, biểu tượng
sẽ xuất hiện trong hộp thoại Create Tag. Di chuột lên biểu tượng để xem “gợi ý” về các ký tự được phép sử dụng, gồm chữ cái, chữ số, dấu chấm ('.'), dấu gạch nối ('-'), dấu thăng ('#') và dấu gạch dưới ('_'); chỉnh sửa thẻ nếu cần.
Khi dự án được phát hành bằng Project Releaser và commit mới nhất chưa có thẻ, một thẻ sẽ tự động được gán cho commit mới nhất này. Thẻ này sẽ có dạng RELEASE_<RevisionID>, trong đó <RevisionID> là số phiên bản của các tệp nguồn dự án đã phát hành (A.1, A.2, v.v.), ví dụ: RELEASE_A.3.
Để đổi tên hoặc xóa thẻ, nhấp vào
rồi di chuột lên mục Tag . Một hộp thoại sẽ mở ra để bạn nhập tên mới cho thẻ. Nếu chọn Remove , thẻ sẽ bị xóa ngay lập tức.
- Tạo bản sao – dùng để tạo bản sao từ phiên bản cụ thể đó của dự án. Hộp thoại Create Project Copy sẽ mở ra để bạn nhập Project Name (theo mặc định, đây sẽ là tên dự án gốc kèm hậu tố ' - Copy'), Description (không được điền sẵn), đường dẫn Folder (trong Workspace) và đường dẫn Local Storage (đến bản sao làm việc). Dự án sẽ được tạo và một thẻ sự kiện Project Copied sẽ được thêm vào dòng thời gian.
-
Revert to – sử dụng lệnh này để quay về sử dụng dữ liệu từ bản sửa đổi cụ thể đó của dự án. Dữ liệu từ các tài liệu nguồn của dự án trong bản sửa đổi đó sẽ ghi đè lên dữ liệu trong bản sao làm việc cục bộ của dự án. Trên thực tế, dự án sẽ được đóng trong giây lát rồi mở lại với dữ liệu đã khôi phục đó. Nếu muốn hoàn tất việc khôi phục và đặt dữ liệu đó làm bản sửa đổi mới nhất (phiên bản hiện tại), bạn phải commit và đẩy dự án trở lại Workspace.
Bạn có thể quay về bất kỳ bản sửa đổi cụ thể nào của dự án ngay từ ô sự kiện Project Committed tương ứng với bản sửa đổi đó.
Phát hành dự án
Related page: Phát hành dự án thiết kế
Mỗi khi bạn phát hành dự án PCB – bằng Project Releaser của Altium Designer – một ô sự kiện Project Released sẽ được thêm vào dòng thời gian. Người thực hiện phát hành được hiển thị bằng tên (và ảnh), cùng với ngày và giờ. Nếu ghi chú phát hành được thêm vào khi phát hành dữ liệu đã tạo lên Workspace – thông qua hộp thoại Xác nhận phát hành – thì ghi chú đó cũng sẽ được hiển thị trong ô. Từng bộ dữ liệu có trong bản phát hành cũng sẽ được liệt kê.
Ví dụ về ô sự kiện Project Released.
Nhấp vào nút điều khiển
ở góc trên bên phải của ô để truy cập menu có các lệnh sau:
- Download Sources – sử dụng lệnh này để tải xuống rồi mở (trong bảng Projects ) bản sửa đổi cụ thể của dự án được dùng để tạo gói phát hành này. Tên dự án sẽ bao gồm phiên bản phát hành. Lưu ý rằng bản sửa đổi này ở chế độ chỉ đọc; bạn có thể xem nhưng không thể chỉnh sửa dưới bất kỳ hình thức nào.
- Compare: Schematic to, PCB to, Gerber to, BOM to – cho phép bạn so sánh dữ liệu sơ đồ nguyên lý, PCB hoặc BOM trong bản phát hành này với dữ liệu của một bản phát hành hoặc sự kiện commit khác. Với dữ liệu Gerber đã tạo, bạn có thể so sánh dữ liệu của bản phát hành này với dữ liệu của một bản phát hành khác hoặc, khi sử dụng Workspace Altium 365, với một bộ tệp Gerber đã tải lên. Sử dụng menu con để so sánh với bộ dữ liệu mong muốn. Sau khi chọn dữ liệu để so sánh, kết quả so sánh sẽ được trình bày trong chế độ xem khác biệt tương ứng, mở dưới dạng tab mới trong trình duyệt mặc định của bạn. Để biết thêm thông tin, hãy xem Design Data Comparisons (Workspace Altium 365, Workspace Enterprise Server).
Sao chép dự án
Mỗi khi bạn sao chép dự án, qua giao diện trình duyệt của Workspace hoặc từ bên trong Altium Designer, một ô sự kiện Project Copied sẽ được thêm vào dòng thời gian. Người thực hiện sao chép được hiển thị bằng tên, ảnh, cùng ngày và giờ. Nếu nội dung mô tả được thêm vào khi sao chép thông qua cửa sổ Clone Project (trên trình duyệt) hoặc hộp thoại Create Project Copy (Altium Designer), nội dung đó cũng sẽ được hiển thị trong ô. Một liên kết đến dự án đã sao chép cũng được cung cấp. Nhấp vào liên kết này để truy cập trang quản lý chi tiết của dự án đó qua giao diện trình duyệt của Workspace.
Ví dụ về ô sự kiện Project Copied.
Trao đổi MCAD
Related page: Altium MCAD CoDesigner
Khi làm việc giữa hai lĩnh vực thiết kế điện tử và cơ khí, Workspace đóng vai trò cầu nối – hỗ trợ đồng thiết kế ECAD-MCAD trực tiếp. Bất cứ khi nào thiết kế PCB của dự án được thay đổi và những thay đổi đó được đẩy lên Workspace thông qua bảng CoDesigner tương ứng, một ô sự kiện MCAD Changes Suggested sẽ được thêm vào dòng thời gian. Người thực hiện thao tác đẩy được hiển thị bằng tên (và ảnh), cùng với ngày và giờ. Nếu có thông điệp được đăng khi đẩy – thông qua bảng MCAD CoDesigner (Altium Designer) hoặc bảng Altium CoDesigner (trong phần mềm MCAD được hỗ trợ) – thì thông điệp đó cũng sẽ được hiển thị trong ô.
Ví dụ về ô sự kiện MCAD Changes Suggested.
Khi kỹ sư MCAD thực hiện các thay đổi đối với PCB trong phần mềm MCAD được hỗ trợ và đẩy chúng trở lại Workspace, sự kiện đẩy tương ứng sẽ xuất hiện trên dòng thời gian lịch sử của dự án only sau khi kéo các thay đổi từ Workspace vào Altium Designer.
Ví dụ minh họa hai sự kiện liên quan đến MCAD. Bên trái trục chính của dòng thời gian là sự kiện đẩy từ phía ECAD, còn bên phải là sự kiện đẩy từ phía MCAD.
Thay đổi cục bộ
Khi có tài liệu dự án PCB đã được lưu cục bộ nhưng chưa được lưu vào Workspace, một ô sự kiện Local Changes sẽ được thêm ở đầu dòng thời gian. Người thực hiện thao tác lưu cục bộ (tức là người dùng hiện tại) được hiển thị bằng tên (và ảnh).

Ví dụ về ô sự kiện Local Changes.
Nhấp vào nút điều khiển
ở góc trên bên phải của ô để truy cập menu có lệnh sau:
- Compare: Schematic to, PCB to, BOM to – cho phép bạn so sánh dữ liệu sơ đồ nguyên lý, PCB hoặc BOM được lưu cục bộ trong lần commit này với dữ liệu của một sự kiện commit hoặc phát hành. Sử dụng menu con để so sánh với dữ liệu nguồn của bản phát hành trước, dữ liệu nguồn của lần commit trước hoặc chọn trong tất cả các bản phát hành và lần commit có sẵn. Sau khi chọn dữ liệu để so sánh, kết quả so sánh sẽ được hiển thị trong chế độ xem khác biệt tương ứng, mở dưới dạng tab mới trong trình duyệt mặc định của bạn. Để biết thêm thông tin, xem Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).
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.
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.
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).
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.
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.


để mở hộp thoại Choose Folder (phiên bản rút gọn của bảng Explorer) nhằm thay đổi thư mục theo yêu cầu. Local Storage theo mặc định sẽ được đặt để sử dụng vị trí được xác định trên trang 

