スマート レポート エンジン - コミュニティ エディション
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」ディレクトリにある「/db/example.sql」ファイルを見つけます。この SQL ファイルには、「items」という名前の単一の MySQL テーブルを作成および設定するために必要なコマンドが含まれています。
- 最初のプロジェクト設定には MySQL データベースを選択します。既存のデータベースを選択することも、このプロジェクト専用に新しいデータベースを作成することもできます。
- 「example.sql」ファイルを選択した MySQL データベースにインポートします。これにより、「items」テーブルが作成され、初期データが設定されます。
4- データベース接続文字列を構成する
- Smart Report Engine Community Edition パッケージ内の「sre_config」ディレクトリに移動します。そこに「config.php」ファイルがあります。任意のテキスト エディタを使用してこのファイルを開いてください。
- 「config.php」ファイルには、データベース設定専用のセクションがあります。 3 番目のステップでサンプル SQL ファイルをインポートした MySQL データベースの適切な詳細で接続文字列を更新します。それぞれのフィールドに正しいホスト名、データベース名、ユーザー名、パスワードを入力してください。
5- 変更を「config.php」ファイルに保存します。
6- Community Edition の「/examples」ディレクトリには、Smart Report Engine の使用を開始するのに役立つ 3 つのサンプルがあります。これらのサンプルのいずれかを実行するには、Web ブラウザから 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」という 2 つの名前空間を使用します。これらの名前空間は、コードの特定の部分を整理してアクセスするのに役立ちます。
- 「sre_bootstrap.php」が必要:コミュニティ エディションを (Composer を使用せずに) 手動でダウンロードした場合は、「sre_bootstrap.php」という特別なファイルをコードに追加する必要があります。
- ReportOptions オブジェクトの作成:このコードは、「ReportOptions」クラスのオブジェクトを初期化します。このオブジェクトは、レポートに必要なオプションを定義します。一部の機能は商用版に限定されていることに留意して、さまざまなオプションをカスタマイズできます。
- ReportOptions オブジェクトを CustomEngine に渡す:レポート オプションを設定したら、「ReportOptions」オブジェクトを「CustomEngine」クラスのコンストラクターに渡します。このクラスは、指定されたオプションに基づいてレポートの作成を処理します。
- CreateReport 関数の呼び出し:レポートを生成するには、「CustomEngine」オブジェクトを使用して「CreateReport」関数を呼び出します。この関数は、定義されたオプションを処理し、レポートを生成します。作成が成功すると、レポートの URL が返されます。 Smart Report Engine を使用して生成されたすべてのレポートは、「sre_reports」ディレクトリに自動的に保存されます。
重要なリンク
- 他の例
- ライセンスの詳細な比較 コミュニティ エディションと商用エディションの違いをよりよく理解できるように、このページでは簡潔な概要を提供しています。各バージョンの機能と使用例の主な違いを強調しています。
- Smart Report Engine のトラブルシューティング ドキュメントのこのセクションの目的は、Smart Report Engine によるレポート生成プロセス中に問題が発生した場合に考慮すべき重要なチェックポイントをユーザーに案内することです。さらに、生成されたレポートで発生する可能性のある潜在的な問題のトラブルシューティングに役立つ、Smart Report Engine のログ機能についても説明します。
- Smart Report Engine のドキュメント このセクションでは、Smart Report Engine の各組み込みクラス、メソッド、および定数に関する包括的なドキュメントと例を紹介します。
- 新機能 このセクションでは、Smart Report Engine に導入された最新の機能について説明します。
- Smart Report Engineのホームページ
- お問い合わせ
コミュニティ版ライセンス
Community Edition では次のことが可能になります。
- Smart Report Engine を試してください (非プレミアム機能のみ)。
- Smart Report Engineは個人利用の範囲でご自由にご利用ください。
- 著作権の主張を守る限り、Smart Report Engine を無料のオープンソース プロジェクトに自由に統合できます。
Community Edition では次のことが制限されます。
- プレミアム機能へのアクセス。
- Smart Report Engine を商用プロジェクトまたは SaaS プロジェクトに統合します。
- Smart Report Maker のコミュニティ エディションで生成されたレポートから「Powered by」要求を削除します。
注:弊社の商用版を使用すると、すべてのプレミアム機能へのアクセスが許可されるだけでなく、上記のすべてのコミュニティ制限が解除されます。
スマート レポート エンジン プロ
Smart Report Engine Pro は、Smart Report Engine の高度なバージョンであり、すべてのプレミアム機能へのアクセスを許可します。チーム ライセンスの価格はわずか 64 ドルで、Pro エディションには次のような数多くの利点があります。
- すべてのプレミアム機能に完全にアクセスできます。
- SaaS および商用プロジェクトで使用できます。
- 既存のセッションベースのログイン システムと簡単に統合できます。
- 生成されたレポートのフッターに「Powered by」属性がありません。
- 1 年間の無料アップグレード。
- 将来のアップグレード料金が 70% 割引になります (無料アップグレード期間後)。
- 優先的な顧客サポート。
- Smart Report Engine を無制限の数のサーバーまたはプロジェクトに展開できる機能。
- チーム ライセンスでは最大 7 人の開発者が使用できますが、エンタープライズ ライセンスでは組織内で無制限の開発者が使用できます。
- Smart Report Engine を商用製品とともに提供した場合は、ロイヤル フリー (追加料金なし) になります。
著者
Webuccino 2007年から使いやすい製品を作り続けています