getGlobalContext.userSettings (referenční dokumentace rozhraní API klienta)

Vrátí informace o aktuálním uživatelském nastavení.

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

Vlastnosti

Objekt userSettings má následující vlastnosti:

Název	Typ	Description
dateFormattingInfo	objekt	Vrátí informace o formátování data pro aktuálního uživatele. Zobrazit dateFormattingInfo
defaultDashboardId	řetězec	Vrátí ID výchozího řídicího panelu pro aktuálního uživatele.
isGuidedHelpEnabled	Booleova hodnota	Jestli je pro aktuálního uživatele povolená nápověda s asistencí.
isHighContrastEnabled	Booleova hodnota	Určuje, jestli je pro aktuálního uživatele povolený vysoký kontrast.
isRTL	Booleova hodnota	Určuje, jestli je jazyk aktuálního uživatele jazykem zprava doleva (RTL).
languageId	číslo	Kód jazyka LCID pro aktuálního uživatele.
roles	kolekce	Kolekce vyhledávacích objektů obsahujících identifikátor GUID a zobrazovaný název každé role zabezpečení přiřazené uživateli a všechny role zabezpečení přiřazené týmu, ke kterému je uživatel přidružený. Zobrazit role
securityRolePrivileges	řetězec[]	pole řetězců, které představují hodnoty GUID každé z oprávnění role zabezpečení, ke kterým je uživatel přidružený, nebo ke všem týmům, ke kterým je uživatel přidružený.
securityRoles	řetězec[]	Deprecated. roles Použijte vlastnost.
transactionCurrency	objekt	Objekt obsahující idměnu transakce , namea entityType pro aktuálního uživatele. Zobrazit transactionCurrency
transactionCurrencyId	řetězec	Deprecated. transactionCurrency Použití vlastnosti
userId	řetězec	Hodnota systemuser.systemuserid aktuálního uživatele.
userName	řetězec	Jméno aktuálního uživatele.

dateFormattingInfo

Objekt s vlastnostmi řetězce týkajícími se formátování kalendářních dat, například FirstDayOfWeek, LongDatePatternMonthDayPattern, TimeSeparatoratd.

roles

Kolekce obsahuje objekty s vlastnostmi idname pro každou z rolí zabezpečení nebo týmů, ke kterým je uživatel přidružený.

Tato vlastnost je podporována pouze u sjednoceného rozhraní.

měna transakce

Tato metoda je podporována pouze u sjednoceného rozhraní.

Data můžou vypadat přibližně takto:

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

Methods

Objekt userSettings má následující metody:

getSecurityRolePrivilegesInfo – metoda

Vrátí příslib, který se vyřeší s objektem, jehož klíče jsou identifikátory GUID oprávnění role zabezpečení a hodnoty jsou objekty obsahující businessUnitId, deptha privilegeName oprávnění role zabezpečení.

Syntaxe

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

Parametry

Název	Typ	Povinné	Description
successCallback	Funkce	Ne	Funkce, která se má volat při načtení informací o oprávněních role zabezpečení. Slovník se předá zpětnému volání úspěchu, kde identifikátory GUID oprávnění role zabezpečení budou klíče a hodnoty budou objekty obsahující následující vlastnosti: id:Řetězec. Identifikátor GUID oprávnění role zabezpečení. businessUnitId:Řetězec. Identifikátor GUID obchodní jednotky oprávnění role zabezpečení. privilegeName:Řetězec. Název oprávnění role zabezpečení. depth:Řetězec. Hloubka oprávnění role zabezpečení.
errorCallback	Funkce	Ne	Funkce, která se má volat v případě selhání operace. Bude předán objekt s následujícími vlastnostmi: errorCode:Číslo. Kód chyby. message:Řetězec. Chybová zpráva popisující problém.

Návratová hodnota

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

Při úspěchu vrátí objekt příslibu obsahující hodnoty zadané v popisu parametru successCallback výše.

Popis: IDENTIFIKÁTOR GUID a další podrobnosti, jako je obchodní jednotka a název oprávnění každé z oprávnění role zabezpečení.

getSecurityRolePrivilegesInfo – příklad

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

metoda getTimeZoneOffsetMinutes

Vrátí rozdíl v minutách mezi místním časem a koordinovaným univerzálním časem (UTC).

Syntaxe

userSettings.getTimeZoneOffsetMinutes()

Návratová hodnota

Typ: číslo

Popis: Posun časového pásma v minutách.

Související články

Kontext klienta
Nastavení organizace
Xrm.Utility.getGlobalContext
Tabulka Uživatelská nastavení (UserSettings)