getGlobalContext.userSettings (Referència de l'API de client)

Retorna informació sobre la configuració actual de l'usuari.

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

Propietats

L'objecte userSettings té les propietats següents:

Nom Tipus Descripció
dateFormattingInfo objecte Retorna la informació de format de data de l'usuari actual. Veure dateFormattingInfo
defaultDashboardId cadena Retorna l'identificador de l'escriptori digital per defecte de l'usuari actual.
isGuidedHelpEnabled bool Si l'ajuda guiada està habilitada per a l'usuari actual.
isHighContrastEnabled bool Si el contrast alt està habilitat per a l'usuari actual.
isRTL bool Si la llengua de l'usuari actual és una llengua de dreta a esquerra (RTL).
languageId número El codi d'idioma LCID de l'usuari actual.
roles col·lecció Col·lecció d'objectes de cerca que conté el GUID i el nom de visualització de cadascuna de les funcions de seguretat assignades a l'usuari i de les funcions de seguretat assignades a l'equip amb el qual l'usuari està associat. Veure rols
securityRolePrivileges corda[modifica] una matriu de cadenes que representen els valors GUID de cadascun dels privilegis de funció de seguretat amb els quals està associat l'usuari o de qualsevol equip amb el qual estigui associat.
securityRoles corda[modifica] Obsolet. Utilitzeu la roles propietat.
transactionCurrency objecte Objecte que conté el id, namei entityType de la moneda de transacció de l'usuari actual. Veure transaccionMoneda
transactionCurrencyId cadena Obsolet. Utilitzar la transactionCurrency propietat
userId cadena El valor systemuser.systemuserid de l'usuari actual.
userName cadena El nom de l'usuari actual.

dateFormattingInfo

Objecte amb propietats de cadena sobre el format de data, com ara FirstDayOfWeek, LongDatePattern, MonthDayPattern, TimeSeparator, i així successivament.

Rols

La col·lecció conté objectes amb id propietats i name per a cadascuna de les funcions de seguretat o equips amb els quals està associat l'usuari.

Aquesta propietat només s'admet a la interfície unificada.

transaccióMoneda

Aquest mètode només s'admet a la interfície unificada.

Les dades poden semblar així:

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

Mètodes

L'objecte userSettings té els mètodes següents:

Mètode getSecurityRolePrivilegesInfo

Retorna una promesa que es resol amb un objecte les claus del qual són els GUID de privilegi de la funció de seguretat i els valors són objectes que contenen el businessUnitIddepthprivilegi de la funció de seguretat , i privilegeName de la funció de seguretat.

Sintaxi

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

Paràmetres

Nom Tipus Necessari Descripció
successCallback Function No Funció per cridar quan es recupera la informació de privilegis de la funció de seguretat. Es passarà un diccionari a la devolució de trucada d'èxit on els GUID de privilegi de funció de seguretat seran les claus i els valors seran objectes que continguin les propietats següents:
id:Corda. El GUID del privilegi de la funció de seguretat.
businessUnitId:Corda. El GUID de la unitat de negoci del privilegi de funció de seguretat.
privilegeName:Corda. El nom del privilegi de la funció de seguretat.
depth:Corda. La profunditat de privilegis de la funció de seguretat.
errorCallback Function No Una funció per cridar quan l'operació falla. Es passarà un objecte amb les següents propietats:
errorCode:Número. El codi d'error.
message:Corda. Un missatge d'error que descriu el problema.

Valor de retorn

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

En cas d'èxit, retorna un objecte de promesa que conté els valors especificats a la descripció del paràmetre successCallback anterior.

Descripció: GUID i detalls addicionals, com ara la unitat de negoci i el nom del privilegi de cadascun dels privilegis de la funció de seguretat.

Exemple de getSecurityRolePrivilegesInfo

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

Mètode getTimeZoneOffsetMinutes

Retorna la diferència en minuts entre l'hora local i l'hora universal coordinada (UTC).

Sintaxi

userSettings.getTimeZoneOffsetMinutes()

Valor de retorn

Tipus: número

Descripció: Desplaçament de fus horari en minuts.

Context del client
Configuració de l'organització
Xrm.Utility.getGlobalContext
Taula Configuració de l'usuari (UserSettings)

  • Last updated on