Категорія:

Пов'язані з базою даних

Загальні

Перевіряє значення поля бази даних на null і повертає значення для заміни null.

Синтаксис

dataset_nvl(
  StepNo Integer,
  FieldName String,
  SubstVal <FieldType> 
): <FieldType>
dataset_nvl(
  StepNo Integer,
  FieldIndex Integer,
  SubstVal <FieldType>
): <FieldType>

Параметри

StepNo. Залежить від контексту, в якому функція використовується:

Контекст експорту до HTML з використанням шаблону. Шаблон HTML може заповнюватися даними за більше, ніж один крок. Наприклад, якщо ваш документ HTML містить кілька таблиць, що мають бути заповнені даними з різних наборів даних, то заповнити їх можна лише за кілька кроків експорту (як правило, один набір даних за один крок). Параметр StepNo якраз і вказує крок експорту, на якому дана функція має обчислюватися.

Контекст звітів. Параметр StepNo в цих функціях вказує крок (прохід), в якому функція має обчислюватися. Можливі значення: 1 або 2. Якщо цей параметр дорівнює 1, то відповідна функція обчислюватиметься безпосередньо при обробці виразу. Якщо ж він дорівнює 2, звіт буде формуватися в режимі двох проходів і відповідна функція обчислюватиметься лише на другому проході обробки звіту, тобто вже після того, як набір даних звіту досягне останнього запису. Використання функцій баз даних на другому проході зручне у випадках, наприклад, коли потрібно підсумки по звіту (групі) помістити на початку звіту (групи).

Інший контекст. Повинен дорівнювати 1.

Поєднання різних StepNo в одному виразі (напр., database_field_val(1, 'total_sum') + database_field_val(2, 'payment_sum')) можливе, але такі вирази повинні бути написані так, щоб функції з меншим StepNo розраховувалися раніше.

FieldName - назва поля бази даних, чиє значення потрібно перевірити.

FieldIndex - порядковий номер поля в поточному наборі даних (в контексті звітів) або колекції відповідностей полів (в контексті експорту даних).

SubstVal - значення, яке потрібно повернути, якщо значення поля містить null. Тип SubstVal повинен співпадати з типом поля.

Значення, що повертається

Тип: <FieldType> (залежить від типу поля). Повертає SubstVal, якщо значення поля містить null, і значення поля в протилежному випадку.

Приклади використання

dataset_nvl(1, 'Salary', 0)