Skip to main content

Konsoleanwendung

AssetManagerConnectorConsole.exe führt einmalig alle gespeicherten Konfigurationen aus und beendet sich anschließend. Die Anwendung eignet sich für Skripte und geplante Aufgaben.

Voraussetzungen

  • Die GUI hat die Konfigurationsdatenbank angelegt und die Service-Verbindung gespeichert.
  • Die gewünschten Transferkonfigurationen sind gespeichert und getestet.
  • Die im Arbeitsverzeichnis liegende Datei config verweist auf dieselbe Konfigurationsdatenbank wie die GUI.
  • Das ausführende Konto besitzt Zugriff auf Datenbank, Protokollverzeichnis und die verwendeten SQL-Systeme.

Aufruf

Die Konsole aus ihrem Installationsverzeichnis starten. Beispiel für PowerShell; der Pfad ist durch den tatsächlichen Installationspfad zu ersetzen:

Set-Location 'C:\Tools\AssetManagerConnector'
& '.\AssetManagerConnectorConsole.exe'
$connectorExitCode = $LASTEXITCODE
Write-Output "Connector-Rückgabecode: $connectorExitCode"

Die Konsole wertet keine Kommandozeilenparameter aus. Es gibt keine implementierten Optionen zum Auswählen einer einzelnen Konfiguration, zum Übergeben von Zugangsdaten oder zum Ändern des Konfigurationspfads per Argument.

Ablauf

  1. Die Datei config wird aus dem aktuellen Arbeitsverzeichnis geladen.
  2. Die Konsole öffnet die SQLite-Datenbank und lädt alle gespeicherten Konfigurationen einschließlich Objekten und Spaltenauswahl.
  3. Sie verarbeitet die Konfigurationen nacheinander mit derselben Transferlogik wie die GUI.
  4. Sie prüft pro Konfiguration die letzten Meldungen der Konfiguration und ihrer Objekte.
  5. Am Ende werden die Ergebnisse in der Konfigurationsdatenbank gespeichert und der Prozess-Rückgabecode gesetzt.

Es ist keine explizite Sortierung der Konfigurationen implementiert. Die Konsole ist daher nicht für Abläufe geeignet, deren Korrektheit eine bestimmte Reihenfolge voneinander abhängiger Konfigurationen voraussetzt.

Fehler werden protokolliert. Ein Fehler an einem Objekt oder in einer Konfiguration führt nicht grundsätzlich zum sofortigen Abbruch aller folgenden Konfigurationen. Eine automatische Wiederholung fehlgeschlagener Transfers ist nicht implementiert.

amc-console.png

Ausgabe und Protokoll

Die Konsole schreibt in die Konsolenausgabe und in das konfigurierte Dateiprotokoll. Der gesetzte Logdateiname lautet AssetManagerConnector.log, standardmäßig im Verzeichnis %ProgramData%\smcTeam\AssetManagerConnector\Logs.

Die Abschlussmeldung enthält den Rückgabecode. Die einzelnen Transfermeldungen nennen Konfiguration beziehungsweise Objekt und bei erfolgreicher Objektverarbeitung die Datensatzanzahl.

amc-log.png

Rückgabecode im aktuellen Stand

Code Tatsächliche Aussage
0 Der zuletzt gesetzte Ergebnisstatus ist erfolgreich. Auch bei einer vorhandenen, aber leeren Konfigurationsdatenbank bleibt der Code 0.
1 Der zuletzt gesetzte Ergebnisstatus ist fehlerhaft oder ein äußerer Fehler, zum Beispiel beim Laden oder Speichern, wurde abgefangen.

Der Rückgabecode ist derzeit kein über alle Konfigurationen aggregiertes Gesamtergebnis. Nach der Verarbeitung jeder Konfiguration setzt die Konsole den Code zunächst wieder auf 0 und bewertet dann deren Meldungen. Eine später erfolgreich verarbeitete Konfiguration kann dadurch den Fehlerstatus einer früheren Konfiguration überschreiben.

Beispiel: Konfiguration A schlägt fehl, die anschließend verarbeitete Konfiguration B ist erfolgreich. Der Prozess kann mit Code 0 enden, obwohl A fehlgeschlagen ist. Für die Überwachung müssen deshalb zusätzlich die Protokolle und Objektergebnisse des gesamten Laufs ausgewertet werden.

Ergebnisse in der GUI ansehen

Die GUI nach Abschluss des Konsolenlaufs neu öffnen. Die gespeicherten Ergebnisse erscheinen beim jeweiligen Objekt unter SQL Object History. Da die Konsole erst am Ende speichert, ist während eines laufenden oder vorzeitig beendeten Prozesses nicht jeder bereits protokollierte Zwischenstand auch in der Datenbank vorhanden.