Ferramenta de Gestão por Linha de Comandos
O Enterprise Server disponibiliza uma ferramenta de Linha de Comandos para dar resposta aos seguintes aspetos da Configuração do Enterprise Server:
- User Management – permitindo que o Workspace do Enterprise Server seja pré-carregado com configurações em massa de utilizadores e grupos provenientes de sistemas ou registos da empresa, evitando assim a necessidade de criar individualmente as entradas através da interface do Workspace baseada no navegador. A ferramenta suporta a importação de dados de Utilizadores, Grupos e pertença de utilizadores a grupos a partir de ficheiros *.csv delimitados por vírgulas padrão.
- Part Choice Indexing – permitindo-lhe efetuar manualmente uma reindexação das Part Choices para os componentes da biblioteca do seu Workspace, obtidos através de Part Sources definidas pelo utilizador (ligações a bases de dados de peças locais).
A ferramenta – avconfiguration.exe – está incluída na instalação do Enterprise Server e pode ser encontrada na pasta \Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool.
Aceder à Ferramenta de Configuração
Para utilizar a ferramenta:
- Inicie uma Linha de Comandos do Windows.
-
Navegue até à pasta correta. Para uma instalação predefinida na unidade C do computador anfitrião, será:
cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\. -
Para executar a ferramenta e listar as opções disponíveis, na linha de comandos escreva:
avconfiguration ?
Aceder à ferramenta de configuração através de uma Linha de Comandos.
Note o ?; incluí-lo apresenta ajuda sobre as funções disponíveis na ferramenta de configuração:
-
usermanagement– importar Utilizadores e Grupos. -
suppliers– indexação de Part Choice. -
help– apresentar o ecrã de ajuda (? pode ser usado em vez da cadeia help).
Sintaxe e Opções do Usermanagement
Estão disponíveis as seguintes opções ao usar a função usermanagement da ferramenta:
avconfiguration usermanagement [-help | params [options]]
em que os parâmetros disponíveis são:
- --url – obrigatório. Endereço e porta do Enterprise Server de destino.
- --user – obrigatório. Parte User Name das credenciais de acesso de um utilizador do Workspace do Enterprise Server.
- --password – obrigatório. Parte Password das credenciais de acesso de um utilizador do Workspace do Enterprise Server (sensível a maiúsculas e minúsculas).
- --roles – nome do ficheiro que contém os grupos a importar.
- --users – nome do ficheiro que contém os utilizadores a importar.
- --memberships – nome do ficheiro que contém as pertenças dos utilizadores a importar.
As opções disponíveis são:
- -d – eliminar utilizadores e grupos não listados nos ficheiros fornecidos. Todos os utilizadores e grupos existentes no Workspace do Enterprise Server, e que não estejam listados nos ficheiros fornecidos, serão eliminados (com exceção dos utilizadores System e admin, e do grupo Administrators).
- -o – substituir dados existentes. Se um utilizador existir no Workspace do Enterprise Server, e também fizer parte de um ficheiro que está a ser importado, então a informação no Workspace será substituída pela do ficheiro importado.
Ao escrever apenas avconfiguration usermanagement, estas opções serão listadas como ajuda útil.
Opções disponíveis ao usar a ferramenta no modo usermanagement.
Usermanagement Example
A entrada seguinte irá importar utilizadores, grupos e pertenças de utilizadores a grupos, conforme definido nos ficheiros de exemplo incluídos no diretório de instalação (users.csv, roles.csv e memberships.csv). Os dados de utilizadores existentes serão substituídos sempre que um utilizador correspondente estiver definido no ficheiro users.csv. Além disso, todos os outros utilizadores e grupos existentes do Enterprise Server que não estejam definidos nos ficheiros users.csv e roles.csv serão eliminados.
avconfiguration usermanagement --url=http://localhost:9780 --user=admin --password=admin --roles=roles.csv --users=users.csv --memberships=memberships.csv -d -o
A ferramenta analisará os dados do ficheiro para verificar a sua validade antes de importar o conteúdo para o Enterprise Server, e também apresentará mensagens de sucesso/falha da importação para cada ficheiro processado à medida que a ferramenta é executada.
O resultado da execução do comando de exemplo configuration-usermanagement.
Ficheiros CSV de Exemplo
Um exemplo de cada ficheiro *.csv reconhecido está incluído no diretório da ferramenta (\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool). As descrições do conteúdo de cada tipo de ficheiro, e quaisquer requisitos, são apresentadas abaixo.
Contém dados de perfis de Utilizador.
| Nome do campo | Descrição | Requisitos |
|---|---|---|
| FIRSTNAME | Primeiro nome | Obrigatório (tem de ter pelo menos um carácter) |
| LASTNAME | Apelido | Obrigatório (tem de ter pelo menos um carácter) |
| USERNAME | Nome de utilizador | Obrigatório |
| PASSWORD | Palavra-passe do utilizador | Obrigatório para o modo de autenticação 'Built In' |
| PHONE | Número de telefone | |
| AUTHTYPE | AUTHTYPE | Obrigatório: Tipo de Autenticação; 0 para autenticação 'Built In', 1 para autenticação 'Windows' (Domínio) |
| Endereço de email | ||
| DOMAIN | Nome do domínio | Obrigatório para o modo de autenticação 'Windows'. |
- Cada utilizador tem de ser definido numa nova linha do ficheiro.
-
Não serão importadas entradas para o Workspace do Enterprise Server se faltarem dados para qualquer um dos campos Obrigatórios no ficheiro
users.csv. - As entradas de utilizador não serão importadas se existir um erro nos dados, tal como um Domínio incluído quando o AUTHTYPE está incorretamente definido como 0 ('Built In').
- Todos os campos têm de estar presentes no ficheiro CSV, separados por vírgulas. Os dados dos campos não obrigatórios devem estar em branco (por exemplo, field1,,field2,...).
Contém dados de grupos.
| Nome do campo | Descrição |
|---|---|
| ROLENAME | Nome do grupo (tem de ter pelo menos um carácter) |
- Cada grupo tem de ser definido numa nova linha do ficheiro.
Contém dados de pertença de utilizadores a grupos (ou seja, que utilizadores são membros de que grupos)
| Nome do campo | Descrição |
|---|---|
| ROLENAME | Nome do grupo |
| USERNAME | Nome de utilizador |
- Cada definição de pertença de utilizador a grupo tem de ser definida numa nova linha do ficheiro.
- Os campos têm de ser separados por vírgulas.
- Correspondências USERNAME–ROLENAME inválidas irão falhar, mas não impedirão que correspondências válidas sejam importadas.
Sintaxe e Opções de Suppliers
Estão disponíveis as seguintes opções ao usar a função suppliers da ferramenta:
avconfiguration suppliers [-help | params]
em que os parâmetros disponíveis são:
-
--url – obrigatório. Endereço e porta do Enterprise Server de destino.
-
--user – obrigatório. Parte User Name das credenciais de acesso de um utilizador do Workspace do Enterprise Server.
-
--passwordMD5 – obrigatório. Parte Password das credenciais de acesso de um utilizador do Workspace do Enterprise Server, como valor hash MD5.
Ao escrever apenas avconfiguration suppliers, estas opções serão listadas como ajuda útil.
Opções disponíveis ao usar a ferramenta no modo suppliers.
Um exemplo de entrada poderá ser:
avconfiguration suppliers --url=http://localhost:9780 --user=admin --passwordMD5=21232f297a57a5a743894a0e4a801fc3
Localizado por IA