Arbortext

Продукт
Разработчики: PTC Inc (Parametric Technology Corporation )
Технологии: SCADA,  САПР

Arbortext — семейство продуктов американской компании-гиганта PTC (Parametric Technology Corp.), предназначенное для создания технической документации. В своей основе Arbortext использует принцип единого источника, в основе которого лежит формат XML. Статья будет посвящена в основном Arbortext Editor with Styler, который является основным инструментом технического писателя. Рассмотрим краткий обзор части продуктов линейки Arbortext и их назначение, так как в дальнейшем эти продукты могут упоминаться.

Arbortext Editor — мощный XML редактор, интегрируемый с другими продуктами компании PTC (в числе которых база данных CSDB for S1000D, система PLM Windchill и т. д.). Поддерживает многочисленные форматы выходных публикаций, такие как Web, PDF, HTML Help, Digital Media Publisher.

Arbortext Styler — надстройка, интегрированная в Arbortext Editor, позволяющая с помощью визуального интерфейса легко создавать и редактировать стили, применяемые при публикации XML источника в различные форматы. Очень часто Arbortext Editor выбирается именно в комплектации Arbortext Editor with Styler.

Arbortext ISO Draw — система для создания технических иллюстраций. Arbortext IsoDraw автоматизирует процесс создания высококачественных 2D и 3D технических иллюстраций и анимаций прямо из трехмерных моделей. Иллюстрации автоматически обновляются при изменении исходных моделей САПР.

Arbortext Publishing Engine — сетевой сервер для публикации. Позволяет подбирать и публиковать материал в соответствии с выбранными требованиями содержания и формата. Содержит машину для публикации в формат IETP.

Arbortext CSDB for S1000D (Arbortext ASD 1000D) является полностью настроенным решением «под ключ», реализующим техническую документацию в соответствии со спецификациями ASD 1000D и ASD 2000M. Почему именно Arbortext?

Высокая степень интегрированности продуктов Arbortext c другими продуктами PTC позволяет осуществлять разработку документации не просто в XML редакторе, но в специальной среде разработки. Эта среда дает возможность не только создавать XML, но и хранить документацию, создавать интерактивные иллюстрации, организовывать параллельную работу по созданию документации нескольким участникам процесса, в то время, как большинство редакторов — замкнутые решения для локального пользователя, нацеленные больше на какие-то свои изыски, но не на законченное решение.

Функциональность самого редактора, которая будет подробно рассмотрена далее, отвечает всем современным требованиям для организации профессиональной работы по разработке документации — с одной стороны. С другой стороны, Arbortext Editor создан для того, чтобы скорее начать работу и получить результат, не нуждаясь в специфических знаниях о XML, XSL-FO, тонкостях инсталляции стандартов, типов документов и т. д.

Практически всегда документация разрабатывается не с чистого листа. Многие понимают, что при переходе на использование единого источника данных в формате XML потребуется не только организовать разработку документации, но при этом использовать имеющиеся наработки. Arbortext содержит конфигурируемый модуль для импорта данных из Microsoft Word и Adobe FrameMaker в формат XML.

Функциональность Arbortext Editor

Приятные моменты рабочего процесса

Начав работу и решив создать новый документ, мы сразу же видим предустановленные ВЕВ: DITA, DocBook/XML, SMA (service manual application — специализация на основе DITA) и другие. Нет необходимости устанавливать или настраивать DITA или DocBook. Добавление нового типа документа происходит указанием нового DTD (на рисунке также видны собственные типы документов, которые были созданы и добавлены — elantra, glava, trg_ditabase).

Предустановленные типы документов

Выбор пункта Sample позволяет нам открыть предустановленный пример документа того или иного типа для ознакомления. На рисунке ниже мы видим интерфейс Arbortext Editor с открытым образцом документа в формате DITA Topic. Придирчивый пользователь может настраивать цвета, панели, отображение элементов на свой вкус.

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

Интерфейс. Предустановленный образец выбранного типа документа

Файл:arbortext2_html_m300da6f0.jpg

Окно атрибутов может быть быстро вызвано горячей клавишей в зависимости от положения курсора в окне редактирования или дереве документа

Экран по умолчанию разбит на 2 фрейма: слева дерево документа, справа — область редактирования. Разбиение экрана на 2 фрейма можно убирать, располагать по-другому, а можно заменять, выбрав, например, менеджер ресурсов, как вы видите на рисунке ниже. Менеджер ресурсов может отображать имеющуюся графику, структуру ссылок и связей с другими XML документами, заимствованные части контента.

Менеджер ресурсов (изображений, контентных ссылок, элементов структуры, на которые разбиваются документы)

Документы могут быть представлены как сборки из файловых сущностей, сборки из наборов ссылок. Это позволяет организовать одновременную работу над документом нескольких пользователей. На примере ниже инструкция по обкатке автомобиля, которая параллельно формировалась из двух частей — файловых сущностей.

Функция Compare позволяет отслеживать изменения, осуществляя сравнение текущего документа с последней сохранённой версией, с документом из другого файла или из другого открытого окна Arbortext Editor. Мы можем отследить, было ли в новой версии произведено редактирование, удаление или же добавление части текста. Как видно на рисунке, из списка был удалён один пункт, но мы видим, в каком месте он находился.

Файл:arbortext2_html_b1afde4.jpg

Функция сравнения отслеживает изменения в документа

Arbortext Editor может включать функцию импорта документов различных форматов в формат XML.

Файл:arbortext2_html_4bc954cb.jpg

Импорт документов в формат

Для импорта используется специальный шаблон STD. Можно использовать готовые шаблоны, а можно воспользоваться встроенным редактором. На примере ниже мы видим некоторый проект импорта, в котором начата работа по созданию своего шаблона для конвертации файлов Microsoft Word в XML.

Среда разработки

Для формирования единой среды разработки документации и обеспечения поддержки жизненного цикла документации предусмотрены:

Arbortext CSDB for S1000D. ASD 1000D (S 1000D) является средой «под ключ» разработки, создания, управления и эксплуатации технических публикаций применительно к гражданской и военной Авиационной и Оборонной промышленности. Формат статьи не позволяет широко раскрыть особенности продукта, более подробную информацию можно найти по ссылке.

Система обеспечения жизненного цикла изделий Windchill. Являясь веб-ориентированной PLM системой, где клиентом является обычный Internet Explorer, Windchill формирует среду для хранения данных и разработки изделия, обеспечивает полноценный workflow. Windchill особенно незаменима, когда участники проекта сильно удалены друг от друга, но имеют доступ к локальной или глобальной сети. Пользователь может сформировать правила, по которым загружаемые XML документы будут разбиваться на несколько файлов, превращаясь в сборку для формирования параллельной работы удалённых пользователей и формирования книг на основе повторного использования частей документации.





Распределение вендоров по количеству проектов внедрений (систем, проектов) с учётом партнёров

За всю историю
2016 год
2017 год
2018 год
Текущий год

  Autodesk (101, 92)
  АСКОН (29, 90)
  PTC Inc (Parametric Technology Corporation ) (15, 53)
  Dassault Systemes (28, 42)
  Siemens PLM Software (8, 30)
  Другие (307, 221)

  Autodesk (9, 10)
  Dassault Systemes (6, 7)
  Intergraph (4, 6)
  АСКОН (2, 6)
  Нанософт (4, 5)
  Другие (10, 13)

  АСКОН (1, 7)
  Intergraph (5, 6)
  Витро Софт (Vitro Software) (1, 5)
  Неолант (3, 4)
  SDI Solution (ЭсДиАй Солюшен) (1, 2)
  Другие (11, 12)

  Autodesk (5, 5)
  Renga Software (2, 4)
  АСКОН (2, 3)
  Ansys (1, 3)
  Dassault Systemes (2, 2)
  Другие (10, 13)

  PTV Group (3, 9)
  Dassault Systemes (4, 4)
  А+С Транспроект (1, 3)
  Autodesk (2, 2)
  SolidWorks Corporation (2, 2)
  Другие (7, 8)

Распределение базовых систем по количеству проектов, включая партнерские решения

За всю историю
2016 год
2017 год
2018 год
Текущий год

  КОМПАС-3D - 61 (50, 11)
  PTC Creo - 31 (16, 15)
  Siemens NX - 24 (24, 0)
  NanoCAD - 18 (15, 3)
  AutoCAD - 16 (7, 9)
  Другие 318

  КОМПАС-3D - 4 (4, 0)
  NanoCAD - 3 (2, 1)
  Altium Designer - 2 (2, 0)
  Autodesk BIM 360 - 2 (2, 0)
  DS Designed for Sea - 2 (2, 0)
  Другие 33

  КОМПАС-3D - 7 (7, 0)
  Vitro-CAD - 5 (5, 0)
  Intergraph SmartPlant Review - 2 (2, 0)
  НСИ Semantic MDM - 2 (2, 0)
  Tekla Structures - 2 (2, 0)
  Другие 18

Распределение вендоров по количеству проектов внедрений (систем, проектов) с учётом партнёров

За всю историю
2016 год
2017 год
2018 год
Текущий год

  Круг, НПФ (6, 74)
  Wonderware (6, 12)
  ARC Informatique (2, 12)
  Honeywell Process Solutions (HPS) (3, 9)
  Frontstep CIS (Фронтстеп СНГ) (1, 4)
  Другие (66, 29)

  Круг, НПФ (3, 7)
  Schneider Electric Global (1, 1)
  Wonderware (1, 1)
  Другие (0, 0)

  Круг, НПФ (3, 11)
  РТСофт (RTSoft) (1, 2)
  Wonderware (1, 1)
  Luxms (1, 1)
  Frontstep CIS (Фронтстеп СНГ) (1, 1)
  Другие (2, 2)

Распределение базовых систем по количеству проектов, включая партнерские решения

За всю историю
2016 год
2017 год
2018 год
Текущий год

  SCADA КРУГ-2000 - 4 (4, 0)
  ПТК КРУГ-2000 - 3 (3, 0)
  PcVue - 1 (1, 0)
  ЦУП: Data Collection - 1 (1, 0)
  MasterSCADA - 1 (1, 0)
  Другие 2