Thu thập dữ liệu Workspace bằng Content Cart
Sơ lược
- Khám phá cách thêm từng bản sửa đổi, nhiều mục hoặc toàn bộ thư mục vào Content Cart.
- Tìm hiểu cách cấu hình thư mục đích, định nghĩa vòng đời và quy tắc đặt tên trước khi truyền dữ liệu.
- Nắm rõ những điểm quan trọng cần lưu ý khi thu nhận dữ liệu, bao gồm các mục con được liên kết, các bản sửa đổi đã được thu nhận trước đó và yêu cầu kết nối Workspace.
Tính năng Thu nhận dữ liệu của Workspace cung cấp một tiện ích tinh gọn để sao chép dữ liệu giữa hai Workspace (xem thông tin về khả năng tương thích). Công cụ thực hiện việc này – giao diện của bạn với Dịch vụ Thu nhận dữ liệu – là Content Cart. Đây là trung tâm điều khiển để xác định dữ liệu cần thu nhận từ Workspace nguồn và chuyển sang Workspace đích được chỉ định – như một chiếc xe chuyển nhà đáng tin cậy, “chuyên chở” dữ liệu bạn chọn giữa các Workspace.
Không có cách nào minh họa hoạt động của một tính năng tốt hơn là thông qua ví dụ. Vì vậy, để làm rõ cách hoạt động của Content Cart và cách sử dụng công cụ này để thu nhận dữ liệu, bài viết này sẽ xem xét việc thu nhận một số linh kiện giữa các Workspace sau:
-
Source Server – một Workspace có tên
Company Workspace. -
Target Server – một Workspace thứ hai có tên
Secondary Company Workspace.
Truy cập giỏ nội dung
Bạn có thể truy cập hộp thoại Content Cart từ trong bảng Explorer. Khi duyệt Workspace nguồn mà bạn muốn lấy dữ liệu, hãy nhấp chuột phải vào bản sửa đổi mục cần thu nhận rồi chọn lệnh Operations » Add to Content Cart từ menu ngữ cảnh. Bạn có thể thêm một hoặc nhiều bản sửa đổi mục đã chọn, hoặc thậm chí cả một thư mục chứa các mục. Khi truy cập giỏ lần đầu, các bản sửa đổi mục đang được chọn trong Workspace nguồn tại thời điểm đó sẽ được nạp vào giỏ:
- Một bản sửa đổi cụ thể của một mục.
- Nhiều bản sửa đổi cụ thể của cùng một mục.
- Các bản sửa đổi mới nhất của nhiều mục.
- Các bản sửa đổi mới nhất của tất cả các mục trong thư mục đã chọn (và cấu trúc thư mục con của nó). Điều này cho phép bạn nạp toàn bộ thư mục vào giỏ mà vẫn giữ nguyên cấu trúc thư mục. Để thu nhận một thư mục (và cấu trúc thư mục con của nó), hãy chọn thư mục đó trong vùng Server Folders của Workspace nguồn (trong bảng Explorer ), sau đó nhấp chuột phải và chọn lệnh Operations » Add to Content Cart từ menu ngữ cảnh.

Ví dụ về cách truy cập Content Cart.
Các mục có thể thu nhận
Có thể sử dụng tính năng Thu nhận dữ liệu để thu nhận các loại mục sau từ Workspace nguồn sang Workspace đích:
- Mô hình 3D
- Tùy chọn Altium Designer
- Linh kiện (bao gồm các Lựa chọn linh kiện liên quan)
- Mẫu linh kiện
- Tài liệu thông số kỹ thuật
- Footprint
- Trang sơ đồ nguyên lý được quản lý
- Outputjob
- Mẫu sơ đồ nguyên lý
- Tập lệnh
- Mô hình mô phỏng
- Ký hiệu
Ngoài ra, khi thu nhận một thư mục chứa các mục từ Workspace nguồn, các loại thư mục sau được hỗ trợ:
- Linh kiện
- Thư mục thông thường
Những lưu ý khi thu nhận
Những điều cần lưu ý khi thu nhận dữ liệu:
- Chỉ có thể thu nhận các mục dữ liệu ở trạng thái đã phát hành trong Workspace nguồn.
- Chỉ bản sửa đổi đã chọn của mục nguồn được thu nhận, chứ không phải tất cả các bản sửa đổi có thể tồn tại của mục đó.
-
Khi thu nhận một bản sửa đổi của mục Linh kiện hoặc Trang sơ đồ nguyên lý được quản lý ở nguồn, tất cả các mục con được liên kết cũng sẽ được thu nhận:
- Component Item – các bản sửa đổi tương ứng của những đối tượng con được liên kết sau: mục Ký hiệu, mục Footprint, mục Mô hình 3D, mục Mô hình mô phỏng, mục Mẫu linh kiện, mục Tài liệu thông số kỹ thuật, các liên kết Lựa chọn linh kiện.
Lưu ý rằng tham số Loại linh kiện không được chuyển trong quá trình thu nhận, vì vậy các linh kiện được chuyển sẽ xuất hiện ở vị trí Uncategorized của đích trong cả bảng Components của Altium Designer và trang Components của Workspace. Bạn có thể áp dụng Loại linh kiện mong muốn cho một hoặc nhiều mục nhập linh kiện bằng thao tác Thay đổi loại linh kiện trong bảng Explorer của Altium Designer.
- Managed Schematic Sheet Item – các bản sửa đổi tương ứng của những đối tượng con được liên kết sau: mục Linh kiện, mục Ký hiệu, mục Footprint, mục Mô hình 3D, mục Mô hình mô phỏng, mục Mẫu linh kiện, mục Tài liệu thông số kỹ thuật, mục Mẫu sơ đồ nguyên lý.
- Vòng đời của bản sửa đổi mục nguồn được thu nhận sẽ nhận trạng thái “sau phát hành” ban đầu, theo định nghĩa vòng đời được gán cho mục đích. Mọi lịch sử vòng đời của bản sửa đổi mục nguồn sẽ bị bỏ qua.
- Nếu vì bất kỳ lý do nào mà không thể thu nhận một mục con của mục Linh kiện/Trang sơ đồ nguyên lý được quản lý đã chọn ở nguồn, thì việc thu nhận mục Linh kiện/Trang sơ đồ nguyên lý được quản lý đó sẽ không được tiến hành.
Quy trình thu nhận dữ liệu - Tóm tắt
Sử dụng Content Cart để thu nhận toàn bộ nội dung dữ liệu bạn cần. Quy trình thu nhận các mục dữ liệu từ máy chủ nguồn khá đơn giản và có thể được tóm tắt qua các bước sau:
-
Máy chủ nguồn được tự động xác định là máy chủ hiện đang hoạt động, nhưng có thể đổi sang một máy chủ đã kết nối khác từ menu lựa chọn ở phía trên bên trái của bảng Explorer.
-
Sử dụng menu thả xuống tên máy chủ đích của Content Cart (được tô màu xanh lam) để chọn một máy chủ đích khác trong danh sách các máy chủ hiện đang kết nối – chọn tùy chọn Quản trị máy chủ để bật/tắt kết nối máy chủ. Đối với Linh kiện, cũng có thể chỉ định đích là một tệp Thư viện tích hợp (IntLib) được lưu cục bộ.
-
Bản sửa đổi mục ban đầu được liệt kê trong bảng chính. Bạn có thể thêm bao nhiêu bản sửa đổi mục vào giỏ tùy ý. Để thực hiện, hãy nhấp vào điều khiển Add More Items ở góc trên bên phải của hộp thoại và chọn mục Select để truy cập hộp thoại Choose Item (một phiên bản của bảng Explorer). Từ đây, bạn có thể duyệt máy chủ nguồn để tìm thêm các mục, thêm từng mục một hoặc thêm hàng loạt bằng các công cụ chọn nhiều tiêu chuẩn. Ngoài ra, hãy chọn mục Add manually để truy cập hộp thoại Thêm mục mới. Hộp thoại này cho phép bạn dán một danh sách bên ngoài gồm các mục cần thiết (mỗi mục một dòng), sau đó tìm kiếm chúng trong máy chủ nguồn theo tiêu chí tìm kiếm đã chọn (GUID, Item ID, Name hoặc MPN). Chọn và xóa các bản sửa đổi mục khỏi danh sách (nhấp vào nút nếu bạn quyết định không thu nhận chúng nữa.
-
Nhấp vào nút điều khiển Change Settings ở góc dưới bên phải của hộp thoại Content Cart để truy cập hộp thoại Content Cart Structure. Tại đây, bạn có thể xác định các tùy chọn mặc định cho từng loại Mục dữ liệu mà tính năng này hỗ trợ thu nhận. Việc này bao gồm chỉ định thư mục mặc định trên máy chủ đích, cũng như Định nghĩa vòng đời, Quy tắc đặt tên Mục và Phiên bản mặc định, cùng chỉ số bắt đầu. Bạn cũng có thể thêm ghi chú để cung cấp thông tin hữu ích về việc thu nhận cho những người khác khi họ duyệt nội dung bạn đã thu nhận.
-
Sau khi chọn các Mục nguồn mong muốn, hãy nhấp vào nút
. Thao tác này chuẩn bị máy chủ đích cho việc thu nhận bằng cách kiểm tra trạng thái của các phiên bản Mục đã chọn (trong trường hợp chúng đã được thu nhận trước đó), các liên kết cha-con và đề xuất hành động cần thực hiện; đối với nội dung thu nhận mới, hành động này sẽ là Transfer new revision and item. Mặc dù các tùy chọn thu nhận mặc định đã chỉ định trước đó được áp dụng trong giai đoạn chuẩn bị này, bạn vẫn có thể sửa đổi thuộc tính của từng Mục đích được đề xuất nếu cần. Để thực hiện, hãy chọn một Mục trong danh sách rồi nhấp vào nút
.
-
Sau khi hoàn tất chuẩn bị, nhấp vào nút
để tiến hành thu nhận. Hộp thoại xác nhận ban đầu sẽ xuất hiện – nhấp vào Yes để tiếp tục chuyển nội dung giữa máy chủ nguồn và máy chủ đích. Hộp thoại xác nhận thứ hai sẽ thông báo kết quả thu nhận – duyệt các Mục đã thu nhận trên máy chủ đích thông qua bảng Explorer.
Dữ liệu đã thu nhận có liên kết trỏ về nguồn gốc của nó. Bạn có thể xem thông tin liên kết nguồn gốc này bằng cách chuyển sang thẻ chế độ xem Origin của phiên bản Mục đích.
Chỉ định Workspace nguồn & đích
Hai Workspace tham gia quá trình thu nhận được chỉ định ở phần trên cùng của hộp thoại Content Cart. Workspace nguồn được xác định tự động dựa trên nơi lưu trữ các Phiên bản Mục bạn đã chỉ định thu nhận – thường là Workspace mà bạn hiện đang đăng nhập (Company Workspace trong ví dụ này). Nếu đang kết nối với nhiều Workspace, hãy nhấp vào tên Workspace đích hoặc nút điều khiển
ở bên phải tên đó để mở danh sách thả xuống gồm các Workspace hiện đang kết nối. Chuyển đổi Workspace theo nhu cầu.

Chỉ định Workspace nguồn và đích tham gia quá trình thu nhận.
Đặt tên cho Giỏ
Dữ liệu được thu nhận từ Workspace nguồn sẽ được sao chép vào các phiên bản mới của các Mục trong Workspace đích. Theo mặc định, các Mục này sẽ nằm trong một cấu trúc thư mục được xác định và tạo mới trong Workspace đích đó. Thư mục cấp cao nhất chứa nội dung đã thu nhận này được đặt theo tên của chính giỏ. Tên mặc định có định dạng Content Cart - <Current Date> - <Current Time> và được xác định tại thời điểm truy cập giỏ. Bạn có thể đổi thành tên có ý nghĩa hơn nếu cần bằng cách nhấp vào nút điều khiển Change ở bên phải tên giỏ.
Sử dụng hộp thoại Content Cart Name Selection xuất hiện sau đó để nhập trực tiếp tên mong muốn cho giỏ. Ngoài ra, bạn có thể chọn một thư mục trong Workspace đích để nhận nội dung trong Giỏ. Đây có thể là thư mục hiện có hoặc một thư mục hoàn toàn mới được tạo ngay trong quá trình thao tác. Duyệt đến và chọn một thư mục hiện có cho giỏ bằng hộp thoại Choose Folder – truy cập bằng cách nhấp vào nút
ở ngoài cùng bên phải trường Content Cart Name. Hoặc tạo thư mục mới trong cấu trúc thư mục bằng các lệnh trong menu chuột phải.

Bạn có thể đặt tên cho Content Cart theo nhu cầu. Hãy đổi tên giỏ (nội dung sẽ được đưa vào thư mục cấp cao nhất mang tên đó) hoặc chọn đưa nội dung của giỏ vào một thư mục cụ thể.
Chỉ định các Mục cần thu nhận
Khu vực chính của hộp thoại Content Cart hiển thị một “bảng tiếp nhận” – liệt kê tất cả các bản sửa đổi mục mà bạn đã chọn để tiếp nhận từ Workspace nguồn. Bạn có thể “nạp” bao nhiêu bản sửa đổi mục dữ liệu tùy ý vào Content Cart để tiếp nhận từ Workspace nguồn. Khi truy cập giỏ lần đầu, các bản sửa đổi mục đang được chọn trong Workspace nguồn tại thời điểm truy cập sẽ được nạp vào giỏ, nhưng bạn có thể nạp thêm bao nhiêu mục tùy ý. Để thực hiện, nhấp vào điều khiển Add More Items ở góc trên bên phải hộp thoại rồi chọn mục Select để mở hộp thoại Choose Item (phiên bản “rút gọn” của bảng Explorer). Từ đây, bạn có thể duyệt Workspace nguồn để tìm thêm mục. Hãy nhớ rằng bạn có thể chọn thêm:
- Một bản sửa đổi cụ thể của một mục.
- Nhiều bản sửa đổi cụ thể của cùng một mục.
- Các bản sửa đổi mới nhất của nhiều mục.
- Các bản sửa đổi mới nhất của tất cả các mục trong thư mục đã chọn (và cấu trúc thư mục con bên dưới).
Ngoài ra, hãy chọn mục Add manually để mở hộp thoại Add new items. Hộp thoại này cho phép bạn dán một danh sách các mục cần dùng từ bên ngoài (mỗi mục một dòng), sau đó tìm kiếm các mục đó trong Workspace nguồn bằng tiêu chí tìm kiếm đã chọn (GUID, Item ID, Name hoặc MPN).

Bảng tiếp nhận chính, liệt kê tất cả các bản sửa đổi mục đã chọn để tiếp nhận từ Workspace nguồn.
Chuẩn bị giỏ
Sau khi chọn các bản sửa đổi mục nguồn, Content Cart cần được “chuẩn bị để chuyển giao” sang Workspace đích. Để thực hiện, nhấp vào nút
. Thao tác này chuẩn bị Workspace đích cho việc tiếp nhận – kiểm tra trạng thái của các bản sửa đổi mục đã chọn (trong trường hợp chúng đã được tiếp nhận trước đó), các liên kết cha-con và đề xuất hành động cần thực hiện. Kết quả của giai đoạn chuẩn bị này được hiển thị lại trong bảng tiếp nhận chính.

Ví dụ về Content Cart đã được chuẩn bị sẵn sàng để chuyển giao sang Workspace đích.
Đối với mỗi bản sửa đổi mục được tiếp nhận, vùng Source của bảng sẽ mở rộng để hiển thị tất cả các bản sửa đổi mục con có liên quan và, nếu chọn, cả thư mục chứa chúng trong Workspace nguồn. Đối với mỗi bản sửa đổi mục (cả cha lẫn con), các thông tin sau có thể được hiển thị trong vùng Target của bảng:
- Revision ID – mã định danh đầy đủ của bản sửa đổi mục trong Workspace đích, dựa trên quy tắc đặt tên mục và bản sửa đổi đã xác định cho loại mục đó.
- Folder – thư mục đích trong Workspace đích, nơi bản sửa đổi mục được tiếp nhận sẽ được tạo/chuyển giao.
- Life Cycle – định nghĩa vòng đời được xác định cho mục cha.
- Naming Scheme – quy tắc đặt tên bản sửa đổi được xác định để nhận diện các bản sửa đổi của mục cha.
- Note – ghi chú tùy chọn có thể dùng để cung cấp thông tin hữu ích về việc tiếp nhận cho người khác khi duyệt nội dung đã tiếp nhận trong Workspace của bạn.
-
Status – trạng thái hiện tại của bản sửa đổi mục trong Workspace đích. Các trạng thái có thể có là:
-
Not found– bản sửa đổi mục chưa từng được tiếp nhận. -
Already Exists– bản sửa đổi mục đã được tiếp nhận trước đó.
-
-
Action – hành động cần thực hiện để đồng bộ hóa Workspace nguồn và đích. Các hành động có thể có là:
-
Transfer new revision and item– dành cho các lần tiếp nhận hoàn toàn mới, khi mục chưa từng được tiếp nhận trước đó. Nói cách khác, tạo một mục thuộc loại đó và một bản sửa đổi mới ở trạng thái dự kiến để chứa dữ liệu nguồn. -
Transfer new revision of existing item– khi tiếp nhận một bản sửa đổi khác của mục và một bản sửa đổi của mục đó đã được tiếp nhận trước đó. -
Nothing to do– bản sửa đổi mục đã chọn đã được tiếp nhận trước đó.
-
Cấu trúc giỏ
Trong giai đoạn chuẩn bị, giỏ sử dụng các thiết lập mặc định được xác định cho từng loại mục có thể tiếp nhận. Các thiết lập này được xác định trong hộp thoại Content Cart Structure, có thể mở bằng cách nhấp vào điều khiển Change Settings ở góc dưới bên phải hộp thoại Content Cart.

Các thiết lập tiếp nhận mặc định được xác định trong hộp thoại Content Cart Structure.
Các thiết lập này được dùng để xác định thuộc tính của các bản sửa đổi mục mới tạo trong Workspace đích – được tạo sẵn ở trạng thái dự kiến để nhận dữ liệu từ các bản sửa đổi mục gốc trong Workspace nguồn. Chúng bao gồm thư mục mặc định trong Workspace đích, cũng như định nghĩa vòng đời, quy tắc đặt tên mục và bản sửa đổi mặc định, cùng chỉ số bắt đầu. Một ghi chú mặc định cũng được xác định theo định dạng Acquired from <SourceWorkspaceName>.
Về thư mục đích trong Workspace đích, mỗi loại mục sẽ được tiếp nhận vào một thư mục riêng nằm bên dưới:
- Một thư mục cha ở cấp cao nhất, được đặt tên theo chính Content Cart
- Một thư mục hiện có, được xác định thông qua hộp thoại chọn Content Cart Name.
Hãy chỉnh sửa các thiết lập tiếp nhận mặc định này cho phù hợp với các quy tắc đang được áp dụng (và được ưu tiên!) cho các loại mục đó trong Workspace đích của bạn. Nhấp vào một ô để truy cập các điều khiển chỉnh sửa.
Các thiết lập tiếp nhận trong hộp thoại Content Cart Structure là các giá trị mặc định ở mức tổng quát. Đối với các mục chưa từng được tiếp nhận – tức là mục cha và bản sửa đổi ban đầu đang được tạo mới (Action là Transfer new revision and item) – bạn có thể xác định thuộc tính ở cấp từng mục nếu cần để kiểm soát chi tiết hơn. Để thực hiện, chọn một bản sửa đổi mục trong bảng tiếp nhận chính rồi nhấp vào nút
. Thao tác này mở hộp thoại Edit Item, nơi bạn có thể chỉnh sửa thuộc tính mục theo yêu cầu – ghi đè các thiết lập mặc định.

Để kiểm soát chi tiết hơn, bạn có thể xác định thuộc tính ở cấp từng mục.
Chuyển giao giỏ
Sau khi hoàn tất chuẩn bị, nhấp vào nút
để tiến hành tiếp nhận. Một hộp thoại xác nhận sẽ xuất hiện, thông báo rằng Content Cart sắp được chuyển từ Workspace nguồn sang Workspace đích – nhấp vào Yes để tiếp tục. Hộp thoại xác nhận thứ hai sẽ xác nhận kết quả tiếp nhận; bạn có thể duyệt các mục đã tiếp nhận trong Workspace đích thông qua bảng Explorer.
Thu nhận dữ liệu ở định dạng IntLib
Bạn cũng có thể thu nhận các linh kiện từ Workspace vào một thư viện tích hợp (*.IntLib). Khi đặt linh kiện từ thư viện tích hợp này, các liên kết thực tế vẫn trỏ về các linh kiện trong Workspace. Nhờ đó, bạn có thể sử dụng hiệu quả các linh kiện trong Workspace của công ty khi ngoại tuyến, đồng thời đảm bảo thiết kế vẫn duy trì liên kết thực sự với các linh kiện đó trong Workspace nguồn.
Thu nhận vào IntLib
Từ hộp thoại Content Cart, quy trình thu nhận vào IntLib như sau:
-
Nhấp vào liên kết Select target server và chọn IntLib file từ menu.
-
Chỉ định tên và vị trí cho tệp IntLib được tạo. Theo mặc định, tệp sẽ được đặt tên theo định dạng
Integrated_Library - <Date> - <Time>.IntLibvà được tạo tại vị trí\Users\Public\Documents\Altium\AD<Solution/Version>\Library\ExportCmpLib. Thay đổi các thiết lập này nếu cần thông qua hộp thoại Save As, được mở bằng cách nhấp vào liên kết Change .
Chấp nhận thư mục đích và tên tệp mặc định hoặc thay đổi theo nhu cầu. -
Nếu cần thu nhận thêm linh kiện vào cùng một IntLib, hãy nhấp vào liên kết Add More Items và chọn mục Select để mở hộp thoại Choose Item (phiên bản “rút gọn” của bảng Explorer). Tại đây, bạn có thể duyệt Workspace nguồn để tìm thêm các Item. Ngoài ra, hãy chọn mục Add manually để mở hộp thoại Add new items. Hộp thoại này cho phép bạn dán danh sách các mục cần dùng từ bên ngoài (mỗi mục một dòng), sau đó tìm kiếm chúng trong Workspace nguồn theo tiêu chí tìm kiếm đã chọn (GUID, Item ID, Name hoặc MPN).
-
Khi đã sẵn sàng, hãy nhấp vào nút
để tiến hành tạo IntLib. Một gói thư viện tích hợp tạm thời (*.LibPkg) sẽ được tạo, đồng thời các tệp nguồn SchLib (chứa ký hiệu, tham số và liên kết mô hình) và PcbLib (chứa mô hình footprint) sẽ được tạo và thêm vào gói. Sau đó, gói này được biên dịch để tạo tệp IntLib trong thư mục đã chỉ định. Một hộp thoại thông tin sẽ xác nhận tệp đã được tạo thành công.
Chuyển giỏ dữ liệu đến thư mục đích, nơi sẽ chứa tệp thư viện tích hợp cần thiết.
Sử dụng IntLib
Sau khi được tạo, IntLib có thể được thêm vào danh sách các thư viện không thuộc Workspace hiện có của phần mềm (thông qua thẻ Installed trong hộp thoại Available File-based Libraries). Khi đó, bạn có thể sử dụng thư viện này từ bảng Components. Đặt các linh kiện từ IntLib vào thiết kế theo nhu cầu. Mặc dù bạn đang làm việc với các linh kiện ở chế độ “ngoại tuyến”, các liên kết ngược về linh kiện gốc trong Workspace vẫn đảm bảo tính liên tục khi bạn quay lại làm việc “trực tuyến” trực tiếp từ Workspace của mình.
