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