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 funções, derivadas 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, Funções e associações utilizador-função a partir de ficheiros *.csv delimitados por vírgulas.
• Part Choice Indexing – permitindo-lhe executar manualmente uma reindexação das Escolhas de Peças para os componentes da biblioteca do seu Workspace, obtidas através de Fontes de Peças 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 a Linha de Comandos do Windows.
2. 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\.
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 ?; ao incluí-lo, é apresentada ajuda sobre as funções disponíveis na ferramenta de configuração:

• usermanagement – importar Utilizadores e Funções.
• suppliers – indexação de Escolhas de Peças.
• help – mostrar o ecrã de ajuda (? pode ser usado 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]]

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 as funções a importar.
• --users – nome do ficheiro que contém os utilizadores a importar.
• --memberships – nome do ficheiro que contém as associações de utilizadores a importar.

As opções disponíveis são:

• -d – eliminar utilizadores e funções não listados nos ficheiros fornecidos. Todos os utilizadores e funções 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 da função 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, e 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ão importadas entradas para o Workspace do Enterprise Server se faltarem dados de 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, 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 Funções.

• Cada função tem de ser definida numa nova linha do ficheiro.

Contém dados de associação de Funções de Utilizador (ou seja, que utilizadores são membros de que Funções)

• Cada definição de associação utilizador-função tem de ser definida numa nova linha do ficheiro.
• Os campos têm de ser separados por vírgulas.
• As correspondências inválidas USERNAME–ROLENAME irão falhar, mas não impedirão a importação das correspondências válidas.

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]

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

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.

Uma entrada de exemplo poderá ser:

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