Smart Report Engine – Community Edition
Smart Report Engine ist ein benutzerfreundliches PHP-Reporting-Framework, das die mühelose programmgesteuerte Erstellung professioneller Berichte innerhalb Ihrer Projekte ermöglicht.
Erste Schritte
1- Sie haben die Möglichkeit, entweder die Community-Edition von Smart Report Engine zu klonen oder sie direkt von dieser Download-Seite herunterzuladen
2- Extrahieren Sie nach dem Herunterladen den komprimierten Ordner, um die Struktur von SmartReportEngine anzuzeigen. Der Inhalt wird in etwa wie folgt aussehen:
├── SmartReportingEngine/
├── sre_config/
└── config.php
├── sre_reports/
├── db/
└── example.sql
├── examples/
└── sre_bootstrap.php
3- Um Ihr erstes Projekt auf Ihrem Server zu starten, müssen Sie eine Beispiel-MySQL-Datenbank importieren. Dieser Prozess ermöglicht Ihnen einen reibungslosen Einstieg in die Smart Report Engine.
- Suchen Sie im heruntergeladenen Paket von Smart Report Engine die Datei „/db/example.sql“ im Verzeichnis „db“. Diese SQL-Datei enthält die notwendigen Befehle zum Erstellen und Füllen einer einzelnen MySQL-Tabelle mit dem Namen „items“.
- Wählen Sie die MySQL-Datenbank für Ihr erstes Projekt-Setup aus. Sie können sich für eine bestehende Datenbank entscheiden oder speziell für dieses Projekt eine neue erstellen.
- Importieren Sie die Datei „example.sql“ in die von Ihnen gewählte MySQL-Datenbank. Dadurch wird die Tabelle „items“ erstellt und mit Anfangsdaten gefüllt.
4- Konfigurieren Sie die Datenbank-Verbindungszeichenfolge
- Navigieren Sie zum Verzeichnis „sre_config“ im Smart Report Engine Community Edition-Paket. Dort finden Sie die Datei „config.php“. Bitte öffnen Sie diese Datei mit einem beliebigen Texteditor Ihrer Wahl.
- In der Datei „config.php“ finden Sie einen Abschnitt zur Datenbankkonfiguration. Aktualisieren Sie die Verbindungszeichenfolge mit den entsprechenden Details der MySQL-Datenbank, in die Sie im dritten Schritt die Beispiel-SQL-Datei importiert haben. Stellen Sie sicher, dass Sie in den entsprechenden Feldern den richtigen Hostnamen, Datenbanknamen, Benutzernamen und das richtige Passwort angeben.
5- Speichern Sie die Änderungen in der Datei „config.php“.
6- Im Verzeichnis „/examples“ der Community Edition finden Sie drei hilfreiche Beispiele, die Ihnen den Einstieg in die Smart Report Engine erleichtern. Um eines dieser Beispiele auszuführen, greifen Sie einfach über Ihren Webbrowser auf die URLs zu. Dadurch können Sie den generierten Bericht basierend auf dem Code in jedem Beispiel anzeigen.
7- Wenn Sie die Beispielprojekte lieber von Grund auf erstellen möchten, fahren Sie bitte mit Schritt 8 im Installationsprozess fort.
HINWEIS: Unabhängig von Ihrer Wahl enthalten die Code-Komplettlösungsabschnitte Erklärungen für den Code in jedem Beispiel.
8- Um mit dem Schreiben Ihres ersten Projekts zu beginnen, benötigen Sie ein neues PHP-Skript. Für dieses Tutorial können Sie das Skript zusammen mit der Datei „sre_bootstrap.php“ zum Stammverzeichnis der Community Edition hinzufügen. Wenn Sie die Community Edition manuell heruntergeladen haben (ohne Composer zu verwenden), müssen Sie die Autoload-Datei „sre_bootstrap.php“ in Ihrem Code benötigen, wie im folgenden Beispiel gezeigt. Falls Ihr Code für andere Projekte an anderen Orten platziert wird, stellen Sie sicher, dass Sie den Pfad zu dieser Autoload-Datei entsprechend anpassen. Bitte befolgen Sie diese Schritte, um mit Ihrem Projekt zu beginnen:
- Erstellen Sie ein neues PHP-Skript für Ihr Projekt.
- Platzieren Sie das Skript optional für die Zwecke dieses Tutorials im Stammverzeichnis der Community Edition (gleiche Ebene wie „sre_bootstrap.php“).
- Versuchen Sie in Ihrem ersten neuen Projekt, den folgenden einfachen PHP-Code zu schreiben. Es sollte ohne Probleme funktionieren.
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 ();
}
Generieren Sie diesen Bericht
Code-Komplettlösung: Das Beispiel verstehen
Der angegebene Code zeigt ein grundlegendes Beispiel für die effektive Verwendung von Smart Report Engine. Gehen wir den Code Schritt für Schritt durch, um zu verstehen, wie er funktioniert:
- Namespaces: Der angegebene Code verwendet zwei Namespaces: „SREEngineCustomEngine“ und „SREEngineReportOptions“. Diese Namespaces helfen bei der Organisation und dem Zugriff auf bestimmte Teile des Codes.
- Erforderlich „sre_bootstrap.php“: Wenn Sie die Community Edition manuell heruntergeladen haben (ohne Composer zu verwenden), müssen Sie Ihrem Code eine spezielle Datei namens „sre_bootstrap.php“ hinzufügen.
- Erstellen des ReportOptions-Objekts: Der Code initialisiert ein Objekt aus der „ReportOptions“-Klasse. Dieses Objekt ist für die Definition der für Ihren Bericht erforderlichen Optionen verantwortlich. Sie können verschiedene Optionen anpassen. Beachten Sie dabei, dass einige Funktionen nur in der kommerziellen Edition verfügbar sind.
- Übergeben des ReportOptions-Objekts an CustomEngine: Nachdem Sie Ihre Berichtsoptionen festgelegt haben, übergeben Sie das „ReportOptions“-Objekt an den Konstruktor der „CustomEngine“-Klasse. Diese Klasse übernimmt die Erstellung Ihres Berichts basierend auf den bereitgestellten Optionen.
- Funktion „CreateReport“ aufrufen: Um Ihren Bericht zu generieren, rufen Sie die Funktion „CreateReport“ mithilfe des Objekts „CustomEngine“ auf. Diese Funktion verarbeitet die definierten Optionen und generiert den Bericht. Nach erfolgreicher Erstellung wird die URL des Berichts zurückgegeben. Alle mit der Smart Report Engine generierten Berichte werden automatisch im Verzeichnis „sre_reports“ gespeichert.
Wichtige Links
- Weitere Beispiele
- Detaillierter Lizenzvergleich Damit Sie die Unterschiede zwischen der Community- und der kommerziellen Edition besser verstehen, haben wir auf dieser Seite eine kurze Übersicht bereitgestellt. Es hebt die wichtigsten Unterschiede in den Funktionen und Anwendungsfällen der einzelnen Versionen hervor.
- Fehlerbehebung bei Smart Report Engine Der Zweck dieses Abschnitts in der Dokumentation besteht darin, Benutzer durch wichtige Prüfpunkte zu führen, die sie berücksichtigen müssen, wenn während des Berichtserstellungsprozesses mit Smart Report Engine Probleme auftreten. Darüber hinaus werden wir die Protokollierungsfunktion der Smart Report Engine untersuchen, die bei der Fehlerbehebung potenzieller Probleme hilft, die in den generierten Berichten auftreten können.
- Smart Report Engine-Dokumentation In diesem Abschnitt finden Sie eine umfassende Dokumentation und Beispiele für jede integrierte Klasse, Methode und Konstante der Smart Report Engine.
- Was ist neu? In diesem Abschnitt werden die neuesten Funktionen vorgestellt, die in Smart Report Engine eingeführt wurden.
- Startseite der Smart Report Engine
- Kontaktieren Sie uns
Community Edition-Lizenz
Mit der Community Edition können Sie:
- Experimentieren Sie mit der Smart Report Engine (nur Nicht-Premium-Funktionen).
- Nutzen Sie Smart Report Engine kostenlos für den persönlichen Gebrauch.
- Integrieren Sie Smart Report Engine frei in kostenlose Open-Source-Projekte, solange Sie unsere Urheberrechtsansprüche wahren.
Die Community Edition beschränkt Sie auf Folgendes:
- Zugriff auf Premium-Funktionen.
- Integration der Smart Report Engine in kommerzielle oder SaaS-Projekte.
- Entfernen des Anspruchs „Unterstützt von“ aus Berichten, die von der Community-Edition von Smart Report Maker erstellt wurden.
HINWEIS: Durch die Nutzung einer unserer kommerziellen Editionen erhalten Sie Zugriff auf alle Premium-Funktionen sowie die Aufhebung aller oben genannten Community-Einschränkungen.
Smart Report Engine Pro
Smart Report Engine Pro ist eine erweiterte Version von Smart Report Engine, die Zugriff auf alle Premium-Funktionen gewährt. Die Pro-Edition kostet für eine Team-Lizenz nur 64 US-Dollar und bietet zahlreiche Vorteile, darunter:
- Vollständiger Zugriff auf alle Premium-Funktionen.
- Kann in SaaS- und kommerziellen Projekten verwendet werden.
- Mühelose Integration mit jedem vorhandenen sitzungsbasierten Anmeldesystem.
- Fehlen der Angabe „Powered by“ in der Fußzeile generierter Berichte.
- Ein kostenloses Jahr mit kostenlosen Upgrades.
- 70 % Rabatt auf zukünftige Upgrade-Gebühren (nach Ablauf des kostenlosen Upgrade-Zeitraums).
- Vorrangiger Kundensupport.
- Die Möglichkeit, Smart Report Engine auf einer unbegrenzten Anzahl von Servern oder Projekten bereitzustellen.
- Die Team-Lizenz ermöglicht die Nutzung durch bis zu 7 Entwickler, während die Enterprise-Lizenz eine unbegrenzte Anzahl von Entwicklern innerhalb der Organisation zulässt.
- Royal kostenlos (ohne Aufpreis), wenn Sie Smart Report Engine mit Ihrem kommerziellen Produkt geliefert haben.
Autor
Webuccino entwickelt seit 2007 benutzerfreundliche Produkte