Интеграция с PLM с использованием XML-файлов

Краткий обзор

Узнайте, как подключить рабочее пространство Altium 365 к поддерживаемой PLM-системе с помощью вручную редактируемых XML-файлов конфигурации и шаблонов публикации. В этой статье рассматриваются настройка экземпляров PLM, сопоставление данных компонентов, настройка публикации выпусков проектов и проверка подключения. Читайте дальше, чтобы создать конфигурацию, отвечающую требованиям вашего рабочего пространства и PLM-системы.

- Узнайте, как адаптировать примеры XML-файлов или сформировать базовую конфигурацию на основе модели данных вашего рабочего пространства.
- Разберитесь, как шаблоны публикации управляют созданием и связыванием компонентов, а также составом выходных данных выпуска, передаваемых в PLM.
- Узнайте, как проверка подключения выявляет ошибки конфигурации и предупреждения до начала использования интеграции.
Узнайте больше с ИИ:
 

На этой странице описывается подключение рабочего пространства Altium 365 к поддерживаемой PLM-системе вручную путем редактирования XML-файлов конфигурации PLM. Интерфейс PLM, основанный на ручном редактировании XML-файлов, активируется снятием флажка Enable new PLM Configuration page на странице Admin – Settings – PLM Integration интерфейса рабочего пространства.

Когда этот флажок установлен (это рекомендуемая настройка по умолчанию), используется расширенный полуавтоматический пользовательский интерфейс, описанный на странице Интеграция с PLM. Обратите внимание, что этот интерфейс также позволяет вручную работать с XML-файлами конфигурации с помощью функций импорта и экспорта XML.

Подробнее об автоматизированном интерфейсе интеграции с PLM.

Подключение к вашему экземпляру PLM

Подключение к вашему экземпляру PLM выполняется на странице Admin – PLM Integration браузерного интерфейса рабочего пространства. Для этого необходимо загрузить соответствующий XML-файл конфигурации и шаблон публикации, а также включить и настроить синхронизацию компонентов PLM с компонентами в рабочем пространстве.

Чтобы создать новый экземпляр интерфейса PLM, нажмите кнопку  . Можно определить любое необходимое количество экземпляров для подключения рабочего пространства к различным экземплярам PLM. Например, компоненты могут храниться в одном экземпляре PLM, а выходные данные выпущенных проектов — в другом. Либо разные подразделения могут использовать разные экземпляры одной или разных PLM-систем. Каждый экземпляр должен иметь уникальное имя, файл конфигурации и один или несколько заданных шаблонов публикации. Чтобы проверить подключение для заданного экземпляра, нажмите кнопку  — см. раздел Проверка подключения ниже.

Примеры файлов конфигурации и шаблонов публикации входят в комплект установки. Разверните разделы ниже, чтобы узнать подробности:

При добавлении новой записи PLM с помощью кнопки  используйте кнопку  , чтобы найти и применить соответствующую сохраненную или измененную конфигурацию PLM.

 

Аналогичным образом совместимый шаблон публикации добавляется с помощью кнопки  на вкладке Publish Template. В открывшемся диалоговом окне Publish Template используйте кнопку  , чтобы найти и выбрать нужный файл шаблона.

Добавьте и настройте интерфейс подключения к PLM-системе вашей компании. При наличии действующего подключения вы сможете публиковать данные выпуска проекта в PLM-систему (с использованием заданных определений процессов) в соответствии с активным шаблоном публикации для этого экземпляра, а также настраивать расписание синхронизации компонентов между этой PLM-системой и рабочим пространством.

Вместо создания нового экземпляра корпоративной системы с использованием поставляемых файлов конфигурации можно воспользоваться встроенным генератором конфигурации Workspace. Он позволяет создать адаптированную конфигурацию, структура которой основана на модели данных Workspace. Генератор запрашивает сведения о подключении (тип и URL-адрес PLM), затем анализирует данные Workspace, определяя зарегистрированные типы компонентов (конденсаторы, диоды и т. д.) и соответствующие им шаблоны компонентов, и на их основе формирует базовый файл конфигурации. Для получения дополнительной информации разверните следующий раздел:

После редактирования файла конфигурации и его повторной загрузки в экземпляр PLM обязательно проверьте подключение, чтобы выявить возможные проблемы, возникшие в результате изменений, — см. ниже.

Поддержка сторонних PLM-систем

Workspace в Altium 365 предоставляет дополнительную поддержку конфигураций для PLM-систем, не поддерживаемых изначально, разработанных сторонними поставщиками. Эта поддержка обеспечивается с помощью Generic Connector от Altium, для которого требуется лицензия Altium 365 PLM Generic Connector Addon.

При добавлении экземпляра PLM в Workspace для такой системы в конфигурацию этого экземпляра PLM загружаются предварительно настроенные XML-файлы, предоставленные сторонним поставщиком, как описано выше.

Чтобы запросить доступ к лицензии Altium 365 PLM Generic Connector Addon, обратитесь по адресу sales.na@altium.com или к своему менеджеру Altium.

Проверка подключения

Workspace предоставляет комплексную проверку подключения к экземпляру PLM, доступную по кнопке на странице Add/Edit Instance. Она выполняет ряд проверок совместимости конфигурации и сразу выводит результаты.

При запуске проверки подключения Workspace анализирует текущую конфигурацию и настройки шаблона публикации на совместимость как с экземпляром Workspace, так и с данными целевой корпоративной системы. Проблемы конфигурации, такие как ошибки путей, несоответствия в определениях типов компонентов и параметрах, некорректные настройки жизненного цикла или ревизий, выявляются и отображаются в следующем диалоговом окне Configuration Validation Report.

Если обнаружены ошибки конфигурации, приводящие к общему статусу ERROR (Status), их необходимо устранить, прежде чем можно будет создать новый экземпляр. Статус WARNING, указывающий, например, на типы компонентов Workspace, не включенные в конфигурацию, или на заданные атрибуты, отсутствующие в корпоративной системе, позволяет сохранить и использовать настроенный экземпляр.

Обнаруженные ошибки и предупреждения можно устранить в используемых файлах конфигурации/публикации и/или путем изменения настроек Workspace либо корпоративной системы. После успешной настройки экземпляра обязательно нажмите кнопку . Этот экземпляр появится в текущем списке подключенных экземпляров на главной странице PLM Integration интерфейса.

После редактирования файла конфигурации и его повторной загрузки в новый экземпляр снова нажмите кнопку , чтобы выявить возможные проблемы, возникшие в результате изменений.

Синхронизация компонентов

Синхронизация компонентов между Workspace в Altium 365 и подключенным экземпляром корпоративной системы — точнее, синхронизация их параметрических данных — основана на LibSync рабочем процессе. Процесс LibSync предопределен в Workspace и недоступен для просмотра или редактирования на странице Admin - Processes. Однако, поскольку он основан на рабочем процессе, можно просматривать результаты синхронизации и обрабатывать возникающие ошибки.

Использование процесса синхронизации включает следующие действия:

  • Настройка синхронизации для каждого типа компонентов, которая на практике включает:
    • Определение направления синхронизации (в Workspace или в PLM).
    • Определение участвующих типов компонентов и места создания новых компонентов.
    • Настройка сопоставления атрибутов параметров.
  • Настройка сопоставления данных вариантов выбора компонентов (Part Choices), если применимо.
  • Выполнение синхронизации.

Первые две группы действий настраиваются в файле конфигурации, используемом для подключенного экземпляра корпоративной системы (например, PLM). Саму синхронизацию можно выполнять по запросу со страницы PLM Integration интерфейса Workspace и/или по расписанию — автоматически, через заданные интервалы времени, определенные при настройке подключения к экземпляру PLM.

Настройка синхронизации

В файле конфигурации подключение к экземпляру корпоративной системы задается между тегами Instance с указанием типа драйвера и целевого URL-адреса. Если файл конфигурации был создан с помощью генератора конфигурации, указанные в нем драйвер и URL-адрес соответствуют значениям, введенным в диалоговом окне Generate Configuration при создании.

<Instance>
    <Driver>[Driver Type]</Driver>
    <Url>[PLM API URL]</Url>
</Instance>
  • Если в файле конфигурации указан драйвер Arena® PLM, доступна дополнительная запись для учета workspaces Arena, доступных для учетной записи пользователя Arena. Необязательный атрибут со ссылкой на многозначный идентификатор добавляется в раздел Instance между тегами context, как показано в примере ниже.

    •  

      <Instance>
          <Driver>Arena</Driver>
          <Url>https:∕∕api.arenasolutions.com/v1/</Url>
          <Context>12345678</Context>
          <!-- If a workspace ID is not defined, the PLM instance will work with Arena's default workspace for that account. -->
          <!-- The server will report an error if another PLM synchronization session is attempting to use a second workspace from the Arena user account. -->
      </Instance>

       

     

  • Если подключена система PTC Windchill PLM, может потребоваться добавить строку конфигурации, чтобы включить единицы измерения для значений Value.
    • <Instance>
          <Driver>Windchill</Driver>
          <Url>URL</Url>
          <EnableUOMRead>true</EnableUOMRead>
      </Instance>

В следующем разделе Schema файла конфигурации задается раздел сопоставления для синхронизации каждого отдельного типа деталей. На стороне Workspace это компонент типа altiumType; его значение — один из вариантов параметра типа, которые можно увидеть на странице «Управление данными — Типы компонентов» диалогового окна Preferences в Altium Designer. На стороне PLM создается деталь типа plmType, определяемого его значением в среде PLM.

В файле этот раздел объявляется как Entity ; например, для конденсаторов:

<Entity altiumType="Capacitor" plmType="Capacitor">
  .
  .
</Entity>
Значение plmType может различаться в зависимости от используемого экземпляра PLM.

В Entity используются два раздела для управления и настройки синхронизации из Workspace в экземпляр PLM и из экземпляра PLM в Workspace, что позволяет выполнять одно- или двунаправленную синхронизацию. Дополнительные сведения приведены в следующих разделах и в комментариях к примерам файлов конфигурации. Конкретное содержимое файла конфигурации зависит от ваших потребностей, а также от атрибутов (PLM), определённых в подключённом экземпляре корпоративной системы.

Раздел определения сопоставления данных вариантов компонентов находится в конце примера файла конфигурации или сгенерированного файла конфигурации.

  • Параметры, атрибуты и значения в файле конфигурации чувствительны к регистру.

  • За исключением общего первичного ключа синхронизации (например, PlmPartNumber), не рекомендуется включать одни и те же атрибуты или параметры компонента одновременно в разделы ToAltium и ToPlm файла конфигурации. Двунаправленная синхронизация выполняется именно в таком порядке (сначала из PLM в Altium), поэтому в этой ситуации данные PLM всегда будут иметь приоритет.

  • Информацию о настройке интеграции с корпоративной системой см. в примерах файлов конфигурации и публикации.

Enterprise Server поддерживает обновление существующих элементов Arena PLM при работе с процессами Altium Project Releaser и Component Sync. Это позволяет передавать новые выпущенные данные проектов и компонентов со стороны Altium в рабочие ревизии элементов деталей спецификации Arena (данные PCBA, FAB и компонентов).

При выпуске проекта Altium в Arena PLM с помощью процесса Project Release with Publish to PLM ранее выпущенная ревизия спецификации проекта Arena обновляется, а дополнительные обновления дочерних деталей связываются с этим родительским элементом. В этом случае журнал PLM будет содержать предупреждение о том, что рабочая ревизия обновлена, а действующие ревизии добавлены в соответствующую спецификацию в Arena.

Выполнение синхронизации компонентов

Синхронизация компонентов (библиотек) может выполняться вручную или по расписанию: соответственно, с помощью кнопки Sync action в записи экземпляра PLM на странице PLM Integration Workspace либо в виде автоматического цикла, заданного в настройках экземпляра. Нажмите  элемент управления, связанный с экземпляром PLM, с которым требуется выполнить синхронизацию. Процесс синхронизации будет выполняться по рабочему процессу LibSync в соответствии с настройками, заданными в связанном файле конфигурации.

Элемент управления изменится на  . Чтобы остановить синхронизацию, нажмите этот элемент управления. Появится окно подтверждения, в котором можно нажать  для отмены синхронизации. Все уже синхронизированные компоненты останутся синхронизированными, но дальнейшая синхронизация выполняться не будет.

Выполняется синхронизация компонентов между рабочим пространством Workspace и указанным экземпляром PLM.Выполняется синхронизация компонентов между рабочим пространством Workspace и указанным экземпляром PLM.

В синхронизацию будут включены only те компоненты, которые были изменены с момента последней синхронизации (то есть их временная метка позднее даты последней синхронизации) и соответствуют критериям синхронизации в файле конфигурации. Такой режим называется Incremental Synchronization.

При запуске синхронизации компонентов процесс LibSync проходит по заранее заданному рабочему процессу до завершения или возникновения ошибки. Обновите страницу браузера (F5), чтобы увидеть текущее состояние синхронизации. Для отслеживания или просмотра процесса LibSync откройте вкладку Synchronization status и выберите вариант списка Closed. Если процесс еще выполняется, он будет отображаться в списке Active. Кнопка , доступная администраторам, позволяет скачать подробный журнал всех перечисленных операций синхронизации в формате CSV с разделителями-запятыми (Synchronisation status.csv).

На вложенных вкладках представления доступна следующая информация:

  • Diagram — графическая схема рабочего процесса с выделенным текущим этапом (завершение или состояние ошибки/сбоя).

  • Data — сводная информация о выполнении процесса, включая успешное или неудачное выполнение его этапов и ссылку на отчет о процессе в журнале — см. ниже.

  • History — хронологический журнал основных событий синхронизации Workspace.

Результаты процесса LibSync также доступны на странице Process Management (Admin » Processes) на вкладке Browser.

 

Сведения о выбранном событии LibSync, отображаемые на вложенной вкладке Data, содержат ссылку на файл системного журнала (PLM [дата-номер].log) для этого события.

При сбое процесса LibSync создается задача Handle errors с данными об ошибке, включая сводную информацию и схему процесса. Текущие задачи доступны на странице Tasks Management, которую можно открыть с помощью пункта Tasks главного меню.

Синхронизация по расписанию

Вы также можете настроить автоматическую синхронизацию по расписанию. Для этого откройте настройки экземпляра PLM (на главной странице PLM Integration нажмите его имя или соответствующий элемент управления), выберите вкладку Component Synchronisation и включите параметр Synchronize PLM Components with server on schedule. С помощью элементов управления Synchronize every настройте нужное расписание автоматической синхронизации. Гибкие возможности системы позволяют:

  • Настроить синхронизацию каждые 15/30/45/60/75/90 минут.
  • Настроить синхронизацию каждые x часов.
  • Настроить ежедневную синхронизацию в указанное время.

Заданное расписание будет отображаться на главной странице PLM Integration в столбце Sync scheduled.

Настройка расписания синхронизации.Настройка расписания синхронизации.

Для настройки синхронизации по расписанию необходимо указать действительные учетные данные пользователя вашей PLM-системы. Эти данные должны быть уже сохранены при настройке экземпляра PLM. Если это не так, нажмите кнопку  и введите User name и Password в открывшемся окне PLM Credentials. Без действительных учетных данных синхронизация по расписанию останется в состоянии OFF. Синхронизация по запросу также будет недоступна.

Вы также можете запускать синхронизацию по запросу. Нажмите кнопку  и выберите нужный режим:

  • Incremental — в этом режиме в синхронизацию включаются only те компоненты, которые были изменены с момента последней синхронизации (то есть их временная метка позднее даты последней синхронизации) и соответствуют критериям синхронизации в файле конфигурации. Соответствующие изменения передаются при синхронизации. Этот режим используется по умолчанию и также запускается при нажатии элемента управления  для экземпляра PLM на главной странице PLM Integration.
  • Full — этот режим принудительно запускает полную синхронизацию. В нее включаются все компоненты, соответствующие критериям синхронизации в файле конфигурации, с передачей соответствующих изменений.

Рабочие процессы

Для поддержки интеграции с PLM в Workspace доступны следующие определения процессов и лежащие в их основе рабочие процессы:

Эти определения процессов нельзя активировать и использовать в исходном виде. Каждое из них представляет собой своего рода шаблон: отредактируйте его в соответствии с требованиями вашей компании, задайте имя и сохраните как новое определение процесса, которое can затем активировать и использовать наряду с остальными определениями в соответствующей категории процессов.
  • Part Requests — категория процессов:
    • Part Request with PLM Part Create — автоматическое создание компонента в экземпляре PLM с последующей передачей сформированного номера компонента обратно в компонент Workspace. Схема рабочего процесса приведена ниже.

Обратите внимание: при изменении этого примера определения для создания собственного необходимо указать экземпляр PLM, в котором будут создаваться компоненты. Выберите объект Create Part in PLM на схеме рабочего процесса и укажите экземпляр PLM в раскрывающемся меню поля PLM Instance. В этом меню перечислены все настроенные экземпляры PLM, заданные на странице PLM Integration интерфейса.

► Подробнее о работе с рабочими процессами см. в разделе Создание процессов и управление ими.

  • Project Activities — категория процессов:
  • Publish to PLM (User selects) — публикация выпущенных выходных данных управляемого проекта в интегрированном экземпляре PLM с возможностью выбора конкретных выходных данных для публикации. Схема рабочего процесса приведена ниже.

  • Project Releaser with Publish — публикация в интегрированном экземпляре PLM в качестве дополнительного этапа работы Project Releaser. Схема рабочего процесса приведена ниже.

  • Project Creations — категория процессов:
    • Project with initialise in PLM — автоматическое создание номеров компонентов в экземпляре PLM с последующей передачей этих номеров в параметры проекта Workspace. Схема рабочего процесса приведена ниже.

Доступ к процессам, связанным с PLM

В следующих разделах показано, где можно получить доступ к активированным процессам, связанным с PLM. Поскольку примеры нельзя использовать в исходном виде, для иллюстрации на их основе были созданы следующие процессы:

  • PR with PLM Part Create — создан на основе примера определения процесса: Part Request with PLM Part Create.
  • Publish to Company PLM – Choose Data — создан на основе примера определения процесса: Publish to PLM (User selects).
  • Project Releaser with Publish to Company PLM — создан на основе примера определения процесса: Project Releaser with Publish.
  • Create Project with PLM Initialise — создан на основе примера определения процесса: Project with Initialise in PLM.
Обратите внимание: администраторы Workspace могут запустить новый экземпляр любого активированного определения процесса непосредственно на вкладке соответствующей категории процессов в области Processes интерфейса Workspace, нажав элемент управления  .

Запросы на компоненты

Доступ из Altium Designer возможен через панель Explorer, после выполнения поиска — из области Details на панели Manufacturer Part Search или по ссылке в нижней части списка компонентов на панели Components.

В интерфейсе Workspace доступ к активированному определению процесса можно получить на странице Part Requests, нажав кнопку  в правом верхнем углу страницы.

Действия с проектом

Данные проекта, выпущенные из Altium Designer в Workspace, можно контролируемым образом передавать в PLM с помощью процессов Workspace Publish to PLM. Процессы Workspace определяют интерфейс и порядок публикации, а указанный XML-шаблон публикации определяет, как данные файлов передаются в целевую систему PLM.

Более подробную информацию о процессе публикации см. в разделе Публикация в PLM.

Стандартный процесс публикации

На стороне проектирования стандартный процесс публикации в PLM доступен в Altium Designer из подменю Project » Project Activities активного проекта.

Процессы, связанные с проектом, также доступны в контекстном подменю Project Activities, которое открывается щелчком правой кнопки мыши по записи проекта на панели Projects.

В интерфейсе Workspace доступ к активным определениям процессов можно получить в представлении Project Management, нажав кнопку  .

Публикация с помощью Project Releaser

Процесс публикации в систему PLM в рамках работы Project Releaser можно запустить в Altium Designer из подменю Project » Project Releaser активного проекта.

Процессы, связанные с выпуском, также доступны в контекстном подменю Project Releaser, которое открывается щелчком правой кнопки мыши по записи проекта на панели Projects.

Откроется Project Releaser с дополнительным этапом — 7: Publish to PLM. Кроме того, в меню кнопки  доступна команда Prepare & Release & Publish to PLM, позволяющая запустить Project Releaser без остановки для проверки сформированных данных и отчета о выполнении.

Если запустить Project Releaser стандартной командой Prepare , то после проверки и выпуска данных на этапе Execution Report появится кнопка  . Нажмите ее, чтобы продолжить выполнение базового рабочего процесса и опубликовать данные в PLM. Откроется диалоговое окно Login Credentials. Введите Username и Password для вашего экземпляра PLM и выберите нужный шаблон PLM (он отображается в формате <PLMInstance>:<PublishingTemplate>).

Если вы выбрали команду Prepare & Release & Publish to PLM, в итоге сразу откроется диалоговое окно Login Credentials. Project Releaser не будет приостанавливаться на этапе Execution Report, и кнопка  не появится.
Обратите внимание: учетные данные для входа в ваш экземпляр PLM требуются только при первой публикации в него. Затем они сохраняются в подключенном рабочем пространстве. После этого все публикации данного проекта в тот же экземпляр PLM будут выполняться напрямую в соответствии с заданным рабочим процессом и выбранным шаблоном публикации.

Перейдите на вкладку Diagram , чтобы просмотреть базовый рабочий процесс.

Нажмите кнопку  , чтобы продолжить публикацию в соответствии с этим рабочим процессом.

Если вы выполняете публикацию впервые и номера изделий (на стороне PLM) еще не связаны с управляемым проектом, эти номера будут созданы в PLM и связаны с проектом в ходе первоначальной публикации. При публикации вы также можете создавать записи для компонентов рабочего пространства в экземпляре PLM, чтобы получить спецификацию компонентов в PLM (необязательно; зависит от шаблона публикации, заданного и используемого при публикации проекта в экземпляр PLM).

Проверить состояние процесса публикации в PLM можно через интерфейс рабочего пространства, выбрав представление Activities в подробном представлении проекта, открытого из представления Projects. Выберите вариант отображения Opened, чтобы просмотреть состояние выполняющегося процесса, или вариант Closed для действий, чтобы получить сведения о состоянии после завершения процесса.

 

На вкладке Data рабочего процесса можно увидеть, что именно было создано, например номера изделий в экземпляре PLM.

Создание проектов

На стороне проектирования доступ осуществляется из главного подменю File » New » Project in <workspace> в Altium Designer.

В интерфейсе рабочего пространства активированное определение процесса доступно в представлении Projects по нажатию кнопки  .

Оно также доступно при клонировании проекта через кнопку меню  в представлении Projects.

В ходе выполнения рабочего процесса откроется диалоговое окно, в котором можно задать имя, описание и тип проекта, а также элемент шаблона проекта, который следует использовать при его создании. После нажатия Start откроется диалоговое окно Login Credentials. Введите Username и Password для вашего экземпляра PLM и выберите нужный шаблон PLM (он отображается в формате <PLMInstance>:<PublishingTemplate>). Затем нажмите Submit , чтобы продолжить выполнение рабочего процесса.

Соответствующие номера изделий будут автоматически созданы для проекта в вашем экземпляре PLM, а затем переданы обратно в рабочее пространство в виде параметров проекта. Эти параметры можно использовать в качестве специальных строк — они доступны на панели Properties, когда в редакторе проекта выбрана размещенная текстовая строка. Параметры сервера рабочего пространства, заданные для проекта, также можно просмотреть на вкладке Параметры сервера диалогового окна Project Options (Project » Project Options).

 

AI-LocalizedЛокализовано с помощью ИИ
Если вы обнаружили проблему, выделите текст/изображение и нажмитеCtrl + Enter, чтобы отправить нам свой отзыв.
Меню
Contents
Доступность функций

Доступные вам функции зависят от того, какое решение Altium вы используете: Altium Develop, Altium Agile Teams, Altium Agile Enterprise или Altium Designer (при активной подписке).

Если вы не видите описанную функцию в используемом вами программном обеспечении, свяжитесь с отделом продаж Altium, чтобы узнать больше.

Contents