Altium Designer Documentation

Altium Concord Pro - Консольное средство для управления сервером

Created: 19.07.2019 | Updated: 19.07.2019

Altium Concord Pro предоставляет консольное средство, предназначенное для следующих аспектов конфигурации:

  • Управление пользователями – позволяет в пакетном режиме предварительно загрузить на Altium Concord Pro настройки пользователей и ролей из систем и записей предприятия и таким образом избежать необходимости создания записей через веб-интерфейс Concord Pro по отдельности. Средство поддерживает импорт пользователей, ролей и данных о связи пользователей и ролей из стандартных файлов *.csv.
  • Индексация вариантов выбора компонентов – позволяет вручную провести переиндексацию вариантов выбора управляемых компонентов, полученных через пользовательские источники компонентов (подключения к локальным базам данных компонентов).

    Переиндексацию вариантов выбора компонентов можно настроить на автоматический запуск. Настройте ее с помощью поля Indexing part choices every при определении пользовательской базы данных компонентов. Источники компонентов определяются администратором Altium Concord Pro на странице Part Providers (Admin - Part Providers) веб-интерфейса Concord Pro. Для получения более подробной информации перейдите в раздел Настройка пользовательской базы данных компонентов.

Это средство, avconfiguration.exe, включено в состав установки Altium Concord Pro, и оно находится в папке \Program Files (x86)\Altium\Altium Concord Pro\Tools\VaultConfigurationTool.

Хотя данное средство можно использовать для автоматизированного управления пользователями, рекомендуемым подходом является использование функциональных возможностей LDAP-синхронизации.

Доступ к средству конфигурации

Для использования средства:

  1. Запустите командную строку Windows.
  2. Перейдите к корректной папке. Для установки по умолчанию на диск C хост-компьютера, это будет cd C:\Program Files (x86)\Altium\Altium Concord Pro\Tools\VaultConfigurationTool\.
  3. Для запуска средства и отображения списка доступных опций введите 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.

Следующая запись импортирует учетные записи пользователей, роли и участие пользователей в ролях, определенные в файлах примеров, которые включены в директорию установки (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

Обнаружили проблему в этом документе? Выделите область и нажмите Ctrl+Enter, чтобы оповестить нас.

Связаться с нами

Связаться с нашими Представительствами напрямую

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
200 characters remaining
Вы сообщаете о проблеме, связанной со следующим выделенным текстом
и/или изображением в активном документе:
Бесплатная пробная версия Altium Concord Pro

Заполните форму ниже, чтобы получить бесплатную пробную версию Altium Concord Pro