Herramienta de gestión de línea de comandos

El Enterprise Server proporciona una herramienta de línea de comandos para cubrir los siguientes aspectos de la configuración de Enterprise Server:

• User Management – permite precargar el Workspace de Enterprise Server con configuraciones masivas de usuarios y grupos derivadas de sistemas o registros de la empresa, evitando así la necesidad de crear las entradas individualmente a través de la interfaz del Workspace basada en navegador. La herramienta admite la importación de datos de usuarios, grupos y pertenencia de usuarios a grupos desde archivos *.csv estándar delimitados por comas.
• Part Choice Indexing – le permite realizar manualmente una reindexación de las Part Choices para los componentes de biblioteca de su Workspace, obtenidos mediante Part Sources definidos por el usuario (conexiones a bases de datos locales de componentes).

La herramienta – avconfiguration.exe – se incluye con la instalación de Enterprise Server y se puede encontrar en la carpeta \Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool.

Acceso a la herramienta de configuración

Para usar la herramienta:

1. Inicie una ventana de símbolo del sistema de Windows.
2. Vaya a la carpeta correcta. Para una instalación predeterminada en la unidad C del equipo anfitrión, será: cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\.
3. Para ejecutar la herramienta y mostrar las opciones disponibles, en el símbolo del sistema escriba: avconfiguration ?

Acceso a la herramienta de configuración mediante un símbolo del sistema.

Tenga en cuenta la opción ?; al incluirla se muestra ayuda sobre las funciones disponibles en la herramienta de configuración:

• usermanagement – importar usuarios y grupos.
• suppliers – indexación de Part Choice.
• help – mostrar la pantalla de ayuda (? puede usarse en lugar de la cadena help).

Sintaxis y modificadores de Usermanagement

Los siguientes modificadores están disponibles al usar la función usermanagement de la herramienta:

avconfiguration usermanagement [-help | params [options]]

donde los parámetros disponibles son:

• --url – obligatorio. Dirección y puerto del Enterprise Server de destino.
• --user – obligatorio. Parte User Name de las credenciales de acceso de un usuario del Workspace de Enterprise Server.
• --password – obligatorio. Parte Password de las credenciales de acceso de un usuario del Workspace de Enterprise Server (distingue entre mayúsculas y minúsculas).
• --roles – nombre del archivo que contiene los grupos para importar.
• --users – nombre del archivo que contiene los usuarios para importar.
• --memberships – nombre del archivo que contiene las pertenencias de usuarios para importar.

Las opciones disponibles son:

• -d – eliminar usuarios y grupos que no estén listados en los archivos suministrados. Todos los usuarios y grupos existentes en el Workspace de Enterprise Server que no estén listados en los archivos suministrados se eliminarán (con la excepción de los usuarios System y admin, y del grupo Administrators).
• -o – sobrescribir los datos existentes. Si un usuario existe en el Workspace de Enterprise Server y también forma parte de un archivo que se está importando, la información del Workspace será sobrescrita con la del archivo importado.

Al escribir solo avconfiguration usermanagement, estos modificadores se mostrarán como ayuda.

Modificadores disponibles al usar la herramienta en modo usermanagement.

Archivos CSV de ejemplo

Se incluye un ejemplo de cada archivo *.csv reconocido en el directorio de la herramienta (\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool). A continuación se muestran las descripciones del contenido de cada tipo de archivo y sus requisitos.

Contiene datos de perfiles de usuario.

• Cada usuario debe definirse en una nueva línea del archivo.
• No se importará ninguna entrada al Workspace de Enterprise Server si faltan datos de cualquiera de los campos obligatorios en el archivo users.csv.
• Las entradas de usuario no se importarán si hay un error en los datos, como incluir un dominio cuando AUTHTYPE está configurado incorrectamente en 0 ('Built In').
• Todos los campos deben estar presentes en el archivo CSV, separados por una coma. Los datos de los campos no obligatorios deben dejarse en blanco (por ejemplo, field1,,field2,...).

Contiene datos de grupos.

• Cada grupo debe definirse en una nueva línea del archivo.

Contiene datos de pertenencia de usuarios a grupos (es decir, qué usuarios son miembros de qué grupos)

• Cada definición de pertenencia de usuario a grupo debe definirse en una nueva línea del archivo.
• Los campos deben estar separados por una coma.
• Las coincidencias no válidas USERNAME–ROLENAME fallarán, pero no impedirán que las coincidencias válidas se importen.

Sintaxis y modificadores de Suppliers

Los siguientes modificadores están disponibles al usar la función suppliers de la herramienta:

avconfiguration suppliers [-help | params]

donde los parámetros disponibles son:

• --url – obligatorio. Dirección y puerto del Enterprise Server de destino.

• --user – obligatorio. Parte User Name de las credenciales de acceso de un usuario del Workspace de Enterprise Server.

• --passwordMD5 – obligatorio. Parte Password de las credenciales de acceso de un usuario del Workspace de Enterprise Server, como valor hash MD5.

Al escribir solo avconfiguration suppliers, estos modificadores se mostrarán como ayuda.

Modificadores disponibles al usar la herramienta en modo suppliers.

Un ejemplo de entrada podría ser:

avconfiguration suppliers --url=http://localhost:9780 --user=admin --passwordMD5=21232f297a57a5a743894a0e4a801fc3