getGlobalContext.userSettings (Ügyfél API-referencia)

Az aktuális felhasználói beállításokra vonatkozó információkat adja vissza.

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

Tulajdonságok

A userSettings objektum a következő tulajdonságokkal rendelkezik:

Név	Típus	Description
dateFormattingInfo	objektum	Az aktuális felhasználó dátumformázási adatait adja vissza. Lásd : dateFormattingInfo
defaultDashboardId	karakterlánc	Az aktuális felhasználó alapértelmezett irányítópultjának azonosítóját adja vissza.
isGuidedHelpEnabled	bool	Azt jelzi, hogy az irányított súgó engedélyezve van-e az aktuális felhasználó számára.
isHighContrastEnabled	bool	Azt jelzi, hogy a kontrasztos megjelenítés engedélyezve van-e az aktuális felhasználó számára.
isRTL	bool	Azt jelzi, hogy az aktuális felhasználó nyelve jobbról balra (RTL) van-e.
languageId	szám	Az aktuális felhasználó LCID nyelvi kódja .
roles	gyűjtemény	Keresési objektumok gyűjteménye, amely tartalmazza a felhasználóhoz rendelt biztonsági szerepkörök GUID-azonosítóját és megjelenítendő nevét, valamint a felhasználó által társított csapathoz rendelt biztonsági szerepköröket. Szerepkörök megtekintése
securityRolePrivileges	karakterlánc[]	sztringek tömbje, amelyek a felhasználó által társított biztonsági szerepkör-jogosultságok GUID-értékeit, illetve a felhasználó által társított csoportokat jelölik.
securityRoles	karakterlánc[]	Deprecated. Használja a tulajdonságot roles .
transactionCurrency	objektum	Az aktuális felhasználó tranzakciós pénznemét tartalmazó idnameentityType objektum. Lásd: transactionCurrency
transactionCurrencyId	karakterlánc	Deprecated. transactionCurrency A tulajdonság használata
userId	karakterlánc	Az aktuális felhasználó systemuser.systemuserid értéke.
userName	karakterlánc	Az aktuális felhasználó neve.

dateFormattingInfo

Olyan objektum, amely sztringtulajdonságokkal rendelkezik a dátumformázással kapcsolatban, például FirstDayOfWeek, LongDatePattern, MonthDayPattern, TimeSeparatorstb.

roles

A gyűjtemény a felhasználó által társított biztonsági szerepkörökhöz id és csoportokhoz tartozó objektumokat és name tulajdonságokat tartalmazza.

Ez a tulajdonság csak az egyesített felületen támogatott.

tranzakció pénzneme

Ez a módszer csak az egyesített felületen támogatott.

Az adatok a következőképpen nézhetnek ki:

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

Methods

Az userSettings objektum a következő módszerekkel rendelkezik:

getSecurityRolePrivilegesInfo metódus

Olyan ígéretet ad vissza, amely egy olyan objektummal oldható meg, amelynek kulcsai a biztonsági szerepkör jogosultsági GUID-jei, az értékek pedig a businessUnitId, depthés privilegeName a biztonsági szerepkör jogosultságát tartalmazó objektumok.

Szemantika

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

Paraméterek

Név	Típus	Kötelező	Description
successCallback	Funkció	Nem	A biztonsági szerepkör jogosultsági adatainak lekérésekor meghívandó függvény. A rendszer egy szótárt ad át a sikeres visszahívásnak, ahol a biztonsági szerepkör jogosultsági GUID-jei lesznek a kulcsok, az értékek pedig a következő tulajdonságokat tartalmazó objektumok lesznek: id:Húr. A biztonsági szerepkör jogosultsági GUID azonosítója. businessUnitId:Húr. A biztonsági szerepkör jogosultság üzleti egységének GUID azonosítója. privilegeName:Húr. A biztonsági szerepkör jogosultságának neve. depth:Húr. A biztonsági szerepkör jogosultsági mélysége.
errorCallback	Funkció	Nem	A művelet sikertelensége esetén meghívandó függvény. A rendszer a következő tulajdonságokkal rendelkező objektumot adja át: errorCode:Szám. A hibakód. message:Húr. A problémát leíró hibaüzenet.

Visszaadott érték

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

Sikeresség esetén egy ígéretobjektumot ad vissza, amely a fenti successCallback paraméter leírásában megadott értékeket tartalmazza.

Leírás: GUID és további részletek, például az egyes biztonsági szerepkörök jogosultságainak üzletiegység- és jogosultságneve.

getSecurityRolePrivilegesInfo példa

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 metódus

A helyi idő és az egyezményes világidő (UTC) közötti percek különbségét adja eredményül.

Szemantika

userSettings.getTimeZoneOffsetMinutes()

Visszaadott érték

Típus: szám

Leírás: Időzóna eltolása percekben.

Kapcsolódó cikkek

Ügyfélkörnyezet
Szervezeti beállítások
Xrm.Utility.getGlobalContext
Felhasználói beállítások (UserSettings) tábla