Первоначально Написано Майклом Уильямсом
Если вы знакомы с BIRT с открытым исходным кодом и какими являются готовые варианты интеграции, вы знаете, что у вас есть средство просмотра, которое можно вызывать по URL, библиотека тегов средства просмотра, позволяющая встроить средство просмотра в страница JSP или пользовательское решение, созданное вами с помощью API BIRT. С BIRT iHub F-Type у вас все еще есть возможность вызывать визуализации по URL, но вы также добавляете JavaScript API (JSAPI), который позволяет легко встраивать контент BIRT в любую страницу, которая позволяет использовать JavaScript.
В этом блоге я покажу пару быстрых примеров вызова отчетов по URL и пару простых примеров использования JavaScript API для встраивания контента BIRT в веб-страницу.
Вызов отчетов по URL
Если единственная интересующая вас интеграция — это возможность ссылки на дизайн из вашего приложения или веб-страницы, подойдет простой URL. Если вы обновляете свое приложение с открытым исходным кодом, чтобы использовать BIRT iHub F-Type, вы можете использовать тот же шаблон URL, что и при работе с программой просмотра с открытым исходным кодом, поэтому обновление будет относительно безболезненным.
Например:
http://192.168.1.107:8700/iportal/frameset?__report=%2FHome%2Fadministrator%2FSampleReport.rptdesign
Если вы не адаптируете приложение с открытым исходным кодом, ваш URL будет выглядеть примерно так:
http://192.168.1.107:8700/iportal/executereport.do?__vp=Default%20Volume&volume=Default%20Volume&__executableName=%2FHome%2Fadministrator%2FSampleReport.rptdesign
Если вы не можете вспомнить шаблон URL, не волнуйтесь. Все, что вам нужно сделать, — это зайти в интерфейс iHub, запустить дизайн, щелкнув по нему, раскрывающееся меню и выбрать параметр «Ссылка на эту страницу».
Верхний вариант в этом окне — это ссылка на дизайн. Скопируйте это и используйте его везде, где вам нужно.
Существует множество параметров URL, доступных для настройки того, что вы получаете от своего URL. Одним из примеров этого является добавление __format = pdf к указанному выше URL:
http://192.168.1.107:8700/iportal/executereport.do?__vp=Default%20Volume&volume=Default%20Volume&__executableName=%2FHome%2Fadministrator%2FSampleReport.rptdesign&__format=pdf
Это сообщит BIRT iHub F-Type о возвращении копии отчета в формате PDF.
Использование JSAPI
Когда ваша цель — обеспечить более плавную интеграцию контента BIRT в ваше приложение, вы должны начать с JavaScript API (JSAPI). JSAPI позволяет быстро и легко встраивать контент BIRT в любую страницу, которая позволяет использовать JavaScript.
Чтобы сделать это еще проще, вам даже не нужно знать JavaScript, чтобы выполнить простейший случай встраивания с использованием JSAPI. IHub предоставит вам минимальный блок кода для встраивания средства просмотра в ваше приложение, просто запустив отчет с iHub по URL-адресу или из консоли, затем перейдите в меню и нажмите «Ссылка на эту страницу», как описано в раздел URL выше. Однако на этот раз мы будем использовать второй вариант.
Если вы скопируете и вставите это в HTML-страницу, а затем откроете ее в браузере, вы увидите следующее:
Как вы можете видеть, весь просмотрщик встроен в страницу, что позволяет вам просматривать все 11 страниц отчета. Существует множество параметров и функций, которые можно настроить с помощью JSAPI для настройки встроенного содержимого.
Например, если вы отметили закладку в своем отчете и хотите вставить только один элемент на свою страницу, вам нужно добавить только одну строку сценария. В отчете, который я использовал для этого блога, я пометил диаграмму «myChart». Внутри функции myInit мы просто используем строку viewer1.setReportletBookmark (‘myChart’); и мы получаем одну страницу в программе просмотра, показывающую только график:
А что если мы не хотим показывать панель инструментов? Чтобы избавиться от этого, мы просто добавим options.enableToolBar (false); и мы увидим только график без панели инструментов:
Вы можете найти больше вещей, которые вы можете сделать с помощью JavaScript API, взглянув на ссылку API в документации.
Отчет и пример HTML-страницы, используемой в этом блоге, скоро будут опубликованы в devShare. Я буду обновлять блог со ссылкой, когда она будет доступна.
Спасибо за чтение. Если у вас есть какие-либо вопросы или комментарии, вы можете использовать раздел комментариев ниже или посетить форум BIRT iHub F-Type . Вы также можете найти дополнительную информацию о BIRT iHub F-Type в руководстве по развертыванию и в документации .
-Майкл
Другие блоги из серии «Представляем BIRT iHub F-Type» см. В списке ниже:
- Установка iHub F-Type: Windows | Linux | VMWare Image
- Подключение к данным и создание дизайна
- Совместное использование дизайнов и других ресурсов