Voraussetzung

• jtel-Portal
• Zugriff auf den File-Share des Systems /home/jtel/shared bzw. //acd-store/shared
• Access zur Reporting-API-Lizenz-Lizenz

Report Kopieren

Aussuchen des Reports

Suche des Reports, der kopiert werden soll im Portal:

• Melden Sie sich als sysadmin an in einen ersten Browser.
• Navigieren Sie zum gewünschten Report über Systemeinstellungen und das Untermenü Berichte.
• Bearbeiten Sie diesen Report - diese Einstellungen und Parameter benötigen Sie per Copy / Paste für das neue Report.

Erstellen des neuen Berichts

Öffnen Sie einen zweiten Browser im Incognitomodus.

Navigieren Sie zum Menüpunkt Systemeinstellungen und das Untermenü Berichte, und erstellen Sie einen neuen Bericht über die Schaltfläche Neu.

Bericht

Tätigen Sie folgende Einstellungen:

Bericht-Parameter

Kopieren Sie die XML-Definition aus den ersten Bericht, am besten in ein Editor, zum Beispiel Notepad++.

Verändern Sie den Eintrag für <param name="jasper" indem Sie die Jasper-Dateiname EXAKT anpassen wie beim Parameter Präfix Dateiname oben.

Beispielsweise:

...
<param name="jasper" value="MYCOMPANY_Statistics_AcdGroupReport2.jasper"/>
...

Das komplette XML wird nun als Parameter im Reiter Bericht-Parameter beim neuen Bericht eingetragen.

Rollenzuordnung

Weisen Sie hier die entsprechenden Rechte bzw. Benutzerrollen zu, um sicherzustellen, dass der Bericht bei der entsprechenden Rolle ausgeführt werden kann.

Beispielsweise, Berichte bei den eine Auswahl an Agenten und Gruppen benötigt werden, können nur bei den Rollen Mandant und Benutzer ausgeführt werden - da auf der sysadmin und reseller Ebene keine Auswahl an ACD Gruppen und Agenten möglich ist.

Die Rollenzuordnung bestimmt also auf welcher Ebene / Rolle kann dieser Bericht überhaupt sinnvoll funktionieren.

Sicherheitsgruppen

Damit nur berechtigte Personen den Bericht nutzen können, muss es über die Rechtezuweisung des den entsprechenden Accounts zugeordnet werden.

(Beispielsweise):

• Gehen Sie nun als sysadmin in die Sicherheitsgruppe Reseller und wählen Sie dort den TAB Berichte. Über die Schaltfläche Hinzufügen bekommen die Reseller, die dieser Sicherheitsgruppe zugeordnet sind, das Recht, den Bericht zu sehen.
• Wechseln Sie nun auf Reseller-Admin und bearbeiten Sie die Sicherheitsgruppe Clients und wechseln Sie in den Reiter Berichte. Über die Schaltfläche Hinzufügen bekommen die Mandanten das Recht, den Bericht zu sehen, die dieser Sicherheitsgruppe zugeordnet sind.
• Wechseln Sie nun auf den Client-Admin und bearbeiten Sie die Sicherheitsgruppe Client-Administrator und Supervisor nacheinander. Somit geben Sie die Client-Administratoren und Supervisoren das Recht, den Bericht zu sehen.

Als nächster Schritt muss das File System bearbeitet werden. 

File System

Gehen Sie nun auf Ihr Filesystem im Verzeichnis shared/Data/system/jasper (über /home/jtel/shared oder //acd-store/shared) und suchen Sie dort nach der ursprünglichen Datei des zu kopierenden Reports:

Kopieren Sie die .jrxml Datei, und benennen Sie diese dann um, sodass es den Dateinamen-Präfix wie oben bei der Berichtdefinition angegeben, entspricht.

In unseren Beispiel:

• Statistics_AcdGroups1.jrxml

  
  Kopieren zu:

• MYCOMPANY_Statistics_AcdGrousReport1.jrxml
  
  

Abfrage Verändern (Optional)

Stored Procedure

Um die Abfrage zu verändern, sollten Sie eine eigene Stored-Procedure anlegen. Hierauf sollte der neue Bericht verweisen.

Welche Stored-Procedure der Bericht verwendet, können Sie im .jrxml Code für den Bericht nachsehen.

Suchen Sie nach den Abschnitt <queryString - beispielsweise hier:

	<queryString language="SQL">
		<![CDATA[CALL Statistics_AcdGroupReport2($P{period}, $P{granularity}, $P{dtFrom}, $P{dtTo}, $P{serviceLevelSeconds}, $P{hangUpSeconds}, $P{groupsIds}, $P{timeFrom}, $P{timeTo});]]>
	</queryString>

Den Quelltext für die Stored-Procedures finden Sie im Shared-Laufwerk in diversen Verzeichnissen hier: //acd-store/shared/JTELCarrierPortal/DB/MySQL/... 

Die meisten Quelldateien werden mit den Präfix JTELStats. versehen sein.

Suchen Sie die relevante Quelltextdatei, und erstellen Sie eine Kopie davon, den Sie auch dann umbenennen. Der Name orientiert sich am besten an den Namen der .jrxml Datei, jedoch findet die Umbenennung am besten nach den Präfix JTELStats statt.

Beispielsweise:

• JTELStats.Statistics_AcdGroupReport2.sql

  
  Kopieren zu:
  
  

• JTELStats.MYCOMPANY_Statistics_AcdGroupsReport2.sql

Mit Hilfe des Quellcodes aus dieser neuen Datei, erstellen Sie Ihre neue Stored-Procedure.

Verändern Sie dabei unbedingt den Namen der Stored-Procedure an folgenden Stellen - hier in Gelb mit Nutzung des Beispiels:

Die Stored-Procedure können Sie nun durch Ausführung des Scripts erstellen - etwa über DBForge oder ein anderer Datenbanktool.

Jasper Definition Anpassen im jrxml

Nun verändern Sie in der Bericht Definitionsdatei (.jrxml Datei) den Aufruf selbst, beispielsweise wie folgt:

	<queryString language="SQL">
		<![CDATA[CALL MYCOMPANY_Statistics_AcdGroupReport2($P{period}, $P{granularity}, $P{dtFrom}, $P{dtTo}, $P{serviceLevelSeconds}, $P{hangUpSeconds}, $P{groupsIds}, $P{timeFrom}, $P{timeTo});]]>
	</queryString>

Source Code

Es empfiehlt sich, dass Sie ein eigenes Verzeichnis anlegen - beispielsweise MYCOMPANY, indem Sie die Quelldateien für den neuen Bericht sowie die Stored-Procedure speichern und tracken können.

Hier sollten Sie den Quellcode für:

• die .jrxml Datei 
• die .xml Definition des Reports
• die Stored Procedure

ablegen. 

Wenn Sie hierauf ein Source-Code Repository installieren (git, subversion oder ähnlich), können Sie Ihre Veränderungen leicht künftig auch nachvollziehen.