getGlobalContext.userSettings (kliento API nuoroda)

Objektas getGlobalContext.userSettings grąžina informaciją apie dabartinius vartotojo parametrus modeliu pagrįstose programėlėse, pvz., saugos vaidmenis, kalbą ir laiko juostą.

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

Apgyvendinimo įstaigos

Objektas userSettings turi šias ypatybes:

Pavadinimą	Rūšis	Aprašą
dateFormattingInfo	dateFormattingInfo	Grąžina dabartinio vartotojo datos formatavimo informaciją.
defaultDashboardId	eilutė	Grąžina dabartinio vartotojo numatytosios ataskaitų srities ID.
isGuidedHelpEnabled	Bulio	Ar dabartiniam vartotojui įgalintas interaktyvusis žinynas.
isHighContrastEnabled	Bulio	Ar dabartiniam vartotojui įgalintas didelis kontrastingumas.
isRTL	Bulio	Ar dabartinio vartotojo kalba yra iš dešinės į kairę rašoma (RTL) kalba.
languageId	Numeris	Dabartinio vartotojo LCID kalbos kodas .
roles	Vaidmenys	Peržvalgos objektų rinkinys, kuriame yra GUID ir rodomas kiekvieno vartotojui priskirto saugos vaidmens pavadinimas ir visi saugos vaidmenys, priskirti komandai, su kuria susietas vartotojas.
securityRolePrivileges	eilutė[]	eilučių masyvas, nurodantis kiekvienos su vartotoju susietos saugos vaidmens teisės GUID reikšmes arba komandas, su kuriomis vartotojas yra susietas.
securityRoles	eilutė[]	Nerekomenduojama. Naudokite ypatybę roles .
transactionCurrency	transactionCurrency	Dabartinio vartotojo operacijos valiuta.
transactionCurrencyId	eilutė	Nerekomenduojama. Naudoti ypatybę transactionCurrency
userId	eilutė	Dabartinio vartotojo systemuser.systemuserid reikšmė.
userName	eilutė	Dabartinio vartotojo vardas.

dateFormattingInfo

Objektas su eilutės ypatybėmis apie datos formatavimą, pvz FirstDayOfWeek., , LongDatePattern, MonthDayPattern, TimeSeparatorir t. t.

Vaidmenys

Rinkinyje yra objektų su id kiekvieno saugos vaidmens ar komandų, su kuriomis susietas vartotojas, ypatybės ir name ypatybės.

Ši ypatybė palaikoma tik vieningojoje sąsajoje.

transactionCurrency

Ši ypatybė palaikoma tik vieningojoje sąsajoje.

Nuoroda į valiutos (TransactionCurrency) įrašą. Duomenys gali atrodyti maždaug taip:

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

Sužinokite daugiau apie operacijos valiutą

Metodai

Objektas userSettings turi tokius metodus:

Metodas	aprašas
getSecurityRolePrivilegesInfo	Gaukite teisių pavadinimus, verslo vienetus ir prieigos gylį, kad patikrintumėte dabartinio vartotojo saugos vaidmens teises.
getTimeZoneOffsetMinutes	Gaukite dabartinio vartotojo laiko juostos poslinkį minutėmis, kad apskaičiuotumėte skirtumą tarp vietos laiko ir UTC.

getSecurityRolePrivilegesInfo metodas

Pateikia pažadą, kuris išsprendžiamas su objektu, kurio raktai yra saugos vaidmens teisių GUID, o reikšmės yra objektai, kuriuose businessUnitIdyra , depthir privilegeName saugos vaidmens privilegija.

Sintaksė

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

Parametrus

Pavadinimą	Rūšis	Privalomas	Aprašą
successCallback	Funkcija	Ne	Funkcija, iškviečiama, kai gaunama saugos vaidmens teisių informacija. Žodynas bus perduotas sėkmingai atgaliniu iškvietimu, kur saugos vaidmens teisių GUID bus raktai, o reikšmės bus objektai, kuriuose yra šios ypatybės: id:Eilutės. Saugos vaidmens teisių GUID. businessUnitId:Eilutės. Saugos vaidmens teisių verslo vieneto GUID. privilegeName:Eilutės. Saugos vaidmens teisės pavadinimas. depth:Eilutės. Saugos vaidmens teisių gylis.
errorCallback	Funkcija	Ne	Funkcija, kurią reikia iškviesti, kai operacija nepavyksta. Bus perduotas objektas su šiomis savybėmis: errorCode:Numeris. Klaidos kodas. message:Eilutės. Klaidos pranešimas, apibūdinantis problemą.

Grąžinama reikšmė

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

Sėkmingai pateikia pažado objektą, kuriame yra reikšmės, nurodytos aukščiau pateiktame "successCallback " parametro apraše.

Aprašas: GUID ir papildoma informacija, pvz., verslo vienetas ir kiekvienos saugos vaidmens teisių teisės pavadinimas.

getSecurityRolePrivilegesInfo pavyzdys

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 metodas

Grąžina vietos laiko ir universaliojo laiko (UTC) minučių skirtumą.

Sintaksė

userSettings.getTimeZoneOffsetMinutes()

Grąžinama reikšmė

Tipas: skaičius

Aprašas: laiko juostos poslinkis minutėmis.

Susiję straipsniai

Kliento kontekstas
Organizacijos parametrai
Xrm.Utility.getGlobalContext
Vartotojo parametrų (UserSettings) lentelė