Интеллектуальный механизм отчетов – версия для сообщества
Smart Report Engine — это удобная для пользователя платформа отчетов PHP, которая позволяет легко создавать профессиональные отчеты программным способом в ваших проектах.
Начиная
1. У вас есть возможность клонировать версию Smart Report Engine, созданную сообществом, или загрузить ее непосредственно с этой страницы загрузки.
2- После загрузки распакуйте сжатую папку, чтобы увидеть структуру SmartReportEngine. Содержимое будет выглядеть примерно так:
├── SmartReportingEngine/
├── sre_config/
└── config.php
├── sre_reports/
├── db/
└── example.sql
├── examples/
└── sre_bootstrap.php
3. Чтобы запустить свой первый проект на своем сервере, вам необходимо импортировать образец базы данных MySQL. Этот процесс позволит вам беспрепятственно начать работу с Smart Report Engine.
- Внутри загруженного пакета Smart Report Engine найдите файл «/db/example.sql» в каталоге «db». Этот файл SQL содержит необходимые команды для создания и заполнения одной таблицы MySQL с именем «items».
- Выберите базу данных MySQL для первой настройки проекта. Вы можете выбрать существующую базу данных или создать новую специально для этого проекта.
- Импортируйте файл «example.sql» в выбранную вами базу данных MySQL. Это создаст таблицу «items» и заполнит ее исходными данными.
4- Настройте строку подключения к базе данных.
- Перейдите в каталог «sre_config» в пакете Smart Report Engine Community Edition. Там вы найдете файл «config.php». Пожалуйста, откройте этот файл в любом текстовом редакторе, который вы предпочитаете.
- В файле «config.php» вы найдете раздел, посвященный настройке базы данных. Обновите строку подключения, указав соответствующие сведения о базе данных MySQL, в которую вы импортировали пример файла SQL на третьем шаге. Обязательно укажите правильное имя хоста, имя базы данных, имя пользователя и пароль в соответствующих полях.
5- Сохраните изменения в файле «config.php».
6. В каталоге «/examples» Community Edition вы найдете три полезных примера, которые помогут вам начать работу с Smart Report Engine. Чтобы выполнить любой из этих примеров, просто откройте их URL-адреса из своего веб-браузера. Это позволит вам просмотреть созданный отчет на основе кода в каждом примере.
7. Если вы предпочитаете создавать примеры проектов с нуля, перейдите к шагу 8 в процессе установки.
ПРИМЕЧАНИЕ. Независимо от вашего выбора, в разделах пошагового руководства по коду будут даны пояснения к коду в каждом примере.
8. Чтобы начать писать свой первый проект, вам понадобится новый PHP-скрипт. Для целей этого руководства вы можете добавить сценарий в корневой каталог версии сообщества вместе с файлом «sre_bootstrap.php». Если вы загрузили версию сообщества вручную (без использования Composer), вам потребуется включить в свой код файл автозагрузки «sre_bootstrap.php», как показано в примере ниже. Если ваш код для других проектов размещен в разных местах, убедитесь, что вы соответствующим образом скорректировали путь к этому файлу автозагрузки. Пожалуйста, выполните следующие действия, чтобы начать работу над вашим проектом:
- Создайте новый PHP-скрипт для своего проекта.
- При желании поместите сценарий в корневой каталог версии сообщества (тот же уровень, что и «sre_bootstrap.php») для целей этого руководства.
- В своем первом новом проекте попробуйте написать следующий простой PHP-код. Это должно работать без каких-либо проблем.
use SRE E ngine C ustomEngine ;
use SRE E ngine R eportOptions ;
require_once " sre_bootstrap.php " ;
try {
$report = new ReportOptions ();
$report - > select_tables( " items " )
- > set_grouping( " country " )
- > set_title( " Items Per country " )
->select_all_fields ();
$engine = new CustomEngine( $report ) ;
$report_path = $engine->create_report ();
if ( $report_path ) {
// The user will be redirected to the URL of the generated report. All generated reports are stored as subdirectories under /sre_reports.
header( " location: " . $report_path ) ;
exit ();
}
} catch (Exception $e ) {
echo $e->getMessage ();
}
Создать этот отчет
Пошаговое руководство по коду: понимание примера
Приведенный код демонстрирует базовый пример эффективного использования Smart Report Engine. Давайте шаг за шагом пройдемся по коду, чтобы понять, как он работает:
- Пространства имен: данный код использует два пространства имен: «SREEngineCustomEngine» и «SREEngineReportOptions». Эти пространства имен помогают организовать определенные части кода и получить к ним доступ.
- Требуется «sre_bootstrap.php». Если вы загрузили версию сообщества вручную (без использования Composer), вам необходимо добавить в свой код специальный файл с именем «sre_bootstrap.php».
- Создание объекта ReportOptions. Код инициализирует объект из класса ReportOptions. Этот объект отвечает за определение параметров, необходимых для вашего отчета. Вы можете настроить различные параметры, учитывая, что некоторые функции доступны только в коммерческой версии.
- Передача объекта ReportOptions в CustomEngine. После установки параметров отчета вы передаете объект ReportOptions конструктору класса CustomEngine. Этот класс обрабатывает создание вашего отчета на основе предоставленных параметров.
- Вызов функции CreateReport: Чтобы создать отчет, вы вызываете функцию CreateReport, используя объект CustomEngine. Эта функция обрабатывает определенные параметры и генерирует отчет. После успешного создания он возвращает URL-адрес отчета. Все отчеты, созданные с помощью Smart Report Engine, будут автоматически сохраняться в каталоге «sre_reports».
Важные ссылки
- Больше примеров
- Подробное сравнение лицензий Чтобы помочь вам лучше понять различия между общественной и коммерческой редакциями, мы предоставили на этой странице краткий обзор. В нем подчеркиваются ключевые различия в функциях и вариантах использования каждой версии.
- Устранение неполадок Smart Report Engine Цель этого раздела документации — помочь пользователям пройти основные контрольные точки, которые следует учитывать при возникновении каких-либо проблем в процессе создания отчетов с помощью Smart Report Engine. Кроме того, мы рассмотрим функцию ведения журнала Smart Report Engine, которая помогает устранять потенциальные проблемы, которые могут возникнуть в создаваемых отчетах.
- Документация Smart Report Engine В этом разделе вы найдете подробную документацию и примеры для каждого встроенного класса, метода и константы Smart Report Engine.
- Что нового В этом разделе будут описаны новейшие функции, представленные в Smart Report Engine.
- Домашняя страница механизма интеллектуальных отчетов
- Связаться с нами
Лицензия Community Edition
Community Edition позволяет вам:
- Поэкспериментируйте с системой Smart Report Engine (только для функций не премиум-класса).
- Свободно используйте Smart Report Engine в личных целях.
- Свободно интегрируйте Smart Report Engine в бесплатные проекты с открытым исходным кодом при условии соблюдения наших претензий на авторские права.
Community Edition ограничивает вас в следующем:
- Доступ к премиум-функциям.
- Интеграция Smart Report Engine в коммерческие или SaaS-проекты.
- Удаление утверждения «На основе» из отчетов, созданных версией Smart Report Maker для сообщества.
ПРИМЕЧАНИЕ. Используя любую из наших коммерческих версий, вам предоставляется доступ ко всем премиум-функциям, а также снимаются все ограничения сообщества, упомянутые выше.
Умный механизм отчетов Pro
Smart Report Engine Pro — это расширенная версия Smart Report Engine, предоставляющая доступ ко всем его премиальным функциям. Версия Pro, стоимость которой составляет всего 64 доллара США за командную лицензию, предлагает множество преимуществ, в том числе:
- Полный доступ ко всем функциям Premium.
- Может использоваться в SaaS и коммерческих проектах.
- Легкая интеграция с любой существующей системой входа на основе сеансов.
- Отсутствие указания «При поддержке» в нижнем колонтитуле созданных отчетов.
- Бесплатный год бесплатных обновлений.
- Скидка 70 % на будущие обновления (после периода бесплатного обновления).
- Приоритетная поддержка клиентов.
- Возможность развертывания Smart Report Engine на неограниченном количестве серверов или проектов.
- Командная лицензия позволяет использовать до 7 разработчиков, а корпоративная лицензия позволяет использовать неограниченное количество разработчиков внутри организации.
- Бесплатно (без дополнительной оплаты) при условии поставки Smart Report Engine вместе с коммерческим продуктом.
Автор
Webuccino Создает простые в использовании продукты с 2007 года.