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

Objekt getGlobalContext.userSettings vrací informace o aktuálním uživatelském nastavení v modelem řízených aplikacích, jako jsou role zabezpečení, jazyk a časové pásmo.

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

Vlastnosti

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

Název	Typ	Description
dateFormattingInfo	dateFormattingInfo	Vrátí informace o formátování data pro aktuálního uživatele.
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	roles	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ý.
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	transactionCurrency	Měna transakce pro aktuálního uživatele.
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 vlastnost je podporována pouze u sjednoceného rozhraní.

Odkaz na záznam Currency (TransactionCurrency). Data můžou vypadat přibližně takto:

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

Další informace o měně transakcí

Methods

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

Method	description
getSecurityRolePrivilegesInfo	Načtěte názvy oprávnění, obchodní jednotky a hloubky přístupu, abyste mohli zkontrolovat oprávnění role zabezpečení aktuálního uživatele.
getTimeZoneOffsetMinutes	Získejte posun časového pásma aktuálního uživatele v minutách, abyste vypočítali rozdíl mezi místním časem a UTC.

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)