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 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ể riêng:

• Khi một dự án được tạo mới trong Workspace. Người tạo dự án sẽ được hiển thị bằng tên (và hình ảnh), cùng với ngày và giờ tạo dự án. Mô tả của dự án cũng sẽ đượ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 sẽ đượ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 sẽ đượ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; nhấp vào đó 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.

Ô sự kiện Project Created đượ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: .

Mỗi lần bạn Commit một dự án lên Workspace (trong đó dự án được quản lý dưới Versioned Storagekho 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) 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 bình luận tại thời điểm commit và được đẩy lên – bằng hộp thoại Commit to Version Control – thì bình luận đó 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à hiển thị thông tin so sánh khác biệt thiết kế, cho biết chi tiết hơn những gì đã 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 diff trong ô 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.

– 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 và hiển thị tên 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 đầy đủ danh sách 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 ô để mở menu với các lệnh sau:

• Download Sources - udùng để tải xuống và mở bản revision cụ thể đó của dự án PCB hoặc Harness trong panel Projects. Tên dự án sẽ bao gồm ngày và giờ mà revision đó được commit. Lưu ý rằng revision này là 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 một commit hoặc sự kiện phát hành khác. 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 khả dụng. Sau khi dữ liệu được chọn để so sánh, kết quả so sánh sẽ được hiển thị trong khung nhìn khác biệt liên quan, 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, xem Design Data Comparisons (Altium 365 Workspace, Enterprise Server Workspace).

• Create Tag – thêm một thẻ đơn, 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 trong 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ẻ 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, 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 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ó tag, một tag sẽ được gán tự động cho commit mới nhất này. Tag này sẽ có dạng RELEASE_<RevisionID>, trong đó <RevisionID> là số revision của 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 tag, nhấp vào  sau đó 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 tag. Nếu chọn Remove , tag sẽ bị xóa ngay lập tức. 

• Tạo bản sao – dùng để tạo 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 với hậu tố ' - Copy'), Description (không được điền sẵn), đường dẫn   (trong Workspace), và đường dẫn   (tới 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 Thư mục Workspace theo mặc định sẽ là cùng thư mục nơi dự án gốc được lưu. Nhấp vào để mở hộp thoại Choose Folder (phiên bản rút gọn của Explorerpanel) nhằm thay đổi thư mục theo nhu cầu. Local StorageVị trí cục bộ 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 vào để mở hộp thoại Windows chuẩn nhằm thay đổi vị trí này khi cần.

• Revert to – dùng lệnh này để hoàn nguyên về 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. Trên thực tế, dự án sẽ được đóng tạm thời rồi mở lại với dữ liệu đã 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 của 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 lệnh Revert to gắn với ô sự kiện Project Committed mới nhất trên dòng thời gian.

Ô 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ó nền 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 – thì ghi chú đó cũng sẽ được hiển thị trong ô. Mỗi bộ dữ liệu được đưa vào 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 ô để mở menu với các lệnh sau:

• Download Sources – dùng lệnh này để tải xuống rồi mở (trong Projects panel) 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 theo bất kỳ cách 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 bản phát hành hoặc sự kiện commit khác. Đối với Gerber được tạo ra, bạn có thể so sánh dữ liệu của bản phát hành này với bản phát hành khác hoặc, khi 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 bộ 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 nhìn khác biệt liên quan, 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).