Công cụ Quản lý Dòng Lệnh
Parent page: Bảo trì
Enterprise Server cung cấp một công cụ dòng lệnh để hỗ trợ các khía cạnh sau đây trong cấu hình Enterprise Server:
- User Management – cho phép không gian làm việc (Workspace) của Enterprise Server được nạp sẵn các cấu hình người dùng và nhóm hàng loạt được trích xuất từ hệ thống hoặc hồ sơ của công ty, nhờ đó tránh được việc phải tạo từng mục một thông qua giao diện dựa trên trình duyệt của không gian làm việc. Công cụ này hỗ trợ việc nhập dữ liệu Người dùng, Nhóm và thông tin thành viên người dùng-nhóm từ các tệp chuẩn được phân cách bằng dấu phẩy *.csv .
- Part Choice Indexing – cho phép bạn thực hiện thủ công việc lập chỉ mục lại các Lựa chọn Phụ tùng cho các thành phần thư viện trong Không gian làm việc của bạn, lấy từ các Nguồn Phụ tùng do người dùng định nghĩa (kết nối với cơ sở dữ liệu phụ tùng cục bộ).
Công cụ – avconfiguration.exe – được bao gồm trong bản cài đặt Enterprise Server của bạn và có thể tìm thấy trong thư mục \Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool thư mục.
Truy cập Công cụ Cấu hình
Để sử dụng công cụ:
- Khởi chạy Command Prompt của Windows.
- Di chuyển đến thư mục đúng. Đối với cài đặt mặc định trên ổ C của máy chủ, đường dẫn sẽ là:
cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\. - Để chạy công cụ và liệt kê các tùy chọn có sẵn, tại dấu nhắc lệnh, hãy nhập:
avconfiguration ?

Truy cập công cụ cấu hình thông qua Dấu nhắc lệnh.
Lưu ý rằng ?, bao gồm cả việc hiển thị trợ giúp về các chức năng có sẵn trong công cụ cấu hình:
usermanagement– Nhập người dùng và nhóm.suppliers– Chỉ mục lựa chọn bộ phận.help– hiển thị màn hình trợ giúp (? có thể được sử dụng thay cho chuỗi help).
Cú pháp và các tùy chọn trong Quản lý người dùng
Các tùy chọn sau đây có sẵn khi sử dụng usermanagement của công cụ:
avconfiguration usermanagement [-help | params [options]]
trong đó các tham số có sẵn là:
- --url – bắt buộc. Địa chỉ và cổng của máy chủ Enterprise Server đích.
- --user – bắt buộc. User Name một phần của thông tin đăng nhập của người dùng Workspace trên Enterprise Server.
- --password – Bắt buộc. Password một phần thông tin đăng nhập của người dùng Enterprise Server Workspace (phân biệt chữ hoa chữ thường).
- --roles – tên tệp chứa các nhóm cần nhập.
- --users – tên tệp chứa danh sách người dùng cần nhập.
- --memberships – tên tệp chứa thông tin thành viên của người dùng cần nhập.
Các tùy chọn có sẵn là:
- -d – xóa các người dùng và nhóm không được liệt kê trong các tệp được cung cấp. Tất cả người dùng và nhóm hiện có trong Enterprise Server Workspace, và không được liệt kê trong các tệp được cung cấp, sẽ bị xóa (ngoại trừ System và admin người dùng, và Administrators ).
- -o – ghi đè lên dữ liệu hiện có. Nếu một người dùng tồn tại trong Enterprise Server Workspace và cũng là một phần của tệp đang được nhập, thì thông tin trong Workspace sẽ bị ghi đè bằng thông tin trong tệp được nhập.
Chỉ cần nhập avconfiguration usermanagement, các tùy chọn này sẽ được liệt kê như một công cụ hỗ trợ hữu ích.

Các tùy chọn có sẵn khi sử dụng công cụ ở usermanagement chế độ này.
Usermanagement Example
Mệnh đề sau đây sẽ nhập người dùng, nhóm và mối quan hệ thành viên giữa người dùng và nhóm, theo định nghĩa trong các tệp ví dụ có trong thư mục cài đặt (users.csv, roles.csv, và memberships.csv). Dữ liệu người dùng hiện có sẽ bị ghi đè nếu có người dùng trùng khớp được định nghĩa trong users.csv tệp. Ngoài ra, tất cả các người dùng và nhóm Enterprise Server hiện có khác không được định nghĩa trong users.csv và roles.csv sẽ bị xóa.
avconfiguration usermanagement --url=http://localhost:9780 --user=admin --password=admin --roles=roles.csv --users=users.csv --memberships=memberships.csv -d -o
Công cụ sẽ phân tích dữ liệu tệp để kiểm tra tính hợp lệ trước khi nhập nội dung vào Enterprise Server, đồng thời hiển thị thông báo nhập thành công/thất bại cho từng tệp được xử lý trong quá trình công cụ chạy.

Kết quả của việc chạy lệnh cấu hình mẫu `configuration-usermanagement`.
Ví dụ về tệp CSV
Một ví dụ về mỗi tệp được nhận diện *.csv được bao gồm trong thư mục của công cụ (\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool). Mô tả nội dung của từng loại tệp và các yêu cầu liên quan được trình bày dưới đây.
Chứa dữ liệu hồ sơ người dùng.
| Tên trường | Mô tả | Yêu cầu |
|---|---|---|
| FIRSTNAME | Tên | Bắt buộc (phải có ít nhất một ký tự) |
| HỌ | Họ | Bắt buộc (phải có ít nhất một ký tự) |
| TÊN ĐĂNG NHẬP | Tên người dùng | Bắt buộc |
| MẬT KHẨU | Mật khẩu người dùng | Bắt buộc đối với chế độ xác thực 'Built In' |
| SỐ ĐIỆN THOẠI | Số điện thoại | |
| AUTHTYPE | AUTHTYPE | Bắt buộc: Loại xác thực; 0 cho xác thực 'Tích hợp sẵn', 1 cho xác thực 'Windows' (Miền) |
| Địa chỉ email | ||
| DOMAIN | Tên miền | Bắt buộc đối với chế độ xác thực 'Windows'. |
- Mỗi người dùng phải được định nghĩa trên một dòng mới trong tệp.
- Sẽ không có mục nào được nhập vào Không gian làm việc của Enterprise Server nếu dữ liệu của bất kỳ trường bắt buộc nào bị thiếu trong
users.csvtệp. - Các mục người dùng sẽ không được nhập nếu có lỗi trong dữ liệu, chẳng hạn như có tên miền được bao gồm khi AUTHTYPE được đặt sai thành 0 ('Built In').
- Tất cả các trường phải có trong tệp CSV, được phân tách bằng dấu phẩy. Dữ liệu cho các trường không bắt buộc phải để trống (ví dụ: field1,,field2,...).
Chứa dữ liệu nhóm.
| Tên trường | Mô tả |
|---|---|
| ROLENAME | Tên nhóm (phải có ít nhất một ký tự) |
- Mỗi nhóm phải được định nghĩa trên một dòng mới trong tệp.
Chứa dữ liệu về tư cách thành viên nhóm người dùng (tức là người dùng nào là thành viên của nhóm nào)
| Tên trường | Mô tả |
|---|---|
| ROLENAME | Tên nhóm |
| USERNAME | Tên người dùng |
- Mỗi định nghĩa về tư cách thành viên nhóm người dùng phải được định nghĩa trên một dòng mới trong tệp.
- Các trường phải được phân tách bằng dấu phẩy.
- Các kết hợp TÊN NGƯỜI DÙNG–TÊN VAI TRÒ không hợp lệ sẽ bị từ chối, nhưng không ngăn cản việc nhập các kết hợp hợp lệ.
Cú pháp và các tùy chọn cho nhà cung cấp
Các tùy chọn sau đây có sẵn khi sử dụng suppliers của công cụ:
avconfiguration suppliers [-help | params]
trong đó các tham số có sẵn là:
- --url – bắt buộc. Địa chỉ và cổng của Enterprise Server đích.
- --user – bắt buộc. User Name một phần của thông tin đăng nhập của người dùng Workspace trên Enterprise Server.
- --passwordMD5 – Bắt buộc. Password một phần thông tin đăng nhập của người dùng Enterprise Server Workspace, dưới dạng giá trị băm MD5.
- --reindexPartChoice – bắt buộc. Tên nhà cung cấp để bắt đầu lập chỉ mục lựa chọn bộ phận. Đây là tên của cơ sở dữ liệu tùy chỉnh do người dùng định nghĩa (Part Source) đã được cấu hình để kết nối với cơ sở dữ liệu bộ phận nội bộ của công ty. Dùng dấu phẩy để phân tách nhiều nhà cung cấp (Part Sources). Lưu ý rằng vì ký tự dấu phẩy được sử dụng làm dấu phân cách, nên không thể sử dụng ký tự này trong tên Nguồn Phụ tùng.
Chỉ cần nhập avconfiguration suppliers, các tùy chọn này sẽ được liệt kê như một công cụ hỗ trợ hữu ích.

Các tùy chọn có sẵn khi sử dụng công cụ ở suppliers chế độ.
Một ví dụ về mục nhập có thể là:
avconfiguration suppliers --url=http://localhost:9780 --user=admin --passwordMD5=21232f297a57a5a743894a0e4a801fc3 --reindexPartChoice=MySQLODBC,MsSQL