Công cụ Quản lý Dòng Lệnh

Enterprise Server cung cấp một công cụ Command Line để đáp ứng các khía cạnh sau của cấu hình Enterprise Server:

• User Management – cho phép Workspace của Enterprise Server được nạp sẵn hàng loạt cấu hình người dùng và nhóm lấy từ các hệ thống hoặc hồ sơ của công ty, nhờ đó không cần phải tạo từng mục riêng lẻ thông qua giao diện trình duyệt của Workspace. Công cụ hỗ trợ nhập dữ liệu Người dùng, Nhóm và dữ liệu thành viên người dùng-nhóm từ các tệp *.csv phân tách bằng dấu phẩy tiêu chuẩn.
• Part Choice Indexing – cho phép bạn thực hiện thủ công việc lập chỉ mục lại Part Choices cho các linh kiện thư viện trong Workspace của mình, được lấy từ các Part Sources do người dùng xác định (các kết nối đến cơ sở dữ liệu linh kiện cục bộ).

Công cụ này – 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.

Truy cập Công cụ Cấu hình

Để sử dụng công cụ:

1. Khởi chạy Windows Command Prompt.
2. Điều hướng đến đúng thư mục. Với cài đặt mặc định trên ổ C của máy chủ, thư mục sẽ là: cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\.
3. Để chạy công cụ và liệt kê các tùy chọn khả dụng, 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 Command Prompt.

Lưu ý tùy chọn ?; khi thêm tùy chọn này sẽ 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 – lập chỉ mục Part Choice.
• help – hiển thị màn hình trợ giúp (? có thể được dùng thay cho chuỗi help).

Cú pháp và các tham số chuyển đổi cho Usermanagement

Các tham số chuyển đổi sau có sẵn khi sử dụng chức năng usermanagement của công cụ:

avconfiguration usermanagement [-help | params [options]]

trong đó các tham số khả dụng là:

• --url – bắt buộc. Địa chỉ và cổng của Enterprise Server đích.
• --user – bắt buộc. Phần User Name trong thông tin xác thực truy cập của người dùng Workspace Enterprise Server.
• --password – bắt buộc. Phần Password trong thông tin xác thực truy cập của người dùng Workspace Enterprise Server (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 các người dùng cần nhập.
• --memberships – tên tệp chứa dữ liệu thành viên của người dùng cần nhập.

Các tùy chọn khả dụng là:

• -d – xóa 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 Workspace Enterprise Server nhưng không được liệt kê trong các tệp được cung cấp sẽ bị xóa (ngoại trừ các người dùng System và admin, và nhóm Administrators).
• -o – ghi đè dữ liệu hiện có. Nếu một người dùng đã tồn tại trong Workspace Enterprise Server và cũng xuất hiện trong một tệp đang được nhập, thì thông tin trong Workspace sẽ bị ghi đè bằng thông tin trong tệp đã nhập.

Khi chỉ nhập avconfiguration usermanagement, các tham số chuyển đổi này sẽ được liệt kê như một trợ giúp hữu ích.

Các tham số chuyển đổi khả dụng khi dùng công cụ ở chế độ usermanagement.

Các tệp CSV ví dụ

Một ví dụ cho mỗi tệp *.csv được nhận diện đượ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à mọi yêu cầu được trình bày bên dưới.

Chứa dữ liệu hồ sơ người dùng.

• Mỗi người dùng phải được định nghĩa trên một dòng mới của tệp.
• Sẽ không có mục nào được nhập vào Workspace Enterprise Server nếu dữ liệu cho bất kỳ trường bắt buộc nào bị thiếu trong tệp users.csv. 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ó Domain trong khi AUTHTYPE được đặt sai thành 0 ('Built In').
• Tất cả các trường phải có mặt 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.

• Mỗi nhóm phải được định nghĩa trên một dòng mới của tệp.

Chứa dữ liệu thành viên nhóm của người dùng (tức là người dùng nào là thành viên của nhóm nào)

• Mỗi định nghĩa thành viên người dùng-nhóm phải được khai báo trên một dòng mới của tệp.
• Các trường phải được phân tách bằng dấu phẩy.
• Các cặp USERNAME–ROLENAME không hợp lệ sẽ thất bại, nhưng không ngăn các cặp hợp lệ được nhập.

Cú pháp và các tham số chuyển đổi cho Suppliers

Các tham số chuyển đổi sau có sẵn khi sử dụng chức năng suppliers của công cụ:

avconfiguration suppliers [-help | params]

trong đó các tham số khả dụng là:

• --url – bắt buộc. Địa chỉ và cổng của Enterprise Server đích.

• --user – bắt buộc. Phần User Name trong thông tin xác thực truy cập của người dùng Workspace Enterprise Server.

• --passwordMD5 – bắt buộc. Phần Password trong thông tin xác thực truy cập của người dùng Workspace Enterprise Server, dưới dạng giá trị băm MD5.

Khi chỉ nhập avconfiguration suppliers, các tham số chuyển đổi này sẽ được liệt kê như một trợ giúp hữu ích.

Các tham số chuyển đổi khả dụng khi dùng công cụ ở chế độ suppliers.

Một mục nhập ví dụ có thể là:

avconfiguration suppliers --url=http://localhost:9780 --user=admin --passwordMD5=21232f297a57a5a743894a0e4a801fc3