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 để đáp ứng các khía cạnh sau của việc 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à vai trò 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 Workspace trên trình duyệt. Công cụ hỗ trợ nhập dữ liệu Người dùng, Vai trò và dữ liệu thành viên người dùng-vai trò 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 định nghĩa (kết nối tới cơ sở dữ liệu linh kiện 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.

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 tới đúng thư mục. Với cài đặt mặc định trên ổ C của máy chủ, thư mục này 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 ý tham số ?; bao gồm tham số 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à Vai trò.
• 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 công tắc của Usermanagement

Các công tắc sau khả dụng 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 Enterprise Server Workspace.
• --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 Enterprise Server Workspace (phân biệt chữ hoa/chữ thường).
• --roles – tên tệp chứa các vai trò 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 những người dùng và vai trò không được liệt kê trong các tệp được cung cấp. Tất cả người dùng và vai trò hiện có trong Enterprise Server Workspace nhưng không được liệt kê trong các tệp được cung cấp sẽ bị xóa (ngoại trừ người dùng System và admin, cùng vai trò Administrators).
• -o – ghi đè 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 có 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 được nhập.

Chỉ cần nhập avconfiguration usermanagement, các công tắc này sẽ được liệt kê như một trợ giúp hữu ích.

Các công tắc khả dụng khi sử dụng công cụ ở chế độ usermanagement.

Các tệp CSV ví dụ

Một ví dụ cho mỗi loại tệp *.csv được nhận dạng có 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 Enterprise Server Workspace 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.
• 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 là 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 Vai trò.

• Mỗi vai trò 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 Vai trò của Người dùng (nghĩa là, người dùng nào là thành viên của vai trò nào)

• Mỗi định nghĩa thành viên người dùng-vai trò phải được định nghĩa 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 công tắc của Suppliers

Các công tắc sau khả dụng 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 Enterprise Server Workspace.
• --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 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 part choice. Đây là tên của custom database Part Source do người dùng định nghĩa đã được cấu hình để kết nối với cơ sở dữ liệu linh kiện cục bộ của công ty. Phân tách nhiều Supplier (Part Source) bằng dấu phẩy. Lưu ý rằng vì dấu phẩy được dùng làm ký tự phân tách nên nó không thể được dùng trong tên Part Source.

Chỉ cần nhập avconfiguration suppliers, các công tắc này sẽ được liệt kê như một trợ giúp hữu ích.

Các công tắc khả dụng khi sử 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 --reindexPartChoice=MySQLODBC,MsSQL