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_AcdGroupsReport1AcdGroupReport2.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. Ü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.

File System

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

Folgende Datei ist wichtig:

Kopere Si de .jrxml datei, und benennen Sie diee dann um, sodass es denatinamen-Päfixwie oben bei der Berichtdefinition angegeben, beinhaltet.

In unseren Beispiel:

• Statistics_AcdGroups1rxml

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

• MYCOMPANY_Sttitics_AcdGrousReport1.jrxml
  
  

AbfrageVerädrn (Optional)

In unseren Beispiel:Um die Abfrage zvändern, olln Sie eine eigene Stored-Procedure anlegen. Hierauf soerneue Beichtverween.

• Statistics_AcdGroupsReport1AcdGroupReport2.jrxml

  
  Kopieren zu:
  
  

• MYCOMPANY_Statistics_AcdGroupsReport1AcdGroupReport2.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 davon werden mit den Präfix JTELStats. versehen sein.

Suchen Kopieren Sie die relevante Quelltextdatei, und benennen Sie diese um. erstellen Sie eine Kopie davon, den Sie auch 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:

Image Added

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. 

9. Erstellen Sie einen Unterordner "reports" und kopieren Sie dort den Ursprungsbericht hin und dann benennen Sie diesen um in den Namen, den Sie im Notepadeintrag gewählt haben - siehe Punkt 3.b.i.

10 . Testen Sie den neuen Bericht ob er läuft.

11. Passen Sie nun die Parameter in der Procedur an. Um die Procedur zu finden, die Sie ändern wollen, führen Sie folgende Schritte durch:

1. • Gehen Sie ins Filesystem auf den Ordner shared/CUST-ME/reports
   • Editieren Sie die Datei mit Notepad
   • Suchen Sie in dieser Datei nach "queryString", dann  sehen Sie den Pfad der Procedur, den Sie anpassen müssen - siehe Screenshot.

Image Removed

12. Gehen Sie nun ins Verzeichnis shared/JTELCarrierPortal/DB/mySQL/acd/Procedures und suchen Sie hier die Procedur (oben gelb markiert)

Image Removed

SPEICHERN SIE DIESER JEDOCH NICHT IMJTELCarrerPortal.Die get ihnen ggf. beim Upd

Souc Coe

Es empfiehlt sich, dass Sie eigesVerzeichis anlgen - beispielsweise MYCOMPANY, indem Sie die Qlldateiefü en uen Beichtsowie die Stored-Procedure speichern und tracken können

Hier sollten Sie den Quellcode für:

• die .jrxml Datei 
• die xmlDefinition des Reports
• die tored Procedure

ablegen.

Wenn Sie hierauf ein Repository (git, subversion etc.) legen, können Sie die Veränderungen leicht nachvollziehen

.