Начало

Алгоритмические возможности

• Условное выполнение кода
  • IF
  • CASE
• Циклическое выполнение кода
  • WHILE
  • FOR
• Структурированная обработка ошибок
  • TRY
  • THROW
  • Функция ERROR_MESSAGE
• Приостановка выполнения кода (пауза)
• Параллельное выполнение кода
• Вызов скриптов, в том числе асинхронно

Все команды, представленные в этом разделе, являются блочными. Это означает, что все они имеют обособленные блоки (области видимости объявления переменных), состоящие из одной или более команд DaJet Script.

Команда IF

IF <condition> THEN <then_statements> [ELSE <else_statements> END

<condition> - выражение, которое возвращает значение типа boolean.
<then_statements> - блок команд DaJet Script, который выполняется если выражение <condition> вернуло значение true.
<else_statements> - (опционально) блок команд DaJet Script, который выполняется если выражение <condition> вернуло значение false.

DECLARE @value number = 1

IF @value = 1
   THEN PRINT '(@value = 1) = true'
   ELSE PRINT '(@value = 1) = false'
END

--Результат выполнения скрипта
[2024-10-12 21:24:21] (@value = 1) = true

Наверх

Команда CASE

CASE
  WHEN <condition> THEN <then_statements> [...n]
 [ELSE <else_statements>]
END

<condition> - выражение, которое возвращает значение типа boolean.
<then_statements> - блок команд DaJet Script, который выполняется если выражение <condition> вернуло значение true.
<else_statements> - (опционально) блок команд DaJet Script, который выполняется если ни одно выражение <condition> не вернуло значение true.

Предложение WHEN может повторяться неограниченное количество раз.

DECLARE @value number = 0

CASE WHEN @value = 1 THEN PRINT '@value = 1'
     WHEN @value = 2 THEN PRINT '@value = 2'
     WHEN @value = 3 THEN PRINT '@value = 3'
     ELSE PRINT 'Нет совпадений'
END

--Результат выполнения скрипта
[2024-10-12 21:24:21] Нет совпадений

Наверх

Команда WHILE

WHILE <condition>
   <statements>
   [BREAK]
   [CONTINUE]
END

<condition> - выражение, которое возвращает значение типа boolean.
<statements> - блок команд DaJet Script, который выполняется пока выражение <condition> возвращает значение true.

BREAK - (опционально) команда немедленного, принудительного, завершения цикла WHILE. Управление кодом передаётся следующей команде скрипта, которая следует сразу же после завершающего цикл WHILE ключевого слова END.

CONTINUE - (опционально) команда принудительного перехода на начало цикла. Управление кодом передаётся строке проверки условия <condition>, с которой начинается цикл WHILE.

Пример простого цикла WHILE

DECLARE @counter number = 0

WHILE @counter < 3
   PRINT '@counter = ' + @counter
   SET @counter = @counter + 1
END

PRINT '@counter = ' + @counter

--Результат выполнения скрипта
[2024-10-12 21:31:55] @counter = 0
[2024-10-12 21:31:55] @counter = 1
[2024-10-12 21:31:55] @counter = 2
[2024-10-12 21:31:55] @counter = 3

Пример цикла WHILE с использованием BREAK и CONTINUE

DECLARE @counter number = 0

PRINT 'SCRIPT START'

WHILE TRUE -- Потенциально "вечный" цикл
   IF @counter = 2
   THEN
      PRINT 'break: ' + @counter
      BREAK;
   ELSE
      PRINT 'continue: ' + @counter
      SET @counter = @counter + 1
      CONTINUE;
   END -- IF
   PRINT 'Эта команда не будет выполнена'
END -- WHILE

PRINT 'SCRIPT END'

-- Результат выполнения скрипта
[2024-10-20 16:28:01] SCRIPT START
[2024-10-20 16:28:01] continue: 0
[2024-10-20 16:28:01] continue: 1
[2024-10-20 16:28:01] break: 2
[2024-10-20 16:28:01] SCRIPT END

Наверх

Команда FOR

Команда FOR выполняет блок команд DaJet Script для каждого элемента object из массива array.

FOR <object> IN <array>
   <statements>
END

<array> - переменная типа array - массив элементов типа object.
<object> - переменная типа object - элемент массива <array>.
<statements> - блок команд DaJet Script, который выполняется для каждого значения <object>.

DECLARE @array  array
DECLARE @object object

USE 'mssql://server/database'
   SELECT TOP 3
          Наименование
     INTO @array
     FROM Справочник.Номенклатура
    ORDER BY Наименование ASC
END

FOR @object IN @array
   PRINT @object.Наименование
END

-- Результат выполнения скрипта
[2024-10-12 21:46:31] Товар MS-001
[2024-10-12 21:46:31] Товар MS-002
[2024-10-12 21:46:31] Товар MS-003

Наверх

Команда TRY

TRY
   <try_statements>
CATCH
   <catch_statements>
FINALLY
   <finally_statements>
END

<try_statements> - блок команд, который может вызвать возникновение исключительной ситуации (ошибки).
<catch_statements> - блок команд, который выполняется только в случае возникновения ошибки в блоке TRY.
<finally_statements> - блок команд, который выполняется всегда и только один раз сразу же после выполнения блока TRY или CATCH.

Для получения описания ошибки следует использовать функцию ERROR_MESSAGE, которая возвращает строковое значение. Использование этой функции имеет смысл только в блоке CATCH. Использование этой функции в любом другом месте скрипта возвращает пустую строку.

Обязательно должен использоваться, либо блок CATCH, либо блок FINALLY, либо оба вместе. Это значит, что допустимы следующие виды использования команды структурированной обработки ошибок:

1. TRY <statements> CATCH <statements> END
2. TRY <statements> FINALLY <statements> END
3. TRY <statements> CATCH <statements> FINALLY <statements> END

DECLARE @value number

TRY
   PRINT 'try block'
   SET @value = 10 / 0
CATCH
   PRINT 'catch block'
   PRINT 'error: ' + ERROR_MESSAGE()
FINALLY
   PRINT 'finally block'
END

-- Результат выполнения скрипта
[2024-10-12 22:08:04] try block
[2024-10-12 22:08:04] catch block
[2024-10-12 22:08:04] error: [SET] failed to evaluate initializer [Variable: @value]
[2024-10-12 22:08:04] finally block

Команда THROW

Команда THROW используется для генерации исключительной ситуации (ошибки) в любом месте скрипта DaJet Script. В качестве обязательного параметра этой команды используется строковое значение или выражение, которое является описанием ошибки.

THROW <error_message>

<error_message> - строковое значение или выражение, описание ошибки.

TRY
   PRINT 'try block'
   THROW 'Что-то пошло не так!'
CATCH
   PRINT 'catch block'
   PRINT 'ERROR: ' + ERROR_MESSAGE()
FINALLY
   PRINT 'finally block'
END

-- Результат выполнения скрипта
[2024-10-12 22:13:59] try block
[2024-10-12 22:13:59] catch block
[2024-10-12 22:13:59] ERROR: Что-то пошло не так!
[2024-10-12 22:13:59] finally block

Наверх

Функция ERROR_MESSAGE

Функция для получения строкового описания ошибки в блоке CATCH, куда выполнение кода попадает в случае возникновения исключительной ситуации (ошибки) в блоке TRY. Использование функции ERROR_MESSAGE() не имеет смысла в любом другом месте скрипта DaJet Script - возвращает пустую строку.

TRY
   THROW 'Ошибочка вышла ¯\_(ツ)_/¯'
CATCH
   PRINT 'ERROR: ' + ERROR_MESSAGE()
END

-- Результат выполнения скрипта
[2024-10-20 16:48:18] ERROR: Ошибочка вышла ¯\_(ツ)_/¯

Наверх

Команда SLEEP

SLEEP <seconds>

<seconds> - период “сна” текущего потока выполнения в секундах.

PRINT 'Начало "сна"'
SLEEP 5
PRINT 'Конец  "сна"'

-- Результат выполнения скрипта
[2024-10-12 22:22:12] Начало "сна"
[2024-10-12 22:22:17] Конец  "сна"

Наверх