Предыдущий разделСледующий раздел


Учебник 1: Создание простого списка

В этом разделе приведены пошаговые инструкции по созданию отчета со списком клиентов, номеров телефонов и контактных лиц. В отчете используются данные из примера базы данных, входящего в состав проектировщика отчетов BIRT (Classic Models). На Рис. 1-1 показан фрагмент готового отчета.

Рис. 1-1 Отчет со списком клиентов, номерами телефонов и контактными лицами.

В ходе данного упражнения нужно будет выполнить следующие задачи:

Задача 1: Создайте проект.

В Eclipse файлы хранятся в составе проектов. Можно хранить все отчеты в одном проекте, а можно - в нескольких, разделив их по категориям. Для каждого проекта Eclipse создает отдельный каталог в файловой системе.

Если вы пользуйтесь проектировщиком отчетов BIRT RCP, этот шаг выполнять не нужно.

  1. Выберите Файл->Создать->Проект. Появится окно Создать проект, показанное на рис. 1-2, со списком возможных типов проектов.
  2. Рис. 1-2 Новый проект
  3. Разверните раздел Бизнес-аналитика и отчеты, выберите пункт Проект отчета и нажмите кнопку Далее.
  4. В окне Создать проект отчета введите следующий текст, как показано на рис. 1-3:
  5. Мои отчеты 
     

    Рис. 1-3 Новый проект отчета
  6. Для создания проекта нажмите кнопку Готово. Проект будет показан в Навигаторе (см. рис. 1-4).
  7. Рис. 1-4 Проект в дереве объектов Навигатора

Задача 2: Создайте отчет.

Отчет можно создать несколькими способами:

В данном учебнике отчет создается с нуля.

  1. Выберите Файл->Создать->Отчет. Появится окно Создать отчет. Соответствующее окно проектировщика отчетов BIRT показано на рис. 1-5. Новый отчет в окне проектировщика отчетов BIRT немного отличается от существующих.
  2. Рис. 1-5 Новый отчет в окне проектировщика отчетов BIRT
  3. Выберите созданный проект в разделе Введите или выберите родительскую папку окна проектировщика отчетов BIRT. Этот шаг нужно выполнять только пользователям проектировщика отчетов BIRT.
  4. Введите следующее имя файла:
  5. Customers.rptdesign 
    
  6. Нажмите кнопку Далее. В окне создания отчета предусмотрена возможность создания отчета с нуля или на основе одного из шаблонов, как показано на рис. 1-6.
  7. Рис. 1-6 Шаблоны отчетов в окне Создать отчет
  8. Выберите опцию Пустой отчет и нажмите кнопку Готово. Новый отчет будет показан в главном окне. Это окно будет представлять собой редактор макета, показанный на рис. 1-7. В редакторе макета будет показана пустая страница отчета.

В дальнейших разделах этого учебника приведены подробные инструкции по созданию отчета о клиентах компании.

Рис. 1-7 Создание отчета с нуля

Задача 3: Создайте источник данных

Перед созданием макета отчета нужно создать источник данных BIRT для подключения отчета к базе данных или одному из других источников данных. Создание источника данных заключается в указании класса драйвера, имени источника данных и параметров соединения, включая идентификатор пользователя и пароль. В этом учебнике в качестве источника данных используется пример базы данных (Classic Models), настроенный для применения с проектировщиком отчетов BIRT. Для этого примера базы данных не нужно указывать параметры соединения.

  1. Откройте меню данных. Если вы пользуетесь стандартной проекцией создания отчетов, меню данных находится слева от редактора отчетов, рядом с палитрой, как показано на рис. 1-8. Если оно не показано, выберите Окно->Показать панель->Меню данных.
  2. Рис. 1-8 Меню данных
  3. Щелкните правой кнопкой мыши на опции Источники данных и выберите опцию Создать источник данных. Появится окно со списком поддерживаемых типов источников данных, показанное на рис. 1-9.
  4. Рис. 1-9 Новый источник данных
  5. Выберите в списке типов источников данных базу данных Classic Models Inc. Оставьте без изменения предложенное по умолчанию имя источника данных и нажмите кнопку Далее. Будут показаны параметры соединения с источником данных.
  6. Нажмите кнопку Готово. Проектировщик отчетов BIRT создаст источник данных и соединение с указанным примером базы данных. Источник данных будет добавлен в список источников данных в меню данных, показанное на рис. 1-10.
  7. Рис. 1-10 Источники данных в меню данных

Задача 4: Создайте набор данных

Теперь можно приступить к созданию набора данных. Набор данных представляет собой описание данных, извлекаемых из источника. Если в отчете используется источник данных JDBC, в качестве набора данных можно указать оператор SQL SELECT.

  1. В меню данных щелкните правой кнопкой на опции Наборы данных и выберите опцию Создать набор данных в контекстном меню.
  2. В окне Создать набор данных укажите следующее значение в поле Имя набора данных, как показано на рис. 1-11:
  3. Customers 
     

    Рис. 1-11 Создание набора данных
  4. Оставьте значения по умолчанию в остальных полях:
    • В поле Источник данных будет указано имя источника данных, созданного ранее.
    • В поле Тип набора данных будет указан оператор SQL SELECT.
  5. Нажмите кнопку Далее.
  6. В поле Запрос будет показана дополнительная информация по созданию запроса SQL. В списке Доступные элементы будут показаны все таблицы базы данных Classic Models. Для просмотра столбцов таблицы нужно щелкнуть на знаке плюса (+) рядом с таблицей. В текстовой области в правой части окна Изменить набор данных будут показаны необходимые ключевые слова оператора SQL SELECT:
    select 
    from 
    
  7. Введите следующий оператор SQL SELECT в текстовой области:
  8. select customerName, 
    contactLastName, 
    contactFirstName, 
    phone 
    from Customers 
    
    Хотя в редакторе набора данных имена таблиц и столбцов будут показаны прописными буквами, указывать их можно в любом регистре, поскольку в языке SQL регистр не учитывается. Если вы не хотите вводить запрос, можно перенести столбцы и таблицы из списка Доступные элементы в текстовую область.
    Новый оператор SELECT, показанный на рис. 1-12, извлекает значения из столбцов CUSTOMERNAME, CONTACTLASTNAME, CONTACTFIRSTNAME и PHONE таблицы CUSTOMERS.

    Рис. 1-12 Оператор SQL SELECT в окне Изменить набор данных
  9. Нажмите кнопку Готово для сохранения набора данных. В окне Изменить набор данных будут показаны столбцы, выбранные для запроса, и опции изменения набора данных.
  10. Нажмите кнопку Просмотр результатов для проверки запроса и правильности возвращаемых данных. Если оператор SELECT указан правильно, запрос выдаст результаты, показанные на рис. 1-13. Это строки данных, возвращаемые запросом.
  11. Рис. 1-13 Строки данных, возвращаемые оператором SQL SELECT
  12. Нажмите кнопку OK.

Задача 5: Создайте макет отчета

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

  1. Выберите палитру. На палитре показаны все элементы, которые можно включить в отчет.
  2. Перенесите элемент таблицы из палитры в макет отчета. В окне Вставить таблицу нужно будет указать количество строк и столбцов.
  3. Укажите 3 столбца и 1 строку и нажмите кнопку OK. В макет будет добавлена таблица, состоящая из трех столбцов и одной строки. Теперь можно перейти к вставке данных в таблицу.
  4. Откройте меню данных.
  5. В меню данных разверните наборы данных, а затем набор данных Customers. В разделе Customers будет показан список столбцов запроса.
  6. Перенесите столбец CUSTOMERNAME из меню данных в первую ячейку таблицы, как показано на рис. 1-14. В строке данных будут показаны данные отчета. В готовом отчете в строке данных будут последовательно показаны все строки набора данных.
  7. Рис. 1-14 Перенос столбца из меню данных в ячейку таблицы
    Проектировщик отчетов BIRT создает именованный столбец, привязанный к полю набора данных. Укажите привязку данных, как показано на рис. 1-15.

    Рис. 1-15 Именованный столбец, привязанный к полю набора данных
  8. Нажмите кнопку OK для принятия привязки данных, предложенной по умолчанию.
  9. В ячейке таблицы, в которую было перенесено поле CUSTOMERNAME, будет показан элемент данных [CUSTOMERNAME]. Над этим элементом будет показан элемент метки, который автоматически создается для строки заголовка. Элемент метки представляет собой имя поля. Он выступает в роли заголовка столбца. На рис. 1-16 показаны элементы данных и меток.

    Рис. 1-16 Элементы данных и меток в таблице
  10. Перенесите поле PHONE из меню данных во вторую ячейку строки данных. Нажмите кнопку OK для принятия привязки данных, предложенной по умолчанию.
  11. Перенесите поле CONTACTFIRSTNAME из меню данных в третью ячейку строки данных. Нажмите кнопку OK для принятия привязки данных, предложенной по умолчанию.
  12. Перенесите поле CONTACTLASTNAME в третью ячейку строки данных под значение CONTACTFIRSTNAME. Нажмите кнопку OK для принятия привязки данных, предложенной по умолчанию. Страница отчета должна выглядеть так, как показано на рис. 1-17.
  13. Рисунок 1-17 Сведения о клиенте и контактная информация в таблице
  14. Откройте вкладку Просмотр в нижней части окна редактора макета. Проектировщик отчетов BIRT создаст и покажет отчет в формате HTML, как показано на рис. 1-18. Пролистайте отчет до конца. Отчет можно также просмотреть в формате PDF. Для этого нужно выбрать Файл->Показать отчет в формате PDF в главном меню.
  15. Как показано на рис. 1-18, данные выбраны правильно, но не упорядочены. Имеет смысл отсортировать данные по алфавиту по имени клиента. Кроме того, можно улучшить оформление отчета.

    Рис. 1-18 Просмотр данных отчета

Задача 6: Отсортируйте данные

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

  1. Откройте вкладку Макет для возврата в редактор макета.
  2. При необходимости откройте редактор свойств. Если вы пользуйтесь стандартной проекцией создания отчетов, редактор свойств находится под редактором макета. Если редактор свойств не показан, выберите Окно->Показать панель->Редактор свойств.
  3. Выберите таблицу в редакторе макета. Для этого нужно щелкнуть на вкладке Таблица в левом нижнем углу. Эта вкладка появляется при наведении указателя мыши на данную область. В редакторе свойств можно изменять свойства таблицы, как показано на рис. 1-19.
  4. Рис. 1-19 Редактор свойств
  5. Откройте вкладку Сортировка.
  6. Нажмите кнопку Добавить для создания условия сортировки. Будет показана строка под полем Ключ сортировки.
  7. Щелкните на строке под полем Ключ сортировки, затем нажмите появившуюся кнопку со стрелкой и выберите значение CUSTOMERNAME в выпадающем списке.
  8. Оставьте без изменения значение По возрастанию в поле Направление сортировки, как показано на рис. 1-20.
  9. Рис. 1-20 Сортировка по возрастанию
  10. Просмотрите отчет. Данные будут отсортированы по имени клиента, как показано на рис. 1-21.
  11. Рис. 1-21 Сортировка данных по имени клиента
    Обратите внимание на то, что значения, начинающиеся с прописной буквы, показаны в начале списка. BIRT сортирует данные по значениям кодовых точек UCS2. В наборах символов на основе ASCII значения кодовых точек у прописных букв меньше, чем у строчных. Поэтому прописные буквы при сортировке по алфавиту идут раньше строчных.
  12. Для сортировки записей по именам клиентов без учета регистра, чтобы компания ANG Resellers была показана после American Souvenirs Inc., а не до нее, нужно указать следующее выражение в поле Ключ сортировки:
  13. row["CUSTOMERNAME"].toUpperCase( ) 
    
    Это выражение переводит названия клиентов в верхний регистр с помощью функции JavaScript toUpperCase() перед сортировкой. В именах функций JavaScript учитывается регистр символов, поэтому нужно ввести toUpperCase() именно так, как указано. Регистр символов также учитывается в именах столбцов. В данном выражении должно быть указано row["CUSTOMERNAME"]. Если вы укажете, например, row["customername"], при создании отчета проектировщик BIRT выдаст сообщение об ошибке. Регистр букв в имени столбца можно сверить с его написанием в меню данных.
  14. Просмотрите отчет. Названия клиентов будут показаны в другом порядке. Значения, начинающиеся с прописных букв, не будут находиться в начале списка.

Задача 7: Отформатируйте отчет

После проверки правильности данных и их сортировки можно приступить к оптимизации оформления отчета. Для этого нужно выполнить следующие задачи:

Изменить заголовки столбцов

  1. Откройте вкладку Макет для возврата в редактор макета.
  2. Дважды щелкните на заголовке первого столбца: CUSTOMERNAME. Заголовки столбцов находятся в первой (верхней) строке таблицы.
  3. Для замены выделенного текста начните ввод и по завершении нажмите Enter. Для изменения текста щелкните один раз для снятия выделения с текста, затем поместите курсор в нужную позицию и добавьте или удалите символы по необходимости.
  4. Укажите следующее значение вместо CUSTOMERNAME:
    Customer 
    
  5. Повторите шаги 2 и 3 для изменения заголовков второго и третьего столбцов на следующие значения:
  6. Phone 
    Contact 
    
    Отчет должен выглядеть так, как показано на рис. 1-22.

    Рис. 1-22 Отчет с измененными заголовками столбцов

Отформатируйте заголовки столбцов

Форматирование элемента отчета заключается в изменении его свойств. Это можно сделать двумя способами:

В этой процедуре первый метод будет применяться для выделения заголовков полужирным шрифтом, а второй - для изменения цвета строки заголовка.

  1. Для выделения заголовков столбцов полужирным шрифтом с помощью редактора свойств выполните следующие действия:
    1. Выделите все заголовки столбцов. Для выделения нескольких элементов нужно щелкнуть на них, держа нажатой клавишу Shift. В редакторе свойств можно изменять свойства выделенных элементов, как показано на рис. 1-23.
    2. Рис. 1-23 Свойства выделенных элементов в редакторе свойств

    3. Нажмите клавишу B для выделения заголовков столбцов полужирным шрифтом.
    4. Для того чтобы снять выделение с заголовков столбцов, щелкните мышью за пределами таблицы.
  2. Для изменения цвета фона строки заголовка с помощью стиля выполните следующие действия:
    1. Выберите Элемент->Создать стиль в главном меню.
    2. Появится окно Создать стиль, показанное на рис. 1-24. В левой части этого окна будут показаны категории свойств. В правой части окна показаны свойства выбранной категории.

      Рис. 1-24 Создание стиля
    3. Укажите следующее имя для нового стиля:
    4. table_header_row 
      
    5. Выберите Фон в списке категорий свойств. Будут показаны свойства фона, которые можно изменить.
    6. Укажите цвет фона одним из следующих способов:
      • Нажмите кнопку, расположенную рядом со свойством, затем выберите цвет в появившейся палитре.
      • Выберите цвет в выпадающем списке.
      Нажмите кнопку OK.
    7. Выберите таблицу в редакторе макета. Для этого нужно щелкнуть на вкладке Таблица в левом нижнем углу. Эта вкладка появляется при наведении указателя мыши на данную область. Над таблицей и слева от нее будут показаны направляющие ячейки, как показано на рис. 1-25.
    8. Рис. 1-25 Направляющие ячейки над таблицей и слева от нее
    9. Выберите направляющую ячейку, расположенную рядом со строкой заголовка. В редакторе свойств будут показаны свойства выбранной строки.
    10. Выберите Свойства - Общие для просмотра общих свойств строки.
    11. Примените новый стиль, выбрав значение table_header_row в выпадающем списке Стиль. Проектировщик отчетов BIRT применит стиль к строке заголовка, что приведет к изменению ее цвета.
  3. Просмотрите отчет. Отчет должен выглядеть так, как показано на рис. 1-26.
  4. Рис. 1-26 Внешний вид отчета после применения стиля к строке заголовка
    На данный момент основное улучшение заключалось в том, что четко видны и определены заголовки.

Обеспечить вывод имен и фамилий на одной строке

Если поместить несколько элементов в одну ячейку, проектировщик отчетов BIRT создает элементы block. Если вы знакомы с языком HTML, вы знаете, что каждый элемент block выводится в отдельной строке. Для вывода нескольких элементов в одной строке нужно пользоваться элементами inline. Кроме того, можно объединить имя и фамилию в одно значение, как продемонстрировано в данной процедуре.

  1. Откройте вкладку Макет для возврата в редактор макета.
  2. Удалите элемент данных, соответствующий фамилии контактного лица.
  3. Удалите элемент данных, соответствующий имени контактного лица.
  4. В списке Выбрать привязку данных будут показаны все привязки, используемые в отчете. Отметка напротив поля CONTACTFIRSTNAME указывает на привязку, применяемую для выбранного элемента данных.
  5. Щелкните на ячейке, в которой показано выражение dataSetRow["CONTACTFIRSTNAME"], и нажмите кнопку с многоточием (...).
  6. В текстовой области в верхней части окна компоновщика выражений будет показано следующее выражение:
    dataSetRow["CONTACTFIRSTNAME"] 
    
  7. Для объединения имен с фамилиями укажите следующее выражение:
  8. dataSetRow["CONTACTFIRSTNAME"]+" "+ 
    dataSetRow["CONTACTLASTNAME"] 
    
    На рис. 1-27 это выражение показано в компоновщике выражений. Пробел в кавычках (" ") применяется для отделения имени от фамилии. Можно либо ввести выражение в текстовой области, либо дважды щелкнуть на элементе, который нужно вставить, в нижнем правом углу окна.

    Рис. 1-27 Объединенные поля в компоновщике выражений
  9. Нажмите кнопку OK, чтобы закрыть компоновщик выражений, а затем кнопку ОК в окне Выбрать привязку данных для сохранения измененного выражения.
  10. Просмотрите отчет. Отчет должен выглядеть так, как показано на рис. 1-28.
  11. Рис. 1-28 Отчет с объединенными полями имен и фамилий

Увеличить расстояние между строками

По умолчанию строки таблицы располагаются на минимальном расстоянии друг от друга. В большинстве случаев имеет смысл увеличить это расстояние.

  1. Откройте вкладку Макет для возврата в редактор макета.
  2. Выделите все ячейки в строке данных (средней строке). Для выделения нескольких ячеек щелкните на них, удерживая нажатой клавишу Shift. Обратите внимание на то, что нужно выделить сами ячейки, а не элементы данных в них. Вокруг выделенных ячеек будет показана квадратная рамка, как на рис. 1-29.
  3. Рис. 1-29 Выделенные ячейки в редакторе макета
    В редакторе свойств будут показаны свойства ячеек. В названии окна редактора свойств будет указан тип выбранного элемента, поэтому в данном случае будет показано Редактор свойств - Ячейка.
  4. Нажмите кнопку Отступ. В редакторе свойств будут показаны свойства отступа. Можно указать размер отступа сверху, снизу, слева и справа от границ ячейки до элемента данных.
  5. Задайте отступ в 12 пунктов сверху.
  6. В этот момент у вас может возникнуть вопрос: почему бы не изменить отступ для всей строки вместо того, чтобы изменять его для отдельных ячеек. В проектировщике отчетов BIRT не предусмотрено изменение отступа для строк, поскольку эта функция поддерживается не всеми браузерами.
  7. Просмотрите отчет. Отчет должен выглядеть так, как показано на рис. 1-30. Расстояние между строками данных станет больше.
  8. Рис. 1-30 Вид отчета с увеличенным расстоянием между строками

Задача 8: Создайте заголовок отчета

Теперь осталось только создать заголовок отчета. Заголовок может представлять собой элемент метки, элемент текста или элемент данных:

В ходе выполнения данной процедуры текст будет отформатирован с помощью элемента текста и тегов HTML. Отметим, что не обязательно пользоваться языком HTML для форматирования текста. Однако если вы хорошо знакомы с HTML и разработкой web-страниц, рекомендуется отформатировать текст с помощью HTML.

  1. Откройте вкладку Макет для возврата в редактор макета.
  2. Выберите палитру.
  3. Перенесите элемент текста из палитры в таблицу.
  4. В выпадающем списке окна Изменить элемент текста выберите значение HTML/Динамический текст вместо значения Обычный текст.
  5. Выбрав значение HTML/Динамический текст, можно внедрять в текст теги HTML и свойства CSS. Самые распространенные теги HTML можно вставлять автоматически, а остальные - вводить вручную.
  6. Укажите следующий текст в области текста, как показано на рис. 1-31:
  7. <CENTER><B><span style="font-size: larger">  Customer
    List  </B></span><BR>  <FONT
    size="small">For internal use only</FONT><BR><BR> 
    Report generated on <VALUE-OF>new Date( )</VALUE-OF> 
    </CENTER><BR><BR>   

    Рис. 1-31 Текст с тегами HTML
  8. Нажмите кнопку OK и просмотрите отчет. Отчет должен выглядеть так, как показано на рис. 1-32.
  9. Рис. 1-32 Отчет с отформатированным заголовком

Как показано на этом примере, применение тегов HTML с элементом текста позволяет решить несколько задач:

Кроме того, можно выбрать и другие подходы:

Следующие шаги

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


(c) Copyright Actuate Corporation 2006

Предыдущий разделСледующий раздел