Befehle für Export-Steuerung (VIDEO_OA_WORKSTATION.exportServer)

Kommandos werden auf dieses Element geschrieben:

*.exportServer.object.command.request

Rückemeldungen auf Befehle werden auf dieses Element geschrieben:

*.exportServer.object.command.response

Eine Rückmeldung enthält auf jeden Fall den kompletten Inhalt des zugehörigen Requests, inklusive aller Parameter. Getrennt durch Semikolon erfolgt der Kommandostatus.

Kommando: cmd=export

Schlüsselwort Beschreibung
begin Startzeit des Exports im Format <TS.ms>
end Endzeit des Exports im Format <TS.ms>
name Exportname, enthält den kompletten Pfad des Exportordners und den Exportnamen.
source Kameraname im Format <Kameraname1>[<Kameraname2>]..
username Benutzername (optional)
password Passwort (optional)
userdata Benutzerdaten (optional)
BEISPIEL - Kommando
 cmd=export;begin=1345466282;end=1345466283;name=D:\\_DATA\\PVSS\\Video\\
 Video_Framework\\VIDEO_FW\\data\\ausgabevideo\\normal\\Testexport_01;source=
 Camera_00004,Camera_00005,Camera_00006,Camera_00007
BEISPIEL - Antwort
 cmd=export;begin=1345466282;end=1345466283;name=D:\\_DATA\\PVSS\\Video\\
 Video_Framework\\VIDEO_FW\\data\\ausgabevideo\\normal\\Testexport_01;source=
 Camera_00004,Camera_00005,Camera_00006,Camera_00007;answer=ok

Im Fehlerfall kann der Parameter "answer" statt "ok" die folgenden Werte aufweisen:

  • not connected - es besteht keine Verbindung zum vimacc OA System
  • missing mandatory parameter - ein benötigter Parameter fehlt beim Kommando
  • duplicate export name - ein Export mit diesem Namen ist bereits aktiv

Kommando: cmd=dirinfo

Schlüsselwort Beschreibung
path Name eines Verzeichnisses relativ zum Export-Server, welches nach Exports untersucht werden soll
Dieses Kommando veranlasst den Exportserver das angegebene Verzeichnis nach vorhandenen Exports zu durchsuchen. Er liefert für jeden Export folgende Informationen zurück:
  • Name des Exports
  • Zeitpunkt der letzten Änderung
  • Gesamtgröße des Exports in Byte
  • Frühester Zeitpunkt für den eine Aufzeichnung existiert
  • spätester Zeitpunkt für den eine Aufzeichnung existiert
 cmd=dirinfo;path=[<exportpath>];answer=ok;dirinfo=[<exportname1>,<moddate1>,
 <exportsize1>,<starttime1>,<endtime1>][<exportname2>,<moddate2>,<exportsize2>,
 <starttime2>,<endtime2>][...

Da zu einem Export nachträglich Daten hinzugefügt werden können, wäre die Angabe der Startzeit des Exports nicht notwendigerweise eindeutig. Daher muss auch der Zeitpunkt der letzten Änderung angegeben werden. Alle Zeiten werden in Sekunden seit dem 1.1.1970 angegeben.

Es kann immer nur ein dirinfo-Kommando aktiv sein. Ein weiteres wird erst angenommen, wenn das vorherige beendet wurde.

BEISPIEL - Kommando

cmd=dirinfo;path=D:\\DATA\\normal

BEISPIEL - Antwort 

cmd=dirinfo;answer=ok;path=[D:\\DATA\\normal][“TestExport_1“,1346319474,
112311884,1346317600,1346319400][“Ausgang Süd“,13462519483,98334131,1346010000,1346000000]
Im Fehlerfall kann der Parameter "answer" statt "ok" die folgenden Werte aufweisen:
  • not connected - es besteht keine Verbindung zum vimacc OA System
  • missing mandatory parameter - ein benötigter Parameter fehlt beim Kommando

Kommando: cmd=strip

Schlüsselwort Beschreibung
name Name des Exports der aus der Liste entfernt werden soll (optional)
Mit dem Kommando strip können Aufträge aus der Statusinformation gelöscht werden. Es können nur Aufträge gelöscht werden, die nicht mehr laufen. (Exportfortschritt 100 oder -1).

Die Angabe des Parameters „name“ ist optional. Ohne Parameter löscht das Kommando alle beendeten Exportvorgänge aus der Liste.

BEISPIEL - Kommando cmd=strip;name=D:\\_DATA\\normal\\Testexport_01

BEISPIEL - Antwort cmd=strip;name= D:\\_DATA\\normal\\Testexport_01;answer=strip done

Kommando: cmd=cancel
Schlüsselwort Beschreibung
name Name des Exports der gestoppt werden soll
Der Export auf diesen Pfad wird abgebrochen. Die Daten verbleiben aber bis zur Löschung durch ein "strip"-Kommando in der active-Liste der Exportvorgänge.

BEISPIEL - Kommando cmd=cancel;name=D:\\_DATA\\normal\\Testexport_01

BEISPIEL - Antwort cmd=cancel;name= D:\\_DATA\\normal\\Testexport_01;answer=cancel done

Da zu einem Export nachträglich Daten hinzugefügt werden können, wäre die Angabe der Startzeit des Exports nicht notwendigerweise eindeutig