getGlobalContext.userSettings (Referencia da API do cliente)

Devolve información sobre a configuración actual do usuario.

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

Propiedades

O userSettings obxecto ten as seguintes propiedades:

Nome	Tipo	Descripción
dateFormattingInfo	obxecto	Devolve a información de formato de data para o usuario actual. Ver dateFormattingInfo
defaultDashboardId	cadea	Devolve o ID do panel predeterminado para o usuario actual.
isGuidedHelpEnabled	booleano	Indica se a axuda guiada está activada para o usuario actual.
isHighContrastEnabled	booleano	Indica se o contraste alto está activado para o usuario actual.
isRTL	booleano	Se o idioma do usuario actual é un idioma de dereita a esquerda (RTL).
languageId	número	Código de idioma LCID para o usuario actual.
roles	colección	Unha colección de obxectos de busca que conteñen o GUID e o nome de visualización de cada un dos roles de seguridade asignados ao usuario e os roles de seguridade asignados ao equipo ao que o usuario está asociado. Ver roles
securityRolePrivileges	corda[editar | editar a fonte]	unha matriz de cadeas que representan os valores GUID de cada un dos privilexios do rol de seguridade ao que o usuario está asociado ou de calquera equipo co que o usuario estea asociado.
securityRoles	corda[editar | editar a fonte]	Obsoleto. Utiliza a propiedade roles .
transactionCurrency	obxecto	Obxecto que contén a idmoeda name, e entityType da moeda da transacción para o usuario actual. Ver transacciónMoeda
transactionCurrencyId	cadea	Obsoleto. Utilizar a propiedade transactionCurrency
userId	cadea	O valor systemuser.systemuserid do usuario actual.
userName	cadea	Nome do usuario actual.

dateFormattingInfo

Obxecto con propiedades de cadea sobre o formato de datas como FirstDayOfWeek, LongDatePattern, MonthDayPattern, TimeSeparator, e así sucesivamente.

Papeis

A colección contén obxectos e id propiedades para cada un dos roles de seguridade name ou equipos cos que o usuario está asociado.

Esta propiedade só está soportada na interface unificada.

Moeda da transacción

Este método só se admite na interface unificada.

Os datos poden parecer algo así:

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

Métodos

O userSettings obxecto ten os seguintes métodos:

Método getSecurityRolePrivilegesInfo

Devolve unha promesa que se resolve cun obxecto cuxas claves son os GUID do privilexio do rol de seguridade e os valores son obxectos que conteñen o privilexio , businessUnitIddepthe do rol de seguridadeprivilegeName.

Sintaxe

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

Parámetros

Nome	Tipo	Obrigatorio	Descripción
successCallback	Function	Non	Unha función para chamar cando se recupera a información dos privilexios do rol de seguridade. Pasarase un dicionario á chamada de éxito onde os GUID do privilexio do rol de seguridade serán as claves e os valores serán obxectos que conteñan as seguintes propiedades: id: String. O privilexio do rol de seguridade GUID. businessUnitId: String. O GUID da unidade de negocio do privilexio do rol de seguridade. privilegeName: String. Nome do privilexio do rol de seguridade. depth: String. O papel de seguridade privilexio profundidade.
errorCallback	Function	Non	Unha función a chamar cando a operación falla. Pasará un obxecto coas seguintes propiedades: errorCode: Número. Código de erro. message: String. Mensaxe de erro que describe o problema.

Devolver valor

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

En caso de éxito, devolve un obxecto de promesa que contén os valores especificados na descrición do parámetro successCallback anterior.

Descrición: GUID e detalles adicionais como a unidade de negocio e o nome do privilexio de cada un dos privilexios do rol de seguridade.

Exemplo 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étodo getTimeZoneOffsetMinutes

Devolve a diferenza en minutos entre a hora local e a hora universal coordinada (UTC).

Sintaxe

userSettings.getTimeZoneOffsetMinutes()

Devolver valor

Tipo: número

Descrición: Desprazamento do fuso horario en minutos.

Artigos relacionados

Contexto do cliente
Configuración da organización
Xrm.Utility.getGlobalContext
Táboa de configuración do usuario (UserSettings)