Get locked records info

Home

4D v15


Get locked records info ( Tabellenname ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Tabellenname	Tabelle	Tabelle, deren gesperrte Datensätze angezeigt werden sollen
Funktionsergebnis	Objekt	Beschreibung der gesperrten Datensätze (sofern vorhanden)

Beschreibung

Eingeführt mit 4D v14 R3

Kapitel: Datensatz sperren

Die Funktion Get locked records info gibt ein Objekt mit Informationen über die aktuell gesperrten Datensätze in Tabellenname zurück.

Das Objekt enthält in der Eigenschaft "records" ein Array mit weiteren Objekten:

{
    "records": [
        description object,
        (…)
    ]
}

Jedes Array Element "description object" beschreibt einen gesperrten Datensatz in der angegebenen Tabelle mit den Eigenschaften:

Eigenschaft	Typ	Beschreibung
KontextID	UUID (String)	UUID des Datenbankkontextes für die Sperrung
KontextAttribut	Objekt	Objekt, Information wie Ergebnis des Befehls LOCKED BY, jedoch angewandt auf den Datensatz. Außerdem gibt Get locked records info den Benutzernamen zurück, der im System definiert wurde und nicht den Namen des 4D Benutzers.
DatensatzNummer	Lange Ganzzahl	Datensatznummer des gesperrten Datensatzes

Hinweis: Der Befehl LOCKED ATTRIBUTES wurde für mehr Klarheit in 4D v14 R3 umbenannt in LOCKED BY.

Das Objekt KontextAttribut hat folgende Eigenschaften:

task_id: Refererenznummer des Prozesses
user_name: Benutzername, der im Betriebssystem definiert wurde
user4d_id: Nummer des 4D Benutzers
host_name: Name des Host Rechners
task_name: Prozessname
client_version: Version der Client Applikation

Hinweis: Den 4D Benutzernamen können Sie aus dem Wert von user4d_id über folgenden Code erhalten:

 GET USER LIST($arrNames;$arrIDs)

 $4DUserName:=Find in array($arrIDs;user4d_id)

Hinweis: Die Funktion ist nur in 4D und 4D Server anwendbar. Wird sie über remote 4D oder eine Komponente aufgerufen, gibt sie immer ein ungültiges Objekt zurück, außer die Option "Auf Server ausführen" ist aktiviert. Dann enthält das zurückgegebene Objekt jeweils Informationen über den Server bzw. die Host Datenbank.

Beispiel

Sie führen folgenden Code aus:

$vOlocked :=Get locked records info([Table])

Sind zwei Datensätze in der Tabelle [Table] gesperrt, wird in $vOlocked folgendes Objekt zurückgegeben:

{
    "records": [
        {
            "contextID": "A9BB84C0E57349E089FA44E04C0F2F25",
            "contextAttributes": {
                "task_id": 8, (*)
                "user_name": "roland", (*)
                "user4d_id": 1,
                "host_name": "iMac de roland",
                "task_name": "P_RandomLock", (*)
                "client_version": -1342106592
            },
            "recordNumber": 1
        },
        {
            "contextID": "8916338D1B8A4D86B857D92F593CCAC3",
            "contextAttributes": {
                "task_id": 9,
                "user_name": "roland",
                "user4d_id": 1,
                "host_name": "iMac de roland",
                "task_name": "P_RandomLock",
                "client_version": -1342106592
            },
            "recordNumber": 2
        }
    ]
}

Wird der Code auf einem 4D Server ausgeführt und die Sperrung von einem remote Client Rechnern ausgelöst, wird in $vOlocked folgendes Objekt zurückgegeben:

{
    "records": [
        {
            "contextID": "B0EC087DC2FA704496C0EA15DC011D1C",
            "contextAttributes": {
                "task_id": 2, 
                "user_name": "achim", 
                "user4d_id": 1,
                "host_name": "achim-pcwin",
                "task_name": "P_RandomLock", 
                "is_remote_context": true,
                "client_uid": "0696E66F6CD731468E6XXX581A87554A",
                "client_version": -268364752
            },
            "recordNumber": 1
        }
    ]
}