Lịch sử dự án
Sơ lược
- Tìm hiểu vị trí của chế độ xem History và cách dòng thời gian sắp xếp các sự kiện trong dự án.
- Nắm rõ các yêu cầu về kiểm soát phiên bản để xem lịch sử commit.
- Khám phá cách kiểm tra các thay đổi trong commit, mở ảnh chụp trạng thái thiết kế trước đây và thêm thẻ cho commit.
Không thể dễ dàng xem lại lịch sử phát triển của dự án thường là điều khiến các nhà thiết kế và quản lý sản phẩm khó chịu. Nhà thiết kế thường phải tìm hiểu cách sử dụng các công cụ quản lý VCS bên ngoài, vốn có thể đòi hỏi chuyên môn nhất định để vận hành – rất tốn thời gian khi chỉ muốn thực hiện các tác vụ quản lý dự án cơ bản. Ngay cả khi bạn thành thạo các công cụ VCS bên ngoài, chúng cũng chỉ xử lý một số khía cạnh nhất định của dự án – các thao tác liên quan đến VCS như mở, tạo bản sao và hoàn nguyên. Nhưng còn phạm vi quản lý dự án rộng hơn, bao gồm các bản phát hành và trao đổi MCAD thì sao? Cũng đừng quên rằng phần lớn những công việc này thường đòi hỏi bạn phải gắn chặt với máy tính để bàn.
Để đáp ứng nhu cầu xem và tương tác với những thông tin này tại một nơi duy nhất một cách thuận tiện, Altium 365 Workspace hỗ trợ khái niệm Project History. Có thể truy cập qua giao diện trình duyệt của Workspace (một thành phần thuộc Giao diện nền tảng Altium 365) hoặc từ bên trong Altium Designer, chế độ xem History chuyên dụng cung cấp dòng thời gian thể hiện tiến trình các sự kiện quan trọng liên quan đến dự án – tạo dự án, commit, phát hành, tạo bản sao và trao đổi MCAD – cùng với nhiều thao tác được hỗ trợ khi phù hợp (chẳng hạn như xem ảnh chụp nhanh của dữ liệu nguồn thiết kế).
Truy cập lịch sử dự án
Bạn có thể truy cập chế độ xem History của một dự án từ trang quản lý chi tiết của dự án đó. Nhấp vào mục History trong ngăn bên trái.
Truy cập lịch sử của dự án từ trang quản lý chi tiết của dự án đó.
Dòng thời gian lịch sử – Tổng quan
Chế độ xem History trình bày dòng thời gian của 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 dưới đây và được mô tả chi tiết ở phần tiếp theo.
Xác định ba thành phần chính của chế độ xem History .
- Main trunk of the timeline. Trình tự thời gian của các sự kiện được thể hiện 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, trong đó sự kiện mới nhất (gần thời điểm 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 thẻ riêng. Mỗi loại sự kiện có thẻ mang 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ư trường hợp 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 để mở 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, xem Tìm kiếm có lọc.
Các sự kiện được hỗ trợ
Dòng thời gian thể hiện tiến trình các sự kiện diễn ra trong suốt vòng đời dự án. Mỗi sự kiện xuất hiện dọc theo dòng thời gian dưới dạng một “thẻ sự kiện” riêng. Các phần sau 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
Related pages: Tạo dự án mới được quản lý (giao diện trình duyệt / Altium Designer), Đưa dự án hiện có lên trực tuyến, Tạo bản sao dự án (giao diện trình duyệt / Altium Designer)
Khi một dự án được tạo, thẻ 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. Thẻ của sự kiện này có thể xuất hiện dưới hai dạng khác nhau:
- Khi 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ả dự án cũng được hiển thị trong thẻ nếu đã được nhập khi tạo.
- Khi dự án là bản sao của một dự án hiện có. Người tạo dự án bản sao đượ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 ô sự kiện nếu đã được nhập khi tạo bản sao. 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 để truy cập trang quản lý chi tiết của dự án đó, được mở trong một tab riêng của trình duyệt.
Ghi nhận thay đổi dự án
Mỗi khi bạn thực hiện Commit & Push cho dự án lên Workspace (nơi dự án được quản lý trong kho lưu trữ Git Versioned Storage 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 thao tác ghi nhận và đẩy thay đổi được hiển thị bằng tên (và ảnh), cùng với ngày giờ. Nếu nhận xét được thêm vào khi ghi nhận và đẩy thay đổi – thông qua hộp thoại Commit to Version Control – thì nhận xét đó cũng sẽ được hiển thị trong ô.
Ví dụ về ô sự kiện Project Committed đầu tiên.
Ô này 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 lần ghi nhận hiện tại và lần trước đó. Các phần tử được hỗ trợ bao gồm tệp, linh kiện, mạng kết nối, biến thể và cấu trúc PCB. Phần so sánh khác biệt trong ô tóm tắt các phần tử bị ảnh hưởng bởi sự kiện ghi nhận thay đổi, đượ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 ô để 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 ô để truy cập menu có các lệnh sau:
- View – sử dụng lệnh này để mở dữ liệu thiết kế nguồn của lần ghi nhận đã chọn trong Web Viewer dưới dạng bản chụp thiết kế tại thời điểm đó.
- Create Tag – thêm tên thẻ VCS vào lần ghi nhận hiện được chọn. Các thẻ gắn với một lần ghi nhận xuất hiện trong ô tương ứng ở chế độ xem History, trong phần đầu của chế độ xem bản chụp trong Web Viewer và trong mọi nhận xét gắn với chế độ xem bản chụp đó. Sau khi một thẻ được thêm vào lần ghi nhận, lệnh trong menu của ô sẽ chuyển thành Tag và cung cấp các tùy chọn con để sửa đổi (Edit) hoặc xóa (Remove) thẻ của lần ghi nhận.
Chọn tùy chọn menu Create Tag để thêm tên thẻ vào một sự kiện ghi nhận thay đổi trong History.
Chế độ xem bản chụp của một sự kiện ghi nhận thay đổi đã gắn thẻ trong History được gắn nhãn bằng tên thẻ.
Khi xem nhận xét trong thiết kế WIP đang làm việc, các nhận xét được tạo trong bản chụp thiết kế của một lần ghi nhận đã gắn thẻ sẽ bao gồm tên thẻ tương ứng. Chọn liên kết tên thẻ để mở bản chụp của lần ghi nhận liên quan. Xem Nhận xét trong Web Viewer để biết thêm thông tin về cách làm việc với nhận xét.
Các nhận xét được thêm vào bản chụp của một sự kiện ghi nhận thay đổi đã gắn thẻ sẽ bao gồm tên thẻ tương ứng.
Sự kiện ghi nhận thay đổi liên quan đến một bản phát hành dự án, được tạo bằng Project Releaser của Altium Designer, sẽ tự động được gắn thẻ bằng ID phiên bản phát hành. Nếu cần, bạn có thể chỉnh sửa hoặc xóa thẻ của lần ghi nhận phiên bản này sau đó. Xem Phát hành lên Workspace để biết thông tin liên quan.
Lần ghi nhận liên quan đến một bản phát hành được Altium Designer tự động gắn thẻ bằng ID bản phát hành.
- Schematic to – cho phép bạn so sánh dữ liệu sơ đồ nguyên lý trong lần ghi nhận này với dữ liệu của một lần ghi nhận hoặc sự kiện phát hành khác. Sử dụng menu con để so sánh với dữ liệu nguồn của lần ghi nhận trước đó, hoặc chọn trong tất cả các lần ghi nhận hay bản phát hành có thể dùng để so sánh. Sau khi chọn bản phát hành/lần ghi nhận để so sánh, kết quả sẽ được trình bày trong chế độ xem Compare, mở ra dưới dạng tab mới trong trình duyệt web mặc định của bạn. Để biết thêm thông tin, hãy xem So sánh sơ đồ nguyên lý.
- PCB to – cho phép bạn so sánh dữ liệu PCB trong lần ghi nhận này với dữ liệu của một lần ghi nhận hoặc sự kiện phát hành khác. Sử dụng menu con để so sánh với dữ liệu nguồn của lần ghi nhận trước đó, hoặc chọn trong tất cả các lần ghi nhận hay bản phát hành có thể dùng để so sánh. Sau khi chọn bản phát hành/lần ghi nhận để so sánh, kết quả sẽ được trình bày trong chế độ xem Compare, mở ra dưới dạng tab mới trong trình duyệt web mặc định của bạn. Để biết thêm thông tin, hãy xem So sánh PCB.
- BOM to – cho phép bạn so sánh dữ liệu BOM trong lần commit này với dữ liệu của một lần commit hoặc lần phát hành khác. Sử dụng menu con tương ứng để so sánh với dữ liệu BOM của lần commit trước, hoặc chọn trong tất cả các lần commit/phát hành đã thực hiện cho dự án. Sau khi chọn đối tượng so sánh, kết quả so sánh được trình bày dưới dạng danh sách các mục BOM được mã hóa bằng màu, thể hiện các mục đã thay đổi giữa các sự kiện Commit/Phát hành được chỉ định. Bản tổng hợp các thay đổi được tạo ở định dạng CSV tiêu chuẩn và có thể tải xuống dưới dạng tệp nén ZIP. Để biết thêm thông tin, xem So sánh BOM.
-
Clone – sử dụng lệnh này để tạo bản sao từ phiên bản cụ thể đó của dự án. Cửa sổ Clone Project sẽ xuất hiện để xác định Name, Description và Parent Folder của dự án (trong Workspace). Lưu ý rằng dòng chữ trên biểu ngữ của cửa sổ cho biết bản sao đang được tạo từ phiên bản nào của dự án. Sau khi điền đầy đủ thông tin theo yêu cầu, nhấp vào nút
. Dự án sẽ được tạo và một thẻ sự kiện Project Cloned sẽ được thêm vào dòng thời gian.
Bạn có thể tạo bản sao từ bất kỳ phiên bản cụ thể nào của dự án đang hoạt động – trực tiếp từ thẻ sự kiện Project Committed tương ứng với phiên bản đó.
- Download Sources – sử dụng lệnh này để tải xuống mã nguồn dự án của phiên bản cụ thể đó dưới dạng tệp nén Zip. Tên tệp Zip và tệp dự án PCB sẽ bao gồm ngày giờ (theo giờ UTC) mà phiên bản dự án đó được commit và đẩy lên Workspace.
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 – sử dụng Project Releaser của Altium Designer – một thẻ 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 giờ. Nếu ghi chú phát hành được thêm vào 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 – ghi chú đó cũng sẽ được hiển thị trong thẻ. Mỗi bộ dữ liệu có trong bản phát hành cũng sẽ được liệt kê, kèm theo trạng thái vòng đời.
Ví dụ về thẻ 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 thẻ để truy cập menu có các lệnh sau:
- View – mở một cổng thông tin sản xuất chuyên dụng (trên một tab trình duyệt riêng) để kiểm tra kỹ hơn dữ liệu đã phát hành. Từ cổng thông tin này, bạn có thể xem và duyệt dữ liệu tệp đã phát hành, kiểm tra BOM, cũng như xem và bình luận về ảnh chụp nhanh của chính thiết kế – nguồn tạo ra dữ liệu đã phát hành đó. Bạn cũng có thể sử dụng các nút điều khiển để tải xuống dữ liệu sản xuất ở nhiều mức độ chi tiết khác nhau (từ toàn bộ bộ dữ liệu đến từng tệp đầu ra đã tạo). Bạn cũng có thể gửi trực tiếp một bản phát hành đã chọn đến nhà sản xuất dưới dạng Manufacturing Package. Để biết thêm thông tin, xem Duyệt gói phát hành thông qua cổng thông tin sản xuất.
Truy cập tab Manufacturing Portal chuyên dụng để kiểm tra kỹ hơn bản phát hành của dự án.
- Schematic to – cho phép bạn so sánh dữ liệu sơ đồ nguyên lý trong bản phát hành này với dữ liệu của một lần phát hành hoặc commit khác. 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, hoặc chọn trong tất cả các lần phát hành và commit hiện có. Sau khi chọn bản phát hành/lần commit để so sánh, kết quả so sánh được trình bày trong chế độ xem Compare, mở dưới dạng tab mới trong trình duyệt web mặc định của bạn. Để biết thêm thông tin, xem So sánh sơ đồ nguyên lý.
So sánh dữ liệu sơ đồ nguyên lý giữa hai bản phát hành của dự án thiết kế.
- PCB to – cho phép bạn so sánh dữ liệu PCB trong bản phát hành này với dữ liệu của một lần phát hành hoặc commit khác. 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, hoặc chọn trong tất cả các lần phát hành và commit hiện có. Sau khi chọn bản phát hành/lần commit để so sánh, kết quả so sánh được trình bày trong chế độ xem Compare, mở dưới dạng tab mới trong trình duyệt web mặc định của bạn. Để biết thêm thông tin, xem So sánh PCB.
So sánh dữ liệu PCB giữa hai bản phát hành của dự án thiết kế.
- Gerber to – cho phép bạn so sánh dữ liệu Gerber được tạo cho bản phát hành này với một bộ dữ liệu Gerber khác. Sử dụng menu con tương ứng để so sánh với dữ liệu chế tạo của bản phát hành trước, chọn trong tất cả các bản phát hành đã thực hiện cho dự án (dòng thời gian sẽ được lọc để chỉ hiển thị các thẻ sự kiện Project Released), hoặc so sánh với một bộ tệp được tạo cục bộ (và tải lên) do bạn chọn. Sau khi chọn đối tượng so sánh, kết quả được trình bày trong chế độ xem Gerber Compare , mở trên một tab trình duyệt riêng. Để biết thêm thông tin, xem So sánh Gerber.
So sánh dữ liệu Gerber được tạo giữa hai bản phát hành của dự án thiết kế.
- BOM to – cho phép bạn so sánh dữ liệu BOM trong bản phát hành này với dữ liệu của một lần commit hoặc lần phát hành khác. Sử dụng menu con tương ứng để so sánh với dữ liệu BOM của lần commit trước, hoặc chọn trong tất cả các lần commit/phát hành đã thực hiện cho dự án. Sau khi chọn đối tượng so sánh, kết quả so sánh được trình bày dưới dạng danh sách các mục BOM được mã hóa bằng màu, thể hiện các mục đã thay đổi giữa các sự kiện Commit/Phát hành được chỉ định. Bản tổng hợp các thay đổi được tạo ở định dạng CSV tiêu chuẩn và có thể tải xuống dưới dạng tệp nén ZIP. Để biết thêm thông tin, xem So sánh BOM.
Tải xuống bản so sánh dữ liệu BOM được tạo giữa hai sự kiện của dự án thiết kế.
-
Download Outputs – cho phép bạn chọn các bộ dữ liệu đầu ra trong gói phát hành cần tải xuống thông qua cửa sổ xuất hiện tiếp theo. Sau khi chọn xong, nhấp vào nút
. Một tệp nén Zip duy nhất sẽ được tải xuống, chứa các thư mục cho từng bộ dữ liệu đã chọn.
- Download Sources – cho phép bạn tải xuống dữ liệu nguồn của phiên bản thiết kế được dùng để tạo gói phát hành đó, dưới dạng tệp nén Zip.
Nhân bản dự án
Related page: Nhân bản dự án (giao diện trình duyệt / Altium Designer)
Mỗi lần bạn nhân bản dự án – thông qua giao diện trình duyệt của Workspace hoặc từ bên trong Altium Designer – một thẻ sự kiện Project Cloned sẽ được thêm vào dòng thời gian. Người thực hiện thao tác nhân bản được hiển thị bằng tên (và ảnh), cùng với ngày giờ thực hiện. Nếu có thêm mô tả khi nhân bản – thông qua cửa sổ Clone Project (trên trình duyệt) hoặc hộp thoại Clone Project (Altium Designer) – thì mô tả đó cũng sẽ được hiển thị trong thẻ. Một liên kết đến dự án được nhân bản cũng được cung cấp – nhấp vào liên kết này sẽ truy cập trang quản lý chi tiết của dự án đó, được mở trong một tab riêng của trình duyệt.
Ví dụ về thẻ sự kiện Project Cloned.
Trao đổi MCAD
Related page: Tìm hiểu thêm về đồng thiết kế ECAD-MCAD
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 giữa hai bên – hỗ trợ đồng thiết kế ECAD-MCAD trực tiếp. Mỗi khi 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 thẻ 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 giờ thực hiện. Nếu có đăng thông điệp 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 thẻ.
Ví dụ về thẻ sự kiện MCAD Changes Suggested.
Khi kỹ sư MCAD thay đổi PCB trong phần mềm MCAD được hỗ trợ và đẩy những thay đổi đó lên Workspace, sự kiện đẩy tương ứng sẽ tự động được hiển thị trên dòng thời gian lịch sử của dự án. Lưu ý rằng bạn có thể cần làm mới trang History để hiển thị thay đổi mới nhất.
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.
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 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 động được áp dụng ngay khi bạn nhập chuỗi tìm kiếm – chỉ giữ lại các sự kiện liên quan đến nội dung tìm kiếm trên trang. Văn bản khớp trong mỗi thẻ sự kiện sẽ được tô sáng.
Ví dụ tìm kiếm trong lịch sử dự án. Dòng thời gian được lọc động 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 thẻ sự kiện liên quan.
Chức năng tìm kiếm áp dụng cho các thông tin sau:
- Tiêu đề thẻ 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ừ nhận xét/ghi chú/mô tả khi sự kiện tương ứng diễn ra).
- Văn bản dữ liệu so sánh khác biệt – trong thẻ sự kiện Project Committed.
- Tên bộ dữ liệu – trong thẻ sự kiện Project Released.
- Tên dự án – trong thẻ sự kiện Project Cloned và thẻ sự kiện Project Created (khi được tạo bằng cách nhân bản).
Cập nhật sự kiện mới
Mỗi khi một sự kiện được hỗ trợ xảy ra liên quan đến dự án, sự kiện đó sẽ tự động được phát hiện và sẵn sàng hiển thị trong 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.