Herramienta de gestión de línea de comandos

Parent page: Mantenimiento

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 mediante la interfaz basada en navegador del Workspace. 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 – permite realizar manualmente una reindexación de las Part Choices para los componentes de la biblioteca de su Workspace, obtenidas a través de Part Sources definidas por el usuario (conexiones a bases de datos locales de piezas).

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

Acceso a la herramienta de configuración

Para usar la herramienta:

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

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

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

• usermanagement – importar usuarios y grupos.
• suppliers – indexación de Part Choices.
• 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 a importar.
• --users – nombre del archivo que contiene los usuarios a importar.
• --memberships – nombre del archivo que contiene las pertenencias de usuarios a importar.

Las opciones disponibles son:

• -d – elimina usuarios y grupos no incluidos en los archivos suministrados. Todos los usuarios y grupos existentes en el Workspace de Enterprise Server que no estén incluidos en los archivos suministrados se eliminarán (con excepción de los usuarios System y admin, y del grupo Administrators).
• -o – sobrescribe 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, entonces la información del Workspace se sobrescribirá con la del archivo importado.

Si escribe 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 de contenido de cada tipo de archivo y sus requisitos.

Contiene datos de perfiles de usuario.

• Cada usuario debe definirse en una línea nueva 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 como 0 ('Built In').
• Todos los campos deben estar presentes en el archivo CSV, separados por comas. Los datos de los campos no obligatorios deben dejarse en blanco (p. ej., field1,,field2,...).

Contiene datos de grupos.

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

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

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

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 de las credenciales de acceso de un usuario del Workspace de Enterprise Server.
• --passwordMD5 – obligatorio. Parte de las credenciales de acceso de un usuario del Workspace de Enterprise Server, como valor hash MD5.
• --reindexPartChoice – obligatorio. Nombre o nombres de proveedores para iniciar la indexación de Part Choices. Este es el nombre de la Part Source de base de datos personalizada definida por el usuario que se ha configurado para conectarse a una base de datos local de piezas de la empresa. Separe varios proveedores (Part Sources) usando una coma. Tenga en cuenta que, como la coma se utiliza como separador, no puede usarse dentro del nombre de una Part Source.

Si escribe 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 --reindexPartChoice=MySQLODBC,MsSQL