В данной статье рассмотрим процесс быстрого развертывания Stimulsoft в приложениях, использующих чистый JavaScript. Основной акцент будет сделан на подключении файлов скриптов через CDN-сервисы. Это позволяет легко подключить необходимые скрипты, например, HTML-страницы, без необходимости загружать их локально.
Основные преимущества использования CDN-сервисов
- Быстрая загрузка. Файлы загружаются с ближайшего к пользователю сервера, а это, в свою очередь, ускоряет загрузку страниц;
- Экономия серверных ресурсов. Скрипты хранятся и раздаются сторонними серверами, уменьшая нагрузку на пользовательский сервер;
- Автоматическое обновление. Всегда можно подключить последнюю версию библиотеки, избегая необходимости ручного обновления;
- Кеширование. Браузеры и сети могут кэшировать файлы CDN, что снижает время загрузки для повторной загрузки;
- Безопасность. Крупные CDN обеспечивают защиту от атак, таких как DDoS, и используют шифрованные соединения (HTTPS).
Таким образом, использование CDN-сервисов зачастую является оправданным.
Сервисы CDN для распространения Stimulsoft
Получить доступ к файлам скриптов можно через следующие сервисы:Пример проекта
Для начала создадим HTML-файл, который будет точкой входа в приложение. По умолчанию, таким файлом является index.html:index.html
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Document</title>
</head>
<body>
</body>
</html>
Используя CDN-сервисы, можно получить доступ к файлам скриптов по URL из npm-пакетов stimulsoft-reports-js и stimulsoft-dashboards-js. Например, при помощи сервиса cdn.jsdelivr.net: index.html
...
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/stimulsoft-reports-js/Scripts/stimulsoft.reports.js"></script>
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/stimulsoft-reports-js/Scripts/stimulsoft.designer.js"></script>
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/stimulsoft-reports-js/Scripts/stimulsoft.viewer.js"></script>
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/stimulsoft-reports-js/Scripts/stimulsoft.blockly.editor.js"></script>
...
В этом случае, будут загружены последние версии файлов скриптов. Однако, можно всегда загрузить файлы скриптов необходимой версии пакета Stimulsoft. Для этого следует использовать специальный символ @ в URL к CDN с указанием номера версии пакета. Например: index.html
...
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/stimulsoft-reports-js@2025.1.4/Scripts/stimulsoft.reports.js"></script>
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/stimulsoft-reports-js@2025.1.4/Scripts/stimulsoft.designer.js"></script>
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/stimulsoft-reports-js@2025.1.4/Scripts/stimulsoft.viewer.js"></script>
<script type="text/javascript" src="https://cdn.jsdelivr.net/npm/stimulsoft-reports-js@2025.1.4/Scripts/stimulsoft.blockly.editor.js"></script>
...
После этого просто определим функцию запуска вьювера отчетов: index.html
...
<script type="text/javascript">
function onLoad() {
var report = new Stimulsoft.Report.StiReport();
report.loadFile('reports/Report.mrt');
var viewer = new Stimulsoft.Viewer.StiViewer();
viewer.renderHtml('content');
viewer.report = report;
}
</script>
...
<body onload="onLoad()">
<div id="content"></div>
</body>
...
Затем можем запускать проект. Однако следует помнить, что браузер не имеет доступа к файловой системе. Это обусловлено политикой безопасности самих браузеров. Чтобы локальный проект запускался корректно, следует использовать различные веб-серверы. Например, можно установить глобально http-server или serve и затем запустить веб-сервер из командной строки в корневой папке проекта. В этом случае, index.html будет открыт в браузере с вьювером Stimulsoft.Подключение файлов скриптов через CDN — это удобный и быстрый способ интеграции Stimulsoft в веб-приложения. Использование сервисов cdn.jsdelivr.net и unpkg.com позволяет загружать последние или конкретные версии файлов скриптов без необходимости их локального хранения. Это упрощает разработку и развертывание, а также снижает нагрузку на сервер без ущерба безопасности.
Теперь, следуя приведенным инструкциям, можно легко интегрировать системы отчетности и аналитики данных в приложения с использованием CDN-сервисов.