====== Protokollverwaltung ======

===== Was mache ich hier? =====
Das Modul  ''Protokollverwaltung''  ermöglicht Ihnen, Ergebnisse bestimmter Aufgaben zu protokollieren. Dies ist insbesondere dann hilfreich, wenn Sie Prozesse automatisiert über einen Batchprozess per Windows-Aufgabenplaner durchführen. Über die Protokollregeln definieren Sie, welche Aktionen ausgeführt werden sollen. Die Protokollierung wird nur für bestimmte Module durchgeführt. 

Die Protokollierung kann je nach Lizensierung für die folgenden Module durchgeführt werden:

  * Import (Stammdaten)
  * Serienimport (Stammdaten)
  * Mapping-Import (Stammdaten)
  * XML-Rechnungsimport
  * Immosolve-Export
  * Serviceportal Schnittstelle
  * Datenschutz: Analyse der Daten
  * iX-Haus plus Hintergrundprozesse
  * DMS Synchronisation
  * Immosolve-Import
  * XML-Meldungsimport
  * Buchung-Hintergrundprozess
  * VBL Export
  * Dateiordner Überprüfung
  * Sollstellung
  * DKB Synchronisation
  * En.Tab Wohnungsübergabe
  * VOK-Berechnung
  * iX-Haus Hintergrundprozesse
  * Altendatenkenner
  * E-Banking
  * Zahlungsverkehr Personen
  * Berichtspaket
  * Indexwerte Destatis (VPI/EHI) 
  * casavi Schnittstelle 

Eine definierte Aufgabe führt je nach Konfiguration zu einer einmaligen oder mehrfachen Protokollierung. Zusätzlich zur Protokollierung kann als Aktionen in Bezug auf Aufgaben pro Aufgabe auch per  ''E-Mail senden''  das Protokoll einem iX-Haus-Benutzer sowie weiteren E-Mail-Adressaten gesendet werden. Über die Intervallsteuerung lässt sich sicherstellen, dass einerseits ein Hintergrundprozess läuft (z. B. positive Rückmeldung einmal täglich), andererseits kann gerade für mit hoher Frequenz laufende Prozesse die Häufigkeit der Meldungen reduziert werden, indem am selben Tag weitere Meldungen nur auf auf Basis von Fehlern generiert werden. 

<WRAP center tip>
Die Definition von Aufgaben ist nur für Hauptbenutzer freigeschaltet. Protokollregeln und Protokolle zum [[ix-haus_plus:scheduler:start|Scheduler]] finden Sie separat in dessem Modulbereich.
</WRAP>
 

===== Wie mache ich es? =====
==== Protokollregeln definieren ====
++++|
Um eine Protokollregel zu definieren, muss unter  ''Protokollverwaltung''  >  ''Aufgaben''  eine neue Aufgabe angelegt werden (siehe Dialog ''Aufgabe''). 

Der Bezug zu einer Protokollregel wird beim entsprechenden Protokoll gespeichert, falls ein solcher existiert. Protokollregeln mit Bezug
zu Protokollen können nicht gelöscht werden, daher werden Benutzer hierüber durch einen entsprechenden Hinweis informiert. Weiterhin können in der Protokollübersicht auch alle Daten zu bezogenen Protokollregeln mit aufgenommen werden. So lassen sich über Grid-Layouts auch individuelle Sichten erstellen, z. B. Sichten je Modul per Aktion ''Nur protokollieren''. So ist auch in iX-Haus eine kurzfristige Abfrage des Status dieser Aufgaben möglich, unabhängig von einer E-Mail-Benachrichtigung.

<WRAP important>
Die technische Verbindung zwischen Protokollen und Protokollregeln besteht ab dem Jahresupdate 20.22.0. Protokolle, die vorher generiert wurden, besitzen diesen Bezug nicht. In der Protokollverwaltung können für ältere Protokolle daher keine zugehörigen Regeln angezeigt werden.
</WRAP>
++++

==== E-Mail senden ====
++++|
Voraussetzung: Konfiguration der SMTP-Einstellungen im Administrationsbereich unter  ''Einstellungen''  >  ''Globale Einstellungen''.

Bei der Auswahl eines Verantwortlichen (iX-Haus Benutzers) stellen Sie bitte sicher, dass zu diesem Benutzer und allen Vertretungen die zugehörigen E-Mail-Adressen erfasst sind. Falls für den Verantwortlichen Vertretungen aktiv geschaltet sind (Komfortpaket), so erhält auch der Vertreter die E-Mail. Die Protokollausgabe wird in der E-Mail als Text hinzugefügt.
++++

===== Was brauche ich dazu? =====
==== Übersicht Protokoll ====
++++|
In der Protokollliste werden alle eingangs genannten Module protokolliert. Im Kopfbereich der Protokollübersicht können Sie Protokolle Datum, Status und Modultyp filtern. Das Protokoll zeigt an, ob die Aufgabe erfolgreich war und ob die erfolgte Aktion fehlerfrei ausgeführt wurde. In der Detailansicht wird auch die Protokollausgabe angezeigt. 
++++

==== Dialog Aufgabe ====
++++|

| ''Modul'' | Modul, auf welches sich die Aufgabe bezieht |
| ''Aktion'' | <WRAP> Gewünschte Aktion\\ 
  *  ''nur protokollieren'' 
  *  ''protokollieren und E-Mail senden'' 
</WRAP>  |
| ''Intervall'' | Anzahl der Protokolle pro Intervall\\ Fehler werden generell protokolliert. Der Parameter ist nicht aktiv, wenn bei der Aktionsauswahl  ''Fehler''  ausgewählt ist.  |
| ''Intervalltyp'' | <WRAP> Zeitraum für die Intervallberechnung\\ Der  ''Intervalltyp''  ist nicht aktiv, wenn bei der Aktionsauswahl  ''Fehler''  ausgewählt ist.\\ Zur Auswahl stehen: 
  *  ''Minute(n)'' 
  *  ''Stunde(n)'' 
  *  ''Tag(e)'' 
  *  ''Woche(n)'' 
  *  ''Monat(e)'' 
Ein Intervall ergibt sich aus der Kombination aus  ''Intervall''  (Wert) und  ''Intervalltyp''  (Einheit der Periodizität), z. B. 4 Stunde(n). Nach Erstellung des ersten Protokolls wird das nächste Protokoll erst nach vier Stunden erstellt.\\ </WRAP>  |
| ''Aktion ausführen bei'' | <WRAP> 
  *  ''Immer'' – unabhängig vom Ergebnis
  *  ''Erfolg'' – wenn die Aufgabe erfolgreich war
  *  ''Fehler'' – wenn die Aufgabe nicht erfolgreich war
Info: Bei der Auswahl  ''Immer''  und  ''Erfolg''  kann zusätzlich die Häufigkeit der Protokollierung eingestellt werden. Hierzu werden die Parameter  ''Intervall''  und  ''Intervalltyp''  genutzt.\\ </WRAP> |
| ''Deaktiviert'' | Checkbox\\ ☑Regel ist deaktiviert. Deaktivierte Regeln werden bei der Protokollierung nicht berücksichtigt.\\ Vorteil der Deaktivierung ist, eine sporadisch genutzte Aufgabe bei Bedarf aktivieren zu können, ohne diese erneut definieren zu müssen. |
| ''E-Mail-Betreff'' | Eintrag des Textes für die Betreffzeile einer E-Mail\\ Diese Information ist nur relevant, wenn die Aktion  ''protokollieren und E-Mail senden'' ausgewählt ist. |
| '' Verantwortlich'' | Auswahl\\ iX-Haus-Benutzer, der als Verantwortlicher per E-Mail informiert werden soll. Dessen E-Mail-Adresse wird aus den Benutzerstammdaten ermittelt.\\ Diese Information ist nur relevant, wenn die Aktion  ''protokollieren und E-Mail senden'' ausgewählt ist. |
| ''weitere E-Mail'' | Weitere E-Mail-Adressen, an welche die E-Mail als Kopie gehen soll. Mehrere E-Mail-Adressen müssen durch Semikolon getrennt werden. |

Eine Kombination mehrerer Aufgaben zu einem Modul ist möglich. 
++++