Jobergebnisse exportieren¶
Exporte vom Typ JobResults enthalten eine Übersicht über die Jobergebnisse aller Jobs.
Der Export kann wahlweise als CSV-oder JSON-Datei ausgegeben werden.
Info
Die Jobergebnisse bereits gelöschter Jobs werden nicht aufgelistet.
Neben den im Abschnitt Parameterdatei beschriebenen Schlüsseln kann die Parameterdatei speziell für diesen Export zusätzlich die folgenden Schlüssel enthalten.
Sektion Common¶
In der Sektion [Common] können die folgenden Schlüssel konfiguriert werden:
| Schlüssel | Beschreibung | Werte |
|---|---|---|
| Dir | Relativer Pfad des Teils des Projektbaums, der exportiert werden soll. Info: Dieser Schlüssel wird ignoriert, wenn für ComponentID ein Wert angegeben ist. | - Kein Wert: Der gesamte Projektbaum wird exportiert, mit Ausnahme der Verzeichnisse und Komponenten, auf die der ausführende Benutzer keinen Zugriff hat. (Standardwert) - Eintrag mit vorangestelltem Backslash ("\"). Der Pfad einer Komponente (mit Namen) kann ebenfalls eingegeben werden. |
Sektion Filter¶
In der Sektion [Filter] können die folgenden Schlüssel konfiguriert werden:
| Schlüssel | Werte |
|---|---|
| FilterFrom | Beginn des Zeitraums, nach dem Einträge gefiltert werden sollen (als Zeitstempel im UTC-Format). Das Datum wird in den Filter einbezogen. Um nur die Unterschiede zum letzten Export auszugeben, können Sie hier den Wert "LastExecution" angeben. In diesem Schlüssel wird in der Sektion [Result] der Zeitstempel des zuletzt ausgeführten Exports eingetragen. |
| FilterTo | Ende des Zeitraums, nach dem Einträge gefiltert werden sollen (als Zeitstempel im UTC-Format). Das Datum wird nicht in den Filter einbezogen. |
| LastXDays | Zeitraum in Tagen, für den Einträge exportiert werden sollen. |
Beispielaufruf¶
Parameterdatei exportJobResults.ini¶
[Common]
ReportType=JobResults
ExportFile=D:\Test\myJobResults.csv
Dir=\SmartShopFloor
[Filter]
LastXDays=20
[User]
Account={User}
Password={Password}
Übersicht über die Spalten, die in der resultierenden Datei vorkommen¶
Die Datensätze sind nach den Inhalten der Spalten JobId und anschließend nach denen der Spalte TimestampUTC sortiert.
| Spalte | Beschreibung |
|---|---|
| Component | Name der Komponente (mit ihrem Pfad im Projektbaum) |
| ComponentID | ID der Komponente (im GUID-Format) |
| ComponentTypeID | ID des Komponententyps (im GUID-Format) |
| ComponentTypeName | Name des Komponententyps |
| ID des Jobs | ID des Jobs (im GUID-Format) |
| JobName | Name des Jobs |
| UploadClass | Uploadtyp des Jobs |
| WhoToNotify | Liste der Benutzer, die über die Jobausführung benachrichtigt werden sollen |
| Execution | Ausführungsstatus des Jobs. Werte: 0: Nicht nach Zeitplan, 1: Nach Zeitplan, 2: Mittels BackupClient |
| IpOrComputername | IP-Adresse oder Computername. Der Wert wird in Abhängigkeit von der Uploadklasse ausgegeben. |
| UploadAgent | Computername oder IP-Adresse des Agents. Dieser Wert wird nur angegeben, wenn dem Job ein Upload Agent zugewiesen ist. |
| CompareAgent | Computername oder IP-Adresse des Agents. Dieser Wert wird nur angegeben, wenn dem Job ein Compare Agent zugewiesen ist. |
| TimestampLocal | Zeitstempel der Jobausführung (lokale Zeit) |
| TimestampUTC | Zeitstempel der Jobausführung (UTC) |
| TimestampBackupLocal | Zeitstempel der Datei Backup.zip (lokale Zeit) |
| TimestampBackupUTC | Zeitstempel der Datei Backup.zip (UTC) |
| DirBackup | Relativer Pfad des Verzeichnisses im Serverarchiv, in dem das aktuelle Backup des Jobs (Datei Backup.zip) gespeichert wurde. |
| ResultVersionVsBackup | Ergebnis des Vergleichs zwischen der Version auf dem Server und dem Backup. Eine Liste der ausgegebenen Statuscodes und ihrer Beschreibungen finden Sie im Tutorial zum AdminClient. Folgende Ergebnisse der Jobausführung werden in diesem Export nicht angezeigt: Nicht vorhanden und Deaktiviert |
| TimestampVersionLocal | Zeitstempel der Datei Archive.zip (lokale Zeit) |
| TimestampVersionUTC | Zeitstempel der Datei Archive.zip (UTC) |
| DirVersion | Relativer Pfad des Verzeichnisses im Serverarchiv, in dem die Version des Jobs (Datei Archive.zip) gespeichert wurde |
| VersionNumber | Versionsnummer |
| ErrorVersionVsBackup | Die Spalte enthält nur einen Wert, wenn beim Vergleich Serverversion ↔ Backup ein Fehler aufgetreten ist. |
| WarningVersionVsBackup | Die Spalte enthält nur einen Wert, wenn beim Vergleich Serverversion ↔ Backup eine Warnung ausgegeben wurde. |
| ResultBackupVsPreBackup | Ergebnis des Vergleichs zwischen dem aktuellen und dem vorherigen Backup. Eine Liste der ausgegebenen Statuscodes und ihrer Beschreibungen finden Sie im Tutorial zum AdminClient. Folgende Ergebnisse der Jobausführung werden in diesem Export nicht angezeigt: Nicht vorhanden und Deaktiviert |
| TimestampPreBackupLocal | Zeitstempel der Datei Backup.zip des vorherigen Backups (lokale Zeit) |
| TimestampPreBackupUTC | Zeitstempel der Datei Backup.zip des vorherigen Backups (UTC) |
| DirPreBackup | Relativer Pfad des Verzeichnisses im Serverarchiv, in dem das vorherige Backup des Jobs (Datei Backup.zip) gespeichert wurde |
| ErrorBackupVsPreBackup | Die Spalte enthält nur einen Wert, wenn beim Vergleich Vorh. Backup ↔ Backup ein Fehler aufgetreten ist. |
| WarningBackupVsPreBackup | Die Spalte enthält nur einen Wert, wenn beim Vergleich Vorh. Backup ↔ Backup eine Warnung ausgegeben wurde. |
| ExecutingServer | Server, auf dem der Job ausgeführt wurde |
| TimestampJobStartLocal | Zeitstempel vom Start der Jobausführung (lokale Zeit) |
| TimestampJobStartUTC | Zeitstempel vom Start der Jobausführung (UTC) |
| TimestampUploadStartLocal | Zeitstempel vom Start des Uploads (lokale Zeit) |
| TimestampUploadStartUTC | Zeitstempel vom Start des Uploads (UTC) |
| TimestampUploadEndLocal | Zeitstempel vom Ende des Uploads (lokale Zeit) |
| TimestampUploadEndUTC | Zeitstempel vom Ende des Uploads (UTC) |
| TimestampCompareStartLocal | Zeitstempel vom Start des Vergleichs (lokale Zeit) |
| TimestampCompareStartUTC | Zeitstempel vom Start des Vergleichs (UTC) |
| TimestampCompareEndLocal | Zeitstempel vom Ende des Vergleichs (lokale Zeit) |
| TimestampCompareEndUTC | Zeitstempel vom Ende des Vergleichs (UTC) |
| TimestampJobEndLocal | Zeitstempel vom Ende der Jobausführung (lokale Zeit) |
| TimestampJobEndUTC | Zeitstempel vom Ende der Jobausführung (UTC) |
| Source | Quelle, aus der das Backup stammt. An Häufigsten werden hier die Werte MainServer und BackupClient ausgegeben. |
| WhoToNotifyNames | Namen der Benutzer, die über Jobausführungen benachrichtigt werden sollen. Mehrere Namen werden durch Kommata getrennt. Diese Spalte wird nur angezeigt, wenn das Versenden von E-Mails zu Jobausführungen konfiguriert ist. |
| WhoToNotifyEMails | E-Mail-Adressen der Benutzer, die über Jobausführungen benachrichtigt werden sollen. Mehrere E-Mail-Adressen werden durch Kommata getrennt. Diese Spalte wird nur angezeigt, wenn das Versenden von E-Mails zu Jobausführungen konfiguriert ist. |
| WhoToNotifyAdditional | E-Mail-Adressen der Benutzer, die keinen octoplant Account haben, aber trotzdem über Jobausführungen benachrichtigt werden sollen. Mehrere E-Mail-Adressen werden durch Kommata getrennt. Diese Spalte wird nur angezeigt, wenn das Versenden von E-Mails zu Jobausführungen konfiguriert ist. |