GET ACTIVITY SNAPSHOT

Home

4D v15

GET ACTIVITY SNAPSHOT ( arrAktivität | arrUUID ; arrStart ; arrDauer ; arrInfo {; arrDetails}{; *} )

Parameter	Typ		Beschreibung
arrAktivität \| arrUUID	Array Objekt, Array Text	<-	Komplette Beschreibung der Operationen (Array Objekt) oder
			Operation UUIDs (Array Text)
arrStart	Array Text	<-	Startzeit der Operation
arrDauer	Array Lange Ganzzahl	<-	Dauer der Operation in Sekunden
arrInfo	Array Text	<-	Beschreibung
arrDetails	Array Objekt	<-	Kontext Details und Unteroperationen (sofern vorhanden)
*	Operator	->	Mit Stern = Erhalte Server Aktivität

Neue Eigenschaften

Eingeführt mit 4D v14 R3

Dieser Befehl gibt zusätzliche Information zurück. Das ergibt sich durch die Erweiterung der Seite Real Time Monitor (RTM) des 4D Server Verwaltungsfensters (siehe Seite Real Time Monitoring).

Die zusätzliche Information wird in den beiden Eigenschaften dbContextInfo und dbOperationDetails zurückgegeben. Diese Eigenschaften sind für beide Syntaxarten verfügbar.

GET ACTIVITY SNAPSHOT(arrAktivität{; *})

Mit dieser Syntax erscheinen die neuen Eigenschaften auf der ersten Ebene des Objekts arrAktivität:

[
    {
        "message":"xxx",
        "maxValue":12321,
        "currentValue":63212,
        "interruptible:0,
        "remote":0,
        "uuid":"deadbeef",
        "taskId":xxx,
        "startTime":"2014-03-20 13:37:00:123",
        "duration":92132,
        "dbContextInfo":{
            "task_id": xxx,
            "user_name": myName,
            "host_name": HAL,
            "task_name": "CreateIndexLocal",
            "client_uid": "DE4DB33F33F"
            "user4d_id ": 1,
            "client_version ": 123456
        },
        "dbOperationDetails":{
            table: "myTable"
            field: "Field_1"
        },
        "subOperations":[...]
    },...
]

GET ACTIVITY SNAPSHOT(arrUUID;arrStart;arrDauer;arrInfo{;arrDetails}{; *})

Mit dieser Syntax erscheinen die neuen Eigenschaften im letzten Parameter, der für mehr Klarheit in arrDetails umbenannt wurde. Die Struktur dieses Array lautet:

[
    {
        "dbContextInfo":{...} //siehe unten
        "dbOperationDetails":{...} //siehe unten
        "subOperations":[...]
    },...
]

Beschreibung

dbContextInfo

Diese Eigenschaft enthält Information, wenn eine Operation über die Datenbank-Engine verwaltet wird. Es gibt folgende Eigenschaften:

host_name (String): Name des Host, der die Operation gestartet hat
user_name (String): Name des 4D Anwenders, dessen Sitzung die Operation gestartet hat
task_name (String): Name des Prozesses, der die Operation gestartet hat
task_id (Zahl): Nummer des Prozesses, der die Operation gestartet hat
client_uid (String): optional, uuid des Client, der die Operation gestartet hat
is_remote_context (Boolean, 0 oder 1): optional, gibt an, ob die Datenbankoperation von einem Client (Wert 1) oder von einem Server über eine Serverprozedur (Wert 0) gestartet wurde
user4d_id (Zahl): Nummer des aktuellen 4D Anwenders auf der Client-Seite
client_version (String): vier Stellen für die 4D Engine Version, auf der die Anwendung basiert, so wie vom Befehl Application version zurückgegeben.

client_uid und is_remote_context sind nur in der Client/Server Umgebung verfügbar. client_uid wird nur zurückgegeben, wenn eine Datenbankoperation client-seitig gestartet wird.

dbOperationDetails

Diese Eigenschaft wird nur zurückgegeben, wenn die Operation die Datenbank-Engine verwendet. Das gilt z.B. für Suchläufe bzw. Sortierungen. Es ist ein Objekt mit spezifischen Informationen zur Aktivität. Die zurückgegebenen Eigenschaften richten sich nach den ausgeführten Datenbankoperationen. Sie können z.B. enthalten:

Tabelle (String): Name der Tabelle, die von der Operation verwendet wird
Feld (String): Name des Feldes, das von der Operation verwendet wird
SuchPlan (String): interner Plan für die Suche...