Различия

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

--- product:settings:scripts [02.10.2025 13:27] – [Где найти файл конфигурации] Сердцев Сергей
+++ product:settings:scripts [03.10.2025 08:45] (текущий) – [Где найти файл конфигурации] Белугин Александр
@@ Строка 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 ====