Enterprise Server udostępnia narzędzie wiersza poleceń, które obejmuje następujące aspekty konfiguracji Enterprise Server:
-
User Management – umożliwia wstępne załadowanie do Workspace Enterprise Server zbiorczych konfiguracji użytkowników i grup pochodzących z systemów lub rejestrów firmowych, dzięki czemu nie ma potrzeby tworzenia wpisów pojedynczo przez przeglądarkowy interfejs Workspace. Narzędzie obsługuje import danych Użytkowników, Grup oraz przynależności użytkownik–grupa ze standardowych plików *.csv rozdzielanych przecinkami.
-
Part Choice Indexing – umożliwia ręczne wykonanie ponownego indeksowania wyborów części (Part Choices) dla komponentów biblioteki Workspace, pozyskiwanych przez zdefiniowane przez użytkownika źródła części (połączenia z lokalnymi bazami danych części).
Ponowne indeksowanie wyborów części można skonfigurować tak, aby odbywało się automatycznie. Skonfiguruj to za pomocą pola
Indexing part choices every podczas definiowania niestandardowego źródła części z bazy danych. Źródła części są definiowane przez administratora Workspace na stronie
Part Providers (
Admin – Part Providers) w przeglądarkowym interfejsie Workspace. Więcej informacji:
Configuring a Custom Database Part Source.
Narzędzie – avconfiguration.exe – jest dołączone do instalacji Enterprise Server i można je znaleźć w folderze \Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool.
Dostęp do narzędzia konfiguracji
Aby użyć narzędzia:
-
Uruchom Wiersz polecenia systemu Windows.
-
Przejdź do właściwego folderu. Dla domyślnej instalacji na dysku C komputera hosta będzie to:
cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\.
-
Aby uruchomić narzędzie i wyświetlić dostępne opcje, w wierszu polecenia wpisz:
avconfiguration ?
W zależności od systemu operacyjnego komputera serwera, skopiowany tekst można wkleić do wiersza polecenia za pomocą prawego przycisku myszy lub Ctrl+V, albo obu metod.
Dostęp do narzędzia konfiguracji przez Wiersz polecenia.
Zwróć uwagę na ? — jego dodanie wyświetla pomoc dotyczącą funkcji dostępnych w narzędziu konfiguracji:
-
usermanagement – import Użytkowników i Grup.
-
suppliers – indeksowanie Part Choice.
-
help – wyświetlenie ekranu pomocy (? można użyć zamiast ciągu help).
Składnia i przełączniki Usermanagement
Następujące przełączniki są dostępne podczas używania funkcji usermanagement narzędzia:
avconfiguration usermanagement [-help | params [options]]
gdzie dostępne parametry to:
-
--url – wymagane. Adres i port docelowego Enterprise Server.
-
--user – wymagane. Część User Name danych uwierzytelniających dostępu użytkownika Workspace Enterprise Server.
-
--password – wymagane. Część Password danych uwierzytelniających dostępu użytkownika Workspace Enterprise Server (z rozróżnieniem wielkości liter).
-
--roles – nazwa pliku zawierającego grupy do zaimportowania.
-
--users – nazwa pliku zawierającego użytkowników do zaimportowania.
-
--memberships – nazwa pliku zawierającego przynależności użytkowników do zaimportowania.
Domyślna ścieżka wyszukiwania dla wejściowych plików danych CSV to bieżący katalog (w którym znajduje się plik avconfiguration.exe). Jeśli plik danych nie znajduje się w bieżącym katalogu, należy podać ścieżkę do pliku danych.
Dostępne opcje:
-
-d – usuń użytkowników i grupy niewymienione w dostarczonych plikach. Wszyscy istniejący użytkownicy i grupy w Workspace Enterprise Server, którzy nie są wymienieni w dostarczonych plikach, zostaną usunięci (z wyjątkiem użytkowników System i admin oraz grupy Administrators).
-
-o – nadpisz istniejące dane. Jeśli użytkownik istnieje w Workspace Enterprise Server i jednocześnie znajduje się w importowanym pliku, wówczas informacje w Workspace zostaną nadpisane danymi z importowanego pliku.
Wpisując tylko avconfiguration usermanagement, przełączniki te zostaną wyświetlone jako pomocna ściągawka.
Przełączniki dostępne podczas używania narzędzia w trybie usermanagement.
Usermanagement Example
Poniższy wpis zaimportuje użytkowników, grupy oraz przynależności użytkownik–grupa, zgodnie z przykładowymi plikami dołączonymi do katalogu instalacyjnego (users.csv, roles.csv i memberships.csv). Istniejące dane użytkowników zostaną nadpisane tam, gdzie pasujący użytkownik jest zdefiniowany w pliku users.csv. Dodatkowo wszyscy pozostali istniejący użytkownicy i grupy Enterprise Server, którzy nie są zdefiniowani w plikach users.csv i roles.csv, zostaną usunięci.
avconfiguration usermanagement --url=http://localhost:9780 --user=admin --password=admin --roles=roles.csv --users=users.csv --memberships=memberships.csv -d -o
Zwróć uwagę, że znaki specyficzne dla języków (takie jak umlauty, akcenty grawis itp.) nie są obsługiwane.
Narzędzie sprawdzi poprawność danych w plikach przed zaimportowaniem zawartości do Enterprise Server, a także będzie wyświetlać komunikaty o powodzeniu/niepowodzeniu importu dla każdego przetwarzanego pliku podczas działania narzędzia.
Wynik uruchomienia przykładowej komendy configuration-usermanagement.
Przykładowe pliki CSV
Przykład każdego rozpoznawanego pliku *.csv jest dołączony w katalogu narzędzia (\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool). Opisy zawartości każdego typu pliku oraz wymagania przedstawiono poniżej.
users.csv
Zawiera dane profili użytkowników.
| Nazwa pola |
Opis |
Wymagania |
| FIRSTNAME |
Imię |
Wymagane (musi mieć co najmniej jeden znak) |
| LASTNAME |
Nazwisko |
Wymagane (musi mieć co najmniej jeden znak) |
| USERNAME |
Nazwa użytkownika |
Wymagane |
| PASSWORD |
Hasło użytkownika |
Wymagane dla trybu uwierzytelniania „Built In” |
| PHONE |
Numer telefonu |
|
| AUTHTYPE |
AUTHTYPE |
Wymagane: typ uwierzytelniania; 0 dla uwierzytelniania „Built In”, 1 dla uwierzytelniania „Windows” (domenowego) |
| EMAIL |
Adres e-mail |
|
| DOMAIN |
Nazwa domeny |
Wymagane dla trybu uwierzytelniania „Windows”. |
-
Każdy użytkownik musi być zdefiniowany w nowej linii pliku.
-
Żadne wpisy nie zostaną zaimportowane do Workspace Enterprise Server, jeśli w pliku
users.csv brakuje danych dla któregokolwiek z pól wymaganych.
-
Wpisy użytkowników nie zostaną zaimportowane, jeśli w danych występuje błąd, np. podano domenę, gdy AUTHTYPE jest błędnie ustawione na 0 („Built In”).
-
Wszystkie pola muszą być obecne w pliku CSV i rozdzielone przecinkiem. Dane dla pól niewymaganych powinny być puste (np. field1,,field2,...).
roles.csv
Zawiera dane grup.
| Nazwa pola |
Opis |
| ROLENAME |
Nazwa grupy (musi mieć co najmniej jeden znak) |
-
Każda grupa musi być zdefiniowana w nowej linii pliku.
memberships.csv
Zawiera dane przynależności użytkowników do grup (tj. którzy użytkownicy są członkami których grup)
| Nazwa pola |
Opis |
| ROLENAME |
Nazwa grupy |
| USERNAME |
Nazwa użytkownika |
-
Każda definicja przynależności użytkownik–grupa musi być zdefiniowana w nowej linii pliku.
-
Pola muszą być rozdzielone przecinkiem.
-
Nieprawidłowe dopasowania USERNAME–ROLENAME zakończą się niepowodzeniem, ale nie uniemożliwią importu poprawnych dopasowań.
Składnia i przełączniki Suppliers
Następujące przełączniki są dostępne podczas używania funkcji suppliers narzędzia:
avconfiguration suppliers [-help | params]
gdzie dostępne parametry to:
-
--url – wymagane. Adres i port docelowego Enterprise Server.
-
--user – wymagane. Część User Name danych uwierzytelniających dostępu użytkownika Workspace Enterprise Server.
-
--passwordMD5 – wymagane. Część Password danych uwierzytelniających dostępu użytkownika Workspace Enterprise Server, jako wartość skrótu MD5.
Źródła części są definiowane przez administratora Workspace na stronie Part Providers (Admin – Part Providers) w przeglądarkowym interfejsie Workspace. Więcej informacji: Configuring a Custom Database Part Source.
Wpisując tylko avconfiguration suppliers, przełączniki te zostaną wyświetlone jako pomocna ściągawka.
Przełączniki dostępne podczas używania narzędzia w trybie suppliers.
Przykładowy wpis może wyglądać następująco:
avconfiguration suppliers --url=http://localhost:9780 --user=admin --passwordMD5=21232f297a57a5a743894a0e4a801fc3
Tłumaczenie SI