getGlobalContext.userSettings (Client-API-Referenz)

Gibt Informationen zu aktuellen Benutzereinstellungen zurück.

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

Das Objekt userSettings bietet die folgenden Eigenschaften und eine Methode.

dateFormattingInfo

Gibt die Datumsformatierungsinformationen für den aktuellen Benutzer zurück.

Syntax

userSettings.dateFormattingInfo

Rückgabewert

Typ: Objekt.

Beschreibung: Ein Objekt mit Informationen zur Datumsformatierung wie FirstDayOfWeek, LongDatePattern, MonthDayPattern, TimeSeparator usw.

defaultDashboardId

Gibt die ID des Standard-Dashboards für den aktuellen Benutzer wieder.

Syntax

userSettings.defaultDashboardId

Rückgabewert

Typ: Zeichenfolge

Beschreibung: ID des Standard-Dashboards.

isGuidedHelpEnabled

Gibt an, ob die anpassbare Hilfe für den aktuellen Benutzer aktiviert ist.

Syntax

userSettings.isGuidedHelpEnabled

Rückgabewert

Typ: Boolesch

Beschreibung: true, wenn aktiviert; sonst false.

isHighContrastEnabled

Gibt an, ob der hohe Kontrast für den aktuellen Benutzer aktiviert ist.

Syntax

userSettings.isHighContrastEnabled

Rückgabewert

Typ: Boolesch

Beschreibung: true, wenn aktiviert; sonst false.

isRTL

Gibt an, ob die Sprache für den aktuellen Benutzer eine Rechts-nach-links-Sprache (RTL) ist.

Syntax

userSettings.isRTL

Rückgabewert

Typ: Boolesch

Beschreibung: „true“, wenn es eine RTL ist, andernfalls „false“.

languageId

Gibt die Sprachen-ID des aktuellen Benutzer wieder.

Syntax

userSettings.languageId

Rückgabewert

Typ: Anzahl

Beschreibung: Sprachen-ID

Rollen

Gibt eine Sammlung von Suchobjekten zurück, die die GUID und den Anzeigenamen jeder der dem Benutzer zugewiesenen Sicherheitsrollen und aller dem Team, dem der Benutzer zugeordnet ist, zugewiesenen Sicherheitsrollen enthält. Diese Methode wird nur für die einheitliche Oberfläche unterstützt.

Syntax

userSettings.roles

Rückgabewert

Typ: Sammlung

Beschreibung: Objekt enthält id und name von jedem der Sicherheitsrollen oder Teams, denen der Benutzer zugeordnet ist.

securityRolePrivileges

Gibt ein Zeichenfolgenarray zurück, das die GUID-Werte für jede des Sicherheitsrollenrechts darstellt, die dem Benutzer oder jedem Team zugeordnet sind, dem der Benutzer angehört.

Hinweis

Diese API ist nicht verfügbar für Dynamics 365 Customer Engagement, das lokal bereitgestellt wird. Weitere Informationen: Client APIs werden in Customer Engagement (on-premises) nicht unterstützt

Syntax

userSettings.securityRolePrivileges

Rückgabewert

Typ: Array

Beschreibung: GUID-Werte jedes der Sicherheitsrollenrechte.

getSecurityRolePrivilegesInfo()

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 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

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.

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);
  });

securityRoles

Gibt ein Zeichenfolgenarray zurück, das die GUID-Werte für jede der Sicherheitsrollen oder Teams darstellt, denen der Benutzer zugeordnet ist.

Veraltet; verwenden Sie stattdessen userSettings.roles, um die Anzeigenamen von Sicherheitsrollen oder -Teams zusammen mit der ID anzuzeigen.

Syntax

userSettings.securityRoles

Rückgabewert

Typ: Array

Beschreibung: GUID-Werte jeder der Sicherheitsrollen. Beispiel:

["0d3dd20a-17a6-e711-a94e-000d3a1a7a9b", "ff42d20a-17a6-e711-a94e-000d3a1a7a9b"]

transactionCurrency

Gibt ein Suchobjekt zurück, das die ID; Anzeigename und den Tabellentyp für die Transaktionswährung für den aktuellen Benutzer enthält. Diese Methode wird nur für die einheitliche Oberfläche unterstützt.

Syntax

userSettings.transactionCurrency

Rückgabewert

Typ: Suchobjekt

Beschreibung: Objekt mit dem id, name und entityType der Transaktionswährung. Beispiel:

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

transactionCurrencyId

Gibt die Transaktionswährungs-ID des aktuellen Benutzers wieder.

Veraltet; verwenden Sie userSettings.transactionCurrency statt auf den Anzeigename zusammen mit der ID zuzugreifen.

Syntax

userSettings.transactionCurrencyId

Rückgabewert

Typ: Zeichenfolge

Beschreibung: Transaktionswährungs-ID.

userId

Gibt die GUID des SystemUser.Id-Werts für den aktuellen Benutzer zurück.

Syntax

userSettings.userId

Rückgabewert

Typ: Zeichenfolge

Beschreibung: Die ID des Benutzers. Beispiel:

"{75B5BA27-FD41-4D45-8E3A-C8446C95F0CC}"

userName

Gibt den Namen des aktuellen Benutzers zurück.

Syntax

userSettings.userName

Rückgabewert

Typ: Zeichenfolge

Beschreibung: Name des aktuellen Benutzers.

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.

Ähnliche Artikel

Kundenkontext
Organisationseinstellungen
Xrm.Utility.getGlobalContext

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).