Различия

Показаны различия между двумя версиями страницы.

--- product:settings:scripts [02.10.2025 13:27] – [Где найти файл конфигурации] Сердцев Сергей
+++ product:settings:scripts [30.10.2026 11:48] (текущий) – [Подключение сторонних скриптов] Белугин Александр
@@ Строка 1: / Строка 1: @@
 ====== Подключение сторонних скриптов ======
-Все сторонние скрипты могут работать только в том случае, если инсталляция ADVANTA не установлена в закрытом контуре (корпоративной интрасети).
+Если к инсталляции ADVANTA подключаются сторонние скрипты, размещенные на внешних ресурсах, то они будут работать только в том случае, если инсталляция ADVANTA не установлена в закрытом контуре, либо внешний ресурс (с которого подключается скрипт) доступен из корпоративной интрасети. При блокировке внешнего (не интранет) трафика такие сторонние скрипты работать не будут (Яндекс.Метрика, Google Analytics и другие).
-Подключение скриптов -- сугубо факультативно. Если у вас как у администратора системы нет потребности в том, чтобы, например, считать посещаемость страниц системы или выводить в системе интерфейсные подсказки (онбординг), то вы можете смело игнорировать эти настройки.
+Подключение скриптов -- сугубо факультативно. Если у вас, как у администратора системы, нет потребности в том, чтобы, например, считать посещаемость страниц системы или выводить в системе интерфейсные подсказки (онбординг), то вы можете смело игнорировать эти настройки.
 ===== Через интерфейс администрирования =====
@@ Строка 54: / Строка 54: @@
 ==== Где найти файл конфигурации ====
 Работа с внешними скриптами настраивается через файл конфигурации ''ThirdPartyScripts.config'', который должен находится в каталоге приложения ''Streamline\_Resources\Config\ThirdPartyScripts''
-  * По умолчанию этого файла нет -- ничего не вставляется.
+  * По умолчанию этого файла в приложении нет -- никакие дополнительные скрипты в страницы системы не вставляется.
-  * В каталоге ''SL\_Resources\Config\ThirdPartyScripts'' (в архиве с модулем обновления), либо в каталоге ''\Context_bkp\config\ThirdPartyScripts'' (в архиве первичного дистрибутива системы) есть тестовая конфигурация, а именно ''ThirdPartyScripts.config'' и %%script_*.js%%-файлы, на которые он ссылается. Их надо скопировать в каталог приложения ''Streamline\_Resources\Config\ThirdPartyScripts'' и перезапустить IIS либо пул приложения.
+  * В каталоге дистирубтива ''SL\Config\ThirdPartyScripts'' (в архиве с модулем обновления), либо в каталоге ''\Context_bkp\config\ThirdPartyScripts'' (в архиве первичного дистрибутива системы) есть тестовая конфигурация, а именно ''ThirdPartyScripts.config'' и %%script_*.js%%-файлы, на которые он ссылается. Их надо скопировать в каталог приложения ''Streamline\_Resources\Config\ThirdPartyScripts'' и перезапустить IIS либо пул приложения.
+  * Если указанных файлов нет в каталоге дистрибутива, вы можете {{ :product:settings:thirdpartyscripts.zip |скачать их в виде архива}}.
-Так выглядит файл конфигурации ''ThirdPartyScripts.config'': <code xml>
+Так выглядит файл конфигурации ''ThirdPartyScripts.config'':
+<code xml>
 <?xml version="1.0"?>
 <scripts>
@@ Строка 75: / Строка 77: @@
     * ''first'' -- в начало контейнера
     * ''last'' -- в конец контейнера
-  * текст тэга. \\ Название файла, расположенного в ''SL\_Resources\Config\ThirdPartyScripts'', содержимое которого будет вставлено в страницу в указанном месте.  \\  При отсутствии файла ничего не вставляется, но ошибка не генерируется
+  * текст (содержимое) тэга -- название файла, расположенного в папке ''Streamline\_Resources\Config\ThirdPartyScripts'', содержимое которого будет вставлено в страницу в указанном месте. При отсутствии указанного в конфиге js-файла на сервере - на страницы системы ничего не вставляется, ошибка не генерируется.
+<callout type="info" icon="true">Указанные в шаблоне файла конфигурации ''ThirdPartyScripts.config'' имена скриптов ''script_header_first.js'', ''script_header_last.js'', ''script_body.js'', ''script_footer.js'' приведены для примера и не являются обязательными. Перечень, имена и содержимое файлов с подключаемыми js-скриптами определяется владельцем инсталляции на свое усмотрение и под его ответственность.</callout>
 В результате в нужных местах страницы генерируется код.
+Содержимое шаблонных %%script_*.js%%-файлов выглядят приблизительно так
+<code js>
+<script>
+// path="header" order="first"
+</script>
+</code>
+то есть они просто содержат метки тэгов расположения из конфигурации. С ними удобно производить первоначальное тестирование механизма подключения скриптов. Для этого скопируте ''ThirdPartyScripts.config'' и файлы %%script_*.js%% в каталог ''Streamline\_Resources\Config\ThirdPartyScripts'' и перзапустите IIS либо пул приложения.
+После этого можно посмотреть в коде страницы, работает ли вставка сторонних скриптов, и куда конкретно вставляются фрагменты с разными тэгами.
+После тестирования и заполнения ''ThirdPartyScripts.config'' рабочими данными, если в нем ссылок на тестовые js-скрипты больше нет - то их можно удалить с сервера.
 ==== Загрузка скрипта в память IIS ====
@@ Строка 84: / Строка 104: @@
   - нажмите в Администрировании -> Общие настройки -> Общие настройки -> Настройка сторонних скриптов -> "Перечитать".
   - обновите страницу, где предполагался скрипт, и проверьте его работоспособность.
+==== Действия при обновлении системы ====
+Если в системе используются сторонние скрипты, то при выполнении обновления воспользуйтесь описанием шагов по созданию резервной копии скриптов и их восстановлению, представленными в разделе [[product:settings:system:update|Обновление системы]]