SQL-запрос

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

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

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

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

Рис. 1. SQL-запрос

Название Описание

Название	Описание
База Данных	БД для подключения. CDR – Собственная событийной потоковой БД домена. Journal – Собственная журнальная БД домена. Report – Собственная отчетная БД домена. Другая – Другая БД.
Драйвер	(если База Данных = Другая) ODBC – подключение через драйвер ODBC. PSQL – подключение через внутренний адаптер к PostgreSQL.
Строка соединения	Пример для PSQL драйвера `Driver={PostgreSQL};Server=67.4.1.1;Port=5432;Database=oktell;Uid=oktell;Pwd=reg53TG;` Пример для ODBC драйвера FreeTDS(для MSSQL) `Driver={FreeTDS};Server=5.44.1.1,49772;Database=oktell;UID=Autelservice;PWD=Version2;TDS_Version=7.4;ClientCharset=UTF-8`
Время,с	Предельное время выполнения запроса. По достижению этого времени, если не получен ответ, будет переход по ветке “Переход, время”
Запрос	Тело SQL запроса, который будет отправлен в БД. Для указания входных значений параметров при использовании ODBC драйвера нужно использовать спецсимвол [?], для использования PSQL спецсимвол [$] с указанием индекса, например: [$1], [$2], [$3], [$4] и так далее. Пример запроса для драйвера ODBC `INSERT INTO EMPLOYEE (NR, FIRSTNAME, LASTNAME, GENDER) VALUES (?, ?, ?, ?)` Пример запроса для драйвера PSQL `INSERT INTO public.studio (id, string) VALUES ( $1, $2 );`
Параметры запроса	Списочное значение, устанавливающее входные параметры для запроса. В качестве параметров запроса указываются переменные сценария. Для корректной передачи входных и выходных параметров название поля таблицы должно совпадать с названием внутренней переменной сценария.
Кодировка	Кодировка, в которой следует сохранить строковые значения в переменных. UTF-8 cp1251 – Кодовая страница windows-1251 (кириллица)
Код ошибки	Переменная для сохранения кода ошибки.
Название ошибки	Переменная для сохранения названия ошибки.
Переход	Компонент, которому передается управление после успешного завершения запроса.
Переход, время	Компонент, которому передается управление после истечения таймаута до получения ответа на запрос.
Переход, ошибка	Компонент, которому передается управление в случае возникновения ошибки при подготовке или выполнении запроса.
Описание	Описание компонента

База Данных

БД для подключения.

CDR – Собственная событийной потоковой БД домена.
Journal – Собственная журнальная БД домена.
Report – Собственная отчетная БД домена.
Другая – Другая БД.

Драйвер

(если База Данных = Другая)

ODBC – подключение через драйвер ODBC.
PSQL – подключение через внутренний адаптер к PostgreSQL.

Строка соединения

Пример для PSQL драйвера

Driver={PostgreSQL};Server=67.4.1.1;Port=5432;Database=oktell;Uid=oktell;Pwd=reg53TG;

Пример для ODBC драйвера FreeTDS(для MSSQL)

Driver={FreeTDS};Server=5.44.1.1,49772;Database=oktell;UID=Autelservice;PWD=Version2;TDS_Version=7.4;ClientCharset=UTF-8

Время,с

Предельное время выполнения запроса. По достижению этого времени, если не получен ответ, будет переход по ветке “Переход, время”

Запрос

Тело SQL запроса, который будет отправлен в БД. Для указания входных значений параметров при использовании ODBC драйвера нужно использовать спецсимвол [?], для использования PSQL спецсимвол [$] с указанием индекса, например: [$1], [$2], [$3], [$4] и так далее.

Пример запроса для драйвера ODBC

INSERT INTO EMPLOYEE (NR, FIRSTNAME, LASTNAME, GENDER)
VALUES (?, ?, ?, ?)

Пример запроса для драйвера PSQL

INSERT INTO public.studio (id, string) VALUES ( $1, $2 );

Параметры запроса

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

Кодировка

Кодировка, в которой следует сохранить строковые значения в переменных.

UTF-8
cp1251 – Кодовая страница windows-1251 (кириллица)

Код ошибки

Переменная для сохранения кода ошибки.

Название ошибки

Переменная для сохранения названия ошибки.

Переход

Компонент, которому передается управление после успешного завершения запроса.

Переход, время

Компонент, которому передается управление после истечения таймаута до получения ответа на запрос.

Переход, ошибка

Компонент, которому передается управление в случае возникновения ошибки при подготовке или выполнении запроса.

Описание

Описание компонента

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