getGlobalContext.userSettings (Klient-API-referanse)

Objektet getGlobalContext.userSettings returnerer informasjon om gjeldende brukerinnstillinger i modelldrevne apper, for eksempel sikkerhetsroller, språk og tidssone.

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

Egenskaper

Objektet userSettings har følgende egenskaper:

Name Type Bekrivelse
dateFormattingInfo dateFormattingInfo Returnerer datoformateringsinformasjonen for gjeldende bruker.
defaultDashboardId streng Returnerer ID-en for standardinstrumentbordet for gjeldende bruker.
isGuidedHelpEnabled bool Om veiledet hjelp er aktivert for gjeldende bruker.
isHighContrastEnabled bool Om høykontrast er aktivert for gjeldende bruker.
isRTL bool Om språket for gjeldende bruker er et høyre-mot-venstre-språk (RTL).
languageId nummer LCID-språkkoden for gjeldende bruker.
roles roller En samling oppslagsobjekter som inneholder GUID-en og visningsnavnet for hver av sikkerhetsrollene som er tilordnet brukeren og eventuelle sikkerhetsroller som er tilordnet teamet som brukeren er tilknyttet.
securityRolePrivileges string[] en matrise med strenger som representerer GUID-verdiene for hver av sikkerhetsrollerettighetene som brukeren er knyttet til, eller team som brukeren er tilknyttet.
securityRoles string[] Avskrevet. Bruk egenskapen roles .
transactionCurrency transactionCurrency Transaksjonsvalutaen for gjeldende bruker.
transactionCurrencyId streng Avskrevet. Bruk egenskapen transactionCurrency
userId streng Systemuser.systemuserid-verdien for gjeldende bruker.
userName streng Navnet på gjeldende bruker.

dateFormattingInfo

Et objekt med strengegenskaper om datoformatering, for eksempel FirstDayOfWeek, LongDatePattern, MonthDayPatternTimeSeparator, og så videre.

Roller

Samlingen inneholder objekter med id og name egenskaper for hver av sikkerhetsrollene eller teamene som brukeren er tilknyttet.

Denne egenskapen støttes bare i Enhetlig grensesnitt.

transactionCurrency

Denne egenskapen støttes bare i Enhetlig grensesnitt.

En referanse til en valutapost (TransactionCurrency). Dataene kan se omtrent slik ut:

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

Finn ut mer om transaksjonsvaluta

Metoder

Objektet userSettings har følgende metoder:

Metode description
getSecurityRolePrivilegesInfo Hent rettighetsnavn, forretningsenheter og tilgangsdybder for å undersøke den gjeldende brukerens sikkerhetsrollerettigheter.
getTimeZoneOffsetMinutes Få tidssoneforskyvningen for gjeldende bruker i minutter for å beregne forskjellen mellom lokal tid og UTC.

getSecurityRolePrivilegesInfo-metode

Returnerer et løfte som løses med et objekt som har nøkler som er GUIDer for sikkerhetsrollerettigheter, og verdier som er objekter som inneholder rettigheten businessUnitId, depthog privilegeName sikkerhetsrollen.

Syntaks

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

Parametere

Name Type Kreves Bekrivelse
successCallback Function No En funksjon som skal ringes når informasjonen om sikkerhetsrollerettigheter hentes. En ordliste sendes til tilbakeringingssuksessen der GUIDene for sikkerhetsrollerettigheter vil være nøklene, og verdiene vil være objekter som inneholder følgende egenskaper:
id:Streng. GUID for sikkerhetsrollerettigheter.
businessUnitId:Streng. GUID-en for forretningsenheten for sikkerhetsrollerettighetene.
privilegeName:Streng. Navnet på sikkerhetsrollerettigheter.
depth:Streng. Dybde på sikkerhetsrollerettigheter.
errorCallback Function No En funksjon som skal kalles når operasjonen mislykkes. Et objekt med følgende egenskaper vil bli sendt:
errorCode:Nummer. Feilkoden.
message:Streng. En feilmelding som beskriver problemet.

returverdi

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

Ved vellykket suksess returnerer et løfteobjekt som inneholder verdiene som er angitt i beskrivelsen av successCallback-parameteren ovenfor.

Beskrivelse: GUID og tilleggsdetaljer, for eksempel forretningsenhet og rettighetsnavn for hver av sikkerhetsrollerettighetene.

getSecurityRolePrivilegesInfo eksempel

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-metode

Returnerer differansen i minutter mellom lokal tid og coordinated Universal Time (UTC).

Syntaks

userSettings.getTimeZoneOffsetMinutes()

returverdi

Type: tall

Beskrivelse: Tidssoneforskyvning i minutter.

Klientkontekst
Organisasjonsinnstillinger
Xrm.Utility.getGlobalContext
Brukerinnstillinger-tabell (UserSettings)

  • Sist oppdatert