getGlobalContext.userSettings (Referencia de API de cliente)

El getGlobalContext.userSettings objeto devuelve información sobre la configuración actual del usuario en aplicaciones controladas por modelos, como roles de seguridad, idioma y zona horaria.

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

Propiedades

El objeto userSettings tiene las siguientes propiedades:

Nombre. Type Description
dateFormattingInfo dateFormattingInfo Devuelve la información del formato de fecha para el usuario actual.
defaultDashboardId string Devuelve el Id. del panel predeterminado para el usuario actual.
isGuidedHelpEnabled bool Si la ayuda guiada está habilitada para el usuario actual.
isHighContrastEnabled bool Si el contraste alto está habilitado para el usuario actual.
isRTL bool Si el idioma para el usuario actual es un idioma que se escribe de derecha a izquierda (RTL).
languageId número El código de idioma LCID para el usuario actual.
roles roles Una colección de objetos de búsqueda que contienen el GUID y nombre de cada uno de los rol de seguridad asignados al usuario y los roles de seguridad asignados al equipo con el que está asociado el usuario.
securityRolePrivileges string[] una matriz de cadenas que represente los valores de GUID de cada privilegio de rol de seguridad con el que está asociado el usuario o cualquier equipo al que está asociado el usuario.
securityRoles string[] Obsoleto. Use la propiedad roles.
transactionCurrency transactionCurrency Moneda de transacción del usuario actual.
transactionCurrencyId string Obsoleto. Usar la propiedad transactionCurrency
userId string El valor de systemuser.systemuserid del usuario actual.
userName string El nombre del usuario actual.

dateFormattingInfo

Un objeto con propiedades de cadena sobre el formato de fecha, como FirstDayOfWeek, LongDatePattern, MonthDayPattern, TimeSeparator, etc.

roles

La colección contiene objetos con y propiedades id y name para cada uno de los roles de seguridad o equipos con los que está asociado el usuario.

Esta propiedad solo se admite en Interfaz unificada.

transactionCurrency

Esta propiedad solo se admite en Interfaz unificada.

Referencia a un registro Currency (TransactionCurrency). Los datos podrían tener un aspecto similar a este:

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

Más información sobre la moneda de transacción

Métodos

El objeto userSettings tiene los siguientes métodos:

Method description
getSecurityRolePrivilegesInfo Recupere los nombres de privilegios, las unidades de negocio y las profundidades de acceso para inspeccionar los privilegios de rol de seguridad del usuario actual.
getTimeZoneOffsetMinutes Obtenga el desplazamiento de zona horaria del usuario actual en minutos para calcular la diferencia entre la hora local y la HORA UTC.

método getSecurityRolePrivilegesInfo()

Devuelve una promesa que se resuelve con un objeto cuyas claves son los GUID de privilegio rol de seguridad y los valores son objetos que contienen el businessUnitId, depth, y privilegeName del privilegio rol de seguridad.

Sintaxis

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

Parámetros

Nombre. Type Obligatorio Description
successCallback Function No Una función para llamar cuando se recupera la información de privilegios rol de seguridad. Se pasará un diccionario a la devolución de llamada exitosa donde los GUID de privilegio rol de seguridad serán las claves y los valores serán objetos que contienen las siguientes propiedades:
id: Cadena. El privilegio del rol de seguridad GUID.
businessUnitId: Cadena. El GUID de la unidad de negocio del privilegio rol de seguridad.
privilegeName: Cadena. El privilegio del rol de seguridad nombre.
depth: Cadena. Profundidad del privilegio del rol de seguridad.
errorCallback Function No Una función a la que se llama cuando la operación tiene error. Se pasará un objeto con las siguientes propiedades:
errorCode: Número. Código de error.
message: Cadena. Un mensaje de error que describe el problema.

Valor de retorno

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

En caso de éxito, devuelve un objeto promesa que contiene los valores especificados en la descripción del parámetro successCallback anterior.

Descripción: GUID y detalles adicionales como la unidad de negocio y el nombre de privilegio de cada uno de los privilegios rol de seguridad.

Ejemplo 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

Devuelve la diferencia en minutos entre la hora local y el Horario universal coordinado (UTC).

Sintaxis

userSettings.getTimeZoneOffsetMinutes()

Valor de retorno

Tipo: número

Descripción: desplazamiento de huso horario en minutos.

Contexto de cliente
Configuración de organización
Xrm.Utility.getGlobalContext
Tabla Configuración de usuario (UserSettings)

  • Se actualizó por última vez el