The actions of the category "Remote Export" subserve to start and control exports over the network. The actions are only at disposal if GSCRemEx service runs on every device and a connection to a central GeViSoft server persists. The GSCServer and GSCRemEx service have to run together on a local machine otherwise exports are not possible. The GSCRemEx service has to be setup in advance by GSCRemExEditor. The exports can be executed by a PILOT center device or other software systems (SDK based, GEUTEBRUECK devices). The PILOT is a system management console of GEUTEBRUECK which simplifies the handling of complex security systems. The PILOT among others can be used to control GSCView. Especially in view of the fact of exports the user can define start and end points by the help of the PILOT through GSCRemEx ("SetExportMarker" action). GSCView remembers the points in time and inserts them to the action "StartRemoteExport". The action "StartRemoteExport" is initiated by GSCView after the PILOT has send the action "InitializeRemoteExport" by indirection via the GeViSoft server and GeViScope server to GSCView. GSCView sends the action "StartRemoteExport" to the GSCRemEx service and triggers the appropriate export. Exports that have been started through GSCRemEx service can be started or aborted from other devices or software systems over the network. Exports that have been started locally in GSCView cannot be controlled from other devices or software systems. In the curse of an export process no new export can be started. This export has to be restarted after the running export process has been completed! The actions "SetExportMarker" and "InitializeRemoteExport" have been developed especially for the PILOT.
Action name:CancelExport(ExportID, AbortFlag)
Action category: command
Through this action the running export process with the specified export ID is being aborted if GSCView remote-controls the GSCRemEx service. If the GSCRemEx service is remote-controlled by an external application the external application has to send the action to abort the running export process.
| Parameter | Function | |
|---|---|---|
| export GUID | ExportID | ID of the export process that has to be aborted. The export GUID is being assigned on the action "StartRemoteExport". e.g.: 01E68451-2406-484d-A9BC-5140762931E0 |
| abort flag | AbortFlag | reason for abort 0: user abort; abort of export through user 1: low disc space; too little storage capacity 2: no user rights; access based on restricted user rights not possible 3: error; internal error |
Action name:ExportFinished(ExportID, Success)
Action category: notification
The GSCRemEx service notifies through this action that the running process was completed.
Possible status messages are: user abort, low disc space, no user rights, error.
| Parameter | Function | |
|---|---|---|
| export GUID | ExportID | ID of completed export process. The export GUID is being assigned on
the action "StartRemoteExport". e.g.: 01E68451-2406-484d-A9BC-5140762931E0 |
| success | Success | reason for abort 0: user abort; abort of export through user 1: low disc space; too little storage capacity 2: no user rights; access based on restricted user rights not possible 3: error; internal error |
Action name:ExportProgress(ExportID, Progress)
Action category: notification
The GSCRemEx service notifies the current status of the running export process in %.
| Parameter | Function | |
|---|---|---|
| export GUID | ExportID | ID of running export. The export GUID is being assigned on the action
"StartRemoteExport". e.g.: 01E68451-2406-484d-A9BC-5140762931E0 |
| progress | Progress | shows current status of the export process in % |
Action name:InitializeRemoteExport(Viewer, Device)
Action category: command
This action is being used especially in the context of control units or systems like for example the PILOT.
The PILOT center device notifies GSCView that a new export has to be initiated. Thereupon GSCView creates the action "StartRemoteExport" with the appropriate parameters.
| Parameter | Function | |
|---|---|---|
| viewer | Viewer | global viewer number |
| device GUID | Device | ID of the PILOT center device (transmitted by the PILOT itself)
e.g.: 01E68451-2406-484d-A9BC-5140762931E0 |
Action name:SetExportMarker(Viewer, Marker)
Action category: command
This action is being used especially in the context of control units or systems like for example the PILOT.
It indicates GSCView that an export start and end point has to be set on the current position of viewer X.
The so-called markers are being transferred automatically into the "StartRemoteExport" action once the "InitializeRemoteExport" action has been sent from the PILOT. The action "StartRemoteExport" transfers the start and end points to the GSCRemEx service which conducts the appropriate export.
| Parameter | Function | |
|---|---|---|
| viewer | Viewer | global viewer number |
| marker | Marker | tags and stores the start and end point of the data that has to be
exported (selection begin=0, selection end=1) |
Action name:StartRemoteExport(ExportID, Device, BackupFormat, Channel, SelectionBegin, SelectionEnd, JobID)
Action category: command
This action tells the GSCRemEx service to start a new export.
The action "StartRemoteExport" was created because the PILOT or another external software system did send the action "InitializeRemoteExport" to GSCView before.
| Parameter | Function | |
|---|---|---|
| export GUID | ExportID | ID of running exports. The export GUID has to be determined separately in advance because the action itself does not create a GUID. |
| device GUID | Device | ID of PILOT center device. If no PILOT is being used the blank GUID
can be used instead. e.g.: 01E68451-2406-484d-A9BC-5140762931E0 |
| format | BackupFormat | defines the format of the exported file 0=default (in this case it equals 1=GBF) 1=GBF( GEUTEBRUECK backup file) 2=MPEG2 |
| channel | Channel | global channel number/camera number |
| start time | SelectionBegin | holds the position of the marker for the start point ("selection begin") |
| end time | SelectionEnd | holds the position of the marker for the end point ("selection end") |
| job ID | JobID | Contains the login data (server name, user name, encoded password)
Optional second user password. The login data is separated by |. e.g.: <server name>|<user>|<PW>|<user2>|<PW2> localhost|admin|test| If there is no second user (second user password) nothing has to be entered at this point. Passwords in this parameter are encoded. Therefor the function DBIEncodeString() of GscDBI-DLL (from GeViScope/re_porter SDK) is being used. |
Action name:StartSceneStore(SceneStoreID, CutList, PreHistoryLength, RecordingLength)
Action category: command
For internal use only!
| Parameter | Function | |
|---|---|---|
| scene store GUID | SceneStoreID | Scene store GUID. |
| cut-list | CutList | Cut-list. |
| pre-history length | PreHistoryLength | Pre-history length. |
| recording length | RecordingLength | Recording length. |