Altium Concord Pro предоставляет консольное средство, предназначенное для следующих аспектов конфигурации:
Это средство, avconfiguration.exe, включено в состав установки Altium Concord Pro, и оно находится в папке \Program Files (x86)\Altium\Altium Concord Pro\Tools\VaultConfigurationTool.
Доступ к средству конфигурации
Для использования средства:
- Запустите командную строку Windows.
- Перейдите к корректной папке. Для установки по умолчанию на диск C хост-компьютера, это будет
cd C:\Program Files (x86)\Altium\Altium Concord Pro\Tools\VaultConfigurationTool\.
- Для запуска средства и отображения списка доступных опций введите
avconfiguration ?
В зависимости от операционной системы ПК сервера, скопированный текст можно вставить в командную строку с помощью контекстного меню, сочетания клавиш Ctrl+V или любым из этих двух способов.
Доступ к средству конфигурации через Командную строку.
Обратите внимание, что при добавлении параметра ? будет отображена справка по функциям, доступным в средстве конфигурации:
usermanagement – импорт пользователей и ролей.suppliers – индексация вариантов выбора компонентов.help – отобразить экран справки (можно использовать ? вместо строки help).
Синтаксис и параметры функции usermanagement
Для функции usermanagement доступны следующие параметры:
avconfiguration usermanagement [-help | params [options]],
где доступными параметрами (params) являются:
--url – обязательно. Адрес и порт целевой инстанции Altium Concord Pro.--user – обязательно. Имя пользователя (User Name), которое является частью учетных данных для доступа к Concord Pro.--password – обязательно. Пароль (Password), который является частью учетных данных для доступа к Concord Pro (чувствителен к регистру).--roles – имя файла, который содержит импортируемые роли.--users – имя файла, который содержит импортируемые учетные записи пользователей.--memberships – имя файла, который содержит импортируемые участия пользователей.
Путем поиска по умолчанию для файлов входных данных является текущая директория (где находятся файлы avconfiguration.exe). Если файл данных находится не в текущей директории, путь к файлу данных необходимо указать.
Доступными опциями (options) являются:
-d – удалить учетные записи пользователей и роли, которых нет в указанных файлах. Все существующие пользователи и роли в инстанции Altium Concord Pro, которых нет в указанных файлах, будут удалены (за исключением пользователей System и admin и роли Administrators).-o – перезаписать существующие данные. Если пользователь существует в инстанции Altium Concord Pro и он приведен в импортируемом файле, то информация в инстанции Concord Pro будет перезаписана теми данными, которые содержатся в импортируемом файле.
Если ввести только avconfiguration usermanagement, будет приведен список этих параметров в качестве справки.
Параметры, доступные при использовании средства в режиме usermanagement.
Пример использования usermanagement
Следующая запись импортирует учетные записи пользователей, роли и участие пользователей в ролях, определенные в файлах примеров, которые включены в директорию установки (users.csv, roles.csv и memberships.csv). Существующие данные пользователей будут перезаписаны, если соответствующие пользователи определены в файле users.csv. Кроме того, все прочие существующие пользователи и роли Altium Concord Pro, которые отсутствуют в файлах users.csv и roles.csv, будут удалены.
avconfiguration usermanagement --url=http://localhost:9780 --user=admin --password=admin --roles=roles.csv --users=users.csv --memberships=memberships.csv -d -o
Обратите внимание, что специфические для языка символы (умлауты, грависы) не поддерживаются.
Перед импортом содержимого в Altium Concord Pro средство проанализирует данные в файлах на корректность и покажет сообщение об успешности/сбое импорта каждого файла при запуске средства.
Результат запуска примера команды usermanagement.
Подробную информацию можно найти в файле import.log, который создается в той же папке, где находится само средство (\Program Files (x86)\Altium\Altium Concord Pro\Tools\VaultConfigurationTool).
Примеры файлов CSV
Пример каждого файла *.csv включен в директорию средства (\Program Files (x86)\Altium\Altium Concord Pro\Tools\VaultConfigurationTool). Описания содержимого файла каждого типа и требования показаны ниже.
users.csv
Содержит данные профилей пользователей.
| Имя поля |
Описание |
Требования |
| FIRSTNAME |
Имя |
Необходимо (должен быть по крайней мере один символ) |
| LASTNAME |
Фамилия |
Необходимо (должен быть по крайней мере один символ) |
| USERNAME |
Имя пользователя |
Необходимо |
| PASSWORD |
Пароль |
Необходимо для встроенного ('Built In') режима аутентификации |
| PHONE |
Номер телефона |
|
| AUTHTYPE |
Тип аутентификации |
Необходимо. 0 для встроенной ('Built In') аутентификации, 1 для доменной ('Windows') аутентификации |
| EMAIL |
Адрес электронной почты |
|
| DOMAIN |
Доменное имя |
Необходимо для режима аутентификации 'Windows'. |
- Каждый пользователь должен быть определен на новой строке файла.
- Никакие записи не будут импортированы в Altium Concord Pro, если в файле
users.csv отсутствует какое-либо из обязательных полей.
- Записи пользователей не будут импортированы, если существует ошибка в данных, например включен домен при некорректно заданном значении
0 параметра AUTHTYPE ('Built In').
- Все поля, представленные в файле CSV, должны быть разделены запятыми. Данные для необязательных полей следует оставлять пустыми (например
поле1,,поле2,...).
roles.csv
Содержит данные о ролях.
| Имя поля |
Описание |
| ROLENAME |
Название роли (должен быть по крайнем мере один символ) |
- Каждая роль должна быть определена на новой строке файла.
memberships.csv
Содержит данные об участии пользователей в ролях (т.е. какой пользователь входит в какие роли)
| Имя поля |
Описание |
| ROLENAME |
Название роли |
| USERNAME |
Имя пользователя |
- Каждая запись должна быть определена на новой строке файла.
- Поля должны быть разделены запятыми.
- Некорректные соответствия USERNAME–ROLENAME не пройдут, но корректные соответствия при этом будут импортированы.
Синтаксис и параметры функции suppliers
Для функции suppliers доступны следующие параметры:
avconfiguration suppliers [-help | params]
где доступными параметрами (params) являются:
--url – обязательно. Адрес и порт целевой инстанции Altium Concord Pro.--user – обязательно. Имя пользователя (User Name), которое является частью учетных данных для доступа к Concord Pro.--passwordMD5 – обязательно. Пароль (Password), который является частью учетных данных для доступа к Concord Pro в виде хеш-значения MD5.--reindexPartChoice – обязательно. Имя (имена) поставщиков для начала индексации вариантов выбора компонентов. Это имя пользовательской базы данных Part Source, которая была настроена для подключения к локальной базе данных компонентов предприятия. Разделите множество поставщиков (Part Source) с помощью запятой. Обратите внимание, что поскольку запятая используется в качестве разделителя, она не должна содержаться в имени Part Source.
Источники компонентов определяются администратором Altium Concord Pro на странице
Part Providers (
Admin - Part Providers) веб-интерфейса Concord Pro. Для получения более подробной информации перейдите в раздел
Настройка пользовательской базы данных компонентов.
Если ввести только avconfiguration suppliers, будет приведен список этих параметров в качестве справки.
Параметры, доступные при использовании средства в режиме suppliers.
Пример возможной записи:
avconfiguration suppliers --url=http://localhost:9780 --user=admin --passwordMD5=21232f297a57a5a743894a0e4a801fc3 --reindexPartChoice=MySQLODBC,MsSQL
