Настройка интеграции с PLM с помощью XML-файлов

Этот раздел используется для управления и настройки синхронизации из экземпляра PLM в Workspace в формате:

  .
  .

Внутри раздела ToAltium определяются следующие секции:

• Как и где создаются новые компоненты в Workspace — между тегами <CreateInfo> и </CreateInfo>.

    
    1-Level Revision Scheme
    Component Lifecycle
    Components/Inbox/Capacitors

Когда запись компонента создается в Workspace, будет использован Component Template, связанный с целевой папкой Workspace (Components/Inbox/Capacitors в приведенном выше примере), если он был указан. Это также определит схему именования элемента для создаваемого компонента, переопределяя ту, что указана в целевой папке Workspace — наоборот, если в папке не определен ни шаблон, ни схема именования, синхронизация завершится с ошибкой.

Также обратите внимание, что в примерах конфигураций определены схема именования ревизий по умолчанию (1-Level Revision Scheme) и определение жизненного цикла (Component Lifecycle) — они будут переопределены, если с целевой папкой Workspace связан шаблон компонента.

Если в конфигурации добавлена ссылка на конкретный шаблон компонента (например, CMPT-00001), этот шаблон будет использован вместо шаблона, связанного с целевой папкой Workspace. Его настройки переопределят любые параметры в конфигурационном файле (такие как определение жизненного цикла и т.д.), за исключением определенной целевой папки.

    
    CMPT-00001
    1-Level Revision Scheme
    Component Lifecycle
    
    Components/Inbox/Capacitors

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

• Фильтрация данных, получаемых из корпоративной системы (PLM), — между тегами <SourceCriteria> и </SourceCriteria>. Оператор фильтра может ограничить получаемые из PLM данные компонентов, например, только теми, которые созданы определенным автором (как показано в примере конфигурации), или элементами компонентов, имеющими определенное значение атрибута (Business Unit = Engineering_RD), как показано ниже.

<SourceCriteria>
    <ns2:Attribute>
        <ns2:Key>Business Unit</ns2:Key>
        <ns2:Value>Engineering_RD</ns2:Value>
    </ns2:Attribute>
</SourceCriteria>

• Список атрибутов (параметров), которые должны быть переданы для компонентов из PLM в Workspace — между тегами <Attributes> и </Attributes>. Пример:

<Attributes>

<!-- Поле Name из PLM будет передано в поле name/comment в Workspace-->
<common:Attribute attributeType="revision">
	<common:Key>name</common:Key>
	<common:Value>${attribute.name}</common:Value>
</common:Attribute>

<!-- Поле Description из PLM будет передано в поле Description в Workspace на уровне ревизии -->
<!-- Атрибуты уровня ревизии вызовут создание новой ревизии, если значение параметра изменится -->
<common:Attribute attributeType="revision">
	<common:Key>Description</common:Key>
	<common:Value>${attribute.description}</common:Value>
</common:Attribute>

<!-- Поле Number из PLM будет передано в поле PlmPartNumber в Workspace на уровне ревизии  -->
<!-- Примечание: можно использовать любое имя атрибута -->
<common:Attribute attributeType="revision" primaryKeyOrdinal="1">
	<common:Key>PlmPartNumber</common:Key>
	<common:Value>${attribute.Number}</common:Value>
</common:Attribute>

<common:Attribute attributeType="item">
	<common:Key>DynamicCONTS</common:Key>
	<common:Value>Не вызовет обновление ревизии при изменении ${attribute.LastModified}</common:Value>
</common:Attribute>

</Attributes>

Вместе с объявлениями Entity в схеме конфигурации есть дополнительный раздел для определения сопоставления данных Part Choice между корпоративной системой (PLM) и Workspace. Этот раздел позволяет настраивать сопоставление параметров атрибутов Part Choices для большинства поддерживаемых систем PLM, а также отношения Approved Manufacturing List (AML) для систем Aras, Windchill и Arena PLM. Это эксклюзивное двунаправленное определение — то есть для одного направления, но не для обоих одновременно — которое указывает атрибуты производителя компонента и номера детали, используемые для передачи данных Part Choices.

Когда синхронизация Part Choices включена в файле конфигурации (sync="true"), значение указанных атрибутов передается в целевую систему. Направление передачи данных определяется выражением 'To', где ToAltium указывает, что параметрические данные из компонента PLM применяются к созданному/обновленному компоненту Workspace, а ToPlm приводит к тому, что данные Part Choices, связанные с компонентом Workspace, передаются на сторону PLM. Включенная настройка применяется ко всем определенным сущностям компонентов, поэтому данные Part Choice будут передаваться в указанный целевой объект при каждом обнаружении набора данных компонента.

Пример записи для сопоставления Part Choices ToAltium в файле конфигурации — где атрибуты системы PLM это MFR1 (имя производителя) и MPN1 (номер детали производителя) — может выглядеть так:

<PartChoices>
    <ToAltium sync="true">
    <MfrMappings>
        <MfrMapping>
            <MfrName>MFR1</MfrName>
            <MfrPartNumber>MPN1</MfrPartNumber>
        </MfrMapping>
    </MfrMappings>
    </ToAltium>
</PartChoices>

Синхронизация данных Part Choice также поддерживает несколько записей данных Part Choice. Эти дополнительные атрибуты необходимо указать в файле конфигурации как еще одну пару определений атрибутов, например: MFR2 и MPN2, как показано ниже:

<MfrMappings>
    <MfrMapping>
        <MfrName>MFR1</MfrName>
        <MfrPartNumber>MPN1</MfrPartNumber>
    </MfrMapping>
    <MfrMapping>
        <MfrName>MFR2</MfrName>
        <MfrPartNumber>MPN2</MfrPartNumber>
    </MfrMapping>
</MfrMappings>

Корпоративные системы, в которых есть собственная/встроенная функциональность выбора производителя, такие как Manufacturer Parts в Windchill и Vendor Parts в Arena, не требуют сопоставления параметров в файле конфигурации. В этом случае прием данных Part Choice просто включается в соответствующем разделе конфигурации.

<PartChoices>
    <ToAltium sync="true"/>
</PartChoices>

Или если поддерживается передача данных в корпоративную систему:

<PartChoices>
    <ToPlm sync="true"/>
</PartChoices>

Система PTC Windchill PLM предоставляет дополнительный модуль PartsLink, который позволяет группировать компоненты. Классификации компонентов, заданные в Windchill, также могут включать связанные пары Атрибут/Значение для более детального описания внутри этой классификации. Система PartsLink позволяет легко и быстро находить определённые типы компонентов и поддерживается интеграцией PLM в Рабочем пространстве для двусторонней синхронизации и доступа на чтение/запись.

В экземпляре конфигурации Рабочего пространства для Windchill классификация PartsLink создаётся в Windchill путём указания связывающего атрибута в разделе ToPLM в формате, приведённом в примере ниже:

<common:Attribute>
	<common:Key>Classification</common:Key>
	<common:Value>102-Capacitor</common:Value>
</common:Attribute>

В данном случае пара Key/Value определяет классификацию с именем 102-Capacitor. Для неё может быть создан соответствующий атрибут классификации в Windchill с указанием имени и значения параметра (здесь Capacitance) — обратите внимание, что к одной классификации можно применить несколько атрибутов:

<common:Attribute>
	<common:ClassificationName>102-Capacitor</common:ClassificationName>
	<common:Key>Capacitance</common:Key>
	<common:Value>${parameter.Value}</common:Value>
</common:Attribute>

В разделе синхронизации ToAltium конфигурации данные, полученные из Windchill, могут быть отфильтрованы по нужной классификации компонента внутри набора тегов <SourceCritera> с указанием ClassificationName.

<SourceCriteria>
	<ClassificationName>102-Capacitor</ClassificationName>
</SourceCriteria>

Чтобы получить все компоненты, соответствующие определённому значению атрибута классификации (например, все конденсаторы на 10uF), раздел <SourceCriteria> должен включать настройки атрибутов конфигурации, определяющие ClassificationName и связанный с ним ключ и значение атрибута классификации.

<SourceCriteria>
	<common:Attribute>
		<common:ClassificationName>102-Capacitor</common:ClassificationName>
		<common:Key>Capacitance</common:Key>
		<common:Value>10uF</common:Value>
	</common:Attribute>
</SourceCriteria>

Чтобы извлечь конкретное значение атрибута классификации из Windchill, укажите параметр Value из имени соответствующего атрибута, связанного с ClassificationName.

<common:Attribute attributeType="revision">
	<common:ClassificationName>102-Capacitor</common:ClassificationName>
	<common:Key>Value</common:Key>
	<common:Value>${attribute.Capacitance}</common:Value>
</common:Attribute>

В самом Windchill классификация PartsLink определяется созданием binding attribute, который может быть применён к типу компонента. Затем к определённому классу классификации добавляется атрибут классификации компонента.

Записи компонентов в Windchill будут содержать определённую классификацию и все указанные параметры атрибутов классификации, которые, в свою очередь, доступны для процесса синхронизации компонентов PLM в Рабочем пространстве.

Когда запись компонента синхронизируется из Windchill в Рабочее пространство и взаимодействие с PartsLink указано в конфигурации PLM Рабочего пространства, атрибуты конфигурации Windchill для этого компонента будут переданы компоненту на стороне Altium.

В следующем примере кратко показано создание новой детали в Workspace, а затем автоматическое создание соответствующей детали в экземпляре PLM. Сгенерированный номер детали затем передаётся из экземпляра PLM обратно компоненту в Workspace в виде параметра элемента — то есть выпуск новой ревизии компонента Workspace не требуется. В этом примере используется определение процесса Part Request with PLM Part Create, созданное на основе примерного определения Part Request with PLM Part Create.

1. Запустите процесс запроса на деталь и заполните последующую форму, указав необходимые данные для начального запроса. На изображении ниже запрос отправляется через страницу Part Requests интерфейса Workspace, и запрашивается одна деталь.

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

3. После того как нужный пользователь возьмёт (или ему будет назначена) задачу по обработке запроса, он в итоге создаёт запрошенные детали. Каждый компонент, созданный (и/или выбранный) для удовлетворения запроса, добавляется в поле Components задачи. Добавленные компоненты будут автоматически созданы в PLM. На изображении ниже создан и добавлен один компонент — CMP-007-00004. Убедитесь, что поле Next step установлено в Completed и нажмите кнопку .

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

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

Администраторы могут использовать кнопку для скачивания подробной записи всех перечисленных запросов компонентов в формате CSV с разделителями-запятыми.

5. Вернувшись в Altium Designer, найдите созданный компонент в панели Explorer и переключитесь на его вкладку Preview . В области параметров обратите внимание, что был добавлен дополнительный параметр – PlmPartNumber – значение которого соответствует номеру созданной детали в PLM.

Обратите внимание, что параметр был добавлен к компоненту, но его ревизия осталась прежней – повторного выпуска компонента не было. Это связано с тем, что параметр является параметром на уровне элемента (Item-level) – он добавляется непосредственно к элементу компонента и доступен во всех его ревизиях.

При настройке процесса Publish to PLM для Windchill^® PLM вы также можете указать (и создать) целевую папку Windchill для документов, публикуемых из Workspace.

Связанные параметры папки Windchill определяются в XML-файле шаблона публикации, который применяется к вашей интеграции Windchill PLM в Workspace. Узлы определения папки имеют формат тега <pt:Folder>xxx</pt:Folder>, где pt — это текущий namespace, а xxx — полный путь к папке, и размещаются как правило публикации в разделе FileDistribution для каждого типа документа (например, для PCB.zip Fabrication output).

Пример иерархии структуры XML для публикации:

<pt:EntityRule id="FAB">
  <pt:FileDistributions>
    <pt:FileDistribution archiveName="PCB.zip">
      <pt:Folder>PRODUCT/Projects/${project.name}/FAB data</pt:Folder>

Если вы используете пример определения процесса – Project Releaser with Publish – для создания собственного определения, имя этапа, отображаемое на стороне клиента проектирования, по умолчанию Publish to PLM. Составная команда в выпадающем меню кнопки Project Releaser также включает это имя: Prepare & Release & Publish to PLM.

Однако вы можете изменить, как это (и всплывающая подсказка, связанная с этапом) будет отображаться пользователям. Поля для этого доступны в базовом рабочем процессе процесса, когда выбран элемент Start (типа Start Release). Эти поля:

• Action name – имя действия после выпуска проекта, которое отображается как имя этапа 7 в Project Releaser. Заполнение этого поля обязательно, если в рабочем процессе определены задачи. Это имя также будет использоваться для команды меню в формате Prepare & Release & <Action name>.
• Action description – описание действия после выпуска проекта, которое отображается пользователю в Project Releaser как всплывающая подсказка для этапа 7.

Настройки по умолчанию для элемента Start в рабочем процессе, основанном на примере определения процесса Project Releaser with Publish, и отображение в Project Releaser.

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

Измененные настройки для элемента Start при использовании в рабочем процессе публикации в PLM через Project Releaser.

Следующий пример кратко показывает создание нового проекта с инициализацией в PLM. Процесс вызывается из Altium Designer с использованием определения Create Project with PLM Initialise — на основе примерного определения Project with Initialise in PLM.

1. После запуска процесса (File » New » Project in <workspace> » Create Project with PLM Initialise) появляется диалог (названный по определению процесса), в котором можно определить проект. В этом примере мы просто назовем проект Example_Project_with_PLM_Init, дадим ему описание и оставим все остальные поля — включая те, что на вкладке Advanced — без изменений.
2. После определения проекта нажмите кнопку . Появится диалог Login Credentials. Поскольку это новый проект, необходимо ввести свои учетные данные для входа в PLM, выбрать экземпляр PLM и связанный с ним шаблон публикации. В данном примере используется конфигурационный файл и связанный шаблон публикации (по запросу) для Arena PLM.

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

3. Процесс будет выполнен до конца (при условии отсутствия ошибок), что можно увидеть в панели Tasklist, в разделе закрытых Activities — проверьте опцию Show closed в меню кнопки . Выберите запись Activity для получения дополнительной информации о завершенном процессе и его наборе данных.

Завершенный процесс и связанная с ним информация также могут быть просмотрены в интерфейсе Workspace, выбрав представление Activities в подробном просмотре проекта — когда проект открыт из представления Projects. Выберите опцию действий Closed (вверху справа), чтобы получить информацию о статусе завершенного процесса.

4. В Altium Designer новый проект отображается в панели Projects, запланирован для коммита в репозиторий проектирования на базе Git Versioned Storage в Workspace — кликните правой кнопкой мыши по записи проекта и используйте команду Save to server. Затем вы можете добавить исходные документы и приступить к проектированию. Когда придет время публиковать, проект уже будет связан с соответствующими деталями в экземпляре PLM.

На вкладке Server Parameters диалога Project Options или в списке параметров проекта в панели Explorer вы можете увидеть номера деталей, присвоенные в экземпляре PLM, которые относятся к соответствующим сущностям проекта, которые могут быть выпущены/опубликованы.

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

При размещении текстовой строки на схеме параметры PLM, связанные с проектом, будут доступны как специальные строки: