BI-Creator Beschreibung

https://wiki.cds.co.at/wikipat/index.php?title=CUSTOMER:PAT_Enterprise_En_BI_Creator

Das BI Creator Modul ist der dynamische PAT Report Creator, der dem User ermöglicht, dynamische Reports mit Hilfe von SQL Befehlen Filter Felder mit (optionalen und erforderlichen) Parametern zu erstellen und die Daten mit den Eingabekriterien in der Vorschau darzustellen. Das dynamische SQL ist eine Programmiertechnik, die es ermöglicht SQL Befehle dynamisch während der Laufzeit zu erstellen. Mehr allgemeine Ziele und flexible Anwendungen können mit dynamischen SQL erstellt werden auch wenn der vollständige SQL Befehl möglicherweise während der Erfassung nicht bekannt ist. Beispielsweise lässt das dynamische SQL das Erstellen einer Prozedur zu, mit der in einer noch unbenannten Tabelle direkt gearbeitet werden kann.

1 Komponenten

PAT BI besteht aus zwei Bereichen:

• Menüleiste
• PAT BI Creator (Arbeitsbereich)
• BI Form (Dialogfilter-Bereich)

BI Creator Tool besteht aus drei Arbeitsgebieten:

• Main: Erlaubt dem Nutzer, dynamische SQL Befehle zu erstellen und Filteroptionen hinzuzufügen.
• Report Layouts: Erlaubt dem Nutzer, Reports mit Hilfe des Report Designer zu erstellen.
• Settings: Display options for Grid View, Pivot Grid View and Endpoint.

2 Menüleiste

• 1) Open Report Designer: Öffnet den Report Designer,
• 2) Edit Report Parameters: Hier können die Benutzerrechte für den Report definiert werden (über verschiedene Rollen),
• 3) Add Report Layout: Fügt ein neues Report Layout hinzu,
• 4) Delete Report Layout: Löscht ein Report Layout,
• 5) Create Menu: erneuert das Menü unter PAT BI,
• 6) Export Report: Exportiert den Report mit allen Layouts (Report & Dashboard),
• 7) Export All Reports: Exportiert alle Reports mit all ihren Layouts (Report & Dashboard),
• 8) Import Report(s): Importiert einen oder mehrere Reports mit allen Layouts (Report & Dashboard) Existiert der Report bereits, besteht die Möglichkeit den bestehenden Report zu überschreiben oder einen neuen zu erstellen.
• 9) Create PAT Mobile Access Rights: Erstellt die Access Rechte für PAT Mobile,
• 10) Create PAT API Access Rights: Erstellt die Access Rechte für PAT API','
• 11) Add Dashboard Layout: Fügt ein neues Dashboard Layout hinzu,
• 12) Delete Dashboard Layout: Löscht ein Dashboard Layout.

3 PAT BI Creator

• 1) Report Id: Vorgegebene ID für den erstellten Report.
• 2) Report Name: Im Bereich Erstellung und Vorschau benutzter Reportname.
• 3) Dynamische SQL Befehle (SELECT): Dynamische SQL Befehle, die die SQL Standards Like, Equal, NotEqual nutzen.
• 4) Filter Bereich: Zufügen von Filter basierten Kriterien (WHERE STATEMENT).
• 5) Vorschau Bereich: Zeigt die Ergebnisse aus den SELECT Befehlen an.
• 6) Field Area: Zusätzliches Definieren der Spalten wie Umbenennen, Typ-Änderung.

Das BI Tool benutzt Standard SQL einschließlich WHERE-Klausel (Filter Bereich), Feldbereich mit dem Spalten umbenannt und Display-Text sowie Vorschau-Bereich angepasst werden können.

3.1 Dynamische SQL Befehle

Die PAT Enterprise Dynamische SQL Befehle ermöglichen dem Nutzer, Freitext SELECTs einzufügen, optionale (define as ?) und erforderliche Parameter (WHERE CLAUSE) zu definieren und vieles mehr; das Ergebnis kann im Vorschaubereich (Datenbereich) angezeigt werden.

1) SQL Befehle mit Feldern die alle obligat sind:

<syntaxhighlight lang="sql">
SELECT * from B_PRODPLAN
WHERE ARTNR = :ARTNR
AND FORM = :FORM
</syntaxhighlight>

2) SQL Statements mit einem optionalen Feld (?AND FORM = :FORM). Where-Klausel ist immer erforderlich:

<syntaxhighlight lang="sql">
SELECT * from B_PRODPLAN
WHERE ARTNR = :ARTNR
?AND FORM = :FORM
</syntaxhighlight>

3) SQL Befehl mit Feldern die alle optional sind:

<syntaxhighlight lang="sql">
SELECT * from B_PRODPLAN
WHERE 1=1
?AND ARTNR = :ARTNR
?AND FORM = :FORM
</syntaxhighlight>

3.2 Dynamischer Filter Bereich

Der Dynamische Filter Bereich erlaubt dem Nutzer, Filter-Werte als WHERE Klauseln zuzufügen, die in den SELECT Befehl eingefügt werden.

1) Position: Es besteht die Möglichkeit, mittels Drag and Drop die vom System vorgegebene Position zu ändern.

2) Id: Die Spaltenbezeichnung in der Datenbank.

3) Display Text: Das Alias (verständlicher Name) für die Spalte zur Verwendung in einem SQL-Befehl.

4) Type: Type legt die Feldart fest:

• Type kann aus 'Input', 'Date', 'Lookup' ausgewählt werden: -> a field can be selected,
• 'Lookup(Search)' -> optionale Suche innerhalb des Lookup
• 'Multi-Select Lookup' -> CheckedComboBox Multi Selection

=> muss IN (:Company) oder 'Fixed Value' -> Es sollte die Möglichkeit geben, folgende fest definierte Werte zu nehmen: Current Company ID, Current Main Location ID, Current Workstation

5) Option:

• Für den Type 'Input' kann diese Option als Default, Uppercase, Lowercase oder Numeric gesetzt werden,
• für die Typen 'Lookup', 'Lookup(Search)' oder 'Multi-Select Lookup' wird diese Option aus Model, stored procedure, hardcoded values oder SQL genommen.

Mit dem SQL Filter besteht die Möglichkeit, eine Auswahlliste über eine SQL-Abfrage zu definieren.

6) Type Detail: Bei den Typen 'Lookup', 'Lookup(Search)' und 'Multi-Select' kann diese Option aus 'Model', 'Stored Procedure' (ein Paket das eine Funktion enthält) oder 'Hardcoded' (verbotener freier Text) ausgewählt werden.

7) Test Value: Der Testwert-Bereich ist die Spalte in der nach Bedarf Werte für Input, Date, Lookup, Lookup(Search) und Multi-Select Lookup eingefügt werden.

8) Mandatory: Wenn das "?" aus dem SQL-Befehl entfernt wird, ändert sich eine optionale Eingabe in eine verpflichtende

?AND =  :CompanyId => Optional ; 
AND = :CompanyId => Mandatory)

3.2.1 Eine Übersicht der verfügbaren Type Optionen:

Types	Option	Beschreibung
Input	Default	Unbeschränkte Eingabe
	Uppercase	Nur GROßBUCHSTABEN
	Lowercase	Nur kleinbuchstaben
	Numeric	Nur Ziffern
	Multiple	Multiple Eingabe; funktioniert nur in Kombination mit der Syntax "in", Beispiel: artnr in (:artnr)
Date	Default	Standard-Datum des Kalenders
Lookup	Model	Unter Type Details kann ein Model aus einer Liste ausgewählt werden.
	Stored Procedure	Im Hintergrund arbeitet ein Package namens PAT_BI_Filters, das für die Auswahl genutzt wird. Derzeit ersetzt durch SQL.
	Hardcoded	Zum Eintragen einer Liste mit festen Werten (a,b,c).
	SQL	Ein SQL Befehl kann unter Berücksichtigung der Firma eingegeben werden (use as :COMPANY_ID).
Lookup (Search)	Model	Unter Type Details kann ein Model aus einer Liste ausgewählt werden.
	Stored Procedure	Im Hintergrund arbeitet ein Package namens PAT_BI_Filters, das für die Auswahl genutzt wird. Derzeit ersetzt durch SQL.
	Hardcoded	Zum Eintragen einer Liste mit festen Werten (a,b,c).
	SQL	Ein SQL Befehl kann unter Berücksichtigung der Firma eingegeben werden (use as :COMPANY_ID).
Multi Select Lookup	Model	Unter Type Details kann ein Model aus einer Liste ausgewählt werden.
	Stored Procedure	Im Hintergrund arbeitet ein Package namens PAT_BI_Filters, das für die Auswahl genutzt wird. Derzeit ersetzt durch SQL.
	Hardcoded	Zum Eintragen einer Liste mit festen Werten (a,b,c).
	SQL	Ein SQL Befehl kann unter Berücksichtigung der Firma eingegeben werden (use as :COMPANY_ID).
Fixed Value	Current Company ID	Bezieht sich auf die gerade ausgewählte Firma.
	Current Workstation	Bezieht sich auf den aktuellen Arbeitsplatz.
	Current Main Location ID	Ist in den "Workstation Settings" definiert.

3.3 Vorschau-Bereich (Datenbereich)

Der Vorschau-Bereich präsentiert eine Datenvorschau aller im SELECT Befehl definierten und eingetragenen Spalten.

3.4 Feld-Bereich

Im Feld-Bereich des BI Creators können die im SELECT Befehl definierten Felder umbenannt und der Feldtyp geändert werden. Die im Feld-Bereich enthaltenen Spalten sind:

• 1) POS: Es besteht die Möglichkeit, mittels Drag and Drop die vom System vorgegebene Position zu ändern,
• 2) Database Name: Spalten-Bezeichnung aus Datenbank und SELECT,
• 3) Code Name: der im WHERE Befehl benutzte Name,
• Display Name from Resource: Name der Datenquelle: Auswahlkästchen, ob der Anzeigenahme der Quelle benutzt werden soll,
• Display Name: Der im Dialog- und ReportBereich benutzte Name,
• Display Type: Datentyp des Feldes (Beispiel: .NET Feldtyp),
• Topsy Turvy: dreht alles um (upside down),
  • Beispiel: select artnr, artkbz, fl_inaktiv from b_artikel (das InActive wird zu Active und ist deshalb einfacher zu lesen).

3.5 Settings

BI Type: Es gibt mehrere Möglichkeiten:

• Default: Das Report Layout wird für die Vorschau verwendet,
• Dashboard: Das Dashboard wird für die Vorschau verwendet,

Show Grid: Zeigt im Standard (Default) die Daten im Netz Design,

Show Pivot Grid: Zeigt im Standard (Default) die Daten im Pivot-Netz Design,

Auto Refreshing: Diese einfache Erweiterung erlaubt ein automatisches Update und neu Laden einer Seite in einem bestimmten Intervall. Dieses Interval wird in Sekunden angegeben.

Auto Refreshing Interval: Definiert die Intervall-Zeit in Sekunden,

Enable Api: Dies ermöglicht den Daten-Aufruf oder die -Anzeige aus verschiedenen Plattformen.

4 Enterprise BI Form

4.1 Dialog Filter Bereich

Der Dialog-Filter Bereich wird für die Anzeige von im BI Creator erstellten Daten genutzt, indem Netz, Pivot-Netz oder ein Report (der im Report Designer erstellt werden kann) verwendet werden.

Datei:Preview(Grid PivotGrid).png

Preview(Grid PivotGrid)

Nach dem Erstellen eines BI Formulars (speichern) ist der nächste Schritt, einen Menüeintrag (Create Menu) als Dialog Form zu erzeugen, der in ListBox geöffnet werden kann. Der Dialog-Filter Bereich zum Bearbeiten von Filterwerten (über die WHERE Klausel) verwendet, um die Daten als Netz oder Pivot-Netz darzustellen.

Create Menu Tab

Im BI Form Dialog kann die Vorgabe genutzt und die Daten können in der Vorschau dargestellt werden (Vorschau als Netz oder Pivot-Netz). Als Beispiel erzeugen wir einen Report basierend auf den Daten aus dem vorher verwendeten SELECT.

<syntaxhighlight lang="sql">
SELECT * from B_PRODPLAN
WHERE ARTNR = :ARTNR
?AND FORM = :FORM
</syntaxhighlight>

Reporting Area

Overview Enterprise Client Menu

5 Report Designer

Die Enterprise Client Reports Suite bietet einen vollständigen anpassbaren Endbenutzer-Report-Designer für das Erstellen bzw. bearbeiten von vorhanden Reports. Enterprise Client Reports Administration zeigt eine Übersicht über die vorhandenen Reports und deren Kategorien, die vom Entwickler erstellt werden müssen.

Enterprise Client Report Designer

Report Administration

6 PAT Mobile BI

PAT BI

Das BI Tool ist eine Melde-Anwendung, die Hand in Hand mit PAT Enterprise zusammenarbeitet. Im PAT Enterprise gibt es einen Report Creator, der hier beschrieben ist.

Reports, die im Enterprise zugefügt wurden, können in PAT Mobile ebenfalls gesehen werden.

Mit Klick auf “BI” bekommt man eine Übersicht auf alle erstellten Reports. Nach Anklicken des >>Open Report<< Button erscheint ein Filter, der genauso funktioniert wie im PAT Enterprise. Dieser gespeicherte Filter kann in beiden Programmen verwendet werden. Nach dem Anwenden des Filters erhält man die Report Daten.

Gibt es ein gespeichertes Report-Layout, kann man diesen Report entweder im XLSX- oder im PDF-Format herunterladen. Einfach das gewünschte Layout in der Combobox auswählen und das gewünschte Format anklicken, dann startet der Download automatisch.

Report Administration

BI Creator

Overview Enterprise Client Menu