> For the complete documentation index, see [llms.txt](https://help.axatel.by/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.axatel.by/administrirovanie-telefonnoi-stancii/rabota-s-graficheskim-redaktorom-scenariev/blok-rabota-s-dannymi.md).

# Блок Работа с данными

### Файловая операция

<div align="left"><img src="/files/-MJHZAAfBhuhIaNfpiGS" alt=""></div>

Производит указанную дисковую операцию с файлом, каталогом, путем или содержимом файла. Для разных Типов объекта доступны разные Операции и разные свойства объекта.

![](/files/-MJHZFLcMLArh5Z_DCEp)

Файловая операция

| **Название**            | **Описание**                                                                                                                                                                                 |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Тип объекта             | Подробно описано ниже в Типы и операции работы с файлами                                                                                                                                     |
| Операции                |                                                                                                                                                                                              |
| Путь                    | Аргумент, содержащий путь.                                                                                                                                                                   |
| Отрезать расширение     | <p>При работе с получением файлов возможно указать вид получаемого ответа</p><ul><li> Да = имя файла с расширением</li><li>Нет = имя файла без расширения</li></ul>                          |
| Категория каталога      | При работе с каталогами возможно указать тип каталога. Подробнее в Типы каталогов                                                                                                            |
| другие поля             | В зависимости от Типа и Операции могут появляться другие однозначные поля (например, Путь источника, Путь назначения, Имя файла и т.д.). Подробно описано в Типы и операции работы с файлами |
| Результат в переменную  | Переменная для сохранения результата операции.                                                                                                                                               |
| Код ошибки в переменную | Переменная для сохранения кода ошибки операции.                                                                                                                                              |
| Переход                 | Компонент, которому передается управление в случае успешного завершения операции. Переход по умолчанию                                                                                       |
| Переход, не найдено     | Компонент, которому передается управление в случае, если объект по указанному пути отсутствует.                                                                                              |
| Переход, ошибка         | Компонент, которому передается управление в случае ошибки выполнения операции.                                                                                                               |
| Описание                | Описание компонента                                                                                                                                                                          |

#### Типы и операции работы с файлами

Операции и свойства различных типов объектов

| **Тип объекта**         | **Операция**                                                                                             | **Описание**                                                                                                        | **Доступные свойства**                                                               |
| ----------------------- | -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------ |
| Файл                    | Удалить                                                                                                  | Удаление файла                                                                                                      | •             Путь                                                                   |
| Скопировать             | Копирование определенного файла по указанному пути                                                       | <ul><li>Путь источника</li><li>Путь назначения</li></ul>                                                            |                                                                                      |
| Переместить             | Перемещение определенного файла по указанному пути                                                       | <ul><li>Путь источника</li><li>Путь назначения</li></ul>                                                            |                                                                                      |
| Переименовать           | Переименование файла                                                                                     | <ul><li>Путь источника</li><li>Путь назначения</li></ul>                                                            |                                                                                      |
| Проверить наличие       | Проверка наличия файла                                                                                   | <ul><li> Путь</li></ul>                                                                                             |                                                                                      |
| Размер                  | Определение размера файла в байтах                                                                       | <ul><li>Путь</li></ul>                                                                                              |                                                                                      |
| Хеш содержимого         | Вычисление md5 подписи к файлу                                                                           | <ul><li>Путь</li></ul>                                                                                              |                                                                                      |
| Создать путь            | Создание всех каталогов до указанного файла. Необходимо передавать с именем файла. Файл создан не будет. | <ul><li>Путь</li></ul>                                                                                              |                                                                                      |
| Путь                    | Тип пути                                                                                                 | Определение типа пути из строки.                                                                                    | <ul><li>Путь</li></ul>                                                               |
| Относительный путь      | Относительный путь после типа пути.                                                                      | <ul><li> Путь</li></ul>                                                                                             |                                                                                      |
| Имя файла               | Возвращает из пути имя файла                                                                             | <ul><li>Путь</li><li>Отрезать расширение</li></ul><p>–            Да</p><p>–            Нет</p>                     |                                                                                      |
| Расширение              | Определение расширение файла из строки полного пути                                                      | <ul><li>Путь</li></ul>                                                                                              |                                                                                      |
| Каталог                 | Определение каталога из строки полного пути                                                              | <ul><li>Путь</li></ul>                                                                                              |                                                                                      |
| Построить путь          | Создать строку пути (в результат) относительно типа каталога                                             | <ul><li>Тип каталога</li><li>Относительный путь</li></ul>                                                           |                                                                                      |
| Построить путь к файлу  | Создать строку пути с именем файла и расширения                                                          | <ul><li>Путь</li><li>Имя файла</li><li>Расширение</li></ul>                                                         |                                                                                      |
| Каталог                 | Создать                                                                                                  | <p>Создание всех каталогов из переменной, включая последний отрезок.<br> Необходимо передавать без имени файла.</p> | <ul><li>Путь</li></ul>                                                               |
| Удалить                 | Удаление каталога и его содержимого по указанному пути                                                   | <ul><li>Путь</li></ul>                                                                                              |                                                                                      |
| Скопировать             | Копирование каталога источника и его содержимого в каталог назначения                                    | <ul><li>Путь источника</li><li>Путь назначения</li></ul>                                                            |                                                                                      |
| Переместить             | Перемещение каталога источника и его содержимого в каталог назначения                                    | <ul><li>Путь источника</li><li>Путь назначения</li></ul>                                                            |                                                                                      |
| Переименовать           | Переименование каталога                                                                                  | <ul><li>Путь источника</li><li>Путь назначения</li></ul>                                                            |                                                                                      |
| Проверить наличие       | Проверка наличия указанного каталога                                                                     | <ul><li>Путь</li></ul>                                                                                              |                                                                                      |
| Количество файлов       | Подсчет количества файлов в текущем каталоге без дочерних                                                | <ul><li>Путь</li></ul>                                                                                              |                                                                                      |
| Количество подкаталогов | Подсчет количества подкаталогов в текущем                                                                | <ul><li>Путь</li></ul>                                                                                              |                                                                                      |
| Содержимое файла        | Создать файл                                                                                             | Создание файла в указанной кодировке                                                                                | <ul><li> Путь</li></ul><p>•             Кодировка</p><p>•             Содержимое</p> |
| Записать файл           | Запись данных в указанной кодировке в файл (перезаписывает существующий файл)                            | <ul><li>Путь</li><li>Кодировка</li><li>Содержимое</li></ul>                                                         |                                                                                      |
| Дописать в конец файла  | Запись данных в указанной кодировке в файл (дописывает в конец если файл существующий)                   | <ul><li>Путь</li><li>Кодировка</li><li>Содержимое</li></ul>                                                         |                                                                                      |
| Считать файл            | Считывание содержимого файла в указной Кодировке в переменную Результат.                                 | <ul><li>Путь</li><li>Кодировка</li></ul>                                                                            |                                                                                      |

#### Типы каталогов

При указании каталога можно выбрать один из следующих типов:

| **Тип каталога**          | **Описание**                                                                                     |
| ------------------------- | ------------------------------------------------------------------------------------------------ |
| SYNC\_COMMON              | Каталог общих данных всех доменов в синхронизирующемся между серверами каталоге.                 |
| SYNC\_DOMAIN\_COMMON      | Каталог общих данных домена в синхронизирующемся между серверами каталоге.                       |
| SYNC\_DOMAIN\_DATA        | Каталог данных домена в синхронизирующемся между серверами каталоге.                             |
| SYNC\_SCRIPT\_DATA        | Каталог данных сценария в синхронизирующемся между серверами.                                    |
| SITESHARE\_PUBLIC         | Каталог общих данных на сетевом диске сайтового хранилища, доступного всем серверам на сайте.    |
| SITESHARE\_DOMAIN\_DATA   | Каталог данных домена на сетевом диске сайтового хранилища, доступного всем серверам на сайте.   |
| SITESHARE\_SCRIPT\_DATA   | Каталог данных сценария на сетевом диске сайтового хранилища, доступного всем серверам на сайте. |
| GLOBALSHARE\_PUBLIC       | Каталог общих данных на сетевом диске глобального хранилища, доступного всем сайтам.             |
| GLOBALSHARE\_DOMAIN\_DATA | Каталог данных домена на сетевом диске глобального хранилища, доступного всем сайтам.            |
| GLOBALSHARE\_SCRIPT\_DATA | Каталог данных сценария на сетевом диске глобального хранилища, доступного всем сайтам.          |
| TEMP                      | Временный каталог текущего обработчика сценария. Удаляется через 5 секунд после его завершения.  |

### SQL-запрос

<div align="left"><img src="/files/-MJHZSR9b94J_NKeEVmx" alt=""></div>

Позволяет производить действия в БД, а также передавать параметры (на вход и на выход). В качестве параметров выступают переменные сценария. Обращение к БД происходит по одной из выбранных технологий: PSQL (Postgre SQL), ODBC.

В случае ошибки переход осуществляется по ветке «Ошибка», и в переменную «Код ошибки» возвращается соответствующий код исключения от БД.

Для PSQL параметры передаются через символ @, а для ODBC через символ соответствующего драйвера (может быть @, ?, :).

Результат записывается в переменные, которые по имени совпадают с названиями возвращаемых колонок из запроса

![](/files/-MJHZ_2zAWY6HDzQZdTX)

| **Название**      | **Описание**                                                                                                                                                                                                                                                                                                                                             |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| База Данных       | <p>БД для подключения.</p><ul><li>CDR – Собственная событийной потоковой БД домена.</li><li>Journal – Собственная журнальная БД домена.</li><li>Report – Собственная отчетная БД домена.</li><li>Другая – Другая БД.</li></ul>                                                                                                                           |
| Драйвер           | <p>(если База Данных = Другая)</p><ul><li>ODBC – подключение через драйвер ODBC.</li><li>PSQL – одключение через внутренний адаптер к PostgreSQL.</li></ul>                                                                                                                                                                                              |
| Строка соединения | <p>Пример для odbc драйвера</p><p>Driver={SQL Server Native Client 11.0};<br> Server=192.168.0.73,14350;<br> Database=testbase;<br> UID=test;<br> PWD=123;</p><p>Пример для psql драйвера</p><p>Driver={PostgreSQL Unicode(x64)};<br> Server=127.0.0.1;<br> Port=5433;<br> Database=r\_cdr\_central\_common;<br> Uid=rostellpgadmin;<br> Pwd=123456;</p> |
| Время,с           | Предельное время выполнения запроса. По достижению этого времени, если не получен ответ, будет переход по ветке “Переход, время”                                                                                                                                                                                                                         |
| Запрос            | <p>Тело SQL запрос, который будет отправлен в БД.</p><p>INSERT INTO EMPLOYEE (NR, FIRSTNAME, LASTNAME, GENDER)<br> VALUES (?, ?, ?, ?)</p>                                                                                                                                                                                                               |
| Параметры запроса | <p>Списочное значение, устанавливающее параметры для запроса.</p><p>pKey="sql\_integer", pValue=\[2,3],<br> pKey="sql\_varchar, 20", pValue=\["Sergey", "Alina"],<br> pKey="sql\_varchar, 20", pValue=\["Ivanov","Gallyamova"],<br> pKey="sql\_char, 1", pValue=\["M","F"].</p>                                                                          |
| Кодировка         | <p>Кодировка, в которой следует сохранить строковые значения в переменных.</p><ul><li>UTF-8</li><li>cp1251 – Кодовая страница windows-1251 (кириллица)</li></ul>                                                                                                                                                                                         |
| Код ошибки        | Переменная для сохранения кода ошибки.                                                                                                                                                                                                                                                                                                                   |
| Название ошибки   | Переменная для сохранения названия ошибки.                                                                                                                                                                                                                                                                                                               |
| Переход           | Компонент, которому передается управление после успешного завершения запроса.                                                                                                                                                                                                                                                                            |
| Переход, время    | Компонент, которому передается управление после истечения таймаута до получения ответа на запрос.                                                                                                                                                                                                                                                        |
| Переход, ошибка   | Компонент, которому передается управление в случае возникновения ошибки при подготовке или выполнении запроса.                                                                                                                                                                                                                                           |
| Описание          | Описание компонента                                                                                                                                                                                                                                                                                                                                      |

Если необходимо вернуть множество строк в ответе, то в SQL запросе необходимо сделать "сохранение в json структуру" и уже компонентом Парсер разобрать результат. В зависимости от СУБД трансформация в json будет различная

### Web-запрос

<div align="left"><img src="/files/-MJHZjF8oSc0cDRvpQw2" alt=""></div>

Позволяет выполнять HTTP- и HTTPS- запросы к web-сервисам, настроенным в Каналах интеграции. Поддерживает методы GET, POST, PUT, HEAD, DELETE, PATCH, TRACE, OPTIONS с контентом и без. Поддерживает отправку асинхронных запросов и запросов с ожиданием ответов.

В случае ошибки переход осуществляется по ветке «Ошибка», и в переменную «Код ошибки» возвращается соответствующий код HTTP. Компонент поддерживает работу в сессиях, сохраняя и используя cookie, а также HTTPS и подтверждение сертификатов.

Фактическая отправка запроса может производиться как с сервера, на котором работает текущий обработчик сценария, так и с других серверов текущего сайта от имени роли WS.

![](/files/-MJHZogskdxqOPWm4Yrc)

Web-запрос

| **Название**               | **Описание**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Прокси                     | <p>Использовать ли прокси сервер для подключения:</p><p>•             Нет. Прямой запрос</p><p>•             Да. Запрос через прокси сервер. Дополнительно надо определить:</p><p>\* Адрес прокси - IP/fqdn прокси сервера<br> \* Порт прокси - Port прокси сервера<br> \* Аутентификация:<br> \*\* Да - необходима аутентификация на прокси<br> \*\*\* Логин прокси<br> \*\*\* Пароль прокси<br> \*\* Нет - прокси без аутентификации</p>                                                                                                                                                                                                                 |
| Макс. перенаправлений      | Ограничение на максимальное число перенаправлений. Значение для HTTP-заголовка Max-Forwards. При каждом перенаправлении cookie-файлы накапливаются и передаются дальше.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Источник канала интеграции | <p>Способ выбора канала интеграции, через URL которого отправлять HTTP-запрос.</p><ul><li>Из списка - необходимо в поле Канал интеграции выбрать канал</li><li>По коду - необходимо в поле Код канала интеграции ввести аргументом Код канала интеграции, который настроен в системе.</li></ul>                                                                                                                                                                                                                                                                                                                                                            |
| Страница                   | Аргумент, содержащий страницу (endpoint, левая часть URL адреса) Итоговый URL для запроса формируется на основании URL канала интеграции и указанной страницы.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Источник запроса           | <p>Адрес сервера, с которого необходимо отправить запрос. По умолчанию запрос отправляется с сервера, где обработчик выполняет сценарий. Возможные форматы указания:</p><p>\* RoleId<br> \* RoleId:Iface<br>    ,где<br>       - RoleId – идентификатор роли в конфигурации, по роли определяется нода;<br>       - Iface – адрес сетевого интерфейса на сервере.</p>                                                                                                                                                                                                                                                                                      |
| Метод                      | <ul><li>POST</li><li>GET</li><li>PUT</li><li>HEAD</li><li>DELETE</li><li>PATCH</li><li>TRACE</li><li>OPTIONS</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Базовая аутентификация     | <ul><li>Да - необходима базовая аутентификация (дополнительно надо ввести аргументы для полей Логин и Пароль)</li><li>Нет - без базовой аутентификации</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| Заголовки                  | <p>Позволяет переопределить некоторые стандартные заголовки, а также установить новые персональные заголовки.<br> Вид:</p><p>HeaderName1: Value1<br> HeaderName2: Value2</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Куки                       | <p>Позволяет установить дополнительные cookie значения.<br> Строковый аргумент, подразумевающий присутствие одного или нескольких дуплетов "ключ=значение", разделенных переводом строки (вид аналогичный “Заголовки”).</p>                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Режим                      | <p>Режим работы компонента после отправки запроса. Возможные варианты:</p><ul><li>Ожидание результата – Ожидание ответа от удаленной стороны без ограничения по времени.</li><li>Асинхронный запуск – Управление сразу передается следующему компоненту.</li><li>Обрыв по таймауту – Ожидание ответа в течение установленного времени, по истечению которого HTTP-подключение разрывается и управление передается следующему компоненту.</li><li>Выход по таймауту – Ожидание ответа в течение установленного времени, по истечению которого управление передается следующему компоненту без разрыва подключения и прерывания процесса отправки.</li></ul> |
| Время, с                   | (для режимов Обрыв по таймауту и Выход по таймауту) Количество секунд ожидания ответа.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Заголовки ответа           | (для всех режимов кроме Асинхронный) Сохранение заголовков ответа.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Ответ                      | (для всех режимов кроме Асинхронный) Сохранение тела ответа.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| Кодировка ответа           | <p>(для всех режимов кроме Асинхронный)</p><ul><li> Авто из заголовка</li><li>Авто из тела</li><li>Unicode</li><li>UTF-8</li><li>UTF-7</li><li>Windows-1251</li><li>Указать название – Задать название кодировки вручную.</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Ошибка                     | Переменная для сохранения HTTP-кода ошибки.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Переход                    | Компонент, которому передается управление в случае успешного завершения операции асинхронной отправки, либо получения HTTP-ответа. Переход по-умолчанию.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Переход, ошибка            | Компонент, которому передается управление в случае ошибки отправки запроса, либо получения неудачного ответа (коды 4xx – 6xx).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| Описание                   | Описание компонента                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |

Адрес запроса формируется как поле URL из канала интеграции + значение из поля Страница

### Отправка сообщения в websocket-подключение

<div align="left"><img src="/files/-MJHZw9U5w1PZbzrkWHc" alt=""></div>

Осуществляет отправку сообщения в websocket-подключение пользователя системы. Подключение должно существовать и быть активным. Каждое подключение идентифицируется внутренним ID Аксател, который можно получить при входящих сообщениях от клиента.\
&#x20;Хранить текущий ID websocket подключения можно в объекте Адресная книга или extObj (доступ через компонент Операция)

![](/files/-MJH_31BkbBEqDoDYpfR)

Отправка сообщения в websocket-подключение

| **Название**     | **Описание**                                                                                           |
| ---------------- | ------------------------------------------------------------------------------------------------------ |
| Операция         | Доступна одна операция - Отправить. Отправляет сообщение в websocket-подключение.                      |
| Ид подключения   | Идентификатор websocket-подключения.                                                                   |
| Сообщение        | Тело сообщения.                                                                                        |
| Ожидать доставки | Выключатель синхронного режима ожидания доставки сообщения до приложения адресата.                     |
| Время, с         | Таймаут ожидания доставки сообщения, в секундах.                                                       |
| Ошибка           | Переменная для сохранения ошибки.                                                                      |
| Переход          | Компонент, которому передается управление в случае успешного завершения операции. Переход по-умолчанию |
| Переход, время   | Компонент, которому передается управление в случае истечения таймаута ожидания доставки сообщения.     |
| Переход, ошибка  | Компонент, которому передается управление в случае возникновения ошибки.                               |

### Парсер

<div align="left"><img src="/files/-MJH_9DsQh9gFFZs207b" alt=""></div>

Осуществляет разбор различных структур данных для выделения необходимого результата. Может работать с

* JSON-структурами
* XML-структурами
* HTML- структурами
* текстовыми документами

На уровне сценария могут быть организованы циклы и условия. Наиболее частое использование для разбора ответов от компонентов Web-запрос, Монитор и Операция.

![](/files/-MJH_FIEos6zlvkz7sKd)

| **Название**           | **Описание**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Документ               | Аргумент, содержащий структуру, подлежащую разбору.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Алгоритм               | <ul><li>Парсер JSON – Применяет алгоритм поиска в JSON структуре.<br></li><li>Парсер XML - Применяет алгоритм поиска в XML документе.<br></li><li>Регулярные выражения – Применяет стандартный алгоритм регулярных выражений. Осуществляет поиск элементов по поисковому шаблону. В общем случае обнаруживает несколько элементов. Для выдачи содержимого необходимо указать номер элемента и номер группы (если в шаблоне используется захват групп).<br></li><li>Парсер HTML – Применяет алгоритм поиска в HTML документе. Синтаксис описан в . Допускает отсутствие закрывающих тегов (в отличие от XML).</li></ul> |
| Поисковый запрос       | Строка с поисковым запросом для выбранного алгоритма. Подробно описано в Правила поиска различных алгоритмов Парсера                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Функция                | В зависимости от алгоритма используются различные функции. Подробнее в Функции различных алгоритмов Парсера                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Номер элемента         | (только для алгоритма Регулярные выражения) Указывает индекс элемента в списке элементов, обнаруженных по шаблону в исходном документе. Нумерация начинается с 0.                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Номер группы           | (только для алгоритма Регулярные выражения) Указывает номер группы в списке захваченных групп выбранного элемента. Имеет значение только при указании в поисковом запросе групп захвата (выделяются круглыми скобками в соответствии с синтаксисом регулярных выражений).                                                                                                                                                                                                                                                                                                                                              |
| Номер атрибута         | (только для алгоритмов xml и html) Указывает номер атрибута                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Имя атрибута           | (только для алгоритмов xml и html) Указывает имя атрибута                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Результат в переменную | Переменная, в которую будет сохранен результат применения поискового запроса к документу.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Ошибка в переменную    | Переменная, в которую сохраняется текст ошибки.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Переход                | Компонент, на который передается управление. Переход по-умолчанию                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Переход, ошибка        | Компонент, на который передается управление в случае ошибки                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| Описание               | Описание компонента                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |

#### Функции различных алгоритмов Парсера

**Функция для алгоритма Парсер JSON.**

| **Вариант**                | **Описание**                                         |
| -------------------------- | ---------------------------------------------------- |
| Содержимое                 | Возвращает обнаруженный элемент вместе с содержимым. |
| Восстановленное содержимое | В ответе убраны внешние признаки JSON элемента       |
| Количество элементов       | Возвращает количество найденных элементов.           |
| Список ключей              | Возвращает список ключей в найденном объекте.        |

**Функция для алгоритма Парсер XML.**

| **Вариант**          | **Описание**                                                     |
| -------------------- | ---------------------------------------------------------------- |
| Документ             | Возвращает выбранный элемент целиком вместе с содержимым.        |
| Содержимое           | Возвращает содержимое выбранного элемента, исключая сам элемент. |
| Количество элементов | Возвращает количество обнаруженных элементов.                    |
| Значение атрибута    | Возвращает значение указанного атрибута выбранного элемента.     |
| Имя атрибута         | Возвращает имя атрибута по его индексу в выбранном элементе.     |
| Количество атрибутов | Возвращает количество атрибутов в выбранном элементе.            |

**Функция для алгоритма Регулярные выражения.**

| **Вариант**          | **Описание**                                                                                                                                                                                                                                                                                                                                                                                                                           |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Содержимое           | Возвращает содержимое указанной группы из указанного элемента. Отсчет элементов с 1 (значение по умолчанию), отсчет групп с 0 (значение по умолчанию 1), причем нулевая группа – это полное содержание элемента. Применение в поисковом шаблоне группировок (круглые скобки) влечет необходимость указывать корректное значение интересующей группы, указание неподходящего индекса приводит к завершению работы компонента с ошибкой. |
| Количество элементов | Возвращает количество обнаруженных элементов, соответствующих поисковому шаблону.                                                                                                                                                                                                                                                                                                                                                      |
| Количество групп     | Возвращает количество захваченных групп в обнаруженном элементе с указанным индексом. Необходимо указание номера элемента, по умолчанию 1. Если группировка в поисковом шаблоне не используется, то возвращается значение 0.                                                                                                                                                                                                           |

**Функция для алгоритма Парсер HTML.**

| **Вариант**          | **Описание**                                                     |
| -------------------- | ---------------------------------------------------------------- |
| Документ             | Возвращает выбранный элемент целиком вместе с содержимым.        |
| Содержимое           | Возвращает содержимое выбранного элемента, исключая сам элемент. |
| Количество элементов | Возвращает количество обнаруженных элементов.                    |
| Значение атрибута    | Возвращает значение указанного атрибута выбранного элемента.     |
| Имя атрибута         | Возвращает имя атрибута по его индексу в выбранном элементе.     |
| Количество атрибутов | Возвращает количество атрибутов в выбранном элементе.            |

#### Правила поиска различных алгоритмов Парсера

**Алгоритм JSON**

Запросом к парсеру JSON является строка, определяющая ключи свойств объектов или номера элементов в массиве, разделенных символом /.\
&#x20;При выполнении запроса слева направо парсер на каждом этапе углубляется внутрь структуры JSON.

Пример исходного json

```typescript
{
   "result": "ok",
   "errormsg": "",
   "chat": [
     {
       "sessId": "uvajoqnx0qcpbjoflxr",
       "msgs": [
         {
           "msgId": 8255,
           "msgDt": 1491292390,
           "msgData": {
             "type": "text",
             "data": "Добрый день. Выберите интересующий Вас вопрос."
           },
           "msgSender": "op"
         },
         {
           "msgId": 8256,
           "msgDt": 1491292391,
           "msgData": {
             "type": "buttons",
             "data": "Связаться с usr 6"
           },
           "msgSender": "ab"
         },
         {
           "msgId": 8257,
           "msgDt": 1491292392,
           "msgData": {
             "type": "buttons",
             "data": "Связаться с usr 8"
           },
           "msgSender": "ab"
         }
       ]
     }
   ]
 }
```

| **Запрос**                                  | **Функция**   | **Результат**                                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------- | ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "chat"/0/"sessId"                           | Содержимое    | uvajoqnx0qcpbjoflxr                                                                                                                                                                                                                                                                                                                                                                                                                    |
| Количество элементов                        | 1             |                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| "chat"/0/"msgs"("msgSender":"ab")/1/"msgId" | Содержимое    | 8257                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| Количество элементов                        | 1             |                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| "chat"/0/"msgs"("msgSender":"ab")           | Содержимое    | <p> \[<br>    {<br>      "msgId": 8256,<br>      "msgDt": 1491292391,<br>      "msgData": {<br>        "type": "buttons",<br>        "data": "Связаться с usr 6"<br>      },<br>      "msgSender": "ab"<br>    },<br>    {<br>      "msgId": 8257,<br>      "msgDt": 1491292392,<br>      "msgData": {<br>        "type": "buttons",<br>        "data": "Связаться с usr 8"<br>      },<br>      "msgSender": "ab"<br>    }<br>  ]</p> |
| Количество элементов                        | 2             |                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| "chat"/0                                    | Список ключей | \["sessId","msgs"]                                                                                                                                                                                                                                                                                                                                                                                                                     |

**Алгоритм XML**

Пример документа XML:

```markup
<configuration version="16">
     <folder id="x.demo.rostell.ru" label="x.demo.rostel.ru" path="c:\rtx_mg3\Media\domains\x.demo.rostell.ru.ru" type="readwrite" rescanIntervalS="10" ignorePerms="false" autoNormalize="true">
         <device id="RXYYDPI-SVKNBMF-YADG7WD"></device>
         <minDiskFreePct>1</minDiskFreePct>
         <versioning></versioning>
         <copiers>0</copiers>
         <pullers>0</pullers>
         <hashers>0</hashers>
         <order>random</order>
     </folder>
     <folder id="demo.rostell.ru" label="demo.rostell.ru" path="c:\rtx_mg3\Media\domains\demo.rostell.ru" type="readwrite" rescanIntervalS="10" ignorePerms="false" autoNormalize="true">
         <device id="RXYYDPI-SVKNBMF-01020304"></device>
         <minDiskFreePct>1</minDiskFreePct>
         <versioning></versioning>
         <copiers>0</copiers>
         <pullers>0</pullers>
         <hashers>0</hashers>
         <order>random</order>
     </folder>
     <gui enabled="true" tls="false" debugging="false">
         <address>127.0.0.1:8384</address>
         <apikey>jeopL9MghPvTmweKDeGcoXhwRtrdaVDP</apikey>
         <theme></theme>
     </gui>
 </configuration>
```

| **Запрос**                                                         | **Функция**                                                                                                                                                                                                             | **Результат**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "configuration"/0/"folder"                                         | Документ                                                                                                                                                                                                                | <p>    \<folder id="x.demo.rostell.ru" label="x.demo.rostel.ru" path="c:\rtx\_mg3\Media\domains\x.demo.rostell.ru.ru" type="readwrite" rescanIntervalS="10" ignorePerms="false" autoNormalize="true"><br>         \<device id="RXYYDPI-SVKNBMF-YADG7WD">\</device><br>         \<minDiskFreePct>1\</minDiskFreePct><br>         \<versioning>\</versioning><br>         \<copiers>0\</copiers><br>         \<pullers>0\</pullers><br>         \<hashers>0\</hashers><br>         \<order>random\</order><br>     \</folder><br>     \<folder id="demo.rostell.ru" label="demo.rostell.ru" path="c:\rtx\_mg3\Media\domains\demo.rostell.ru" type="readwrite" rescanIntervalS="10" ignorePerms="false" autoNormalize="true"><br>         \<device id="RXYYDPI-SVKNBMF-YADG7WD">\</device><br>         \<minDiskFreePct>1\</minDiskFreePct><br>         \<versioning>\</versioning><br>         \<copiers>0\</copiers><br>         \<pullers>0\</pullers><br>         \<hashers>0\</hashers><br>         \<order>random\</order><br>     \</folder></p> |
| "configuration"/0/"folder"("id":"x.demo.rostell.ru")/0/"device"/0/ | Документ                                                                                                                                                                                                                | \<device id="RXYYDPI-SVKNBMF-YADG7WD"/>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| "configuration"/0/"folder"("id":"x.demo.rostell.ru")               | Документ                                                                                                                                                                                                                | <p>    \<folder id="x.demo.rostell.ru" label="x.demo.rostel.ru" path="c:\rtx\_mg3\Media\domains\x.demo.rostell.ru.ru" type="readwrite" rescanIntervalS="10" ignorePerms="false" autoNormalize="true"><br>         \<device id="RXYYDPI-SVKNBMF-YADG7WD">\</device><br>         \<minDiskFreePct>1\</minDiskFreePct><br>         \<versioning>\</versioning><br>         \<copiers>0\</copiers><br>         \<pullers>0\</pullers><br>         \<hashers>0\</hashers><br>         \<order>random\</order><br>     \</folder></p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Содержимое                                                         | <p>\<device id="RXYYDPI-SVKNBMF-YADG7WD"/><br> \<minDiskFreePct>1\</minDiskFreePct><br> \<versioning/><br> \<copiers>0\</copiers><br> \<pullers>0\</pullers><br> \<hashers>0\</hashers><br> \<order>random\</order></p> |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p>Значение атрибута.<br> Имя атрибута: "type"</p>                 | readwrite                                                                                                                                                                                                               |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| <p>Имя атрибута.<br> Номер атрибута: 1</p>                         | id                                                                                                                                                                                                                      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Количество атрибутов                                               | 7                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

**Алгоритм HTML**

Общие правила:

* Поиск по наименованию тега в двойных кавычках, например "br"<br>
* Последовательность тегов формируется разделителем |, например "html"|"head"|"title"<br>
* Получения одного из одинаковых тегов производится добавлением индекса после разделителя тега (начиная с нуля), например "html"|"br"|1|"title"<br>
* По умолчанию переход к поиску следующего тега происходит с выбором нулевого тега.<br>
* Запрос "html"|0|"head"|0|"title"|0 равносилен запросу "html"|"head"|"title", т.е запрос по имени тега всегда возвращает список.<br>
* Запрос можно строить по индексам, например "0|0|1"<br>
* Для обращений к атрибутам тега используется скобки.<br>
* Запрос "html"|"head"|("charset") выдаст список родительских тегов "head" в которых присутствует атрибут "charset".<br>
* Запрос "html"|"head"|("type="test/css") выдаст список родительских тегов "head" в которых атрибут "type" равен "test/css".

Пример документа HTML:

```markup
<HTML>
     <HEAD>
          <META a="1" b="2"/>
     </HEAD>
     <BODY>
         <p id="x1" class="abc">abc abc
         <a href="http://asdf.ru">link</a> <br>
         </p>
         <br><br>
         <p id="x2" class="abc" v="123">zxcv zxcv</p>
     </BODY>
 </HTML>
```

| **Запрос**                                     | **Функция**                                                                                                                                                                                               | **Результат**                                                                                                                                                                                                                          |
| ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ("id"="x1")                                    | Документ                                                                                                                                                                                                  | <p>\<p id="x1" class="abc">abc abc<br> \<a href="[http://asdf.ru">link\&#x3C;/a>](https://help.axatel.by/administrirovanie-telefonnoi-stancii/rabota-s-graficheskim-redaktorom-scenariev/http:/asdf.ru">link\&#x3C;/a>) \<br>\</p></p> |
| Содержимое                                     | <p>abc abc<br> \<a href="[http://asdf.ru">link\&#x3C;/a>](https://help.axatel.by/administrirovanie-telefonnoi-stancii/rabota-s-graficheskim-redaktorom-scenariev/http:/asdf.ru">link\&#x3C;/a>) \<br></p> |                                                                                                                                                                                                                                        |
| Количество элементов                           | 1                                                                                                                                                                                                         |                                                                                                                                                                                                                                        |
| <p>Значение атрибута.<br> Имя атрибута: id</p> | x1                                                                                                                                                                                                        |                                                                                                                                                                                                                                        |
| "META"                                         | Количество атрибутов                                                                                                                                                                                      | 2                                                                                                                                                                                                                                      |
| "p"                                            | Документ                                                                                                                                                                                                  | <p>\<p id="x1" class="abc">abc abc<br> \<a href="[http://asdf.ru">link\&#x3C;/a>](https://help.axatel.by/administrirovanie-telefonnoi-stancii/rabota-s-graficheskim-redaktorom-scenariev/http:/asdf.ru">link\&#x3C;/a>) \<br>\</p></p> |
| "p"\|0                                         | Документ                                                                                                                                                                                                  | <p>\<p id="x1" class="abc">abc abc<br> \<a href="[http://asdf.ru">link\&#x3C;/a>](https://help.axatel.by/administrirovanie-telefonnoi-stancii/rabota-s-graficheskim-redaktorom-scenariev/http:/asdf.ru">link\&#x3C;/a>) \<br>\</p></p> |
| "p"\|1                                         | Документ                                                                                                                                                                                                  | \<p id="x2" class="abc" v="123">zxcv zxcv\</p>                                                                                                                                                                                         |
| "BODY"\|"p"\|("v")                             | Содержимое                                                                                                                                                                                                | zxcv zxcv                                                                                                                                                                                                                              |

### Генератор события

<div align="left"><img src="/files/-MJH_X5RMpwzpnAmasp1" alt=""></div>

Осуществляет отправку произвольного события подписчикам на события системы. Более подробно в руководстве по событийной модели (доступно через запрос в службу Технической поддержки).

![](/files/-MJH_w1kqPpOmpvQk6wn)

Генератор события

| **Название**   | **Описание**                                                                                                                                                     |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Пользователь   | <p>Имя пользователя, по которому производится фильтрация при подписке. Значение представляется в виде структуры<br><br></p><p>{"sipuser":"login or number"}.</p> |
| Имя События    | Имя события, содержащее класс и тип через точку в формате CLASS\_NAME.TYPE\_NAME                                                                                 |
| Тело события   | Пересылаемая информация от Аксател на сторону внешней системы в формате JSON                                                                                     |
| Переход        | Компонент, которому передается управление при успешном завершении.                                                                                               |
| Переход,Ошибка | Компонент, на который передается управление, в случае ошибки                                                                                                     |
| Причина ошибки | Переменная, в которую будет сохранена причина ошибки                                                                                                             |
| Описание       | Описание компонента                                                                                                                                              |

### LDAP-интеграция

<div align="left"><img src="/files/-MJHbZVNisH3W5f2ptPm" alt=""></div>

Компонент позволяющий сделать запрос по протоколу LDAP. Используется для интеграции с AD.

![](/files/-MJHbfh7B-_0g8w4u8ph)

LDAP-интеграция

Свойства:

| **Название**            | **Описание**                                                                                          |
| ----------------------- | ----------------------------------------------------------------------------------------------------- |
| Протокол                | LDAP (протокол соединения с Active Directory)                                                         |
| Адреса серверов         | Список адресов серверов службы каталогов. Можно задать несколько адресов через запятую.               |
| Домен пользователя      | Домен к которому происходит подключение                                                               |
| Имя пользователя        | Пользователь под которым происходит подключение                                                       |
| Пароль                  | Пароль пользователя                                                                                   |
| Тайм-аут                | Время подключения к серверу.  В случае истечения времени сработает Переход, ошибка                    |
| Действие                | Подробно в Действия LDAP-интеграции                                                                   |
| Дополнительные поля     |                                                                                                       |
| Результат в переменную  | Переменная, в которую будет сохранен результат применения запроса.                                    |
| Код ошибки в переменную | Переменная, в которую будет сохранен код ошибки                                                       |
| Переход                 | Компонент, на который передается управление, если запрос в AD выполнен успешно. Переход по-умолчанию. |
| Переход, ошибка         | Компонент, на который передается управление, если возникла ошибка при запросе к AD                    |
| Описание                | Описание компонента                                                                                   |

Права доступа к атрибутам, объектам и доменам определяются пользователем из-под которого работает текущий компонент

#### Действия LDAP-интеграции

**Действие Авторизовать**

Производит подключение и возвращает 1 или 0 в зависимости от успешности. Никаких дополнительных операций в AD не производит.

Дополнительных полей нет.

**Действие Найти**

Используется для поиска данных в LDAP и получение списка значений в результирующую переменную.

Используются дополнительные поля:

| **Доп.поле**  | **Описание**                                                                                                                                                                                                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| DN            | <p>Название домена, в котором производится операция. Например,<br> ou=AD-TEST,dc=Siberia,dc=ttt</p>                                                                                                                                                                             |
| Охват         | <p>Выбор охвата для операции поиска. Возможные варианты:</p><p>•             Базовый объект – Только внутри объекта.</p><p>•             Только уровень – По указанному уровню списка, то есть без рекурсии.</p><p>•             Ветвь целиком – По всему дочернему дереву.</p> |
| Атрибуты      | <p>Атрибуты для поиска. Например,<br> objectGUID,cn,telephoneNumber,mobile</p>                                                                                                                                                                                                  |
| Строка поиска | <p>Строка поиска в службе каталогов. Подробнее в Поиск LDAP. Например,<br> present("cn") and present("telephoneNumber") and present("objectGUID") and substrings("mobile",5551234)</p>                                                                                          |

**Поиск LDAP**

При работе с LDAP возможно использовать строку поиска. Ниже приведены базовые принципы работы алгоритма фильтрации в LDAP протоколе.

| **Функция**    | **Описание**                                   | **Пример**                                                                                                                                                                                                                     |
| -------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| present        | существование атрибута с непустым значением    | <p>present("cn")<br> present("telephoneNumber")<br> present("ou")</p>                                                                                                                                                          |
| not            | отрицание результата. Логическое НЕ (инверсия) | not(present("telephoneNumber"))                                                                                                                                                                                                |
| and            | Логическое И                                   | not(present("telephoneNumber")) and present("cn") and present("mobile")                                                                                                                                                        |
| greaterOrEqual | Больше или равно                               | greaterOrEqual("cn","b")                                                                                                                                                                                                       |
| lessOrEqual    | Меньше или равно                               | lessOrEqual("sn","b") and greaterOrEqual("cn","a")                                                                                                                                                                             |
| equalityMatch  | Приблизительно равно                           | <p>equalityMatch("sn","Ivanov")<br> equalityMatch("instanceType","4")</p>                                                                                                                                                      |
| approxMatch    | Жестко равно                                   | approxMatch("sn","Ivanov")                                                                                                                                                                                                     |
| substrings     | Поиск подстроки                                | <p>substrings("sn","vano")<br> substrings(initial,"sn","Iva")<br> substrings(any,"sn","va","no")<br> substrings(any,"sn","I","v","a","n","o","v")<br> substrings(final,"sn","nov")<br> substrings(initial,"objectGUID",10)</p> |

**Пример**\
&#x20;Возврат всех атрибутов по пользователю

DN: CN=User\_A7 LastNameA7,OU=City\_A,OU=AD-TEST,DC=Siberia,DC=post\
&#x20;Охват: базовый объект\
&#x20;Атрибуты: \*\
&#x20;Строка поиска: present("cn")

**Пример**\
&#x20;Возврат по всем объектам в указанном DN атрибутов cn, displayName, mobile

DN: CN=OU=City\_A,OU=AD-TEST,DC=Siberia,DC=post\
&#x20;Охват: ветвь целиком\
&#x20;Атрибуты: cn, displayName, mobile\
&#x20;Строка поиска: present("cn")

**Действие Создать**

Осуществляет создание нового объекта в LDAP по указанному пути. Используются дополнительные поля:

| **Доп.поле** | **Описание**                                                                                           |
| ------------ | ------------------------------------------------------------------------------------------------------ |
| DN           | <p>Название объекта, которй необходимо создать. Например,<br> cn=User,ou=AD-TEST,dc=Siberia,dc=ttt</p> |
| Атрибуты     | <p>Атрибуты создания объекта в формате JSON. Например,<br> {"mobile": \["111 11 11"]}</p>              |

**Пример**\
&#x20;Создание нового объекта в указанном dn с выставленными атрибутами

DN: CN=User\_A7 LastNameA7,OU=City\_A,OU=AD-TEST,DC=Siberia,DC=post\
&#x20;Атрибуты:\
&#x20;&#x20;

```markup
{
   "objectClass": ["top", "person", "organizationalPerson", "user"],
   "cn": ["User_A7 LastNameA7"],
   "sn": ["LastNameA7"],
   "mobile": ["545 555 00"]
  }
```

**Действие Удалить**

Удаление указанного объекта из LDAP Используются дополнительные поля:

| **Доп.поле** | **Описание**                                                                                            |
| ------------ | ------------------------------------------------------------------------------------------------------- |
| DN           | <p>Название объекта, который необходимо удалить. Например,<br> cn=User,ou=AD-TEST,dc=Siberia,dc=ttt</p> |

**Пример**\
&#x20;Удаление существующего объекта с указанным dn

DN: CN=User\_A7 LastNameA7,OU=City\_A,OU=AD-TEST,DC=Siberia,DC=post

**Действие Изменить**

Изменение существующего объекта в LDAP по указанному пути с новыми атрибутами. Используются дополнительные поля:

| **Доп.поле** | **Описание**                                                                                              |
| ------------ | --------------------------------------------------------------------------------------------------------- |
| DN           | <p>Название объекта, который необходимо изменить. Например,<br> cn=User4,ou=AD-TEST,dc=Siberia,dc=ttt</p> |
| Атрибуты     | <p>Атрибуты изменения объекта в формате JSON. Например,<br> {"mobile": \["111 11 11"]}</p>                |

**Пример**\
&#x20;Изменение у существующего объекта с указанным dn атрибутов displayName и mobile

DN: CN=User\_A7 LastNameA7,OU=City\_A,OU=AD-TEST,DC=Siberia,DC=post\
&#x20;Атрибуты:\
&#x20;&#x20;

```markup
 {
     "displayName":"ASDF",
     "mobile": ["334 113 43"]
   }
```

**Действие Изменить пароль**

Изменение пароля объекта для авторизации в AD Используются дополнительные поля:

| **Доп.поле**  | **Описание**                                                                                                        |
| ------------- | ------------------------------------------------------------------------------------------------------------------- |
| DN            | <p>Ссылка на объект, у которого необходимо изменить пароль. Например,<br> cn=User7,ou=AD-TEST,dc=Siberia,dc=ttt</p> |
| Новый пароль  | Новый пароль. Если не указан, то пароль сгенерится и вернется в качестве результата в переменную.                   |
| Старый пароль | Старый пароль. Может не указываться. В этом случае сверки не происходит (пароль меняется безусловно на новый)       |

**Пример**\
&#x20;Безусловное изменение пароля у объекта

DN: CN=User\_A7 LastNameA7,OU=City\_A,OU=AD-TEST,DC=Siberia,DC=post\
&#x20;Старый пароль:\
&#x20;Новый пароль: 3486ghT56^8j

**Действие Изменить DN**

Перенос объекта между доменами Используются дополнительные поля:

| **Доп.поле**    | **Описание**                                                                                              |
| --------------- | --------------------------------------------------------------------------------------------------------- |
| DN              | <p>Название объекта, который необходимо изменить. Например,<br> cn=User7,ou=AD-TEST,dc=Siberia,dc=ttt</p> |
| Новый DN        | <p>Новое имя для объекта. Например,<br> \`cn=User8'</p>                                                   |
| Родительский DN | <p>Название домена, в котором будет распологаться объект. Например,<br> ou=CITY,dc=NorthWest,dc=ttt</p>   |

**Пример**\
&#x20;Изменение имени объекта без переноса в другой домен

```markup
DN: CN=User_A7 LastNameA7,OU=City_A,OU=AD-TEST,DC=Siberia,DC=post
 Новый DN: CN=User_A7test LastNameA7test
 Родительский DN: OU=City_B,OU=AD-TEST,DC=Siberia,DC=post
```

### Доступ к сервису S3

<div align="left"><img src="/files/-MJHbxtB7vF6X9SG3ru9" alt=""></div>

Взаимодействует с объектным хранилищем по протоколу S3.

![](/files/-MJHc2YlkbmZy8ma2X3o)

| **Название**                | **Описание**                                                                                                                                                                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Хранилище                   | Название хранилища (bucket).                                                                                                                                                                                                                                              |
| Ключ хранения               | Ключ доступа к хранилищу.                                                                                                                                                                                                                                                 |
| Действие                    | <ul><li>Разместить – Размещает файл в хранилище.</li><li>Скачать – Возвращает содержимое файла, либо скачивает в локальный каталог и возвращает путь к нему.</li><li>Удалить – Удаляет файл из хранилища.</li><li>Размер – Возвращает размер файла в хранилища.</li></ul> |
| Тип данных                  | <p>Определяет способ обмена данными сценария с хранилищем</p><ul><li> Массив байтов – Использует бинарные данные через аргумент или переменную.</li><li>Файл данных – Использует путь к файлу в локальном каталоге.</li></ul>                                             |
| Путь к файлу                | (если тип данных = файл) Путь к файлу в локальном каталоге, с использование одной из файловых категорий.                                                                                                                                                                  |
| Данные                      | (если тип данных = массив байтов) Аргумент с содержимым размещаемого в хранилище ресурса.                                                                                                                                                                                 |
| Буфер                       | Переменная для сохранения содержимого скачанного из хранилища ресурса.                                                                                                                                                                                                    |
| Параметры запроса (JSON)    | Набор параметров для операции в хранилище, в формате JSON-объекта, где ключи – названия параметров.                                                                                                                                                                       |
| Результат в переменную      | Переменная для сохранения результата выполнения запроса на получение размера файла в хранилище.                                                                                                                                                                           |
| Время, с                    | Таймаут ожидания ответа, в секундах                                                                                                                                                                                                                                       |
| Переход                     | Компонент, которому передается управление в случае успешного выполнения запроса. Переход по-умолчанию                                                                                                                                                                     |
| Переход, время              | Компонент, которому передается управление по истечение установленного времени выполнения запроса.                                                                                                                                                                         |
| Переход, ошибка             | Компонент, которому передается управление при возникновении ошибки.                                                                                                                                                                                                       |
| Причина ошибки в переменную | Переменная для сохранения ошибки.                                                                                                                                                                                                                                         |

### Запуск процесса

<div align="left"><img src="/files/-MJHc9MzjcRh-UDYfWc1" alt=""></div>

Запускает на сервере внешний консольный процесс. Параметры передаются в теле командной строки. Возвращаемое процессом значение из консоли может быть захвачено и возвращено в переменную.

Операция должна быть предварительно разрешена и настроена в файле ассетов permissions.json на каждом сервере, где может выполняться компонент.

![](/files/-MJHcFZDK5S2EAAmT2tk)

Запуск процесса

| **Название**                       | **Описание**                                                                                                                                                                                                                                                                |
| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Режим                              | <p>Определяет тип запуска</p><ul><li>Асинхронный запуск – Сразу после запуска процесса передает управление следующему компоненту.</li><li>Ожидания завершения – Передает управление следующему компоненту только после завершения процесса или таймаута ожидания.</li></ul> |
| Путь к исполняемому файлу          | Путь к файлу или команда ОС. Префикс командной строки. Префикс должен быть разрешен в файле permissions.json.                                                                                                                                                               |
| Параметры запуска командной строки | Аргумент, определяющий постфикс команды, содержащий параметры.                                                                                                                                                                                                              |
| Время,с                            | (только для режим = ожидания завершения) Аргумент, определяющий предельное время ожидания, по истечении которого управление будет в передано дальше по Переход, время                                                                                                       |
| Результат в переменную             | (только для режим = ожидания завершения) Переменная, в которую будет сохранен консольный вывода завершенного процесса.                                                                                                                                                      |
| Переход                            | Компонент, которому передается управление далее. Переход по-умолчанию                                                                                                                                                                                                       |
| Переход, ошибка                    | Компонент, на который передается управление, если возникла ошибка при запуске внешнего процесса                                                                                                                                                                             |
| Причина ошибки в переменную        | Переменная, в которую будет сохранена причина ошибки запуска процесса                                                                                                                                                                                                       |
| Переход, время                     | (только для режим = ожидания завершения) Компонент, на который передается управление, если истекло предельное время ожидания                                                                                                                                                |
| Описание                           | Описание компонента                                                                                                                                                                                                                                                         |