-

docs/integration.rst

@@ -828,3 +828,106 @@ ARTA Synergy при загрузке внешнего web-модуля буде
 значение которого будет равно ``${docID}`` —
 эта строка в web-интерфейсе проигрывателя форм Synergy
 будет заменена на идентификатор данного документа.
+
+Ссылки на модули системы и их внутренние элементы
+-------------------------------------------------
+
+Ссылки на модули и различные объекты Synergy
+можно использовать как внутри основного web-приложения
+(в этом случае предпочтительно использовать относительные
+ссылки, чтобы не перезагружать страницу), так и во внешних
+системах.
+
+Общий вид ссылок:
+
+    http[s]://**host***[:port]*/**Application**?*param1*=*value1*&*param2*=*value2*#*param3*=*value3*&*param4*=*value4*
+
+где
+
+* **host** - доменное имя или ip-адрес сервера Synergy
+* *port* - порт
+* **Application**:
+    * `Synergy` - основное приложение
+    * `Configurator` - Конфигуратор
+    * `SynergyAdmin` - административное приложение
+* *param1*, *param2* - параметры абсолютной ссылки
+* *param3*, *param4* - параметры относительной ссылки
+
+Параметры абсолютной ссылки - это, как правило:
+
+* **locale** - локаль загружаемой системы
+* **nocache** - специальный параметр, предотвращающий случайное кэширование
+
+остальные параметры можно передавать как параметры относительной ссылки.
+
+Ниже для краткости будем приводить образец относительной ссылки
+
+Ссылка на модуль системы
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+``#submodule=module_id``
+
+
+где ``module_id``:
+
+* **workflow** - Потоки работ
+* **calendar** - Ежедневник
+* **repository** - Хранилище
+* **plans** - Проекты
+* **pointers** - Цели и показатели
+* **employees** - Сотрудники
+
+При переходе по ссылке откроется указанный модуль.
+
+Ссылка на документ и файл в нём
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``#submodule=common&file_identifier=some_file_id&action=open_document&document_identifier=some_doc_id``
+
+При переходе по такой ссылке откроется указанный документ с основным файлом,
+а если указан ``file_identifier`` - то откроется документ с этим файлом.
+
+Ссылка на проект и мероприятие в нем
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``#submodule=plans&action=open_action&action_identifier=some_action_id&project_identifier=some_project_id``
+
+При переходе по такой ссылке откроется указанный проект,
+а если указан ``action_identifier`` - то в проекте будет выделено
+это мероприятие.
+
+Ссылка на профиль пользователя
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+``#submodule=employees&innermodule=structure&action=open_user&user_identifier=some_user_id``
+
+При переходе по такой ссылке будет открыт модуль «Сотрудники»,
+а в нем - профиль указанного пользователя
+
+Отключение всего пользовательского клиентского скриптинга
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Если в абсолютной ссылке указать параметр ``noCustomScripting``,
+то все пользовательские ВМК, скрипты в формах и пользовательских
+компонентах будут отключены. Это можно использовать для отладки
+пользовательских компонентов, ВМК и скриптов на форме.
+
+Как задеплоить интеграционное приложение
+----------------------------------------
+
+ARTA Synergy работает на сервере приложений JBoss AS7.
+Интеграционное приложение может представлять собой
+*jar*-файл либо *war*-файл либо их комбинацию.
+
+Если приложение является одиночным файлом, его можно задеплоить,
+скопировав в директорию ``${jboss.home}/standalone/deployments``.
+Если приложение состоит из нескольких файлов,
+необходимо создать `*.ear` приложение.
+
+Если приложение имеет зависимости на внешние библиотеки
+и они находятся в модулях JBoss-а (``${jboss.home}/modules``),
+необходимо использовать их, прочие зависимости — помещать внутрь приложения.
+
+.. danger:: В целях безопасности работы приложения Synergy и сервера приложений
+            категорически запрещается помещать артефакты интеграционного модуля
+            в приложение ``Synergy.ear`` и изменять состав модулей (``${jboss.home}/modules``).