Настройка источника данных

Описание настройки источника данных

Формирование источника данных отчета, печатной формы включает в себя:

• Создание соединения с базой данных

  • Добавление источника данных JDBC
  • Редактирование источника данных
  • Удаление источника данных

  Подключение к базе данных не является обязательным. Наличие подключения дает возможность воспользоваться:

  • предпросмотром данных, извлеченных с помощью SQL;
  • предпросмотром отчета, печатной формы, см. Предпросмотр шаблона PRD.
• Формирование таблицы отчета, печатной формы
  • Составление SQL запроса для извлечения данных
  • Скрипт шаблона отчета (печатной формы)

Добавление источника данных JDBC

Чтобы добавить источник данных, выполните следующие действия:

1. Создайте новый или откройте существующий шаблон PRD, см. Добавление шаблона PRD. Настройка структуры шаблона PRD

2. Разверните меню "Данные", выберите раздел "Добавить источник данных", далее выберите JDBC.

   

   или на вкладке "Данные" нажмите иконку Добавить источник данных и выберите JDBC.

   

   На экране откроется форма "JDBC источник данных".

   

3. На вкладке "Источники данных" нажмите иконку , чтобы добавить соединение. На экране откроется форма с параметрами подключения к базе данных.

4. Выберите тип подключения и вид доступа. Выбор зависит от типа СУБД, к которой производится подключение.

   • Для PostgreSQL следует выбирать тип подключения: "PostgreSQL", вид доступа: "Native (JDBC)".

     

5. Заполните поля: имя подключения, имя сервера, имя базы данных, номер порта, имя пользователя и пароль доступа к базе данных.
6. Для проверки соединения с базой данных нажмите кнопку Тест. На экране выводится сообщение об успешном соединении с базой данных или ошибке соединения.
7. Нажмите кнопку ОК.

Форма добавления закроется, источник данных отобразится в списке соединений на вкладке "Источники данных".

После этого необходимо создать SQL запрос для извлечения данных.

Составление SQL запроса для извлечения данных

При составлении запроса необходимо учитывать, что база данных доступна в режиме чтения, соответственно нельзя использовать запросы, модифицирующие базу данных

Особенности

При написании SQL запроса могут использоваться системные параметры: subject_table, subject_id, subject_case, см. Системные параметры.

Структура базы данных SMP, см. Описание структуры таблиц базы данных.

Данные в отчете, которые формируются SQL запросом выводятся в часовом поясе пользователя. Если пользовательский часовой пояс [не указано], то берется часовой пояс сервера, на котором установлено приложение.

У Oracle есть особенность: поле timestamp возвращается как oracle.sql.TIMESTAMP, а для корректной работы с date-field в Pentaho нужно получать java.sql.Timestamp, поэтому необходимо преобразовывать oracle.sql.TIMESTAMP в java.sql.Timestamp любым из способов.

Например:

TRUNC(TBL_SERVICECALL__EVT.eventdate, 'HH24') AS "Время нового события",

или

CAST(TBL_SERVICECALL__EVT.eventdate as DATE) AS "Время нового события"

Составление SQL запроса

Чтобы написать SQL запрос для извлечения данных из базы, выполните следующие действия:

1. Выберите источник данных JDBC, см.  Добавление источника данных JDBC.

   

   На экране откроется форма "JDBC источник данных".

   

   Скрипты, добавленные в источнике данных на вкладке "Скрипты запроса", не учитываются при воспроизведении отчета в SMP. Скрипты для отчета пишутся в шаблоне отчета в SMP, см. Скрипт шаблона отчета (печатной формы).

2. Добавьте SQL запрос, для этого на вкладке "Источники данных" в блоке "Доступные запросы" нажмите иконку . В поле "Доступные запросы" отобразится название SQL запроса.

   Название выбранного SQL запроса повторяется в поле Имя запроса и может быть изменено, после выбора SQL запроса в блоке "Доступные запросы".

3. Заполните или измените содержание SQL запроса, для этого на вкладке "Статический запрос" введите содержание SQL запроса в поле Запрос.

4. Чтобы просмотреть извлеченные данные, нажмите кнопку Предпросмотр. Данные выводится в виде плоской таблицы.

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

5. Нажмите кнопку ОК.

Форма "JDBC источник данных" закроется, SQL запрос отобразится на вкладке "Данные" справа.

Пример использования системных параметров в sql-скрипте. Получение названия объектов того же типа, что и объект, с карточки которого строится отчет:

SELECT title
FROM ${subject_table}
WHERE case_id=${subject_case} 

Редактирование источника данных

Чтобы изменить параметры источника данных, выполните следующие действия:

1. Откройте форму настройки источника данных. На вкладке "Данные" выберите источник данных в ветке "Наборы данных". Откройте правой кнопкой контекстное меню и выберите пункт "Редактировать источник данных".

   

   или разверните меню "Данные" и выберите раздел "Добавить источник данных", далее выберите JDBC.

   На экране откроется форма "JDBC источник данных".

   

2. На вкладке "Источники данных" выберите соединение и нажмите иконку . На экране отобразится форма "Подключение к базе данных".

   

   Измените параметры подключения и нажмите кнопку ОК. Форма настройки подключения закроется, внесенные изменения будут применены.

3. Чтобы удалить соединение, на вкладке "Источники данных" выберите соединение и нажмите иконку . Выбранное соединение будет удалено.

Удаление источника данных

Чтобы удалить источник данных, откройте форму настройки источника данных, на вкладке "Данные" выберите источник данных в ветке "Наборы данных". Откройте правой кнопкой контекстное меню и выберите пункт "Удалить".