Freigeben über

getGlobalContext.userSettings (Client-API-Referenz)

  • Artikel

Gibt Informationen zu aktuellen Benutzereinstellungen zurück.

var userSettings = Xrm.Utility.getGlobalContext().userSettings

Eigenschaften

Das userSettings-Objekt bietet folgende Eigenschaften:

Name typ Eigenschaft
dateFormattingInfo object Gibt die Datumsformatierungsinformationen für den aktuellen Benutzer zurück. Siehe dateFormattingInfo
defaultDashboardId string Gibt die ID des Standard-Dashboards für den aktuellen Benutzer wieder.
isGuidedHelpEnabled Boolesch Gibt an, ob die anpassbare Hilfe für den aktuellen Benutzer aktiviert ist.
isHighContrastEnabled Boolesch Gibt an, ob der hohe Kontrast für den aktuellen Benutzer aktiviert ist.
isRTL Boolesch Gibt an, ob die Sprache für den aktuellen Benutzer eine Rechts-nach-links-Sprache (RTL) ist.
languageId Zahl Der Sprachencode des aktuellen Benutzenden.
roles Sammlung Eine Sammlung von Lookup-Objekten, die die GUID und den Anzeigenamen jeder dem Benutzer zugewiesenen Sicherheitsrolle und aller Sicherheitsrollen enthalten, die einem Team zugewiesen sind, dem der Benutzer zugeordnet ist. Siehe Rollen
securityRolePrivileges string[] Ein Zeichenfolgenarray, das die GUID-Werte für jede des Sicherheitsrollenrechts darstellt, die dem Benutzer oder jedem Team zugeordnet sind, dem der Benutzer angehört.
securityRoles string[] Veraltet. Verwenden Sie die roles-Eigenschaft.
transactionCurrency object Objekt mit dem id, name und entityType der Transaktionswährung für den aktuellen Benutzer. Siehe transactionCurrency
transactionCurrencyId string Veraltet. Verwenden Sie die transactionCurrency-Eigenschaft.
userId string Der systemuser.systemuserid-Wert des aktuellen Benutzers.
userName string Der Name des aktuellen Benutzers

dateFormattingInfo

Ein Objekt mit Zeichenfolgeneigenschaften zur Datumsformatierung, z. B. FirstDayOfWeek, LongDatePattern, MonthDayPattern, TimeSeparator usw.

Rollen

Die Sammlung enthält Objekte mit id und name Eigenschaften für jede der Sicherheitsrollen oder Teams, denen der Benutzer zugeordnet ist.

Diese Eigenschaft wird nur auf der einheitlichen Oberfläche unterstützt.

transactionCurrency

Diese Methode wird nur für die einheitliche Oberfläche unterstützt.

Die Daten sehen in etwa wie folgt aus:

{id: "e7dd9bc6-d239-ea11-a813-000d3a35b14a", entityType: "transactioncurrency", name: "US Dollar"}

Methoden

Das Objekt userSettings verfügt über die folgenden Methoden:

getSecurityRolePrivilegesInfo-Methode

Gibt ein Zusage zurück, die mit einem Objekt aufgelöst wird, dessen Schlüssel die Sicherheitsrollenberechtigungs-GUIDs und -Werte Objekte sind, die die businessUnitId, depth und den privilegeName der Sicherheitsrollenberechtigung enthalten.

Syntax

userSettings.getSecurityRolePrivilegesInfo().then(successCallback, errorCallback);

Parameter

Name Type Erforderlich Beschreibung
successCallback Function Nein Eine Funktion, die aufgerufen wird, wenn die Informationen zu den Sicherheitsrollenberechtigungen abgerufen werden. Ein Wörterbuch wird an den Erfolgsrückruf übergeben, wobei die Sicherheitsrollenberechtigung-GUIDs die Schlüssel und die Werte Objekte mit den folgenden Eigenschaften sind:
id: Zeichenfolge. Die Sicherheitsrollenberechtigung-GUID.
businessUnitId: Zeichenfolge. Die GUID der Unternehmenseinheit des Sicherheitsrollenberechtigung.
privilegeName: Zeichenfolge. Der Name der Sicherheitsrollenberechtigung.
depth: Zeichenfolge. Die Tiefe der Sicherheitsrollenberechtigung.
errorCallback Function Nein Eine Funktion zum Aufrufen, wenn der Vorgang fehlschlug. Es wird ein Objekt mit den folgenden Eigenschaften übergeben:
errorCode: Zahl. Der Fehlercode.
message: Zeichenfolge. Eine Fehlermeldung, die das Problem beschreibt.

Rückgabewert

Typ: Promise<{[key: string]: {id: string, businessUnitId: string, privilegeName: string, depth: number}}>

Bei Erfolg wird ein Zusageobjekt mit den Werten zurückgegeben, die zuvor in der Beschreibung des successCallback-Parameters oben angegeben wurden.

Beschreibung: GUID und zusätzliche Details wie Unternehmenseinheit und Berechtigungsname jeder der Sicherheitsrollenberechtigungen.

getSecurityRolePrivilegesInfo – Beispiel

userSettings
  .getSecurityRolePrivilegesInfo()
  .then(function success(rolePrivileges) {
    var privilegeGuids = Object.keys(rolePrivileges);
    console.log("Privileges Count: " + privilegeGuids.length);

    // Print information about the first role privilege in the dictionary
    var guid = privilegeGuids[0];
    console.log("Privilege Id: " + rolePrivileges[guid].id);
    console.log("Privilege Name: " + rolePrivileges[guid].privilegeName);
    console.log("Privilege Business Unit Id: " + rolePrivileges[guid].businessUnitId);
    console.log("Privilege depth: " + rolePrivileges[guid].depth);
  });

getTimeZoneOffsetMinutes-Methode

Gibt die Differenz in Minuten zwischen der Ortszeit und der Coordinated Universal Time (UTC) zurück.

Syntax

userSettings.getTimeZoneOffsetMinutes()

Rückgabewert

Typ: Zahl

Beschreibung: Zeitzonenoffset in Minuten.

Kundenkontext
Organisationseinstellungen
Xrm.Utility.getGlobalContext
Tabelle Benutzereinstellungen (UserSettings)