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 roles derivadas de sistemas o registros de la empresa, evitando así la necesidad de crear las entradas individualmente mediante la interfaz del Workspace basada en navegador. La herramienta admite la importación de datos de usuarios, roles y pertenencia de usuarios a roles 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 biblioteca de su Workspace, obtenidos mediante Part Sources definidas por el usuario (conexiones a bases de datos locales de componentes).

La herramienta – avconfiguration.exe – se incluye con su 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. Inicie un símbolo del sistema de Windows.
2. Vaya a la carpeta correcta. En 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 listar 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 roles.
• suppliers – indexación de Part Choice.
• help – mostrar la pantalla de ayuda (? puede usarse en lugar de la cadena help).

Sintaxis y modificadores de gestión de usuarios

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 de archivo del archivo que contiene los roles que se van a importar.
• --users – nombre de archivo del archivo que contiene los usuarios que se van a importar.
• --memberships – nombre de archivo del archivo que contiene las pertenencias de usuarios que se van a importar.

Las opciones disponibles son:

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

Si escribe solo avconfiguration usermanagement, estos modificadores se mostrarán como ayuda útil.

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, así como los requisitos correspondientes.

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, por ejemplo, si se incluye un Domain 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 roles.

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

Contiene datos de pertenencia de usuario a rol (es decir, qué usuarios son miembros de qué roles)

• Cada definición de pertenencia usuario-rol debe definirse en una nueva línea del archivo.
• Los campos deben separarse mediante una coma.
• Las coincidencias no vá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 User Name 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 del proveedor o proveedores para iniciar la indexación de Part Choice. Este es el nombre de la Part Source personalizada definida por el usuario que se ha configurado para conectarse a una base de datos local de componentes de la empresa. Separe varios Suppliers (Part Sources) con una coma. Tenga en cuenta que, dado que el carácter 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 útil.

Modificadores disponibles al usar la herramienta en modo suppliers.

Una entrada de ejemplo podría ser:

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