# Модуль «MS SQL Gateway»

> [HTML Version](ms-sql-gateway.html)

Модуль позволяет настроить обмен данными между СУБД Microsoft SQL Server и ELMA365. С помощью запросов на языке SQL вы сможете извлекать информацию, хранящуюся в СУБД и связанных с ней источниках, добавлять записи в базу данных и т. д. 

Например, интеграция позволяет получать документы и файлы из системы электронного документооборота для дальнейшей обработки в ELMA365. Затем вы можете отправлять сведения о документах из ELMA365 во внешнюю базу данных, например, обновлять их статус. 

````
начало внимание

````
Модуль доступен для поставок On-Premises, а также для SaaS Enterprise начиная с версии 2024.10.

````
конец внимание

````
При установке модуля в дизайнер бизнес-процессов добавляется специальный графический элемент для отправки запросов в Microsoft SQL Server. Вы можете включить этот блок в любой пользовательский процесс, где требуется взаимодействие со сторонней системой. После выполнения запроса в ELMA365 поступает ответ в формате JSON-строки, из которой можно извлечь данные для дальнейшей работы.

Загрузить модуль из каталога ELMA365 Store и настроить его могут пользователи, включённые в группу [Администраторы](360006871932.md#administrators).

## Установить модуль

Для импорта модуля:

1. Перейдите в раздел **Администрирование > Модули**.

2. Нажмите **+ Модуль**, а затем **Скачать**.

3. В открывшемся каталоге [ELMA365 Store](https://store.elma365.ru/component/ms_sql_gateway-417) установите **MS SQL Gateway**.

4. Поскольку модуль является платным, после пробного периода его необходимо [активировать](licenses-store.md) таким же образом, как бизнес‑решения из каталога. Для этого перейдите в раздел **Администрирование > Управление лицензиями** и напротив названия модуля нажмите кнопку **Активировать**.

5. В открывшемся окне скопируйте **Регистрационный токен решения** и передайте его менеджеру ELMA365.

6. Укажите предоставленный ключ активации решения в форме и нажмите **Активировать**.

## Настроить модуль

Подготовьте модуль к работе: 

1. Перейдите в **Администрирование > Модули > MS SQL Gateway**.

2. На странице модуля укажите строку подключения к Microsoft SQL Server. Варианты формирования строки представлены на сайте [connectionstrings.com](https://www.connectionstrings.com/microsoft-data-sqlclient/).

**(ms-sql-gateway-1.png)**

**Важно**: в строке подключения всегда нужно явно указывать имя пользователя и пароль SQL Server с помощью свойств **User ID** и **Password**. Аутентификация через Windows не поддерживается в модуле, поэтому включать свойство **Integrated Security** нельзя.

3. Нажмите кнопку **TEST**, чтобы проверить подключение. Отобразится ответ сервера в виде JSON‑строки, в которой указана успешность запроса, версия Microsoft SQL Server и версия модуля.

4. Нажмите **Сохранить**.

Теперь вы можете использовать в бизнес-процессах графический элемент **Запрос в MS SQL**. Подробнее о том, как настроить взаимодействие с сервером, читайте в статье [«Настроить отправку запросов в Microsoft SQL Server»](work-with-ms-sql.md).