4D Doc Center : GET ACTIVITY SNAPSHOT

Home

4D v14.3

GET ACTIVITY SNAPSHOT


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

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
arrUnterOp	Array Objekt	Unteroperationen
*	Operator	Mit Stern: Erhalte Server Aktivität

Beschreibung

Der Befehl GET ACTIVITY SNAPSHOT gibt Arrays zurück, die mit 4D Daten ablaufende Operationen beschreiben. Diese Operationen zeigen in der Regel ein Ablaufdialog.

So erhalten Sie eine Momentaufnahme der Operationen, die am meisten Zeit benötigen bzw. am häufigsten auf dem Server laufen, wie z.B. Schreiben in den Cache oder Ausführen von Formeln.

Hinweis: Die vom Befehl GET ACTIVITY SNAPSHOT zurückgegebene Information ist dieselbe wie auf der Seite "Real-time monitor" (RTM) des Verwaltungsfensters von 4D Server. Weitere Informationen dazu finden Sie auf der Seite Real Time Monitor des 4D Server Handbuchs.

GET ACTIVITY SNAPSHOT bearbeitet standardmäßig Operationen, die lokal ausgeführt werden (mit 4D Einzelplatz, 4D Server oder 4D im remote Modus).
Mit 4D im remote Modus können Sie aber auch eine Momentaufnahme der Operationen erhalten, die auf dem Server ausgeführt werden. Dazu müssen Sie nur den Stern (*) als letzten Parameter übergeben. Dann werden die Server Daten auch lokal übermittelt.
Der Parameter * wird beim Ausführen des Befehls auf 4D Server oder im 4D Einzelplatz ignoriert.

Der Befehl akzeptiert zwei Syntaxarten:

Syntax mit nur einem Array Objekt
Syntax mit mehreren Arrays

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

Mit dieser Syntax werden alle Operationen in strukturierter Form im 4D Array Objekt (arrAktivität) zurückgegeben. Jedes Element des Array ist ein Objekt in folgender Form:

[
    {
        "message":"xxx",
        "maxValue":12321,
        "currentValue":63212,
        "interruptible:0,
        "remote":0,
        "uuid":"deadbeef",
        "taskId":xxx,
        "startTime":"2014-03-20 13:37:00:123",
        "duration":92132,
        "subOperations":[
            {"message":"xxx",
            ...}
            ]
    },
    {...}
]

Die Beschreibung dieser Eigenschaft ist:

    message (Text): Art der Operation
    maxValue (Zahl): Anzahl Wiederholungen für diese Operation (-1 für nicht wiederholte Operationen)
    currentValue (Zahl): Aktuelle Wiederholung
    interruptible (Zahl): Operation kann durch Anwender abgebrochen werden (0=Ja, 1=Nein)
    remote (Zahl): Operation läuft auf Client und Server (0=Ja, 1=Nein)
    uuid (Text): UUID Identifier für Operation
    taskId (Zahl): Interne ID des Prozesses der die Operation gestartet hat
    startTime (Text): Start Zeit der Operation in Format "yyyy:mm:dd hh:mm:ss:mls"
    duration (Zahl): Dauer der Operation in Millisekunden
    subOperations (Array): Array Objekt mit Unteroperationen für die aktuelle Operation (falls vorhanden). Die Struktur jedes Unterelements ist identisch zum Hauptobjekt. Wenn es keine Unteroperationen gibt, ist der Eintrag leer.

Zweite Syntax: GET ACTIVITY SNAPSHOT ( arrUUID ; arrStart ; arrDuration ; arrInfo {;arrSubOp}{; *} )

Mit dieser Syntax erscheinen alle Operationen in mehreren synchronisierten Arrays (bei jeder Operation wird ein Element in allen Arrays hinzugefügt). Folgende Arrays werden zurückgegeben:

arrUUID: Enthält die UUIDs jeder Operation (entsprechend der Eigenschaft uuid in der oberen Syntax)
arrStart: Enthält die Startzeiten jeder Operation (entsprechend der Eigenschaft startTime in der oberen Syntax)
arrDuration: Enthält die Dauer jeder Operation in Millisekunden (entsprechend der Eigenschaft duration in der oberen Syntax)
arrInfo: Enthält die Bezeichnungen, die jede Operation beschreiben (entsprechend der Eigenschaft message in der oberen Syntax)
arrSubOp (optional): Jedes Element dieses Array ist ein Objekt mit der Eigenschaft "Unteroperation". Ihr Wert ist ein Array Objekt mit all den Unteroperationen zur aktuellen Operation. Hat die aktuelle Operation keine Unteroperationen, ist der Wert der Eigenschaft subOperations ein leeres Array. (entsprechend der Eigenschaft subOperations in der oberen Syntax)

Beispiel

Diese Methode, die in einem eigenen Prozess in 4D oder 4D Server ausgeführt wird, liefert folgenden Schnappschuss der gerade ablaufenden Operationen:

 ARRAY TEXT(arrUUID;0)

 ARRAY TEXT(arrStart;0)

 ARRAY LONGINT(arrDuration;0)

 ARRAY TEXT(arrInfo;0)

 

 Repeat

    GET ACTIVITY SNAPSHOT(arrUUID;arrStart;arrDuration;arrInfo)

    If(Size of array(arrUUID)>0)

       TRACE // Debugger aufrufen

    End if

 Until(False) // Nicht beendete Schleife

Sie erhalten z.B. folgende Arrays: