Teilen über

getGlobalContext.userSettings (Client-API-Referenz)

  • Artikel

Gibt Informationen zu aktuellen Benutzereinstellungen zurück.

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

Eigenschaften

Das userSettings Objekt hat folgende Eigenschaften:

Name des Dataflows 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 Ob die geführte Hilfe für den aktuellen Benutzer aktiviert ist.
isHighContrastEnabled Boolesch Ob hoher Kontrast für den aktuellen Benutzer aktiviert ist.
isRTL Boolesch Ob die Sprache für den aktuellen Benutzer eine Sprache ist, die von rechts nach links (RTL) geschrieben wird.
languageId Zahl Der LCID-Sprachcode für den aktuellen Benutzer.
roles Sammlung Eine Sammlung von Nachschlageobjekten, die die GUID und Anzeigename aller dem Benutzer zugewiesenen Sicherheitsrolle und aller dem Team zugewiesenen Sicherheitsrollen enthalten, dem der Benutzer zugeordnet ist. Siehe Rollen
securityRolePrivileges string[] Ein Array von Zeichenfolgen, die die GUID-Werte aller Sicherheitsrolle-Berechtigungen darstellen, denen der Benutzer zugeordnet ist, oder aller Teams, denen der Benutzer zugeordnet ist.
securityRoles string[] Veraltet. Verwenden Sie die roles -Eigenschaft.
transactionCurrency object Objekt, das die id, name und entityType der Transaktionswährung für den aktuellen Benutzer enthält. Siehe Transaktionswährung
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 wie 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 Einheitliche Oberfläche unterstützt.

transactionCurrency

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

Die Daten könnten etwa so aussehen:

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

Methoden

Das userSettings Objekt hat die folgenden Methoden:

Methode getSecurityRolePrivilegesInfo

Gibt ein Versprechen zurück, das mit einem Objekt aufgelöst wird, dessen Schlüssel die GUIDs des Sicherheitsrolle-Privilegs sind und dessen Werte Objekte sind, die die businessUnitId, depth und privilegeName des Sicherheitsrolle-Privilegs enthalten.

Syntax

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

Parameter

Name des Dataflows 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: Nummer. Der Fehlercode.
message: Zeichenfolge. Eine Fehlermeldung, die das Problem beschreibt.

Rückgabewert

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

Bei Erfolg wird ein Promise-Objekt zurückgegeben, das die in der Beschreibung des Parameters successCallback oben angegebenen Werte enthält.

Beschreibung: GUID und zusätzliche Details wie Geschäftseinheit und Berechtigungsname jeder der Sicherheitsrolle-Berechtigungen.

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: Zeitzonenverschiebung in Minuten.

Clientkontext
Organisationseinstellungen
Xrm.Utility.getGlobalContext
Tabelle „Benutzereinstellungen“ (UserSettings)