Lịch sử dự án

Refer to: Tạo một dự án, Đưa một 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ử cho dự án. Vì vậy, nó luôn có thể được tìm thấy ở mục nằm dưới cùng của dòng thời gian. Ô cho sự kiện này có thể xuất hiện theo hai biến thể khác nhau:

• 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 và giờ tạo dự án. Mô tả của dự án cũng được hiển thị trong ô nếu đã được nhập tại thời điểm tạo.

• Khi dự án là bản sao của một dự án hiện có. Người tạo dự án sao chép được hiển thị bằng tên, cùng với ngày và giờ tạo dự án. Mô tả của dự án cũng được hiển thị trong ô nếu đã được nhập tại thời điểm sao chép. Một liên kết đến dự án gốc cũng được cung cấp; khi nhấp vào đó, bạn sẽ truy cập trang quản lý chi tiết của dự án đó thông qua giao diện trình duyệt của Workspace.

Ô sự kiện Project Created được kết nối vật lý với trục chính của dòng thời gian bằng một đường nối và nút màu xanh dương liền nét: .

Mỗi lần bạn Commit một dự án lên Workspace (khi dự án được quản lý trong Versioned Storage kho Git nội bộ của Workspace), một ô 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 và giờ. Nếu có thêm nhận xét tại thời điểm commit và được đẩy lên – bằng hộp thoại Commit to Version Control – thì nội dung đó cũng sẽ được hiển thị trong ô.

Ví dụ về ô sự kiện Project Committed ban đầu.

Ô này cũng hỗ trợ và trình bày thông tin diff thiết kế, hiển thị thông tin chi tiết hơn về những gì đã thay đổi giữa commit hiện tại và commit trước đó. Các phần tử được hỗ trợ gồm có tệp, linh kiện, net, biến thể và cấu trúc PCB. Phần diff của ô tóm tắt các phần tử khác nhau 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 vào.

– phần tử bị xóa.

– phần tử được sửa đổi.

Nhấp vào điều khiển trong ô để mở rộng phần diff này nhằm hiển thị tên của các phần tử bị ảnh hưởng.

Sử dụng các điều khiển Show More và Show Less có sẵn để xem xét danh sách đầy đủ cho từng loại phần tử. Nhấp vào điều khiển trong ô để quay lại chế độ hiển thị tóm tắt.

Nhấp vào điều khiển ở góc trên bên phải của ô để truy cập menu với các lệnh sau:

• Download Sources - usử dụng để tải xuống và mở chính bản revision đó của dự án PCB hoặc Harness trong bảng Projects. Tên dự án sẽ bao gồm ngày và giờ revision đó được commit. Lưu ý rằng revision 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ỳ revision cụ thể nào của dự án – trực tiếp từ ô sự kiện Project Committed tương ứng của revision đó.

• Compare: Schematic to, PCB to, BOM to – cho phép bạn so sánh dữ liệu Schematic, PCB hoặc BOM của dự án PCB trong commit này với dữ liệu của một commit khác hoặc một sự kiện phát hành. Sử dụng menu con để so sánh với commit trước đó hoặc chọn từ tất cả các bản phát hành và commit có thể. Sau khi chọn dữ liệu để so sánh, kết quả so sánh sẽ được hiển thị trong khung xem khác biệt tương ứng, mở ra 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, xem Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).

• Create Tag – thêm một thẻ tùy chỉnh, được đặt tên riêng cho bất kỳ commit nào của dự án thiết kế (và chỉ khi dự án đó được lưu trong một Workspace dưới hệ thống Git VCS nội bộ của nó). 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 Create.

  Khi đã nhập một thẻ 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ề những ký tự được phép, tức là chữ cái, chữ số, dấu chấm ('.'), dấu gạch ngang ('-'), dấu thăng ('#') và dấu gạch dưới ('_'); cập nhật lại thẻ nếu cần.

Khi dự án được phát hành bằng Project Releaser và commit mới nhất của nó chưa có thẻ, một thẻ sẽ được tự động gán cho commit mới nhất này. Thẻ này sẽ có dạng RELEASE_<RevisionID>, trong đó <RevisionID> là số revision của mã 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 một thẻ, nhấp  rồi di chuột qua 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 một bản sao từ revision cụ thể đó của dự án. Hộp thoại Create Project Copy sẽ mở ra, trong đó bạn nhập Project Name (mặc định 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 ô sự kiện Project Copied sẽ được thêm vào dòng thời gian.

Folder của Workspace theo mặc định sẽ là cùng thư mục nơi dự án gốc được lưu. Nhấp để mở hộp thoại Choose Folder (phiên bản rút gọn của panel Explorer) nhằm thay đổi thư mục theo nhu cầu. Local Storage theo mặc định sẽ được đặt để dùng vị trí được xác định trên trang System - Default Locations của hộp thoại Preferences. Nhấp để mở hộp thoại Windows chuẩn nhằm thay đổi vị trí này nếu cần.

• Revert to – dùng lệnh này để quay lại sử dụng dữ liệu từ revision cụ thể đó của dự án. Dữ liệu từ các tài liệu nguồn của dự án trong revision cụ thể đó sẽ ghi đè lên dữ liệu trong bản sao làm việc cục bộ của dự án. Về bản chất, dự án sẽ tạm thời được đóng lại rồi mở lại với dữ liệu đã được hoàn nguyên đó. Nếu bạn muốn hoàn tất việc hoàn nguyên và biến dữ liệu đó thành Head Revision (phiên bản hiện tại), bạn phải commit và push dự án trở lại Workspace.

   Bạn có thể hoàn nguyên về bất kỳ revision cụ thể nào của dự án trực tiếp từ ô sự kiện Project Committed tương ứng cho revision đó.

  Sau khi hoàn nguyên về một revision cụ thể và trước khi commit, bạn có thể khôi phục bản sao làm việc cục bộ của mình về revision mới nhất bằng cách sử dụng lệnh Revert to liên kết với ô sự kiện Project Committed mới nhất trên dòng thời gian.

Một ô sự kiện Project Committed được nối vật lý với trục chính của dòng thời gian bằng một đường nối màu xanh dương liền nét và một nút: . Revision mới nhất của dự án (tức commit cuối cùng) được phân biệt bằng nút có phần tô màu trắng: .

Related page: Phát hành Dự án Thiết kế

Mỗi khi bạn thực hiệ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 sẽ được hiển thị bằng tên (và hình ảnh), cùng với ngày và giờ. Nếu có thêm ghi chú phát hành tại thời điểm phát hành dữ liệu đã tạo lên Workspace – thông qua hộp thoại Confirm Release dialog – thì nội dung đó cũng sẽ được hiển thị trong ô. Mỗi tập 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 điều khiển ở góc trên bên phải của ô để truy cập menu với các lệnh sau:

• Download Sources – dùng lệnh này để tải xuống rồi mở (trong panel Projects ) revision cụ thể của dự án mà từ đó gói phát hành này được tạo ra. Tên dự án sẽ bao gồm phiên bản phát hành. Lưu ý rằng revision này là 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 Schematic, PCB hoặc BOM trong bản phát hành này với dữ liệu của một sự kiện phát hành hoặc commit khác. Đối với 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 Altium 365 Workspace, với một bộ tệp Gerber đã tải lên. Sử dụng menu con để so sánh với tập dữ liệu cần thiết. Sau khi dữ liệu đã được chọn để so sánh, kết quả so sánh sẽ được hiển thị trong khung xem khác biệt tương ứng, khung này sẽ mở thành một 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).