levis/help365
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

push ru help
All checks were successful
Deploy Static Site / deploy (push) Successful in 6m55s
Details

Browse Source
This commit is contained in:
koziavin
2025-05-28 05:24:40 +04:00
parent 0113fb8289
commit 041abbbd24
4459 changed files with 121310 additions and 86248 deletions
Download Patch File Download Diff File Expand all files Collapse all files

211
platform/npm-package.html
View File

@ -1,19 +1,20 @@
<!DOCTYPE html>
<html lang="en">
<html lang="ru">
<head>
<title>Server dependencies in npm packages</title>
<title>Серверные зависимости пакетов npm</title>
<meta name="generator" content="Help+Manual" />
<meta name="keywords" content="" />
<meta name="keywords" content="ELMA365 On-Premises" />
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta name="description" content="In BRIX On-Premises, you can add server dependencies in widget scripts. This allows you to solve some uncommon problems without writing custom microservices. Instead, you can..." />
<meta name="description" content="В ELMA365 On-Premises вы можете подключать серверные зависимости в скриптах виджетов и пользовательских модулей. Это позволит решить ряд специфичных задач при разработке без..." />
<meta name="picture" content="" />
<meta property="og:type" content="website" />
<meta property="og:title" content="Full documentation for BRIX365 platform. Low-code developer guide. User guide. Admin guide. Developer guide." />
<meta property="og:url" content="https://brix365.com/en/help" />
<meta property="og:image" content="" />
<meta property="og:title" content="Cправка по Low-code платформе ELMA365" />
<meta property="og:url" content="https://elma365.com/ru/help" />
<meta property="og:image" content="" />
<meta property="og:site_name" content="ELMA365" />
<link rel="icon" href="favicon.png" type="image/png" />
<link href="https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap" rel="stylesheet" />
@ -23,6 +24,7 @@
<link rel="stylesheet" href="./article.css" />
<link rel="stylesheet" href="./glossary.css" />
<link rel="stylesheet" href="./theme.css" />
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="helpman_settings.js"></script>
<script type="text/javascript" src="helpman_topicinit.js"></script>
@ -34,16 +36,16 @@
</head>
<body>
<script async src="https://www.googletagmanager.com/gtag/js?id=G-M6ETBEC1R9"></script><script>window.dataLayer=window.dataLayer || []; function gtag(){dataLayer.push(arguments);}gtag('js', new Date()); gtag('config', 'G-M6ETBEC1R9');</script>
<script>!function(e,t,c,n,r,a,m){e.ym=e.ym||function(){(e.ym.a=e.ym.a||[]).push(arguments)},e.ym.l=1*new Date;for(var s=0;s<document.scripts.length;s++)if(document.scripts[s].src===n)return;a=t.createElement(c),m=t.getElementsByTagName(c)[0],a.async=1,a.src=n,m.parentNode.insertBefore(a,m)}(window,document,"script","https://mc.yandex.ru/metrika/tag.js"),ym(83179930,"init",{clickmap:!0,trackLinks:!0,accurateTrackBounce:!0,webvisor:!0})</script><noscript><div><img alt=""src=https://mc.yandex.ru/watch/83179930 style=position:absolute;left:-9999px></div></noscript>
<header class="header elma-365">
<div class="container">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-en.svg" alt="header logo">
<a class="header__logo" href="https://elma365.com/ru/help">
<img src="./logo.svg" alt="header logo">
</a>
<!-- <div class="hero__search-form" id="search-panel">
<form class="search-form" onsubmit="ym(83180416,'reachGoal','poisk')">
<form class="search-form" onsubmit="ym(83179930,'reachGoal','poisk')">
<label class="search-form__label">
<span id="reset-search" class="search__icon"></span>
<input class="search-form__input" type="text">
@ -63,7 +65,7 @@
</div>
<div class="header__navi">
<ul class="header__list"><li><span class="solution-select"><span class="solution-select__selected"></span><svg width="7" height="4" viewBox="0 0 7 4" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L3.5 3.5L6 1" stroke="white" stroke-linecap="round" stroke-linejoin="round"/></svg><ul class="solution-select__list"><li><a class="project-link" href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a class="project-link" href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a class="project-link" href="https://brix365.com/en/help/crm/crm_overview.html">CRM</a></li><li><a class="project-link" href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a class="project-link" href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li><li><a class="project-link" href="https://brix365.com/en/help/business_solutions/-elma365-store.html">Business Solutions</a></li></ul></span></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li><li><a href="https://tssdk.brix365.com/" target="_blank">SDK</a></li></ul>
<ul class="header__list"><li><span class="solution-select"><span class="solution-select__selected"></span><svg width="7" height="4" viewBox="0 0 7 4" fill="none" xmlns="http://www.w3.org/2000/svg"><path d="M1 1L3.5 3.5L6 1" stroke="white" stroke-linecap="round" stroke-linejoin="round"/></svg><ul class="solution-select__list"><li><a class="project-link" href="https://elma365.com/ru/help/platform/get-trial.html">Платформа</a></li><li><a class="project-link" href="https://elma365.com/ru/help/ecm/ecm-functions.html">ECM</a></li><li><a class="project-link" href="https://elma365.com/ru/help/crm/crm_overview.html">CRM</a></li><li><a class="project-link" href="https://elma365.com/ru/help/service/service-functions.html">Service</a></li><li><a class="project-link" href="https://elma365.com/ru/help/projects/projects-functions.html">Проекты</a></li><li><a class="project-link" href="https://elma365.com/ru/help/business_solutions/-elma365-store.html">Бизнес-решения</a></li></ul></span></li><li><a href="https://api.elma365.com/ru/"target="_blank">API</a></li><li><a href="https://tssdk.elma365.com/"target="_blank">SDK</a></li><li><a href="https://community.elma365.com/" target="_blank">Community</a></li><li><a href="https://elma-academy.com/ru/" target="_blank">Академия</a></li><li><a href="https://elma365.com/ru/" target="_blank">Сайт ELMA365</a></li></ul>
</div>
@ -78,8 +80,8 @@
<aside class="sidebar" id="sidebar">
<div class="sidebar__header">
<a class="header__logo" href="https://brix365.com/en/help">
<img src="./logo-light-en.svg">
<a class="header__logo" href="https://elma365.com/ru/help">
<img src="./logo-light.svg">
</a>
<span class="sidebar__close elma-365-close" id="close"></span>
</div>
@ -92,15 +94,15 @@
<div class="article-inner">
<div class="content">
<header class="article__header">
<div class="article__bread" style="display:flex; gap:10px;">
<div class="article__bread" style="display:flex; gap:10px;">
<span id="subcategory" class="search-res__item-category search-res__item-category_subcategory subcategory article__badge"></span>
<div class="topic__breadcrumbs">
<p><a href="solutions-building.html">Build solutions in BRIX</a> / Server dependencies in npm packages</p>
<p><a href="solutions-building.html">Разработка решений на платформе ELMA365</a> / Серверные зависимости пакетов npm</p>
</div>
</div>
<div class="topic__title"><h1 class="p_Heading1"><span class="f_Heading1">Server dependencies in npm packages</span></h1>
<div class="topic__title"><h1 class="p_Heading1"><span class="f_Heading1">Серверные зависимости пакетов npm</span></h1>
</div>
</header>
@ -109,7 +111,7 @@
<a href="#h1-article" class="scroll-top"></a>
</div>
<!-- Placeholder for topic body. -->
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-size: 15px; font-family: Inter;">In BRIX On-Premises, you can add server dependencies in widget scripts. This allows you to solve some uncommon problems without writing custom microservices. Instead, you can use the rich ecosystem of npm packages when writing server scripts. </span><span style="font-family: Inter;">For example, you can add the <a href="https://www.npmjs.com/package/xlsx" target="_blank" class="weblink">XLSX</a> package to read data from Excel files using the following commands:</span></p>
<p class="p_Normal">В ELMA365 On-Premises вы можете подключать серверные зависимости в скриптах виджетов и пользовательских модулей. Это позволит решить ряд специфичных задач при разработке без написания своего микросервиса. Для этого используйте экосистему npm-пакетов при разработке серверных скриптов. Например, можно использовать пакет <a href="https://www.npmjs.com/package/xlsx" target="_blank" class="weblink">XLSX</a> для чтения данных из excel-файла с помощью команд:</p>
<p class="p_CodeExample" style="white-space: normal; page-break-inside: avoid;"><span class="f_CodeExample">import * as XLSX from 'xlsx';</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">const url = await Context.data.file.getDownloadUrl();</span><br />
@ -118,34 +120,35 @@
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">const workbook = XLSX.read(data);</span><br />
<span class="f_CodeExample">const sheets = workbook.Sheets;</span><br />
<span class="f_CodeExample">const cellValue = sheets['Sheet1']['A1'].v;</span></p>
<span class="f_CodeExample">const cellValue = sheets['List1']['A1'].v;</span><br />
<span class="f_CodeExample">&nbsp;</span></p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">начало&nbsp;внимание</span></p>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-family: Inter;">Server dependencies in npm packages can be added only in <a href="elma365-on-premises.html" class="topiclink">BRIX On-Premises</a>.</span></p>
<p class="p_Normal">Подключение серверных зависимостей пакетов npm доступно только в <a href="elma365-on-premises.html" class="topiclink">ELMA365 On-Premises</a>.</p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">конец&nbsp;внимание</span></p>
<p style="line-height: 1.20; margin: 7px 0 16px 0;"><span style="font-size: 15px; font-family: Inter;">To create an npm package, pack the prepared </span><code><b>node_modules</b></code><span style="font-size: 15px; font-family: Inter;"> folder and the </span><code><b>package.json</b></code><span style="font-size: 15px; font-family: Inter;"> file into an archive called </span><code><b>dependencies.tar.gz</b></code><span style="font-size: 15px; font-family: Inter;">. For more details see:</span></p>
<p class="p_Normal">Чтобы собрать npm-пакет с зависимостями, упакуйте готовую папку <span style="font-weight: bold;">node_modules </span>и файл <span style="font-weight: bold;">package.json </span>в архив с названием<span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;"> </span><span style="font-weight: bold;">dependencies.tar.gz</span><span style="font-size: 15px; font-family: Calibri,Vectora,'Droid Sans','Open Sans',Frutiger,sans-serif;">. </span>Подробнее о том, как это сделать, читайте ниже:</p>
<ul style="list-style-type:disc">
<li style="line-height: 1.20;"><a href="npm-package.html#npm-package-shell-linuxmacos" class="topiclink">building a package with a Shell scritp for Linux, macOS</a><span style="font-size: 15px; color: #394149;">;</span></li><li style="line-height: 1.20;"><span style="color: #394149;"><a href="npm-package.html#npm-package-powershell-windows" class="topiclink">building a package with a PowerShell script for Windows</a></span><span style="font-size: 15px; color: #394149;">.</span></li></ul>
<p style="line-height: 1.20; margin: 0 0 16px 0;"><span style="font-size: 15px; color: #394149;">Install Docker before starting work.</span></p>
<h2 class="p_Heading2"><a id="npm-package-shell-linuxmacos" class="hmanchor"></a><span class="f_Heading2">Building a package with server dependencies using a Shell script for Linux, macOS</span></h2>
<li class="p_Normal"><a href="npm-package.html#npm-package-shell-linuxmacos" class="topiclink" title="npm-package-Shell-LinuxMacOS">сборка пакета с помощью Shell-скрипта для Linux, macOS</a>;</li><li class="p_Normal"><a href="npm-package.html#npm-package-powershell-windows" class="topiclink" title="npm-package-PowerShell-Windows">сборка пакета с помощью PowerShell-скрипта для Windows</a>.</li></ul>
<p class="p_Normal">Для работы установите Docker.</p>
<h2 class="p_Heading2"><a id="npm-package-shell-linuxmacos" class="hmanchor"></a><span class="f_Heading2">Сборка пакета с серверными зависимостями с помощью Shell-скрипта для Linux, macOS</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" class="p_Normal">Create an empty folder on your computer. Copy the script below and save it as a file named <span style="font-weight: bold;">makedeps.sh</span> in the created folder:</li></ol>
<li value="1" class="p_Normal">Создайте пустую папку на своём компьютере. Скопируйте приведённый ниже скрипт и сохраните его как файл с названием <span style="font-weight: bold;">makedeps.sh</span> в созданной папке:</li></ol>
<p class="p_CodeExample" style="white-space: normal; page-break-inside: avoid;"><span class="f_CodeExample">rm</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-rf</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">./deps</span><br />
<span class="f_CodeExample">docker</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">run</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-v</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">`pwd`:/data</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-w</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">/data/deps</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">--platform</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">linux/amd64</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">--rm</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">node:14.16.0-alpine</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">/bin/sh</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-c</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">&quot;npm init -y &amp;&amp; npm i $*&quot;</span><br />
<span class="f_CodeExample">docker</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">run</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-v</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">`pwd`:/data</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-w</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">/data</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">--platform</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">linux/amd64</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">--rm</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">busybox</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">tar</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-zcf</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">dependencies.tar.gz</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-C</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">/data/deps</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">node_modules</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">package.json</span><br />
<span class="f_CodeExample">rm</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-rf</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">./deps</span></p>
<ol style="list-style-type:upper-roman" start="2">
<li value="2" class="p_Normal">Through the developer console, find the saved file and make it executable:</li></ol>
<li value="2" class="p_Normal">Через консоль разработчика найдите сохранённый файл и сделайте его исполняемым:</li></ol>
<p class="p_CodeExample" style="white-space: normal; page-break-inside: avoid;"><span class="f_CodeExample">$chmod 755 makedeps.sh</span></p>
<ol style="list-style-type:upper-roman" start="3">
<li value="3" class="p_Normal">Run the script, passing a list of npm packages as parameters. For example, for the XLSX package: </li></ol>
<li value="3" class="p_Normal">Запустите скрипт, передав в качестве параметров список npm-пакетов. Например, для пакета XLSX: </li></ol>
<p class="p_CodeExample" style="white-space: normal; page-break-inside: avoid;"><span class="f_CodeExample">$./makedeps.sh xlsx semver</span></p>
<p class="p_Normal">As a result of the command execution, an archive with dependencies named <span style="font-weight: bold;">dependencies.tar.gz</span>.</p>
<p class="p_Normal">В результате выполнения команды сформируется архив с зависимостями <span style="font-weight: bold;">dependencies.tar.gz</span>.</p>
<ol style="list-style-type:upper-roman" start="4">
<li value="4" class="p_Normal">Upload the package to the system; this can be done in the <a href="client_server_scripts.html" class="topiclink">widget settings</a> in the interface designer and in the custom module when creating an <a href="extention-api.html" class="topiclink">API method</a>: add the obtained dependencies archive on the <span style="font-weight: bold;">Files</span> tab.</li></ol>
<p class="p_Normal">Packed server dependencies can be used in server script code.</p>
<h2 class="p_Heading2"><a id="npm-package-powershell-windows" class="hmanchor"></a><span class="f_Heading2">Building a package with server dependencies using a PowerShell script for Windows</span></h2>
<li value="4" class="p_Normal">Загрузите пакет в систему. Это можно сделать в <a href="client_server_scripts.html" class="topiclink">настройках виджета</a> в дизайнере интерфейсов и в пользовательском модуле при создании <a href="extention-api.html" class="topiclink">метода API</a>: добавьте полученный архив с зависимостями на вкладке <span style="font-weight: bold;">Файлы</span>.</li></ol>
<p class="p_Normal">Упакованные серверные зависимости можно использовать в коде серверного скрипта.</p>
<h2 class="p_Heading2"><a id="npm-package-powershell-windows" class="hmanchor"></a><span class="f_Heading2">Сборка пакета с серверными зависимостями помощью PowerShell-скрипта для Windows</span></h2>
<ol style="list-style-type:upper-roman">
<li value="1" class="p_Normal">Create an empty folder on your computer. Copy the script below and save it as a file named <span style="font-weight: bold;">makedeps.ps1</span> in the created folder:</li></ol>
<li value="1" class="p_Normal">Создайте пустую папку на своём компьютере. Скопируйте приведённый ниже скрипт и сохраните его как файл с названием <span style="font-weight: bold;">makedeps.ps1</span> в созданной папке:</li></ol>
<p class="p_CodeExample" style="white-space: normal; page-break-inside: avoid;"><span class="f_CodeExample">$ErrorActionPreference</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">=</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">&quot;SilentlyContinue&quot;</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">#This</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">will</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">hide</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">errors</span><br />
<span class="f_CodeExample">Remove-Item</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-Recurse</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-Force</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">.\deps</span><br />
<span class="f_CodeExample">$ErrorActionPreference</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">=</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">&quot;Continue&quot;</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">#Turning</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">errors</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">back</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">on</span><br />
@ -153,60 +156,60 @@
<span class="f_CodeExample">docker</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">run</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-v</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">${PWD}:/data</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-w</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">/data</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">--platform</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">linux/amd64</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">--rm</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">busybox:stable</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">tar</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-zcf</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">dependencies.tar.gz</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-C</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">/data/deps</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">node_modules</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">package.json</span><br />
<span class="f_CodeExample">Remove-Item</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-Recurse</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">-Force</span><span class="f_CodeExample" style="color: #ffffff;"> </span><span class="f_CodeExample">.\deps</span></p>
<ol style="list-style-type:upper-roman" start="2">
<li value="2" class="p_Normal">Run the script, passing a list of npm packages as parameters. For example, for the XLSX package: </li></ol>
<li value="2" class="p_Normal">Запустите скрипт, передав в качестве параметров список npm-пакетов. Например, для пакета XLSX: </li></ol>
<p class="p_CodeExample" style="white-space: normal; page-break-inside: avoid;"><span class="f_CodeExample">$./makedeps.ps1 xlsx semver</span></p>
<p class="p_Normal">As a result of the command execution, an archive with dependencies named <span style="font-weight: bold;">dependencies.tar.gz</span>.</p>
<p class="p_Normal">В результате выполнения команды сформируется архив с зависимостями <span style="font-weight: bold;">dependencies.tar.gz</span>.</p>
<ol style="list-style-type:upper-roman" start="3">
<li value="3" class="p_Normal">Upload the package to the system; this can be done in the <a href="client_server_scripts.html" class="topiclink">widget settings</a> in the interface designer and in the custom module when creating an <a href="extention-api.html" class="topiclink">API method</a>: add the obtained dependencies archive on the <span style="font-weight: bold;">Files</span> tab.</li></ol>
<p class="p_Normal">Packed server dependencies can be used in server script code.</p>
<h2 class="p_Heading2"><span class="f_Heading2">Module connection features</span></h2>
<p class="p_Normal">Pay attention to some features of importing components when connecting modules.</p>
<div style="text-align: left; text-indent: 0; line-height: 1.80; padding: 0 0 0 0; margin: 0 0 0 0;"><table style="border:none; border-spacing:0;">
<li value="3" class="p_Normal">Загрузите пакет в систему. Это можно сделать в <a href="client_server_scripts.html" class="topiclink">настройках виджета</a> в дизайнере интерфейсов и в пользовательском модуле при создании <a href="extention-api.html" class="topiclink">метода API</a>: добавьте полученный архив с зависимостями на вкладке <span style="font-weight: bold;">Файлы</span>.</li></ol>
<p class="p_Normal">Упакованные серверные зависимости можно использовать в коде серверного скрипта.</p>
<h2 class="p_Heading2"><span class="f_Heading2">Особенности подключения модулей</span></h2>
<p class="p_Normal">Обратите внимание на особенности импорта компонентов при подключении модулей.</p>
<div style="text-align: left; text-indent: 0; padding: 0 0 0 0; margin: 0 0 0 0;"><table style="border:none; border-spacing:0;">
<tr>
<td colspan="2" style="vertical-align:top; width:950px; padding:0; border:none"><p class="p_Normal"><span style="font-weight: bold;">In custom scripts</span></p>
<td colspan="2" style="vertical-align:top; width:950px; padding:0; border:none"><p class="p_Normal"><span style="font-weight: bold;">В пользовательских скриптах</span></p>
</td>
</tr>
<tr>
<td style="vertical-align:top; width:477px; height:15px; padding:0; border:none"><p class="p_Normal">can be imported:</p>
<td style="vertical-align:top; width:477px; padding:0; border:none"><p class="p_Normal">можно импортировать:</p>
</td>
<td style="vertical-align:top; width:473px; height:15px; padding:0; border:none"><p class="p_Normal">cannot be imported:</p>
<td style="vertical-align:top; width:473px; padding:0; border:none"><p class="p_Normal">нельзя импортировать:</p>
</td>
</tr>
<tr>
<td style="vertical-align:top; width:477px; padding:0; border:none"><ul style="list-style-type:disc">
<li class="p_Normal">modules from <span style="font-weight: bold;">package.json</span> (dependencies section).</li></ul>
<li class="p_Normal">модули из <span style="font-weight: bold;">package.json</span> (раздел dependencies).</li></ul>
</td>
<td style="vertical-align:top; width:473px; padding:0; border:none"><ul style="list-style-type:disc">
<li class="p_Normal">transitive dependencies;</li></ul>
<li class="p_Normal">транзитивные зависимости;</li></ul>
<ul style="list-style-type:disc">
<li class="p_Normal">host modules (in relation to <a href="https://nodejs.org/docs/latest-v14.x/api/cluster.html#cluster_class_worker" target="_blank" class="weblink">worker</a>);</li></ul>
<li class="p_Normal">модули хоста (по отношению к <a href="https://nodejs.org/docs/latest-v14.x/api/cluster.html#cluster_class_worker" target="_blank" class="weblink">worker</a>);</li></ul>
<ul style="list-style-type:disc">
<li class="p_Normal">built-in <span style="font-weight: bold;">node.js </span>modules<span style="font-weight: bold;"> </span>(fs, path, tty, etc.).</li></ul>
<li class="p_Normal">встроенные модули <span style="font-weight: bold;">node.js</span> (fs, path, tty и т. д.).</li></ul>
</td>
</tr>
<tr>
<td colspan="2" style="vertical-align:top; width:950px; padding:0; border:none"><p class="p_Normal"><span style="font-weight: bold;">In external modules imported into the script</span></p>
<td colspan="2" style="vertical-align:top; width:950px; padding:0; border:none"><p class="p_Normal"><span style="font-weight: bold;">Внутри внешних модулей импортируемых в скрипте</span></p>
</td>
</tr>
<tr>
<td style="vertical-align:top; width:477px; padding:0; border:none"><p class="p_Normal">can be imported:</p>
<td style="vertical-align:top; width:477px; padding:0; border:none"><p class="p_Normal">можно импортировать:</p>
</td>
<td style="vertical-align:top; width:473px; padding:0; border:none"><p class="p_Normal">cannot be imported:</p>
<td style="vertical-align:top; width:473px; padding:0; border:none"><p class="p_Normal">нельзя импортировать:</p>
</td>
</tr>
<tr>
<td style="vertical-align:top; width:477px; padding:0; border:none"><ul style="list-style-type:disc">
<li class="p_Normal">any other modules present in the dependencies directory.;</li></ul>
<li class="p_Normal">любые другие модули, присутствующие в директории с зависимостями;</li></ul>
<ul style="list-style-type:disc">
<li class="p_Normal">built-in <span style="font-weight: bold;">node.js </span>modules (fs, path, tty, etc.).</li></ul>
<li class="p_Normal">встроенные модули <span style="font-weight: bold;">node.js</span> (fs, path, tty и т. д.).</li></ul>
</td>
<td style="vertical-align:top; width:473px; padding:0; border:none"><ul style="list-style-type:disc">
<li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;">host modules (in relation to <a href="https://nodejs.org/docs/latest-v14.x/api/cluster.html#cluster_class_worker" target="_blank" class="weblink">worker</a>).</li></ul>
<li style="line-height: 1.28; margin-top: 0; margin-right: 0; margin-bottom: 11px;">модули хоста (по отношению к <a href="https://nodejs.org/docs/latest-v14.x/api/cluster.html#cluster_class_worker" target="_blank" class="weblink">worker</a>).</li></ul>
</td>
</tr>
</table>
</div>
<p class="p_Normal">TypeScript compilation on the server is performed with the following <span style="font-weight: bold;">tsconfig</span> parameters:</p>
<p class="p_Normal">Компиляция TypeScript на сервере выполняется со следующими параметрами <span style="font-weight: bold;">tsconfig</span>:</p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">{</span><br />
<span class="f_CodeExample">&nbsp;&nbsp;&nbsp;&nbsp;allowJs:&nbsp;</span><span class="f_CodeExample" style="font-weight: bold;">true</span><span class="f_CodeExample">,</span><br />
<span class="f_CodeExample">&nbsp;&nbsp;&nbsp;&nbsp;checkJs:&nbsp;</span><span class="f_CodeExample" style="font-weight: bold;">false</span><span class="f_CodeExample">,</span><br />
@ -221,22 +224,23 @@
<span class="f_CodeExample">&nbsp;&nbsp;&nbsp;&nbsp;typeRoots:&nbsp;['node_modules/@types',&nbsp;'node_modules'],</span><br />
<span class="f_CodeExample">&nbsp;&nbsp;&nbsp;&nbsp;lib:&nbsp;['es2016']</span><br />
<span class="f_CodeExample">}</span></p>
<p class="p_Normal">Note that not all npm packages work with these parameters without modifications. You may need to wrap them in a thin layer compatible with CommonJS or AMD.</p>
<h2 class="p_Heading2"><span class="f_Heading2">Supported JavaScript module systems</span></h2>
<p class="p_Normal">As server-side dependencies, you can use modules based on two JavaScript module systems: CommonJS and UMD (Universal Module Definition).</p>
<h3 class="p_Heading3"><span class="f_Heading3">Module import examples</span></h3>
<p class="p_Normal">Using the CommonJS module as an example, let's look at how to import it. Let's say a module contains one function and one constant:</p>
<p class="p_CodeExample" style="white-space: normal; page-break-inside: avoid;"><span class="f_CodeExample">function add(a, b) {</span><br />
<span class="f_CodeExample"> return a + b;</span><br />
<p class="p_Normal">Обратите внимание, не все npm-пакеты работают с такими параметрами без изменений. Возможно, вам понадобится обернуть их в тонкую прослойку, совместимую с CommonJS или AMD.</p>
<h2 class="p_Heading2"><span class="f_Heading2">Поддерживаемые модульные системы JavaScript</span></h2>
<p class="p_Normal">В качестве серверных зависимостей вы можете использовать модули на основе двух модульных систем JavaScript: CommonJS и UMD (Universal Module Definition).</p>
<h3 class="p_Heading3"><span class="f_Heading3">Примеры импорта модуля</span></h3>
<p class="p_Normal">На примере модуля CommonJS рассмотрим, как его импортировать.</p>
<p class="p_Normal">Допустим, модуль содержит одну функцию и одну константу:</p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">function&nbsp;add(a,&nbsp;b)&nbsp;{</span><br />
<span class="f_CodeExample">&nbsp;return&nbsp;a&nbsp;+&nbsp;b;</span><br />
<span class="f_CodeExample">}</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">const name = 'noname'</span><br />
<span class="f_CodeExample">const&nbsp;name&nbsp;=&nbsp;'noname'</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">module.exports = {</span><br />
<span class="f_CodeExample"> add,</span><br />
<span class="f_CodeExample"> name</span><br />
<span class="f_CodeExample">module.exports&nbsp;=&nbsp;{</span><br />
<span class="f_CodeExample">&nbsp;add,</span><br />
<span class="f_CodeExample">&nbsp;name</span><br />
<span class="f_CodeExample">}</span></p>
<p class="p_Normal">You can import such module in three ways:</p>
<p class="p_Normal">Такой модуль можно импортировать тремя способами:</p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">//&nbsp;1&nbsp;named&nbsp;import</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">import&nbsp;{&nbsp;add,&nbsp;name&nbsp;}&nbsp;from&nbsp;'module_name';</span><br />
@ -262,14 +266,16 @@
<span class="f_CodeExample">async&nbsp;function&nbsp;test():&nbsp;Promise&lt;void&gt;&nbsp;{</span><br />
<span class="f_CodeExample">&nbsp;&nbsp;&nbsp;Context.data.res&nbsp;=&nbsp;plus(1,&nbsp;3);</span><br />
<span class="f_CodeExample">}</span></p>
<p class="p_Normal">Module documentation frequently includes examples with <code><b>require</b></code> for import. Instead of using <code><b>require</b></code>, you can use <code><b>namespace import</b></code> as shown in the second example above:</p>
<p class="p_CodeExample" style="white-space: normal; page-break-inside: avoid;"><span class="f_CodeExample">var m = require('module_name');</span><br />
<p class="p_Normal">Часто документация к модулям содержит примеры, которые используют импорт с помощью <code><b>require</b></code>. Вместо него вы можете применить <code><b>namespace import</b></code>, как во втором примере выше:</p>
<p class="p_CodeExample" style="page-break-inside: avoid;"><span class="f_CodeExample">var&nbsp;m&nbsp;=&nbsp;require('module_name');</span><br />
<span class="f_CodeExample">m.example();</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">...</span><br />
<span class="f_CodeExample">&nbsp;</span><br />
<span class="f_CodeExample">import * as m from 'module_name';</span><br />
<span class="f_CodeExample">m.example();</span></p>
<span class="f_CodeExample">import&nbsp;*&nbsp;as&nbsp;m&nbsp;from&nbsp;'module_name';</span><br />
<span class="f_CodeExample">m.example();</span><br />
<span class="f_CodeExample">&nbsp;</span></p>
<p class="p_Normal">&nbsp;</p>
<div class="bottom-nav">
@ -286,7 +292,7 @@
</div>
<!-- добавляет на страницу строку блок Была ли статья полезной? -->
<div class="feedback" id="feedback"><div class="feedback-help"><span><b>Was this helpful?</b></span><form action="" method="POST" class="feedback-form" id="feedback-form"><div class="feedback__popup feedback__popup-response" id="feedback__popup_thx" style="display: none;">Thanks for your feedback!</div><div class="feedback__popup" id="feedback__popup_why" style="display: none;"><div class="feedback__popup-header">Please specify why:</div><input type="radio" name="category" id="bad_recommendation" value="bad_recommendation"><label for="bad_recommendation">Recommendations did not help me</label><input type="radio" name="category" id="difficult_text" value="difficult_text"><label for="difficult_text">Article is hard to understand</label><input type="radio" name="category" id="no_answer" value="no_answer"><label for="no_answer">Didn`t answer my question</label><input type="radio" name="category" id="bad_header" value="bad_header"><label for="bad_header">Content does not match the topic</label><input type="radio" name="category" id="other_reason" value="other_reason"><label for="other_reason">Other</label></div><div class="feedback__popup" id="feedback__popup-other" style="display: none;"><div class="feedback__popup-header">How we can improve it?</div><textarea class="feedback__textarea" name="other" id=""></textarea><input type="submit" class="feedback__other-btn" value="Submit"></div><div class="feedback-form__btn-group"><input type="radio" name="useful" id="feedback__useful_yes" value="true"><label for="feedback__useful_yes"><img src="like.svg" class="small-img" alt="like"><spanclass="feedback-form__btn-group_yes-btn">Yes</spanclass="feedback-form__btn-group_yes-btn"></label><input type="radio" name="useful" id="feedback__useful_no" value="false"><label for="feedback__useful_no"><img src="dislike.svg" class="small-img" alt="dislike"><spanclass="feedback-form__btn-group_no-btn">No</spanclass="feedback-form__btn-group_no-btn"></label></div><select name="category"><option disabled="">Please specify why</option><option value="bad_recommendation" selected="">Recommendations did not help me</option><option value="difficult_text">Article is hard to understand</option><option value="no_answer">Didn`t answer my question</option><option value="bad_header">Content does not match the topic</option><option value="other_reason">Other</option></select><input type="submit"></form></div><div class="found_typo"><p style="margin: 0px; margin-top: 16px !important;"><span><b>Found a typo?</b></span> Select it and press <i>Ctrl+Enter</i> to send us feedback</p></div></div>
<div class="feedback-wrap"><div class="feedback" id="feedback"><span><b>Была ли статья полезной?</b></span><form action="" method="POST" class="feedback-form" id="feedback-form"><div class="feedback__popup feedback__popup-response" id="feedback__popup_thx">Спасибо за ваш отзыв!</div><div id="feedback-success-popup"><div class="wrap"><button type="button" class="feedback-popup-close">×</button><svg width="44" height="44" viewBox="0 0 44 44" fill="none" xmlns="http://www.w3.org/2000/svg"><g clip-path="url(#clip0_212_2187)"><path d="M22 0.6875C10.2294 0.6875 0.6875 10.2294 0.6875 22C0.6875 33.7706 10.2294 43.3125 22 43.3125C33.7706 43.3125 43.3125 33.7706 43.3125 22C43.3125 10.2294 33.7706 0.6875 22 0.6875ZM22 40.5625C11.8023 40.5625 3.4375 32.3078 3.4375 22C3.4375 11.8024 11.6922 3.4375 22 3.4375C32.1977 3.4375 40.5625 11.6922 40.5625 22C40.5625 32.1976 32.3078 40.5625 22 40.5625ZM34.1713 16.933L18.6613 32.3186C18.257 32.7197 17.604 32.7171 17.203 32.3128L9.82283 24.873C9.42176 24.4686 9.42434 23.8157 9.82867 23.4146L10.5609 22.6884C10.9652 22.2873 11.6181 22.2899 12.0192 22.6942L17.9468 28.6697L31.9926 14.7366C32.3969 14.3356 33.0498 14.3382 33.4509 14.7425L34.1772 15.4747C34.5783 15.879 34.5757 16.532 34.1713 16.933Z" fill="#27AE60"></path></g><defs><clipPath id="clip0_212_2187"><rect width="44" height="44" fill="white"></rect></clipPath></defs></svg><p>Ваш отзыв успешно отправлен!</p><span>Спасибо за обратную связь.</span></div></div><div class="feedback__popup" id="feedback__popup_why"><button type="button" class="feedback-popup-close">×</button><div class="feedback__popup-header">Уточните, почему:</div><input type="radio" name="category" id="bad_recommendation" value="bad_recommendation"><label for="bad_recommendation">Рекомендации не помогли</label><input type="radio" name="category" id="difficult_text" value="difficult_text"><label for="difficult_text">Текст трудно понять</label><input type="radio" name="category" id="no_answer" value="no_answer"><label for="no_answer">Нет ответа на мой вопрос</label><input type="radio" name="category" id="bad_header" value="bad_header"><label for="bad_header">Содержание статьи не соответствует заголовку</label><input type="radio" name="category" id="other_reason" value="other_reason"><label for="other_reason">Другая причина</label></div><div class="feedback__popup" id="feedback__popup-other"><button type="button" class="feedback-popup-close">×</button> <div class="feedback__popup-header">Расскажите, что вам не понравилось в статье:</div><textarea class="feedback__textarea" name="other" id=""></textarea><input type="submit" class="feedback__other-btn" value="Отправить"></div><div class="feedback-form__btn-group"><input type="radio" name="useful" id="feedback__useful_yes" value="true"><label for="feedback__useful_yes"><img src="like.svg"/><span class="feedback-form__btn-group_yes-btn">Да</span></label><input type="radio" name="useful" id="feedback__useful_no" value="false"><label for="feedback__useful_no"><img src="dislike.svg"/><span class="feedback-form__btn-group_no-btn">Нет</span></label></div><select name="category"><option disabled>Выберите вариант</option><option value="bad_recommendation" selected>Рекомендации не помогли</option><option value="difficult_text">Текст трудно понять</option><option value="no_answer">Нет ответа на мой вопрос</option><option value="bad_header">Содержание статьи не соответствует заголовку</option><option value="other_reason">Другая причина</option></select><input type="submit"></form></div></div>
</section>
</div>
@ -294,7 +300,7 @@
<input type="checkbox" />
<div class="article__arrow"></div>
<div class="table-of-contents elma365-right" id="toc2Content">
<h3 class="h3-toc">In this topic</h3>
<h3 class="h3-toc">В этой статье</h3>
<nav id="toc2"></nav>
</div>
</aside>
@ -305,30 +311,63 @@
<div class="footer-container">
<div class="footer-mobile">
<ul class="footer-mobile__list"><li><a href="https://brix365.com/en/" target="_blank">BRIX</a></li><li><a href="https://tssdk.brix365.com/en/latest/" target="_blank">SDK</a></li><li><a href="https://api.brix365.com/en/" target="_blank">API</a></li></ul><ul class="footer-mobile__list"><li><a href="https://brix365.com/en/help/platform/get-trial.html">Platform</a></li><li><a href="https://brix365.com/en/help/ecm/ecm-functions.html">ECM</a></li><li><a href="https://brix365.com/en/help/service/service-functions.html">Service</a></li><li><a href="https://brix365.com/en/help/projects/projects-functions.html">Projects</a></li></ul>
<ul class="footer-mobile__list"><li><a href="https://api.elma365.com/ru/" target="_blank">API</a></li><li><a href="https://tssdk.elma365.com/" target="_blank">TS SDK</a></li><li><a href="https://community.elma365.com/" target="_blank">Community</a></li><li><a href="https://elma-academy.com/ru/elma365" target="_blank">Академия</a></li></ul><ul class="footer-mobile__list"><li><a href="https://elma365.com/ru/help/platform/get-trial.html">Платформа</a></li><li><a href="https://elma365.com/ru/help/ecm/ecm-functions.html">ECM</a></li><li><a href="https://elma365.com/ru/help/service/service-functions.html">Service</a></li><li><a href="https://elma365.com/ru/help/projects/projects-functions.html">Проекты</a></li></ul>
</div>
<div class="footer-wrap">
<div><span class="mobile-question-popup">Send feedback</span><form method="POST" action class="question__popup question-xs" id="question__popup"><div class="question-wrap"><span class="close"></span><span class="title">Ask a question</span><label for="help_question" style="display: none;"></label><textarea name="help_question" id="help_question"></textarea><input type="submit" value="Send"></div></form><div class="hidden fade-in question-success-xs">Sent</div></div>
<div class="footer-flex-b">
<span class="footer-copy">&copy; 2025 BRIX</span>
<ul class="footer-list">
<li class="footer-item">
<a href="#" class="arrow-top" style="display: block;"></a>
</li>
</ul>
<div class="container">
<div class="footer-wrap">
<div><span class="mobile-question-popup">Отправить фидбэк</span><form method="POST" action class="question__popup question-xs" id="question__popup"><div class="question-wrap"><span class="close"></span><span class="title">Задать вопрос</span><label for="help_question" style="display: none;"></label><textarea name="help_question" id="help_question"></textarea><input type="submit" value="Отправить"></div></form><div class="hidden fade-in question-success-xs">Ваш фидбэк отправлен.</div></div>
<div class="footer-flex-b">
<div class="footer-top">
<span class="footer-copy">&copy; 2025
ELMA365
</span>
<a href="https://navigator.sk.ru/orn/1122971" target="_blank">
<img src="sk-resident.svg" alt="sk icon" class="footer-img" width="117" height="34">
</a>
</div>
<div class="footer-line">
<div class="footer-line-copy">
<span class="footer-copy">&copy; 2025
ELMA365
</span>
</div>
<ul class="footer-list">
<li class="footer-item"><a href="https://elma365.com/ru/" target="_blank" class="footer-link" style="color: #0D4A75;"><img src="browse.svg" alt="browse icon" class="footer-img">elma365.com</a></li><li class="footer-item"><a href="https://www.youtube.com/user/ELMABPM" target="_blank" class="footer-link"><img src="yt.svg" alt="youtube icon" class="footer-img"></a></li><li class="footer-item"><a href="https://vk.com/elma_bpm" target="_blank" class="footer-link"><img src="vk.svg" alt="vk icon" class="footer-img"></a></li><li class="footer-item"><a href="https://t.me/elmaday" target="_blank" class="footer-link"><img src="tg.svg" alt="telegram icon" class="footer-img"></a></li><li class="footer-item"><a href="https://dzen.ru/elma" target="_blank" class="footer-link"><img src="dzen.svg" alt="dzen icon" class="footer-img"></a></li>
<li class="footer-item">
<a href="https://navigator.sk.ru/orn/1122971" target="_blank">
<img src="sk-resident.svg" alt="sk icon" class="footer-img" width="117" height="34">
</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<a href="#" class="arrow-top"></a>
</div>
</footer>
<!-- <script type="text/javascript" src="jquery1.min.js"></script>-->
<iframe name="hmnavigation" style="display:none!important"></iframe>
<script src="./jquery-ui.js"></script>
<!--<script src="./jquery-ui.js"></script> -->
<script src="./jquery-ui.min.js"></script>
<!--script src="//cdn.jsdelivr.net/npm/featherlight@1.7.14/release/featherlight.min.js" type="text/javascript" charset="utf-8"></script-->
<script src="./jquery.tocify.min.js"></script>
<script src="./TypoReporter.min.js"></script>