<?xml version='1.0' encoding='ISO-8859-1'?>
<!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
<!-- $Id: stats.xml,v 1.1 2010/12/01 10:43:32 mg Exp $ -->

<chapter id='statistic-module'>
<title>Statistikmodul</title>

<para>
Statistiken und Reports sind fr Unternehmen existenziell.
An Hand der Statistiken knnen Informationen ausgewertet, beurteilt
und zu guter letzt fundiert Entscheidungen getroffen werden.
</para>

<para>
Die Anforderungen an ein Statistikmodul sind vielfltig.
</para>

<para>
<itemizedlist>
<listitem>
    <para>
    es mssen verschiedene OTRS-Module ausgewertet werden knnen,
    </para>
</listitem>
<listitem>
    <para>
    es muss dem Rechtekonzept der jeweiligen Installation Rechnung
    getragen werden,
    </para>
</listitem>
<listitem>
    <para>
    komplexe Statistiken mssen generiert werden knnen,
    </para>
</listitem>
<listitem>
    <para>
    die Konfiguration einer Statistik muss schnell und einfach
    durchfhrbar sein,
    </para>
</listitem>
<listitem>
    <para>
    eine hohe Performance muss gegeben sein,
    </para>
</listitem>
<listitem>
    <para>
    verschiedene Ausgabevarianten mssen untersttzt werden.
    </para>
</listitem>
</itemizedlist>
</para>

<para>
Das Statistikmodul versucht diese Anforderungen zu vereinigen.
Kern des Ganzen ist dabei eine grafische Benutzeroberflche,
durch die sich Statistiken per Mausklick konfigurieren lassen.
</para>

<para>
Um komplexe Statistiken abzubilden, besteht ferner die Mglichkeit
statische Elemente zu integrieren (Dateien die die Funktionalitt
des Statistik-Moduls um ganz spezifische Anforderungen ergnzen).
</para>

<para>
Hinzu kommt, dass Anforderungen zum Thema
"Auswertung personenbezogener Daten" bercksichtigt werden, so ist
es z. B. in der Standardkonfiguration nicht mglich, direkt Auswertungen ber
die Aktivitten einzelner Agents zu erstellen.
</para>

<para>
Alles in allem ermglicht das Statistik-Modul OTRS-Anwendern
schnell und unproblematisch die Auswertung der Aktivitten auf ihrem
System.
</para>

<sect1 id='stats-usage'>
<title>Bedienung des Moduls durch den Agent</title>

<para>
Wurde das Statistik-Modul erfolgreich durch den OTRS-Admin
installiert und konfiguriert,  erhlt jeder Agent mit Schreib-
oder/und Leserechten den zustzlichen Modullink "Statistiken"
in der Navigationsleiste.
</para>

<para>
<screenshot>
<screeninfo>Das Statistikmodul</screeninfo>
<graphic srccredit="stats-icon - Screenshot" scale="40" fileref="screenshots/stats-icon.png"></graphic>
</screenshot>
</para>

<para>
Ferner werden nach der Auswahl des Links verschiedene Aktionslinks
fr das Statistikmodul in der Navigationsleiste angezeigt.
</para>

<para>
<itemizedlist>
<listitem>
    <para>
    "bersicht"
    </para>

    <para>
    wird auch automatisch nach der Auswahl des Modullinks
    "Statistiken" angezeigt
    </para>
</listitem>
<listitem>
    <para>
    "Neu"
    </para>

    <para>
    rw-Rechte erforderlich
    </para>
</listitem>
<listitem>
    <para>
    "Import"
    </para>

    <para>
    rw-Rechte erforderlich
    </para>
</listitem>
<listitem>
    <para>
    "Einstellungen"
    </para>

    <para>
    Oberflche fr persnliche Einstellungen in OTRS
    </para>
</listitem>
</itemizedlist>
</para>

<sect2 id='stats-overview'>
<title>bersicht</title>

<para>
Hierbei handelt es sich um die Auflistung aller vorkonfigurierten
Statistiken, die der Agent benutzen darf.
</para>

<para>
Zur bersicht gelangt man am besten durch die Auswahl des
Aktionslinks "bersicht" in der Navigationsleiste, wenn zuvor der
Link "Statistik" ausgewhlt wurde. Ferner gelangt man automatisch zur
bersicht des Statistik-Moduls, wenn man den Modullink "Statistik"
in der Navigationsleiste folgt.
</para>

<para>
<screenshot>
<screeninfo>bersicht mit den Standardstatistiken</screeninfo>
<graphic srccredit="stats-overview - Screenshot" scale="40" fileref="screenshots/stats-overview.png"></graphic>
</screenshot>
</para>

<para>
Folgende Informationen sind den in der bersicht aufgelisteten
Statistiken zu entnehmen:
</para>

<para>
<itemizedlist>
<listitem>
    <para>
    "Stat\#"
    </para>

    <para>
    die eindeutige Statistiknummer
    </para>
</listitem>
<listitem>
    <para>
    "Titel"
    </para>

    <para>
    der Titel der Statistik
    </para>
</listitem>
<listitem>
    <para>
    "Objekt"
    </para>

    <para>
    Objekt, das fr die Generierung der Statistik verwendet wird.
    Wenn es sich um eine statische Statistik handelt,
    wird kein Objekt angezeigt, da kein dynamisches
    Objekt zur Generierung verwendet wird.
    </para>
</listitem>
<listitem>
    <para>
    "Beschreibung"
    </para>

    <para>
    Ein Auszug aus der Beschreibung
    </para>
</listitem>
</itemizedlist>
</para>

<para>
Oberhalb der Auflistung befindet sich eine Ergebnisanzeige. Sie
gibt Auskunft ber die Anzahl der zugnglichen Statistiken. Bei
mehrseitigen Auflistungen kann der Agent in den einzelnen
bersichtsseiten blttern.
</para>

<para>
Die blauen "Auf"- und "Ab"-Icons in der Benamungszeile ermglichen
dem Agent eine Sortierung der Statistiken nach eigenen Bedrfnissen.
</para>

<para>
Will man nun eine Statistik generieren, whlt man einfach die
gewnschte Statistik aus, indem man den Link der Statistiknummer
folgt. Anschlieend gelangt man in die Oberflche "Ansehen".
</para>

<para>
Wird das Statistik-Modul initial verwendet, werden sofort einige
Musterstatistiken importiert.
</para>
</sect2>

<sect2 id='stats-viewing-generating'>
<title>Ansehen und Generieren von Statistiken</title>

<para>
Aufgabe der "Ansehen"-Oberflche ist es, dem Agent einen berblick
ber die Vorkonfiguration der Statistik zu ermglichen.
</para>

<para>
Ferner kann der Agent im Rahmen der vorkonfigurierten Mglichkeiten
weitere Konfigurationen vornehmen. D. h. der Ersteller einer
Statistikkonfiguration kann bei der Definition der Statistik
festlegen, inwieweit die eigentliche Generierung der Statistik
noch beeinflusst werden kann. Im Extremfall bedeutet dies, dass
der Agent gar keine Vernderung mehr vornehmen kann oder im anderen
Extrem smtliche Attribute beeinflussen darf.
</para>

<para>
<screenshot id="stats-view-screenshot">
<screeninfo>Ansicht einer Statistik</screeninfo>
<graphic srccredit="stats-view - Screenshot" scale="40" fileref="screenshots/stats-view.png"></graphic>
</screenshot>
</para>

<para>
Konkret wird auf dieser Seite folgendes angezeigt:
</para>

<para>
<itemizedlist>
<listitem>
    <para>
    die Menlinks
    </para>

    <para>
    <itemizedlist>
    <listitem>
        <para>
        "Zurck"
        </para>

        <para>
        Link zurck zum Ausgangspunkt
        </para>
    </listitem>
    <listitem>
        <para>
        "Bearbeiten"
        </para>

        <para>
        Link um in die Bearbeiten-Oberflche
        der Statistik zu gelangen
        (rw-Rechte erforderlich)
        </para>
    </listitem>
    <listitem>
        <para>
        "Lschen"
        </para>

        <para>
        Erlaubt das Lschen einer Statistik
        (rw-Rechte erforderlich)
        </para>
    </listitem>
    <listitem>
        <para>
        "Konfiguration exportieren"
        </para>

        <para>
        Exportieren einer Statistikkonfiguration
        mittels Dateidownload (rw-Rechte erforderlich).
        </para>

        <para>
        Verwendung: Mittels der Export- und Importfunktionen
        knnen Statistiken bequem auf Testsystemen entworfen
        und getestet werden, um dann anschlieend einfach in
        das Produktivsystem integriert zu werden.
        </para>
    </listitem>
    </itemizedlist>
    </para>
</listitem>
<listitem>
    <para>
    Meta-Angaben (grauer Block auf der rechten Seite)
    </para>

    <para>
    Dort finden Sie Angaben zu den Erstellern der Statistik. So
    kann man an dieser Stelle entnehmen, wer wann die Statistik
    initial erstellt hat und von wem Sie zuletzt verndert wurde.
    </para>
</listitem>
<listitem>
    <para>
    die eigentlichen Statistikangaben
    </para>

    <para>
    Diese befinden sich im zentralen Block der Oberflche.
    </para>
</listitem>
</itemizedlist>
</para>

<para>
Nachfolgend wird auf die eigentlichen Statistikeingaben eingegangen,
da diese Eingaben die Kerninformationen enthalten.
</para>

<para>
Zuerst erhlt man dabei allgemeine Angaben:
</para>

<para>
<itemizedlist>
<listitem>
    <para>
    "Stat#"
    </para>

    <para>
    die Statistiknummer
    </para>
</listitem>
<listitem>
    <para>
    "Titel"
    </para>

    <para>
    der Titel der Statistik
    </para>
</listitem>
<listitem>
    <para>
    "Objekt"
    </para>

    <para>
    Objekt durch das die Statistik generiert wird
    </para>
</listitem>
<listitem>
    <para>
    "Beschreibung"
    </para>

    <para>
    die Beschreibung gibt einen tieferen Einblick
    ber die Intention der Statistik.
    </para>
</listitem>
<listitem>
    <para>
    "Format"
    </para>

    <para>
    Ausgabeformat der Statistik.
    Hierbei stehen je nach Konfiguration folgende
    Ausgabeformate zur Verfgung:
    </para>

    <para>
    <itemizedlist>
    <listitem>
        <para>
        "CSV" -&gt; Download der Statistik im csv-Format
        </para>
    </listitem>
    <listitem>
        <para>
        "Drucken" -&gt; Druckfhige HTML-Tabelle oder Tabelle im PDF-Format
        </para>
    </listitem>
    <listitem>
        <para>
        "Liniendiagramm"
        </para>
    </listitem>
    <listitem>
        <para>
        "Balkendiagramm"
        </para>
    </listitem>
    <listitem>
        <para>
        "Balkendiagramm (horizontal)"
        </para>
    </listitem>
    <listitem>
        <para>
        "Punktdiagramm"
        </para>
    </listitem>
    <listitem>
        <para>
        "Linienpunktdiagramm"
        </para>
    </listitem>
    <listitem>
        <para>
        "Flchendiagramm"
        </para>
    </listitem>
    <listitem>
        <para>
        "Tortendiagramm"
        </para>
    </listitem>
    </itemizedlist>
    </para>
</listitem>
<listitem>
    <para>
    "Grafikgre"
    </para>

    <para>
    mgliche Gre der Grafik bzw. des Diagramms.
    </para>

    <para>
    <itemizedlist>
    <listitem>
        <para>
        Angabe in Pixeln
        </para>

        <para>
        diese Auswahl bzw. Anzeige erscheint nur,
        wenn die Statistikvorkonfiguration ein
        Diagramm vorsieht bzw. ermglicht.
        </para>
    </listitem>
    <listitem>
        <para>
        Alle generell verwendbaren Grafikgren
        </para>

        <para>
        werden durch den otrs-Admin in der
        SysConfig definiert. Beim
        Konfigurieren der Statistiken kann dann
        der Ersteller alle relevanten Formate
        vorselektieren.
        </para>
    </listitem>
    </itemizedlist>
    </para>
</listitem>
<listitem>
    <para>
    "Zeilensummierung"
    </para>

    <para>
    Gibt an, ob die Statistik durch eine Spalte ergnzt
    wird, deren Zellen die Summe der
    jeweiligen Zeile darstellt.
    </para>
</listitem>
<listitem>
    <para>
    "Spaltensummierung"
    </para>

    <para>
    Angabe, ob die Statistik durch eine
    Zeile ergnzt wird, deren Zellen die Summe
    der jeweiligen Spalte beinhaltet
    </para>
</listitem>
<listitem>
    <para>
    "Cache"
    </para>

    <para>
    Gibt an, ob die errechneten Statistiken im
    Dateisystem gecachet werden.
    </para>
</listitem>
<listitem>
    <para>
    "Gltig"
    </para>

    <para>
    Ist eine vorkonfigurierte Statistik erst im Entstehen
    oder darf sie aus bestimmten Grnden temporr nicht mehr
    ausgefhrt werden so wird das Element "Gltig" auf
    "ungltig" gesetzt. Ferner wird dadurch die Schaltflche
    "Start" rechts unten am Ende des Block ausgeblendet.
    Ein Generieren der Statistik ist somit nicht mglich.
    </para>
</listitem>
<listitem>
    <para>
    "Achsen vertauschen"
    </para>

    <para>
    Diese Option erlaubt es dem Agenten, die X- und
    Y-Achsen zu vertauschen (Diese Funktion muss vom
    OTRS-Administrator freigeschaltet werden).
    </para>
</listitem>
</itemizedlist>
</para>

<para>
Nach den allgemeinen Angaben sieht der Agent die Angaben zur
eigentlichen Statistik. Hierbei kommen grundstzlich zwei
verschiedene Anzeigen zum Einsatz:
</para>

<para>
<itemizedlist>
<listitem>
    <para>
    Anzeige statischer Statistiken:
    </para>

    <para>
    Komplexe Statistiken knnen nicht dynamisch generiert werden.
    Hierfr kann das Statistik-Modul statische Statistik-Generatoren
    integrieren. Diese wurden von Programmierern
    speziell fr die jeweilige Auswertung geschaffen. Durch die
    jeweilige Aufgabenstellung der Statistik ergeben sich
    unterschiedliche Darstellungen.
    </para>

    <para>
    <screenshot>
    <screeninfo>Ansicht der statischen Statistik</screeninfo>
    <graphic srccredit="stats-view-static - Screenshot" scale="40" fileref="screenshots/stats-view-static.png"></graphic>
    </screenshot>
    </para>
</listitem>
<listitem>
    <para>
    Dynamische Statistiken knnen auf zweierlei Weise angezeigt werden:
    </para>

    <para>
    <itemizedlist>
    <listitem>
        <para>
        unvernderbare Einstellungen
        </para>

        <para>
        in diesem Fall hat der Ersteller der Statistik dem Agent,
        der eine Statistik generieren will, keinen Freiraum fr
        Vernderungen gelassen.
        </para>
    </listitem>
    <listitem>
        <para>
        vernderbare Einstellungen
        </para>

        <para>
        Bei derartigen Statistiken ist es dem Agent noch erlaubt
        die vorkonfigurierte Statistik zu verndern.
        </para>
    </listitem>
    </itemizedlist>
    </para>
</listitem>
</itemizedlist>
</para>

<para>
<screenshot>
<screeninfo>Ansicht einer vernderbaren dynamischen Statistik</screeninfo>
<graphic srccredit="stats-view-configurable - Screenshot" scale="40" fileref="screenshots/stats-view-configurable.png"></graphic>
</screenshot>
</para>

<para>
Um eine Statistik zu generieren, muss abschlieend lediglich der
"Start"-Button am rechten unteren Ende des Blocks gedrckt werden.
Sollte einmal der "Start"-Button nicht sichtbar sein, kann dies
zwei Ursachen haben:
</para>

<para>
<orderedlist numeration="arabic">
<listitem>
    <para>
    die Statistik wurde auf ungltig gesetzt und damit deaktiviert.
    </para>
</listitem>
<listitem>
    <para>
    die Statistik wurde nicht sauber konfiguriert und ist noch
    nicht lauffhig. Ist dies der Fall, findet man die ntigen Informationen im
    Notification-Bereich von OTRS (unterhalb der Navigationsleiste).
    </para>
</listitem>
</orderedlist>
</para>

<para>
Bei falschen Einstellungen auf der Ansichtsseite wird nach
Drcken des "Start"-Button wieder die Ansichtseite gezeigt und
im Notificationbereich darauf hingewiesen, welche Eingaben falsch
waren.
</para>
</sect2>

<sect2 id='stats-modify-new'>
<title>Bearbeiten - Neu</title>

<para>
Es gibt fr den Agent zwei Mglichkeiten in die Bearbeitenoberflche des
Statistikmoduls zu gelangen:
</para>

<para>
<orderedlist numeration="arabic">
<listitem>
    <para>
    Durch den Menlink "Bearbeiten" in der Statistikansicht.
    Dadurch kann eine bestehende Statistikkonfiguration
    bearbeitet werden.
    </para>
</listitem>
<listitem>
    <para>
    durch den "Neu"-Link in der Navigationsleiste.
    </para>
</listitem>
</orderedlist>
</para>

<para>
Damit diese Links fr den Agent sichtbar werden, bentigt man fr
dieses Modul Schreibrechte (rw).
</para>

<para>
Das Bearbeiten der Statistiken erfolgt in vier Schritten mit Hilfe eines
Assistenten bzw. Wizards:
</para>

<para>
<orderedlist numeration="arabic">
<listitem>
    <para>
    Allgemeine Angaben zur Statistik
    </para>
</listitem>
<listitem>
    <para>
    Festlegen des Elements fr die X-Achse
    </para>
</listitem>
<listitem>
    <para>
    Festlegen der Wertereihen
    </para>
</listitem>
<listitem>
    <para>
    Festlegen der Einschrnkungen
    </para>
</listitem>
</orderedlist>
</para>

<para>
Die Punkte 2-4 werden nur fr dynamisch zusammengestellte Statistiken
bentigt. Benutzt man eine statische Statistik ist man mit dem Einfgen der
allgemeinen Angaben in Punkt 1. bereits fertig.
</para>

<para>
Fr alle Eingabeoberflchen des Statistik-Moduls gilt: Im Anschluss
an das jeweilige Eingabeformular findet der Benutzer Informationen
zur Bedienung der Seite.
</para>

<para>
Sollte es dennoch zu fehlerhaften Eingaben  kommen, wird die
zuvor bearbeitete Oberflche wieder geladen. Dabei wird die Seite um
Informationen zur fehlerhaften Eingabe ergnzt.
Diese Informationen findet man im Notificationbereich von OTRS.
Erst nachdem ein Formular korrekt ausgefllt wurde, gelangt man zur
nchsten Eingabeoberflche.
</para>

<para>
<orderedlist numeration="arabic">
<listitem>
    <para>
    "Allgemeine Angaben"
    </para>

    <para>
    Die Eingabeoberflche "Allgemeine Angaben" ist die erste Seite des
    Assistenten. Der Ersteller einer Statistik kann dort eine Vielzahl von
    allgemeinen Angaben und Einstellungen ttigen.
    </para>

    <para>
    <screenshot>
    <screeninfo>Allgemeine Angaben zur Statistik</screeninfo>
    <graphic srccredit="stats-bearbeiten-allgemein - Screenshot" scale="40" fileref="screenshots/stats-bearbeiten-allgemein.png"></graphic>
    </screenshot>
    </para>

    <para>
    <itemizedlist>
    <listitem>
        <para>
        "Titel"
        </para>

        <para>
        Er soll kurz und prgnant die Aufgabe der Statistik wiedergeben.
        </para>
    </listitem>
    <listitem>
        <para>
        "Beschreibung"
        </para>

        <para>
        Hier werden Informationen eingetragen, die einen
        tieferen Einblick in die Aufgabenstellung, Art
        der Konfigurationsparameter, usw. erlauben.
        </para>
    </listitem>
    <listitem>
        <para>
        "Dynamisches Objekt"
        </para>

        <para>
        Sollte die OTRS-Installation ber mehrere
        dynamische Objekte verfgen, kann hier das
        gewnschte Objekt ausgewhlt werden. Die
        Objekte sind jeweils auf die Anforderungen
        des entsprechenden Moduls ausgelegt.
        </para>
    </listitem>
    <listitem>
        <para>
        "Statische Datei"
        </para>

        <para>
        An dieser Stelle kann eine gewnschte statische
        Datei ausgewhlt werden. Diese Auswahl wird fr
        gewhnlich nicht erscheinen, da nur die statischen
        Dateien angezeigt werden, die noch keiner Statistik
        zugeordnet wurden! Wenn der Punkt "Statische Datei"
        angezeigt wird, ist es wichtig im Formular
        durch die Auswahl des Optionsfelds die gewnschte
        Generierungsart auszuwhlen (Dynamisch durch ein
        dynamisches Objekt oder statisch durch eine Datei).
        Wird eine statische Datei ausgewhlt entfallen die
        Eingabeoberflchen 2-4, da die statische Datei die
        ntigen Konfigurationen bereits mitbringt.
        </para>
    </listitem>
    <listitem>
      <para>
        "Rechtevergabe"
        </para>

        <para>
        Durch die Rechtevergabe kann man regeln, welche Gruppen
        (und dadurch welche Agents) die vorkonfigurierten Statistiken
        spter ansehen und generieren knnen. So knnen die
        verschiedenen Statistiken auf die verschiedenen Abteilungen
        und Arbeitsgruppen aufgeteilt werden, die diese bentigen.
        Eine Mehrfachauswahl ist dabei mglich.
        </para>

        <para>
        Beispiel 1: Es wurde die Gruppe "stats" selektiert. Dann wird diese Statistik
        fr alle sichtbar die mindestens ro-Rechte auf die Gruppe "stats" haben. In der
        Standardkonfiguration bedeutet dies aber, dass alle Benutzer die Statistiken erzeugen
        knnen diese Statistik sehen knnen, da in der Standardkonfiguration ro-Rechte in der
        Gruppe "stats" Grundbedingung ist um berhaupt in den Ansichtsmodus des Statistikmoduls
        zu gelangen.
        </para>

        <para>
        Beispiel 2: Es wurde eine Gruppe namens "sales" selektiert. Alle Benutzer die ro-Rechte
        in der Gruppe "sales" haben knnen nun diese Statistik im Ansichtsmodus sehen und generieren.
        Anderen Benutzern, die in der Lage sind Statistiken zu generieren wird dann diese Statistik nicht
        angeboten.
        </para>
    </listitem>
    <listitem>
        <para>
        "Format" Ausgabeformat der Statistik
        </para>

        <para>
        Hierbei stehen je nach Konfiguration folgende
        Ausgabeformate zur Verfgung:
        </para>

        <para>
        <itemizedlist>
        <listitem>
            <para>
            "CSV" -&gt; Statistik im csv-Format
            </para>
        </listitem>
        <listitem>
            <para>
            "Drucken" -&gt; Druckfhige HTML-Tabelle oder Tabelle im PDF-Format
            </para>
        </listitem>
        <listitem>
            <para>
            "Liniendiagramm"
            </para>
        </listitem>
        <listitem>
            <para>
            "Balkendiagramm"
            </para>
        </listitem>
        <listitem>
            <para>
            "Balkendiagramm (horizontal)"
            </para>
        </listitem>
        <listitem>
            <para>
            "Punktdiagramm"
            </para>
        </listitem>
        <listitem>
            <para>
            "Linienpunktdiagramm"
            </para>
        </listitem>
        <listitem>
            <para>
            "Flchendiagramm"
            </para>
        </listitem>
        <listitem>
            <para>
            "Tortendiagramm"
            </para>
        </listitem>
        </itemizedlist>
        </para>

        <para>
        Eine Mehrfachauswahl ist mglich.
        </para>
    </listitem>
    <listitem>
        <para>
        "Grafikgre"
        </para>

        <para>
        Hier kann ausgewhlt werden, in welchen Gren die
        Diagramme ausgegeben werden drfen.
        </para>

        <para>
        <itemizedlist>
        <listitem>
            <para>
            Angabe in Pixeln
            </para>
        </listitem>
        <listitem>
            <para>
            diese Auswahl ist nur sinnvoll, wenn unter dem Punkt "Format"
            ein grafisches Ausgabeformat ausgewhlt wurde.
            </para>
        </listitem>
        <listitem>
            <para>
            alle generell verwendbaren Grafikgren werden
            durch den OTRS-Admin in der SysConfig
            definiert. Bei der Konfiguration der
            Statistiken kann der Ersteller alle
            relevanten Formate vorselektieren.
            </para>
        </listitem>
        </itemizedlist>
        </para>
    </listitem>
    <listitem>
        <para>
        "Zeilensummierung"
        </para>

        <para>
        Wird im Pulldownmen "Ja" ausgewhlt, wird die Statistik durch
        eine Spalte ergnzt, deren Zellen die Summe der jeweiligen
        Zeile darstellt.
        </para>
    </listitem>
    <listitem>
        <para>
        "Spaltensummierung"
        </para>

        <para>
        Angabe, ob die Statistik durch eine Zeile ergnzt
        wird, deren Zellen die Summe der jeweiligen Spalte
        beinhaltet.
        </para>
    </listitem>
    <listitem>
        <para>
        "Cache"
        </para>

        <para>
        Wird im Pulldownmen "Ja" ausgewhlt, werden die errechneten
        Statistiken im Dateisystem gecachet. Dies spart
        Rechenleistung und Zeit, sollte genau diese Statistik wieder
        aufgerufen werden.
        </para>

        <para>
        Diese Funktion ist jedoch nur sinnvoll, wenn sichergestellt ist, dass
        sich der Inhalt der Statistik nicht mehr ndert. Dies ist genau
        zu prfen, bevor man die Cachingfunktion nutzt.
        </para>

        <para>
        Bei folgenden Situationen wird das Cachen automatisch verhindert.
        </para>

        <para>
        <itemizedlist>
        <listitem>
            <para>
            wenn die Statistik keinerlei Zeitangaben enthlt.
            (Es kommen laufend neue Daten hinzu)
            </para>
        </listitem>
        <listitem>
            <para>
            wenn eine Zeitangabe in der Zukunft liegt
            </para>
        </listitem>
        </itemizedlist>
        </para>

        <para>
        Sollte eine Statistik zwischenzeitlich wieder bearbeitet werden,
        werden alle gecachten Daten wieder gelscht.
        </para>
    </listitem>
    <listitem>
        <para>
        "Gltig"
        </para>

        <para>
        Ist eine vorkonfigurierte Statistik erst im Entstehen
        oder darf sie aus bestimmten Grnden temporr nicht mehr
        ausgefhrt werden, so wird das Element "Gltig" auf "ungltig"
        gesetzt. Ferner wird dadurch die Schaltflche "Start" in der
        "Ansehen" Oberflche ausgeblendet. Ein Generieren
        der Statistik ist somit nicht mglich.
        </para>
    </listitem>
    </itemizedlist>
    </para>

    <para>
    Durch Drcken der Schaltflche "Weiter" gelangt man in die nchste
    Oberflche des Wizards.
    </para>
</listitem>
<listitem>
    <para>
    "X-Achse"
    </para>

    <para>
    Nach dem Bearbeitungsschritt "Allgemeine Angaben" folgt das Formular
    "X-Achse".
    </para>

    <para>
    <screenshot>
    <screeninfo>Festlegen des Elements fr die X-Achse</screeninfo>
    <graphic srccredit="stats-edit-xaxis - Screenshot" scale="40" fileref="screenshots/stats-edit-xaxis.png"></graphic>
    </screenshot>
    </para>

    <para>
    Hier wird eingestellt welches Element fr die Darstellung der X-Achse
    verwendet wird, bzw. bei Tabellen, welche Spaltenbezeichnung die
    Statistik bekommt.
    </para>

    <para>
    Als erstes whlt man ein Element per Optionsfeld aus.
    Anschlieend mssen zwei oder mehr Attribute des Elements selektiert
    werden. Werden keine Attribute des Elements ausgewhlt, werden alle
    Attribute verwendet, auch solche die nach der Konfiguration der
    Statistik hinzukommen.
    </para>

    <para>
    Entfernt man den Haken "Fixiert" in der Checkbox, kann der Agent, der die
    Statistik erstellt, die Attribute des entsprechenden Elements in der
    "Ansehen"-Oberflche verndern.
    </para>

    <para>
    Eine Besonderheit stellen Zeitelemente dar, hier ist die Zeitspanne und
    die Skalierung anzugeben.
    </para>

    <para>
    Die Art und Anzahl der Elemente ergibt sich durch das verwendete
    dynamische Objekt und ist von Objekt zu Objekt verschieden.
    </para>

    <para>
    Wurden alle Eingaben richtig gettigt, gelangt man nach der Auswahl des
    "Weiter" Schalters zu dem Formular "Wertereihen". Ebenfalls gibt es die
    Mglichkeit, einen Bearbeitungsschritt zurck zu gehen und
    nochmals die Oberflche "Allgemeine Angaben" zu bearbeiten.
    </para>
</listitem>
<listitem>
    <para>
    "Wertereihen"
    </para>

    <para>
    Im dritten Schritt der Vorkonfiguration einer Statistik werden die
    Wertereihen der Statistik festgelegt. Sie bilden spter die einzelnen
    Grafen des Diagramms (grafische Darstellung) oder die einzelnen
    Reihen (tabellarische Darstellung).
    </para>

    <para>
    <screenshot>
    <screeninfo>Festlegen der Wertereihen</screeninfo>
    <graphic srccredit="stats-edit-valueseries - Screenshot" scale="40" fileref="screenshots/stats-edit-valueseries.png"></graphic>
    </screenshot>
    </para>

    <para>
    Wird ein Element selektiert, entspricht jedes ausgewhlte Attribut
    einer Wertereihe.
    </para>

    <para>
    <example id='stats-value-series-1'>
    <title>Festlegen einer Wertereihe bei einem Element</title>

    <para>
    Element Queue:
    </para>

    <para>
    <itemizedlist>
    <listitem>
        <para>
        Wertereihe 1 = Raw
        </para>
    </listitem>
    <listitem>
        <para>
        Wertereihe 2 = Junk
        </para>
    </listitem>
    <listitem>
        <para>
        ....
        </para>
    </listitem>
    </itemizedlist>
    </para>
    </example>
    </para>

    <para>
    Werden zwei Elemente selektiert, wird jedes ausgewhlte Attribut
    des ersten Elements kombiniert mit einem Attribut des zweiten Elements
    zu einer Wertereihe.
    </para>

    <para>
    <example id='stats-value-series-2'>
    <title>Festlegen einer Wertereihe bei zwei Elementen</title>
    <para>
    Element 1 Queue und Element 2 Status:
    </para>

    <para>
    <itemizedlist>
    <listitem>
        <para>
        Wertereihe 1 = Raw-offen
        </para>
    </listitem>
    <listitem>
        <para>
        Wertereihe 2 = Raw-erfolgreich geschlossen
        </para>
    </listitem>
    <listitem>
        <para>
        Wertereihe 3 = Junk-offen
        </para>
    </listitem>
    <listitem>
        <para>
        Wertereihe 4 = Junk-erfolgreich geschlossen
        </para>
    </listitem>
    </itemizedlist>
    </para>
    </example>
    </para>

    <para>
    Die Auswahl von drei oder mehr Elementen ist nicht sinnvoll und wird
    deshalb durch eine Fehlermeldung verhindert.
    </para>

    <para>
    Ferner gelten noch die gleichen Bedingungen zur Auswahl der
    Attribute und zur "Fixiert" Checkbox wie bei der "X-Achsen" Auswahl.
    </para>

    <para>
    <itemizedlist>
    <listitem>
        <para>
        Werden keine Attribute des Elements ausgewhlt, werden alle
        Attribute verwendet, auch solche die nach der Konfiguration der
        Statistik hinzukommen.
        </para>
    </listitem>
    <listitem>
        <para>
        Entfernt man den Haken "Fixiert" in der Checkbox, kann der Agent
        der die Statistik erstellt, die Attribute des entsprechenden
        Elements verndern.
        </para>
    </listitem>
    </itemizedlist>
    </para>
</listitem>
<listitem>
    <para>
    "Einschrnkungen"
    </para>

    <para>
    Vierter und letzter Schritt bei der Vorkonfiguration ist das Festlegen
    der Einschrnkungen. Hier ist es mglich die Ergebnisse
    einer Statistik durch die Angabe von Bedingungen einzuschrnken.
    Vergleichbar ist dies mit Eingaben in eine Suchoberflche.
    </para>

    <para>
    <screenshot>
    <screeninfo>Festlegen der Einschrnkungen</screeninfo>
    <graphic srccredit="stats-edit-restrictions - Screenshot" scale="40" fileref="screenshots/stats-edit-restrictions.png"></graphic>
    </screenshot>
    </para>

    <para>
    Es kann durchaus vorkommen, dass keine Einschrnkungen gettigt werden
    mssen.
    </para>

    <para>
    Nachdem man alle Einschrnkungen gettigt hat, drckt man den Button
    "Abschlieen". Dadurch beendet man die Vorkonfiguration der Statistik
    und gelangt in die "Ansehen" Oberflche.
    </para>
</listitem>
</orderedlist>
</para>

</sect2>

<sect2 id='stats-import'>
<title>Importieren</title>

<para>
Durch die Auswahl des "Import"-Links bzw. -Icons in der Navigationsleiste
gelangt man in die Importoberflche (rw-Rechte erforderlich).
</para>

<para>
<screenshot>
<screeninfo>Die Import-Oberflche</screeninfo>
<graphic srccredit="stats-import - Screenshot" scale="40" fileref="screenshots/stats-import.png"></graphic>
</screenshot>
</para>

<para>
Durch sie knnen Statistiken importiert werden. Dies ist im Zusammenhang
mit der Exportfunktion des Moduls eine sehr hilfreiche Funktionalitt.
So knnen Statistiken bequem auf Testsystemen entworfen und getestet
werden, um sie spter auf dem Produktivsystem zu importieren.
</para>

<para>
Der Import geschieht dabei ganz einfach durch einen Dateiupload.
Anschlieend gelangt man automatisch in die Ansehenoberflche der
importierten Statistik.
</para>

</sect2>

</sect1>

<sect1 id='stats-managing-the-module'>
<title>Verwaltung des Statistik-Moduls durch den OTRS-Administrator</title>

<para>
In diesem Abschnitt werden die Aufgaben und Mglichkeiten des
OTRS-Administrators in Bezug auf das Statistikmodul angesprochen.
</para>

<sect2 id='stats-permissions'>
<title>Rechte, Gruppen und Queues</title>

<para>
Durch die Installation des Statistikmoduls
werden keine neuen Queues oder/und Gruppen angelegt.
</para>

<para>
Durch die Standardkonfiguration der Modulregistrierung haben alle
Agenten, die Rechte in der "stats"-Gruppe haben, Zugriff auf das
Statistikmodul.
</para>

<para>
Zugangsmglichkeiten auf Grund der Rechte:
</para>

<para>
<itemizedlist>
<listitem>
    <para>
    "rw" -&gt; darf Statistiken konfigurieren
    </para>
</listitem>
<listitem>
    <para>
    "ro" -&gt; darf vorkonfigurierte Statistiken generieren
    </para>
</listitem>
</itemizedlist>
</para>

<para>
Ob nun dem jeweiligen Agenten, der spter vorkonfigurierte Statistiken
generieren darf, ro-Rechte in der "stats" Gruppe zugewiesen werden oder
in der Modulregistrierung der SysConfig die dem Agent entsprechenden Gruppen
ergnzt werden, bleibt dem OTRS-Administrator und dessen Anforderungen
berlassen.
</para>

</sect2>

<sect2 id='stats-sysconfig'>
<title>SysConfig</title>

<para>
Die SysConfig-Gruppen

<link linkend="Framework:Core::Stats">
Framework:Core::Stats
</link>

,

<link linkend="Framework:Core::Stats::Graph">
Framework:Core::Stats::Graph
</link>

und

<link linkend="Framework:Frontend::Agent::Stats">
Framework:Frontend::Agent::Stats
</link>

enthalten alle Konfigurationsparameter zur grundlegenden Einstellung des
Statistik-Moduls. Weiterhin regelt der Konfigurationsparameter

<link linkend="Framework:Frontend::Agent::ModuleRegistration:Frontend::Module_AgentStats">
$Self-&gt;{'Frontend::Module'}-&gt;{'AgentStats'}
</link>

die Anordnung und Registrierung der Module und Icons innerhalb des
Statistik-Moduls selbst.
</para>

</sect2>

</sect1>

<sect1 id='stats-managing-the-stats-module-by-the-sysadmin'>
<title>Verwaltung des Statistik-Moduls durch den System-Administrator</title>

<para>
Grundstzlich ist bei der Bedienung, Konfiguration und Wartung
des Statistikmoduls kein System-Administrator notwendig. An dieser
Stelle sollen nur einige Hintergrundinformationen fr den System-
Administrator gegeben werden.
</para>

<note>
<para>
Pfadangaben beziehen sich auf Unterverzeichnisse des
OTRS-Homeverzeichnisses (meist <filename>/opt/otrs</filename>.
</para>
</note>

<sect2 id='stats-db-table'>
<title>Datenbanktabelle</title>

<para>
Alle Statistikkonfigurationen werden in XML umgesetzt und verwaltet.
Dies bedeutet unter anderem, dass alle Statistikkonfigurationen in der
Datenbanktabelle "xml\_storage" gespeichert werden.
Diese Tabelle wird auch von anderen Modulen benutzt, deren Inhalte im
XML-Format dargestellt werden.
</para>
</sect2>

<sect2 id='stats-filelist'>
<title>Auflistung aller Dateien</title>

<para>
Folgende Dateien sind fr die fehlerfreie Funktion des Statistikmoduls
notwendig.
</para>

<para>
<itemizedlist>
<listitem>
<para>
<filename>Kernel/System/Stats.pm</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/Modules/AgentStats.pm</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/System/CSV.pm</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/Output/HTML/Standard/AgentStatsOverview.dtl</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/Output/HTML/Standard/AgentStatsDelete.dtl</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/Output/HTML/Standard/AgentStatsEditSpecification.dtl</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/Output/HTML/Standard/AgentStatsEditRestrictions.dtl</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/Output/HTML/Standard/AgentStatsEditXaxis.dtl</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/Output/HTML/Standard/AgentStatsEditValueSeries.dtl</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/Output/HTML/Standard/AgentStatsImport.dtl</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/Output/HTML/Standard/AgentStatsPrint.dtl</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/Output/HTML/Standard/AgentStatsView.dtl</filename>
</para>
</listitem>
<listitem>
<para>
<filename>Kernel/System/Stats/Dynamic/Ticket.pm</filename>
</para>
</listitem>
<listitem>
<para>
<filename>bin/mkStats.pl</filename>
</para>
</listitem>
</itemizedlist>
</para>

</sect2>

<sect2 id='stats-caching'>
<title>Caching</title>

<para>
Bei der Vorkonfiguration von Statistiken kann eingestellt
werden, ob die Ergebnisse einer Statistik gecachet werden oder
nicht. Gecachete Statistikergebnisse werden als Datei im
Verzeichnis <filename>var/tmp</filename> der OTRS-Installation
gespeichert (meist <filename>/opt/otrs/var/tmp</filename>).
</para>

<para>
Alle gecacheten Statistiken sind dabei durch das Prfix "Stats" zu erkennen.
</para>

<para>
Sollten diese Dateien verloren gehen, ist dies nicht weiter
schlimm. Beim nchsten Aufruf dieser Statistik
kann das Statistikmodul diese Datei nicht mehr finden und
muss deshalb die Statistik neu errechnen, was etwas Zeit
beanspruchen kann.
</para>


</sect2>

<sect2 id='stats-mkstats'>
<title>mkStats.pl</title>

<para>
Diese Datei befindet sich im Verzeichnis <filename>bin/</filename>.
Durch sie ist es mglich Statistiken per Kommandozeile
zu generieren.
</para>

<para>
Exemplarisch soll hierzu folgender Kommandozeilenaufruf
stehen:
</para>

<para>
<programlisting>
bin&gt; perl mkStats.pl -n 10004 -o /output/dir
</programlisting>
</para>

<para>
Dabei wird eine Statistik aus der Statistikkonfiguration "Stat# 10004"
generiert und als csv in das Verzeichnis <filename>/output/dir</filename>
gespeichert.
</para>

<para>
Ferner kann die generierte Statistik auch per Email versandt werden.
Mehr Informationen erhlt man durch den Aufruf
</para>

<para>
<programlisting>
bin&gt; perl mkStats.pl --help
</programlisting>
</para>

</sect2>

<sect2 id='stats-cron'>
<title>Automatisiertes Generieren von Statistiken - Cron</title>

<para>
Sinnvoll ist das Generieren von Statistiken per Hand ber
die Kommandozeile natrlich nicht unbedingt, da das
Statistikmodul eine geeignete grafische Oberflche bietet.
Interessant wird die Generierung von Statistiken per Kommandozeile
aber in Kombination mit einem Cronjob.
</para>

<para>
Folgendes Szenario ist denkbar: Ein Abteilungsleiter
wnscht pnktlich zum ersten eines Monats eine Statistik
zum abgelaufenen Monat. Durch die Kombination Cronjob
und Kommandozeilenaufruf ist man in der Lage automatisiert
zu Beginn eines Monats dem Abteilungsleiter die
gewnschte Statistik per Email zukommen zu lassen.
</para>

</sect2>

<sect2 id='stats-static'>
<title>Statische Statistiken</title>

<para>
Das Statistikmodul bietet die Mglichkeit statische Statistiken
zu generieren. Fr jede statische Statistik gibt es eine
Datei in der die Inhalte der Statistik genau definiert sind.
</para>

<para>
Vorteil dieser Art von Statistik ist, dass dadurch sehr komplexe
Statistiken erzeugt werden knnen. Der Nachteil ist wiederum
die mangelnde Flexibilitt dieser Statistiken.
</para>

<para>
Gespeichert werden diese Dateien unter folgendem Pfad
<filename>Kernel/System/Stats/Static/</filename>.
</para>

</sect2>

<sect2 id='stats-using-old-stats'>
<title>Wiederverwerten alter statischer Statistiken</title>

<para>
Bereits das Standard OTRS Version 1.3 und 2.0 bietet die Mglichkeit
Statistiken zu generieren. Eine Vielzahl der Statistiken, die fr
OTRS-Versionen 1.3 und 2.0 speziell auf Kundenwunsch entwickelt wurden,
knnen wiederverwendet werden.
</para>

<para>
Diese Dateien mssen hierzu lediglich aus dem Pfad <filename>Kernel/System/Stats/</filename> in
den Pfad <filename>Kernel/System/Stats/Static/</filename> verschoben werden. Ferner muss
die Paketangabe des jeweiligen Skripts um "::Static" ergnzt werden.
</para>

<para>
Z. B. wird aus
</para>

<para>
<programlisting>
    package Kernel::System::Stats::AccountedTime;
</programlisting>
</para>

<para>
<programlisting>
    package Kernel::System::Stats::Static::AccountedTime;
</programlisting>
</para>

</sect2>

<sect2 id='stats-default-stats'>
<title>Defaultstatistiken</title>

<para>
"Man muss das Rad nicht immer neu erfinden."
</para>

<para>
Deshalb liefert das Statistikmodul automatisch Defaultstatistiken mit.
Statistiken, die fr alle OTRS-Benutzer interessant sind, werden zuknftig
als Defaultstatistik im Statistik-Modul-Paket ergnzt. Gespeichert werden
die Defaultstatistiken im XML-Format des Statistikmoduls im Verzeichnis
<filename>scripts/test/sample/</filename>.
</para>

</sect2>

</sect1>

</chapter>