Process activity

Home

4D v20 R7

Process activity


Process activity {( {sessionID}{;}{Optionen} )} -> Funktionsergebnis

Parameter	Typ	Beschreibung
sessionID	Text	Session ID
Optionen	Lange Ganzzahl	Eine bestimmte Liste zurückgeben
Funktionsergebnis	Objekt	Momentaufnahme der laufenden Prozesse bzw. Benutzersitzungen (nur 4D Server)

Beschreibung

Der Befehl Process activity liefert einen Schnappschuss der laufenden Prozesse und/oder (nur 4D Server) verbundenen User Sessions zu einem bestimmten Zeitpunkt. Dieser Befehl gibt alle Prozesse zurück, einschließlich interner Prozesse, die nicht über den Befehl Process info erreichbar sind.

Standardmäßig gibt Process activity bei Verwendung ohne Parameter ein Objekt zurück, das die folgenden Eigenschaften enthält:

"Prozesse", eine Collection aller Prozesse
"Sessions" (nur 4D Server), eine Collection aller Sessions

Bei 4D Server können Sie die zurückzugebenden Informationen mit Hilfe der optionalen Parameter sessionID und options filtern:

Wenn Sie im Parameter sessionID eine User-Session-ID übergeben, gibt der Befehl nur Informationen zurück, die sich auf diese Session beziehen. Wenn der Parameter options weggelassen wird, enthält das zurückgegebene Objekt standardmäßig eine Collection mit allen Prozessen, die mit der Session verknüpft sind, und eine Collection mit einem einzelnen Objekt, das die Session beschreibt. Wenn Sie eine ungültige Session ID übergeben, wird ein Null-Objekt zurückgegeben.

Sie können die zurückzugebende(n) Collection(s) auswählen, indem Sie eine der folgenden Konstanten des Themas "4D Umgebung" im Parameter options übergeben:

Konstante	Typ	Wert	Kommentar
Processes and sessions	Lange Ganzzahl	0	Gibt sowohl die Listen "Prozesse" als auch "Sessions" zurück (Standardwert)
Processes only	Lange Ganzzahl	1	Gibt nur die Prozessliste zurück
Sessions only	Lange Ganzzahl	2	Gibt nur die Liste Benutzersitzung zurück

Hinweis: Bei der Ausführung auf 4D im Remote- oder lokalen Modus gibt Process activity immer die Liste der laufenden Prozesse zurück (die Parameter sessionID und options werden ignoriert).

Liste der Sessions

Die Eigenschaft "Sessions" enthält eine Collection von Objekten, die alle laufenden Sessions auf dem Server beschreiben.

Eine Beschreibung der Eigenschaften von Session-Objekten finden Sie in dem Befehl Session info.

Hinweise:

Sie können das Objekt einer Session mit dem Befehl Session abrufen.
Process activity liefert Remote Client Sessions, Stored Procedure Sessions und Rest Sessions, aber keine Web Sessions (Einschränkung).

Liste der Prozesse

Die Eigenschaft „Prozesse“ enthält eine Collection von Prozessobjekten, die alle laufenden Prozesse beschreiben.

Eine Beschreibung der Eigenschaften von Prozessobjekten finden Sie in dem Befehl Process info.

Auf dem Server gibt der Befehl Process activity eine zusätzliche Eigenschaft "Session" zurück:

Zusätzliche Eigenschaft	Typ	Beschreibung
session	Objekt	Die Eigenschaft .info der Session, in der der Prozess läuft. Nicht definiert, wenn der Parameter [#cst id=„3390628“/] übergeben wird.

Beispiel 1

Sie möchten die Collection aller User Sessions abrufen:

  //Zur Ausführung auf dem Server

 

 var $o : Object

 var $i : Integer

 $processName;$userName Text

 

 $o:=Process activity //Prozess- und Session-Informationen abrufen

 For($i;0;($o.processes.length)-1) //Iterieren Sie über die Collection „Prozesse“.

    $processName:=$o.processes[$i].name

    $userName:=String($o.processes[$i].session.userName) // Einfacher Zugriff auf userName

  //String verwenden, da das Session-Objekt undefiniert sein könnte

 End for

Beispiel 2

Sie möchten alle Prozesse sehen, die mit der aktuellen Session verbunden sind:

  // auf dem Server auszuführen

 

 var $sessionID: Text:=Session.id

 var $o : Object

 

 $o:=Process activity($sessionID ;Processes only)

Siehe auch

_o_PROCESS PROPERTIES
Process info
Session storage by ID
WEB Get server info