Публикация и загрузка в Servigistics InService > Использование публикации и загрузки > Выполнение PxTAL
  
Выполнение PxTAL
Поддержка пакета Px
Совместимость пакетов
TAL поддерживает пакеты Servigistics InService 6.5 и 7.1. Версия определяется из информации для публикации, находящейся в пакете.
* 
Необходимо загрузить пакеты версии 6.5 или 7.1. Нельзя загружать разные типы.
Ограничения для пакетов
Далее приведены некоторые ограничения для данных пакетов.
• Не используйте символ # в наименованиях файлов, содержащихся в пакетах Servigistics InService.
Если наименование файла будет содержать этот символ, то процесс преобразования и загрузки не сможет быть выполнен и завершится со следующей ошибкой:
[ERROR,ProcessActionHandler] Failed node: fetchApplicableFilesForPartsList within flow:getRegistryFromIMANSubFlow_PD , reason #path to a partslist item(The system cannot find the file specified) java.io.FileNotFoundException:#path to a partslist item(The system cannot find the file specified)
• Не используйте символ вертикальной черты (|) в значениях свойств APEX, за исключением случаев, когда он представляет логический оператор OR.
Содержимое пакета Px
Пакет Px состоит из папок и файлов, показанных в следующей таблице.
Наименование
Файл/папка
Описание
com.ptc.arbortext.windchill.partlist.PartList
Папка
Содержит списки деталей, которые используются как ссылка из файла *-DMPmap.xml. Имя папки обычно является наименованием типа в соответствие с тем, какие данные созданы в SIM/SP.
com.ptc.ptcnet.DynamicDocument
Папка
Содержит динамические документы, которые используются как ссылка из файла *-DMPmap.xml. Как правило, это специфичное содержимое для форматов DITA XML, обычного XML, PDF или изображений. Имя папки обычно является наименованием типа в соответствие с тем, какие данные созданы в SIM/SP.
reps
Папка
Содержит связанные изображения для файла *_Hierarchy.xml.
*_Hierarchy.xml
Файл
Файл иерархии изделия, содержащий сведения об иерархии для структуры изделия.
*_Hierarchy.xml.meta
Файл
Файл метаданных иерархии изделия
*-DMPmap.xml
Файл
Файл структуры информации (IS) или структуры публикации (PS), который обычно предоставляет содержание. Данные также присутствуют в иерархической структуре.
*-DMPmap.xml.meta
Файл
Сопутствующий файл метаданных IS или PS
OptionsDefinition.xml
Файл
Список определений опций и вариантов с данными о связи с контекстом (PH или IS).
partThumbnails.zip
Файл
Изображения, связанные с деталями.
ProductInstances.xml
Файл
Файл экземпляра изделия, предоставляющий серийный номер для сопоставления контекстов. Этот файл содержит несколько значений в одном файле.
publishInfo.xml
Файл
Метаданные, связанные с опубликованным пакетом. Обычно указывается идентификатор пакета, дата публикации, языковая настройка, последовательность пакета и флаг, который обозначает, является ли пакет полным или инкрементным.
Файл содержит параметр Bundle-Source для определения владельца пакета. Если это свойство не существует, TAL по умолчанию использует свойство orgName из Rootobjects источника пакета.
Следующие свойства определяют, является ли пакет полным или инкрементным.
• JobSpecification/@increment
• JobSpecification/@incremental
Полный пакет будет иметь значения increment="0" или incremental="false". Инкрементный пакет будет иметь значения increment="1" или incremental="true".
Язык пакета определяется параметром Language для элемента JobSpecification:
<JobSpecification
…………………………..
<Parameter token="com.ptc.arbortext.
wvs/Language">
<Value>ja</Value>
</Parameter>
<Parameter token="Language">
<Value>ja</Value>
</Parameter>
……………….
</JobSpecification>
ReadyForTAL
Файл
Сигнальный файл с нулевым числом байтов, который показывает, что пакет готов для TAL. Если этот файл отсутствует, пакет не обрабатывается.
referencedObjects.xml
Файл
Указывает различные объекты, которые используются как ссылка из других объектов.
В обычном пакете информационной структуры этот файл содержит URI контекста (как целевой атрибут), с которым он связан через файл relatedContext.xml. Кроме того, этот файл содержит подробную информацию о URI и связанных объектах, а также данные PRODUCT, связанные с атрибутом ServiceInformation.
referencedParts.xml
Файл
Специфичный для деталей файл, содержащий подробную информацию обо всех деталях, которые используются как ссылка из списка деталей.
relatedContexts.xml
Файл
Указывает контекст, с которым связан пакет (обычно IS или PS).
relatedParts.xml
Файл
Содержит информацию о связях деталей, таких как Alternate, Supersession и Cross Reference.
translation.xml
Файл
Содержит локализованные значения локализованных атрибутов, используемые в различных бизнес-объектах, таких как PH, IS, PS, PL, IEXML, PDFM, "Графика" и "Деталь".
excludedObjects.xml
Файл
Предоставляет URI содержимого, которое должно быть удалено из предыдущего опубликованного содержимого.
ModelItemPartObjects.xml
Файл
Базовый артефакт информационного элемента (IE), используемый для создания связей между исходным IEXML и нулевым или большим числом связанных объектов IEXML.
contentMap.xml
Файл
Файл сопоставления, предоставляющий URI для физического сопоставления файлов. Также содержит значения для контрольной суммы, контрольной метасуммы и даты сбора, на основе которых принимается решение о необходимости загрузки данных.
Информационные структуры и структуры документации
Файл *-DMPMap.xml представляет файл информационной структуры или структуры документации. В данном разделе описаны компоненты этих объектов. Применяется терминология из языка, используемого в SIM/SP. Например, IsRoot - динамический тип wt.part.WTPart, который заканчивается на …|com.ptc.sis.IsRoot.
Информационные структуры содержат следующие узлы.
• Узлы <topicref>
◦ IsRoot
◦ IsGroup
◦ ContentRef (является носителем содержимого)
• Связи использования от родительского узла к дочернему
• Ограничение применимости службы, определенное для любого из описанных выше узлов
• Выбранные представления этих узлов
Структура может ссылаться на графику, XML-документы или списки деталей. Она также может получать метаданные из этих используемых как ссылка объектов.
Структуры документации содержат следующие узлы.
• Узлы (включая генерируемый обработчик прерываний) <topicref>
◦ PsRoot
◦ PsSection
◦ PsToc
◦ PsIndex
◦ ContentRef
• Связи использования от родительского узла к дочернему
• Ограничение применимости службы, определенное для любого из описанных выше узлов
Структура может ссылаться на XML-документы или списки деталей. Она также может получать метаданные из этих используемых как ссылка объектов.
Типовой узел одной из таких структур может выглядеть следующим образом:
<topicref id="..."
href="uri of node"
copy-to="relative path of Information Element (IE)"
format="dita|pdf|xml|…"
...>
В инкрементном пакете, не содержащем изменений информационных элементов, атрибут copy-to отсутствует.
Информационные элементы
Все информационные элементы состоят из основного содержимого и метаданных. В пакетах Px поддерживаются следующие различные типы содержимого.
Компоненты списка деталей
• Сам список деталей
• GDD (графический динамический документ) изображения или опубликованный GDD
◦ Основное содержимое
◦ Его представления
◦ Его вложения
• Элемент списка деталей
◦ Деталь
• Связи использования от родительского узла к дочернему
• Ограничение применимости служб, определенное для любого из описанных выше элементов
Компоненты XML-документа
• Основной DD (динамический документ)
◦ Его метаданные
◦ Его основное содержимое
• Изображение, используемое как ссылка
◦ Основное содержимое
◦ Его представления
◦ Его вложения
• Содержимое XML, разрешенное в процессе публикации
◦ Xinclude
◦ Ссылка на раздел DITA
◦ DITA conref, conkeyref и т. д.
Перекрестные ссылки на внешние XML-документы не являются компонентами объекта.
Графическое содержимое
• Основной GDD (графический динамический документ)
◦ Его метаданные
◦ Его основное содержимое
◦ Его представления
◦ Его вложения
Деталь
• Деталь
◦ Метаданные (мастер и экземпляр)
◦ Связанные детали
◦ Ограничение применимости служб, определенное для детали
◦ Пиктограммы
В настоящее время детали извлекаются и публикуются, но процесс публикации обрабатывает их не как объекты, а как компоненты списка деталей. В настоящее время публикация включает связанные детали.
Замечание по ограничению применимости служб
Ограничение применимости служб является не объектом, а информацией, связанной с несколькими объектами. Оно представляет фильтрацию информации о различных объектах информационного элемента. Оно отображается как метаданные в любом объекте, для которого определено. Например:
<Metadata ...
<Property token="ServiceEffectivity">
<Value>(OR (AND (PRODUCT '0000016602') (INSTANCE 'SUV_WE_EV4_SN001'
'SUV_WE_EV4_SN002')) (AND (PRODUCT '0000016610') (INSTANCE
'SUV_WE_EE_SN002' 'SUV_WE_EE_SN001')) (AND (PRODUCT '0000016611')
(INSTANCE 'SUV_WF_EV6T_SN001' 'SUV_WF_EV6T_SN002')) (AND (PRODUCT
'0000016617') (INSTANCE )))</Value>
</Property>
...
</Metadata>
Типы пакетов
В Servigistics InService существует два типа пакетов Px. Тип пакета определяется с помощью файла publishInfo.xml.
Поддерживаются следующие типы:
• Пакет PH
Этот тип пакета переносит информацию о единой иерархии изделия и связанном экземпляре изделия. Обычно этот пакет может принадлежать к следующим типам данных.
◦ Иерархия изделия (PH) (*Hierarchy.xml)
◦ Экземпляры изделия (PI) (ProductInstances.xml)
◦ Опции и варианты (OptionsDefinitions.xml)
◦ PublishInfo.xml
• Пакет IS или PS
Пакеты этого типа несут информацию о структуре информации (IS) или структуре публикации (PS). Обычно этот пакет может принадлежать к следующим типам данных.
◦ relatedContext.xml
◦ IS
◦ Информационные элементы (IEXML, PDFM, графика, список деталей) - обычно подсоединяются через IS
◦ Базовые информационные элементы
◦ Детали, связанные со списками деталей
◦ Взаимосвязи детали
◦ Документы, связанные с деталью
◦ Опции и варианты
◦ Дерево симптомов
◦ PublishInfo.xml
• Пакет, не относящийся к изделию
Этот пакет похож на пакет IS, но не содержит файл relatedContext.xml. Это означает, что пакет не связан ни с одним контекстом изделия. Обычно такие типы пакетов связаны с категорией, определяемой в файле publishInfo.xml.
Определение контекста и категории пакета
Информация о контексте указывает контекст изделия, с которым связан элемент. Контекст в Servigistics InService используется для хранения, фильтрации и поиска различных элементов в системе. Обычно с контекстом связан пакет IS или PS. Обратите внимание, что пакет PH не связан ни с одним контекстом, так как пакет этого типа сам по себе является контекстом. Пакеты PH в Servigistics InService загружаются в каждый сегмент
Пакет Px содержит файл relatedContext.xml, используемый для идентификации контекста, с которым связан пакет. Примечание. Пакет может ссылаться на один или несколько контекстов. Ниже приведен фрагмент файла relatedContext.xml. Атрибут src ссылается на IS или PS. Атрибут target ссылается на информацию о контексте.
Например:
Категория пакета указана в файле PublishInfo.xml. Например:
Сигнальные файлы пакета
Сигнальные файлы - это специальные файлы с нулевым числом байтов, создаваемые в пакете для сигнализации о различных состояниях обработки. Могут использоваться следующие сигнальные файлы.
• ReadyForTAL
Этот файл генерируется владельцем пакета. Наличие этого файла означает, что пакет сгенерирован полностью и может быть обработан процессом TAL.
• PrepTAL
Этот файл создается при одновременной загрузке нескольких пакетов с помощью задания преобразования и загрузки.
• TransformInProgress_Набор или TransformInProgress_ИД_пакета
Наименование этого файла определяется в соответствии с тем, был ли включен общий доступ к содержимому. Если общий доступ к содержимому не разрешен, используется имя TransformInProgress_Набор. Если общий доступ к содержимому разрешен, используется имя TransformInProgress_ИД_пакета. Файл создается во время выполнения преобразования.
• TransformFailed_Набор или TransformFailed_ИД_пакета
Наименование этого файла определяется в соответствии с тем, был ли включен общий доступ к содержимому. Если общий доступ к содержимому не разрешен, используется имя TransformFailed_Набор. Если общий доступ к содержимому разрешен, используется имя TransformFailed_ИД_пакета. Этот файл создается заданием преобразования, когда оно начинает выполняться. При успешном завершении задания преобразования этот файл удаляется.
• TransformCompleted_Набор или TransformCompleted_ИД_пакета
Наименование этого файла определяется в соответствии с тем, был ли включен общий доступ к содержимому. Если общий доступ к содержимому не разрешен, используется имя TransformCompleted_Набор. Если общий доступ к содержимому разрешен, используется имя TransformCompleted_ИД_пакета. Этот файл создается заданием преобразования, когда оно начинает выполняться. Этот файл создается при успешном завершении задания преобразования для набора.
• tal_completed
Этот файл создается после выполнения задания преобразования.
• tal_failed
Этот файл создается в случае сбоя задания преобразования.
Исключение объектов из пакета
Если имеются объекты, которые требуется намеренно исключить из пакета, необходимо включить в пакет файл excludedObjects.xml. Этот файл содержит серию тегов Object, определяющих id и uri объектов, которые не требуется загружать с пакетом.
Ниже представлен пример этого файла:
<?xml version="1.0" encoding="UTF-8"?>
<ExcludedObjects>
<Object id="PartListItem_8153223"
uri="x-wc://com.ptc.arbortext.windchill.partlist.PartListItem:8153223"/>
<Object id="PartListItem_8153222"
uri="x-wc://com.ptc.arbortext.windchill.partlist.PartListItem:8153222"/>
<Object id="WTPartMaster_8118901"
uri="x-wc://f5e0179d8f894049:wt.part.WTPartMaster:0069313461"/>
<Object id="WTPartMaster_8118955"
uri="x-wc://134e815ca9117606:wt.part.WTPartMaster:0069313463"/>
<Object id="WTPartMaster_8118947"
uri="x-wc://ce2ace730699a033:wt.part.WTPartMaster:0069313462"/>
<Object id="EPMDocumentMaster_8143009"
uri="x-wc://file=0000020874.png"/>
</ExcludedObjects>