Відноситься до
Описує джерело даних для звіту. В інтерфейсі Reportizer ці налаштування доступні на сторінці Джерело даних головного вікна. У текстовому представленні звіту ви можете побачити це всередині блоку DataOptions.
Складається з кількох елементів:
1. Інтерфейс (див. нижче)
2. База даних. Залежить від інтерфейсу:
ADO: Тека (напр., з DBF файлами), багатотабличний файл бази даних (наприклад, .mdb, .accdb, .xls, .xlsx, .html і т.д.), джерело даних ODBC (DSN) або строчка підключення ADO.
FD: Список параметрів з'єднання, що вар'юється в залежності від типу баз даних (Oracle, SQL Server і т.д.).
Interbase: Файл бази даних Interbase або Firebird (зазвичай мають розширення .gdb, .ib, .fdb).
BDE: Тека (напр., з DBF файлами), багатотабличний файл бази даних (наприклад, .gdb), BDE аліас чи джерело даних ODBC (DSN).
Folders/Files: Назва фізичної директорії. Може задаватися відносним шляхом, наприклад "..\Examples". В назві можна використовувати специфікатори <CURRENT_DIR> і <TEMPLATE_DIR>, які програма замінить відповідно на поточну директорію або директорію, де знаходить шаблон звіту.
3. Ім'я користувача - для тих баз даних, які вимагають авторизації користувача при вході; якщо не задано, то користувачу при вході в базу даних буде запропоновано ввести його. Тільки для джерел даних, в яких інтерфес ADO, FD, BDE або Interbase.
4. Пароль - для тих баз даних, які вимагають авторизації користувача при вході; якщо не задано, то користувачу при вході в базу даних буде запропоновано ввести його. Тільки для джерел даних, в яких інтерфес ADO, FD, BDE або Interbase.
5. Параметри запиту - описує властивості кожного параметру запиту (якщо набір даних є запитом і якщо він містить параметри), що робить ввід параметрів при перегляді звіту максимально зручним. Тільки для джерел даних, в яких інтерфес ADO, FD, BDE або Interbase.
6. Набір даних. Залежить від інтерфейсу:
ADO, BDE, Interbase, FD: Назва таблиці з цієї ж бази даних або SQL-вираз (SQL-запит). Рекомендується використовувати SQL-запит, де це можливо. Приклад такого запиту:
SELECT *
FROM ORDERS
WHERE COUNTRY = 'Germany'
Folders/Files: Містить XML-опис набору даних, як це показано в наступному прикладі:
<Dataset>
<Source>FILES_AND_FOLDERS</Source>
<Options>
<FileMask>*.*</FileMask>
<IncludeReadOnly>0</IncludeReadOnly>
<IncludeHidden>0</IncludeHidden>
<IncludeSystem>0</IncludeSystem>
<IncludeSubFolders>0</IncludeSubFolders>
</Options>
</Dataset><FileMask> вказує маску, по якій фільтруються типи файлів. Якщо масок більше однієї, вони повинні розділятися крапкою з комою.
<Source> визначає, які саме елементи бази даних повинні бути вибрані. Можливі значення: FOLDERS (теки), FILES (файли) або FILES_AND_FOLDERS (файли і теки).
<IncludeReadOnly> вказує, чи включати файли "лише для читання". Можливі значення: 1 (включати) або 0 (не включати).
<IncludeHidden> вказує, чи включати приховані файли. Можливі значення: 1 (включати) або 0 (не включати).
<IncludeSystem> вказує, чи включати системні файли. Можливі значення: 1 (включати) або 0 (не включати).
<IncludeSubFolders> вказує, чи включати елементи з підпапок. Можливі значення: 1 (включати) або 0 (не включати).
Набір даних для цього типу завжди містить наступні поля:
FullPath Повний шлях до файлу (теки).
ItemCreated Дата створення файлу (теки).
ItemLastAccessed Дата останнього відкриття файлу (теки).
ItemLastModified Дата останньої зміни файлу (теки).
ItemName Назва файлу (теки).
ItemSize Розмір файлу (теки) в байтах. Для папок повертається 0.
ItemType Тип (розширення) у верхньому регістрі без крапки.
FileFolderMark Містить 0 для папок і 1 для файлів.
7. Перед відкриттям. Необов'язковий набір SQL-команд, які необхідно виконувати щоразу, коли відкривається джерело даних звіту. Тільки для звітів на основі даних бази даних. Це корисно, коли перед відкриттям джерела даних звіту необхідно виконати певну підготовку в базі даних. Це має бути будь-який дійсний набір SQL-команд для бази даних звіту. У випадку кількох команд необхідно використовувати відповідний роздільник SQL-команд (наприклад, крапка з комою для більшості типів баз даних). Ось як такий набір команд може виглядати, наприклад, для бази даних PostgreSQL:
--виклик функції для виконання певних підготовчих дій:
SELECT * FROM public.prepare_something();
--надання прав користувачу звіту на щойно створену вітрину:
GRANT SELECT ON public.orders_showcase TO showcase_read_role;
Цей блок можна легко ввімкнути/вимкнути за допомогою відповідної опції.
Див. також