Voraussetzung

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

Aussuchen des Reports

Suche des Reports, der kopiert werden soll im Portal uns sicher stellen, dass dieser richtig arbeitet.:

• 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 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"

Image Removed

indem Sie die Jasper-Dateiname EXAKT anpassen wie beim Parameter Präfix Dateiname oben.

Beispielsweise:

...
<param name="jasper" value="MYCOMPANY_Statistics_AcdGroupsReport1.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 (über /home/jtel/shared oder //acd-store/shared) und suchen Sie dort nach

der ursprünglichen

Dateien des kopierten Reportes

. 

Folgende Datei ist wichtig:

Hinweis: Der Report.jasper wird bei jedem Aufruf des Reports neu erstellt, die jrxml ist die ausführbare Datei.

8. Erstellen Sie nun im Verzeichnis shared einen neuen Ordner, z.B. CUST-ME.

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.

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

1. • Öffnen Sie diese Datei mit dbForge
   • Suchen Sie nach Drop Procedure und ändern Sie die folgenden Zeilen entsprechend ab, so dass Ihr eigener Bericht ausgeführt wird.

     
     

     

     
     

   • Drücken Sie Execute und danach Refresh, damit die Änderung aktiv wird.
   • Kopieren Sie nun den Dateiname aus der  Create-Zeile.
   • Ändern Sie danach den Namen der Procedur in der Datei Statistics_AcdAgentCallsReport_CUST-ME.jrxml im Verzeichnis shared/Data/system/jasper und fügen Sie dort den kopierten Namen ein und speichern Sie abschließend die Datei.
   • Gehen Sie nun wieder ins Verzeichnis shared/CUST-ME/reports
   • Kopieren Sie die jrxml-Datei
   • Gehen Sie ins Verzeichnis Shared/Data/system/jasper und fügen Sie dort die kopierte Datei hinzu.
   • Testen Sie im Portal ob der Bericht ausführbar ist.

Voraussetzung:

• jtel-Portal
• Zugriff auf den Fileserver
• Access zur Reporting-API

Suche des Reports, der kopiert werden soll im Portal uns sicher stellen, dass dieser richtig arbeitet.

1. Melden Sie sich als sysadmin an.
2. Öffnen Sie einen zweiten Browser im Incognitomodus.
3. Gehen Sie über das Menü auf Systemeinstellungen und das Untermenü Berichte und erstellen Sie dort einen neuen Bericht über die Schaltfläche NEU. 
   1. Einstellungen im TAB Bericht:
      1. Geben Sie die Technik-ID ein. Am besten Sie verwenden, den Namen des Berichtes, den Sie kopieren wollen und ergänzen diesen um den Namen Ihrer Firma in Klammern (Kundenname) 
      2. Geben Sie dem Bericht einen neuen Namen. Am besten, Sie verwenden den Namen des Berichtes, den Sie kopieren wollen und ergänzen diesen um den Namen Ihrer Firma in Klammern (Kundenname)
      3. Geben Sie den File Namen Präfix ein. Am besten, Sie verwenden den Namen des Berichtes, den Sie kopieren wollen und ergänzen diesen um den Namen Ihrer Firma in Klammern (Kundenname)
      4. Beim WIKI-Link können Sie gerne auf eine eigene Dokumentationsseite verweisen, in der Sie Ihren Bericht dokumentiert oder beschrieben haben.
   2. Einstellungen im TAB Bericht-Parameter
      1. Gehen Sie auf den TAB Report Parameter Kopieren Sie die kompletten Parameter aus dem Ursprungsbericht in ein Notepad und verändern Sie dort den folgenden Eintrag param name = "jasper" - in diesem Beispiel haben wir ergänzt _CUST-ME
      2. Kopieren Sie dann den geänderten Notepad-Eintrag in den TAB Bericht Parameter des neuen Berichtes und speichern Sie den Bericht.
   3. Einstellungen im TAB Rollenzuordnung
      1. Weisen Sie hier die entsprechenden Rechte bzw. Benutzerrollen zu, um sicherzustellen, dass nur berechtigte Personen den Bericht sehen können. Sie können gerne die Rechtezuweisung des Ursprungsberichtes beibehalten, wenn es keine Einschränkungen seitens Betriebsrat oder aus Datenschutzgründen gibt.
4. Gehen Sie nun als sysadmin in die Sicherheitsgruppe Reseller und wählen Sie dort den TAB Berichte.
   1. über die Schaltfläche Hinzufügen bekommt der Reseller das Recht, den Bericht zu sehen.
5. Wechseln Sie nun auf Reseller-Admin und bearbeiten Sie die Sicherheitsgruppe Clients
   1. über die Schaltfläche Hinzufügen bekommt der Client das Recht, den Bericht zu sehen.
6. Wechseln Sie nun auf den Client-Admin und bearbeiten Sie die Sicherheitsgruppe Client-Administrator und Supervisor nacheinander
   1. über die Schaltfläche Hinzufügen bekommt der Client-Administrator und der Supervisor das Recht, den Bericht zu sehen.
7. Gehen Sie nun auf Ihr Filesystem und im Verzeichnis shared/Data/system und suchen Sie dort nach dem ursprünglichen Namen des kopierten Reportes - in unserem Beispiel heißt dieser wie folgt:

Der Report.jasper wird bei jedem Aufruf des Reports neu erstellt, die jrxml ist die ausführbare Datei.

8. Erstellen Sie nun im Verzeichnis shared einen neuen Ordner, z.B. CUST-ME 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.

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

10. Ab der Suche nach querystring war Lewis für mich zu schnell, daher bitte ich einen, der es kann ab da zu dokumentieren.