Parent page: Maintenance
Le serveur Enterprise fournit un outil en ligne de commande pour prendre en charge les aspects suivants de la configuration du serveur Enterprise :
-
User Management – permettre de précharger l’espace de travail Enterprise Server avec des configurations en masse d’utilisateurs et de rôles issues des systèmes ou des 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, Rôles et appartenances utilisateur-rôle à 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).
La réindexation des choix de pièces peut être configurée pour s’exécuter automatiquement. Configurez cela à l’aide du champ
Indexing part choices every, lors de la définition d’une source de pièces de base de données personnalisée. Les sources de pièces sont définies par un administrateur de l’espace de travail sur la page
Part Providers (
Admin – Part Providers) de l’interface navigateur de l’espace de travail. Pour plus d’informations, voir
Configuration d’une source de pièces de base de données personnalisée.
L’outil – avconfiguration.exe – est inclus avec votre installation du serveur Enterprise et se trouve dans le dossier \Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool.
Accès à l’outil de configuration
Pour utiliser l’outil :
-
Lancez une invite de commandes Windows.
-
Accédez au dossier approprié. Pour une installation par défaut sur le lecteur C de l’ordinateur hôte, il s’agira de :
cd C:\Program Files (x86)\Altium\Altium365\Tools\VaultConfigurationTool\.
-
Pour exécuter l’outil et afficher les options disponibles, saisissez à l’invite :
avconfiguration ?
Selon le système d’exploitation du PC serveur, le texte copié peut être collé dans l’invite de commandes à l’aide du clic droit ou de Ctrl+V, ou des deux.
Accès à l’outil de configuration via une invite de commandes.
Notez l’option ? ; son inclusion affiche l’aide sur les fonctions disponibles dans l’outil de configuration :
-
usermanagement – importer des utilisateurs et des rôles.
-
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 du serveur Enterprise cible.
-
--user – requis. Partie User Name des informations d’identification d’accès d’un utilisateur de l’espace de travail Enterprise Server.
-
--password – requis. Partie Password des informations d’identification d’accès d’un utilisateur de l’espace de travail Enterprise Server (sensible à la casse).
-
--roles – nom du fichier contenant les rôles à importer.
-
--users – nom du fichier contenant les utilisateurs à importer.
-
--memberships – nom du fichier contenant les appartenances des utilisateurs à importer.
Le chemin de recherche par défaut des fichiers de données d’entrée CSV est le répertoire courant (où se trouve le fichier avconfiguration.exe). Si un fichier de données ne se trouve pas dans le répertoire courant, le chemin vers ce fichier doit être inclus.
Les options disponibles sont :
-
-d – supprimer les utilisateurs et rôles non répertoriés dans les fichiers fournis. Tous les utilisateurs et rôles existants dans l’espace de travail Enterprise Server qui ne sont pas répertoriés dans les fichiers fournis seront supprimés (à l’exception des utilisateurs System et admin, ainsi que du rôle 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, 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.
Usermanagement Example
L’entrée suivante importera les utilisateurs, les rôles et les appartenances utilisateur-rôle, tels que définis dans les fichiers d’exemple inclus dans le répertoire d’installation (users.csv, roles.csv et memberships.csv). Les données utilisateur existantes seront écrasées lorsqu’un utilisateur correspondant est défini dans le fichier users.csv. En outre, tous les autres utilisateurs et rôles Enterprise Server existants qui ne sont pas définis dans les fichiers users.csv et roles.csv seront supprimés.
avconfiguration usermanagement --url=http://localhost:9780 --user=admin --password=admin --roles=roles.csv --users=users.csv --memberships=memberships.csv -d -o
Notez que les caractères spécifiques à une langue (tels que les trémas, accents graves, etc.) ne sont pas pris en charge.
L’outil analysera les données du fichier pour en vérifier la validité avant d’importer le contenu dans le serveur Enterprise, et affichera également des messages de réussite/échec de l’importation pour chaque fichier traité pendant l’exécution de l’outil.
Résultat de l’exécution de la commande d’exemple configuration-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.
users.csv
Contient les données des profils utilisateur.
| Nom du champ |
Description |
Exigences |
| FIRSTNAME |
Prénom |
Requis (doit comporter au moins un caractère) |
| LASTNAME |
Nom |
Requis (doit comporter au moins un caractère) |
| USERNAME |
Nom d’utilisateur |
Requis |
| PASSWORD |
Mot de passe utilisateur |
Requis pour le mode d’authentification 'Built In' |
| PHONE |
Numéro de téléphone |
|
| AUTHTYPE |
AUTHTYPE |
Requis : type d’authentification ; 0 pour l’authentification 'Built In', 1 pour l’authentification 'Windows' (domaine) |
| EMAIL |
Adresse e-mail |
|
| DOMAIN |
Nom de domaine |
Requis pour le mode d’authentification 'Windows'. |
-
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 manquantes dans le fichier
users.csv.
Les entrées utilisateur ne seront pas importées s’il existe une erreur dans les données, par exemple si un domaine est 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,...).
roles.csv
Contient les données de rôle.
| Nom du champ |
Description |
| ROLENAME |
Nom du rôle (doit comporter au moins un caractère) |
-
Chaque rôle doit être défini sur une nouvelle ligne du fichier.
memberships.csv
Contient les données d’appartenance utilisateur-rôle (c’est-à-dire quels utilisateurs sont membres de quels rôles)
| Nom du champ |
Description |
| ROLENAME |
Nom du rôle |
| USERNAME |
Nom d’utilisateur |
-
Chaque définition d’appartenance utilisateur-rôle doit être définie sur une nouvelle ligne du fichier.
-
Les champs doivent être séparés par une virgule.
-
Les correspondances USERNAME–ROLENAME invalides échoueront, mais n’empêcheront pas 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 du serveur Enterprise cible.
-
--user – requis. Partie User Name des informations d’identification d’accès d’un utilisateur de l’espace de travail Enterprise Server.
-
--passwordMD5 – requis. Partie Password des informations d’identification d’accès d’un utilisateur de l’espace de travail Enterprise Server, sous forme de valeur de hachage MD5.
-
--reindexPartChoice – requis. Nom(s) du ou des fournisseurs pour démarrer l’indexation des choix de pièces. Il s’agit du nom de la source de pièces de base de données personnalisée définie par l’utilisateur et configurée pour se connecter à une base de données locale de pièces de l’entreprise. Séparez plusieurs fournisseurs (sources de pièces) à l’aide d’une virgule. Notez que, comme la virgule est utilisée comme séparateur, elle ne peut pas être utilisée dans un nom de source de pièces.
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 --reindexPartChoice=MySQLODBC,MsSQL
Localisé par IA