-

guide/integration.rst

@@ -829,6 +829,100 @@ ARTA Synergy при загрузке внешнего web-модуля буде
 эта строка в web-интерфейсе проигрывателя форм Synergy
 будет заменена на идентификатор данного документа.
 
+Внешний проигрыватель форм
+--------------------------
+
+В бизнес-приложениях на базе Synergy может возникнуть необходимость работы из
+внешних систем с формами Synergy. В этом случае можно использовать внешний проигрыватель форм.
+
+Проигрыватель форм - это инструмент, который даёт возможность работать с формами,
+созданными и используемыми в Synergy, а также выполняет скрипты. При использовании
+во внешней системе проигрыватель позволяет:
+
+* отображать и редактировать формы Synergy;
+* настраивать произвольный вид формы и ее компонентов, создавать новые компоненты;
+* автоматически заполнять поля формы данными из внешней системы;
+* обеспечивать обратную связь от проигрывателя к серверу, используя механизм событий;
+* обрабатывать наступившие события.
+
+.. note:: Проигрыватель форм запускается на стороне клиента, поэтому все события
+          и скрипты срабатывают только при открытом проигрывателе.
+
+Подключение проигрывателя форм
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+#. Для подключения проигрывателя на страницу необходимо добавить код в раздел ``head``:
+
+    .. code-block:: xml
+
+        <script>
+         FORM_PLAYER_URL_PREFIX = "http://127.0.0.1:8080/Synergy/"; <!--служебная переменная для корректной работы компонента "HTD-редактор"-->
+        </script>
+        <link rel="stylesheet" href="http://127.0.0.1:8080/Synergy/js/form.player.css"/> <!--стандартный стиль компонентов формы-->
+        <script src="http://127.0.0.1:8080/Synergy/js/vendor.js" type="text/javascript"></script> <!--ссылка на сторонние библиотеки-->
+        <script src="http://127.0.0.1:8080/Synergy/js/form.player.js" type="text/javascript"></script> <!--ссылка на проигрыватель форм-->
+
+   и вставить элемент для размещения проигрывателя в тело страницы:
+
+   .. code-block:: xml
+
+       <div id="form_player_container">
+           <div id="form_player_div"></div>
+       </div>
+
+#. Код скрипта, который использует проигрыватель, должен содержать ссылку на Synergy:
+
+   .. code-block:: javascript
+
+      AS.OPTIONS.coreUrl = "http://127.0.0.1:8080/Synergy/"; //ссылка на экземпляр Synergy
+
+   Создание объекта проигрывателя выглядит следующим образом:
+
+   .. code-block:: javascript
+
+       'use strict';
+
+        AS.OPTIONS.locale = "ru";
+        AS.OPTIONS.coreUrl = "http://127.0.0.1:8080/Synergy/";
+
+
+        var portal = {
+            player : null,
+
+            /**
+             * очистить текущий проигрыватель форм
+             */
+            clearPlayer : function() {
+                if(portal.player) {
+                    portal.player.destroy();
+                }
+            },
+            /**
+             * добавить новый проигрыватель форм
+             */
+            createPlayer : function(formCode){
+
+                portal.clearPlayer();
+                portal.player = AS.FORMS.createPlayer();
+
+                portal.player.showFormByCode(formCode);
+
+                portal.player.view.appendTo($('#form_player_div'));
+
+            }
+
+        };
+
+        $(document).ready(function(){
+
+            AS.OPTIONS.login = "login";
+            AS.OPTIONS.password = "password";
+            portal.createPlayer("formCode");
+
+        });
+
+   См. также документацию по `Скриптинг в формах`_.
+
 Ссылки на модули системы и их внутренние элементы
 -------------------------------------------------