Die AE bietet die Möglichkeit Informationen zu Aufgabendurchführungen in eine Datei zu exportieren. Ihnen stehen dadurch beispielsweise Objektname, Status und Rückgabewert zur Verfügung. Auch der Report der Durchführung ist als Textdatei verfügbar. Durch die Strukturierung dieser Daten wird die Überleitung für ein Output-Managementsystem einfach und bequem möglich.
Sie können auf die Durchführungs-Informationen und Reports von Jobs sowie FileTransfers zugreifen.
Die Reportdaten können entweder mit dem Dienstprogramm AE DB Archive oder direkt durch einen Zugriff auf die Datenbank-Tabelle "XRO" aufbereitet werden. Letztere Möglichkeit unterstützt Ihre selbst geschriebenen Programme.
Diese spezielle Form der Reportaufbereitung ist standardmäßig nicht in Betrieb und muss daher pro Mandant aktiviert werden. Verwenden Sie dazu in der Variablen UC_CLIENT_SETTINGS den Key XRO_REPORTS.
Für jede Durchführung eines Jobs oder FileTransfers wird ein Eintrag in geschrieben, der unter anderem den Objektnamen, den Durchführungszeitpunkt und einen Verweis auf den Report enthält. Mit dem Dienstprogramm AE DB Archive können Sie die Daten aufbereiten.
Vergessen Sie nicht die XRO-Einträge regelmäßig aus der Tabelle zu entfernen, um ein übermäßiges Wachsen der Datenbank zu verhindern. Der Punkt "Tabelleneinträge entfernen" beschreibt wie dies zu bewerkstelligen ist.
|
Reports auflisten |
---|
Starten Sie AE DB Archive im Batchmodus mit der folgenden Syntax, um eine CSV-Datei zu erhalten, die alle noch nicht archivierten Aufgabendurchführungen auflistet:
UCYBDBAR -B -Xlist -SMandant/-DMandant [-OPfad und Dateiname] [-YStatus]
Geben Sie keinen Pfad an, so wird eine Datei namens "uc_XROlist.csv" im Ordner des Dienstprogrammes angelegt.
Der Inhalt der Datei entspricht exakt dem Inhalt der Datenbank-Tabelle "XRO", deren Aufbau am Ende dieses Dokumentes beschrieben ist.
Das Dienstprogramm bricht den Vorgang ab, wenn bereits eine gleichnamige Datei existiert.
Soll die Ergebnisdatei nicht alle Tabelleneinträge enthalten, ist es möglich den Startparameter -Y anzuwenden. Dabei werden nur jene Zeilen selektiert, die den angegebenen Status (Spalte "XRO_CusStatus") besitzen. Diesen Wert, der eine Zahl ist, können Sie selbst vorgeben und beim Entladen des Reports setzen.
AE DB Archive legt eine leere Datei an, wenn keine Reportdaten vorhanden sind.
|
Reports entladen |
---|
Rufen Sie AE DB Archive im Batchmodus mit der folgenden Syntax auf, um einen Report in eine Textdatei zu exportieren:
UCYBDBAR -B -Xunload -SMandant/-DMandant -RRunID der Aufgabe[-TYReporttyp] [-OPfad und Dateiname] [-YStatus]
Geben Sie den RunID der Aufgabe und den Reporttyp an, um einen bestimmten Report zu entladen. Wenn Sie nur die RunID übergeben, erhalten Sie alle Reports dieser Durchführung.
Geben Sie keinen Pfad an, so wird eine Datei namens "uc_XROreport.txt" im Ordner des Dienstprogrammes angelegt. Die Textdatei enthält den Inhalt des Reports.
Das Dienstprogramm bricht den Vorgang ab, wenn bereits eine gleichnamige Datei existiert.
Mit dem Startparameter -Y können Sie für den Report einen Status setzen. Geben Sie zu diesem Zweck eine Zahl Ihrer Wahl an, der in der Spalte XRO_CusStatus eingetragen wird. Die Reportliste kann über diesen Wert gefiltert werden.
Durch das Entladen eines Reports werden dessen Einträge in der Tabelle "XRO" nicht gelöscht. Dies geschieht im nächsten Arbeitsschritt.
|
Tabelleneinträge entfernen |
---|
Es gibt zwei Methoden, um die Tabelleneinträge zu reorganisieren:
Die exportierte CSV-Datei enthält den Inhalt und die Struktur der Datenbank-Tabelle "XRO". Beide besitzen daher folgende Spalten:
Spaltenname |
Beschreibung |
---|---|
XRO_Client |
Mandant |
XRO_AH_Idnr |
Laufende Nummer (RunID) der Aufgabendurchführung |
XRO_RType |
Reporttyp |
XRO_System |
Name des Automation Engine Systems |
XRO_OType |
Objekttyp (JOBS, JOBF) |
XRO_Object |
Name des Objektes |
XRO_HostDst |
Name des Agenten am Zielhost |
XRO_LoginDst |
Benutzername unter dem das Objekt durchgeführt wird |
XRO_HostScr |
Name des Agenten am Quellhost (nur bei FileTransfers) |
XRO_LoginSrc |
Benutzername für den Quellhost (nur bei FileTransfers) |
XRO_TimeStamp1 |
Startzeit der Durchführung |
XRO_TimeStamp4 |
Endezeit der Durchführung |
XRO_RetCode |
Rückgabewert der Aufgabe |
XRO_Status |
Status der Aufgabe |
XRO_RRetCode |
Rückgabewert der Reportübertragung "0" - Report wurde erfolgreich übertragen. |
XRO_ReportSize |
Größe des Reports in Bytes Beachten Sie, dass bei FileTransfers in dieser Spalte immer "0" vermerkt ist. |
XRO_UserTime |
Verbrauchte Benutzerzeit |
XRO_KernelTime |
Verbrauchte Kernelzeit |
XRO_CpuTime |
Verbrauchte CPU-Zeit |
XRO_Archive1 |
Erster Archivbegriff des Objektes |
XRO_Archive2 |
Zweiter Archivbegriff des Objektes |
XRO_CusStatus |
Benutzerdefinierte Zahl für die Verwendung von Filter |
Siehe auch:
Allgemeines zu Reports
Startparameter
Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support |
Copyright © 2016 Automic Software GmbH |