Outil de gestion en ligne de commande

Enterprise Server fournit un outil en ligne de commande pour couvrir les aspects suivants de la configuration d’Enterprise Server :

• User Management – permettre de précharger l’espace de travail Enterprise Server avec des configurations en masse d’utilisateurs et de groupes issues des systèmes ou enregistrements de l’entreprise, évitant ainsi d’avoir à créer individuellement les entrées via l’interface navigateur de l’espace de travail. L’outil prend en charge l’importation des données Utilisateurs, Groupes et appartenances utilisateur-groupe à partir de fichiers *.csv standard délimités par des virgules.
• Part Choice Indexing – vous permettre d’effectuer manuellement une réindexation des choix de pièces pour les composants de bibliothèque de votre espace de travail, provenant de sources de pièces définies par l’utilisateur (connexions à des bases de données locales de pièces).

L’outil – avconfiguration.exe – est inclus avec votre installation d’Enterprise Server et se trouve dans le dossier \Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool.

Accès à l’outil de configuration

Pour utiliser l’outil :

1. Lancez une invite de commandes Windows.
2. Accédez au dossier approprié. Pour une installation par défaut sur le lecteur C de l’ordinateur hôte, ce sera : cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\.
3. Pour exécuter l’outil et afficher les options disponibles, saisissez à l’invite : avconfiguration ?

Accès à l’outil de configuration via une invite de commandes.

Notez l’option ? ; en l’incluant, l’aide sur les fonctions disponibles dans l’outil de configuration s’affiche :

• usermanagement – importer des utilisateurs et des groupes.
• suppliers – indexation des choix de pièces.
• help – afficher l’écran d’aide (? peut être utilisé à la place de la chaîne help).

Syntaxe et commutateurs de gestion des utilisateurs

Les commutateurs suivants sont disponibles lors de l’utilisation de la fonction usermanagement de l’outil :

avconfiguration usermanagement [-help | params [options]]

où les paramètres disponibles sont :

• --url – requis. Adresse et port de l’Enterprise Server cible.
• --user – requis. Partie User Name des identifiants d’accès d’un utilisateur de l’espace de travail Enterprise Server.
• --password – requis. Partie Password des identifiants d’accès d’un utilisateur de l’espace de travail Enterprise Server (sensible à la casse).
• --roles – nom du fichier contenant les groupes à importer.
• --users – nom du fichier contenant les utilisateurs à importer.
• --memberships – nom du fichier contenant les appartenances des utilisateurs à importer.

Les options disponibles sont :

• -d – supprimer les utilisateurs et groupes non répertoriés dans les fichiers fournis. Tous les utilisateurs et groupes existants dans l’espace de travail Enterprise Server qui ne figurent pas dans les fichiers fournis seront supprimés (à l’exception des utilisateurs System et admin, ainsi que du groupe Administrators).
• -o – écraser les données existantes. Si un utilisateur existe dans l’espace de travail Enterprise Server et fait également partie d’un fichier en cours d’importation, alors les informations de l’espace de travail seront remplacées par celles du fichier importé.

En saisissant simplement avconfiguration usermanagement, ces commutateurs seront listés comme aide pratique.

Commutateurs disponibles lors de l’utilisation de l’outil en mode usermanagement.

Exemples de fichiers CSV

Un exemple de chaque fichier *.csv reconnu est inclus dans le répertoire de l’outil (\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool). Les descriptions du contenu de chaque type de fichier, ainsi que les exigences éventuelles, sont indiquées ci-dessous.

Contient les données des profils utilisateur.

• Chaque utilisateur doit être défini sur une nouvelle ligne du fichier.
• Aucune entrée ne sera importée dans l’espace de travail Enterprise Server si des données de l’un des champs requis sont absentes du fichier users.csv.
• Les entrées utilisateur ne seront pas importées s’il existe une erreur dans les données, par exemple un domaine inclus alors que AUTHTYPE est incorrectement défini sur 0 ('Built In').
• Tous les champs doivent être présents dans le fichier CSV, séparés par une virgule. Les données des champs non requis doivent être laissées vides (par ex. field1,,field2,...).

Contient les données des groupes.

• Chaque groupe doit être défini sur une nouvelle ligne du fichier.

Contient les données d’appartenance des utilisateurs aux groupes (c’est-à-dire quels utilisateurs sont membres de quels groupes)

• Chaque définition d’appartenance utilisateur-groupe doit être indiquée sur une nouvelle ligne du fichier.
• Les champs doivent être séparés par une virgule.
• Les correspondances USERNAME–ROLENAME invalides échoueront, sans toutefois empêcher l’importation des correspondances valides.

Syntaxe et commutateurs des fournisseurs

Les commutateurs suivants sont disponibles lors de l’utilisation de la fonction suppliers de l’outil :

avconfiguration suppliers [-help | params]

où les paramètres disponibles sont :

• --url – requis. Adresse et port de l’Enterprise Server cible.

• --user – requis. Partie User Name des identifiants d’accès d’un utilisateur de l’espace de travail Enterprise Server.

• --passwordMD5 – requis. Partie Password des identifiants d’accès d’un utilisateur de l’espace de travail Enterprise Server, sous forme de valeur de hachage MD5.

En saisissant simplement avconfiguration suppliers, ces commutateurs seront listés comme aide pratique.

Commutateurs disponibles lors de l’utilisation de l’outil en mode suppliers.

Un exemple d’entrée pourrait être :

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