Ferramenta de Gestão por Linha de Comandos

Parent page: Manutenção

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 derivadas de sistemas ou registos da empresa, evitando assim a necessidade de criar individualmente as entradas através da interface baseada em navegador do Workspace. A ferramenta suporta a importação de dados de Utilizadores, Grupos e pertença utilizador-grupo a partir de ficheiros *.csv delimitados por vírgulas.
• Part Choice Indexing – permitindo-lhe executar manualmente uma reindexação das Part Choices dos componentes da biblioteca do seu Workspace, obtidas através de Part Sources definidas pelo utilizador (ligações a bases de dados locais de peças).

A ferramenta – avconfiguration.exe – está incluída na instalação do seu Enterprise Server e pode ser encontrada na pasta \Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool.

Aceder à Ferramenta de Configuração

Para utilizar a ferramenta:

1. Abra uma Linha de Comandos do Windows.
2. Navegue até à pasta correta. Numa instalação predefinida na unidade C do computador anfitrião, será: cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\.
3. 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.

Repare no parâmetro ?; ao incluí-lo, é apresentada 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 utilizado em vez da cadeia help).

Sintaxe e Opções de Usermanagement

As seguintes opções estão disponíveis ao utilizar a função usermanagement da ferramenta:

avconfiguration usermanagement [-help | params [options]]

onde 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 de 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 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 utilizar a ferramenta no modo 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, bem como quaisquer requisitos, são apresentadas abaixo.

Contém dados de perfis de utilizador.

• Cada utilizador tem de ser definido numa nova linha do ficheiro.
• Não será importada qualquer entrada para o Workspace do Enterprise Server se faltarem dados de algum dos campos obrigatórios no ficheiro users.csv.
• As entradas de utilizador não serão importadas se existir um erro nos dados, como por exemplo 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.

• Cada grupo tem de ser definido numa nova linha do ficheiro.

Contém dados de pertença de utilizadores a grupos (isto é, que utilizadores são membros de que grupos)

• Cada definição de pertença utilizador-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 falharão, mas não impedirão que correspondências válidas sejam importadas.

Sintaxe e Opções de Suppliers

As seguintes opções estão disponíveis ao utilizar a função suppliers da ferramenta:

avconfiguration suppliers [-help | params]

onde 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.
• --reindexPartChoice – obrigatório. Nome(s) do(s) fornecedor(es) para iniciar a indexação de part choice. Este é o nome da Part Source de base de dados personalizada definida pelo utilizador que foi configurada para ligar a uma base de dados local de peças da empresa. Separe vários Suppliers (Part Sources) com uma vírgula. Tenha em atenção que, como o caráter vírgula é utilizado como separador, não pode ser usado dentro do nome de uma Part Source.

Ao escrever apenas avconfiguration suppliers, estas opções serão listadas como ajuda útil.Opções disponíveis ao utilizar a ferramenta no modo suppliers.

Um exemplo de entrada poderá ser:

avconfiguration suppliers --url=http://localhost:9780 --user=admin --passwordMD5=21232f297a57a5a743894a0e4a801fc3 --reindexPartChoice=MySQLODBC,MsSQL