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 reindexação de Part Choice pode ser configurada para ocorrer automaticamente. Configure isto utilizando o campo
Indexing part choices every, ao definir uma fonte de peças de base de dados personalizada. As fontes de peças são definidas por um administrador do Workspace na página
Part Providers (
Admin – Part Providers) da interface do navegador do Workspace. Para mais informações, consulte
Configurar uma Fonte de Peças de Base de Dados Personalizada.
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.
Embora a ferramenta possa ser usada para gestão automatizada de utilizadores, a abordagem recomendada é utilizar a funcionalidade de
sincronização LDAP.
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 ?
Dependendo do sistema operativo do PC servidor, o texto copiado pode ser colado na linha de comandos usando o botão direito do rato ou Ctrl+V, ou ambos.
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.
O caminho de pesquisa predefinido para os ficheiros de dados de entrada CSV é o diretório atual (onde reside o ficheiro avconfiguration.exe). Se um ficheiro de dados não estiver localizado no diretório atual, o caminho para esse ficheiro de dados tem de ser incluído.
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
Note que caracteres específicos de idioma (tais como umlauts, graves, etc.) não são suportados.
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.
users.csv
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) |
| EMAIL |
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,...).
roles.csv
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.
memberships.csv
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
AI-localized