listUserGroupsEx

[ Funktion ]

public static listUserGroupsEx(
    options?: object | null,
    requestOptions: TcHmi.Server.IRequestOptions | null = null,
    callback: null | ((this: void, data: TcHmi.Server.UserManagement.IGroupResultObject) => void) = null
): TcHmi.IErrorDetails;

Liefert eine Liste aller vorhandenen Benutzer des Systems als Objekt mit allen Metadaten.

Parameter

Name	Typ	Beschreibung
options	object, null	aktuell unbenutzt
requestOptions	TcHmi.Server.IRequestOptions, null	Optionen des Server-Requests
callback [ Optional ]	(data: TcHmi.Server.UserManagement.IGroupResultObject) => void, null	Asynchrone Callback Funktion, die ausgelöst wird, wenn die Aktion abgeschlossen wurde.

Rückgabewert

Typ	Beschreibung
TcHmi.IErrorDetails	Liefert eine Rückmeldung, ob die Operation erfolgreich abgeschickt worden konnte.

	Verfügbar ab Version 1.10.1040.0

Beispiel - JavaScript

TcHmi.Server.UserManagement.listUserGroupsEx (
    null,
    {timeout: 2000},
    function(data) {
        if (data.error === TcHmi.Errors.NONE) {
            if (
                !data
                || !data.groupDetailsList
                || !data.groupDetailsList.__SystemGuests
            ) {
                // Error
                return;
            }
            // Are Guests able to fetch current user status?
            console.log(data.groupDetailsList.__SystemGuests.symbols.GetCurrentUser === TcHmi.Server.ACCESS.READWRITE); 
            console.log(data.groupDetailsList);
/*
{
    "__SystemAdministrators": {
        "enabled": true,
        "fileAccess": 3,
        "files": {},
        "symbolAccess": 3,
        "symbols": {}
    },
    "__SystemGuests": {
        "enabled": true,
        "fileAccess": 0,
        "files": {},
        "symbolAccess": 0,
        "symbols": {
            "GetCurrentUser": 3,
            "IsAuthRequired": 3,
            "ListUserNames": 3,
            "Login": 3
        }
    } // and more…
}
*/
        } else {
            // Error
        }
    }
);