Compartir a través de

getGlobalContext.userSettings (Referencia de API de cliente)

  • Artículo

Devuelve la información sobre la configuración del usuario actual.

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

Propiedades

El objeto userSettings tiene las siguientes propiedades:

Name Type Description
dateFormattingInfo objeto Devuelve la información del formato de fecha para el usuario actual. Ver dateFormattingInfo
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 contraste alto está habilitado para el usuario actual.
isRTL bool Si el idioma del usuario actual es un idioma de derecha a izquierda (RTL).
languageId número El código de idioma LCID del usuario actual.
roles recopilación 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 cualquier rol de seguridad asignado al equipo con el que está asociado el usuario. Ver roles
securityRolePrivileges string[] Una matriz de cadenas que representan los valores GUID de cada uno de los privilegios rol de seguridad con los que está asociado el usuario o de cualquier equipo con el que esté asociado el usuario.
securityRoles string[] Obsoleto. Utilice la propiedad roles .
transactionCurrency objeto Objeto que contiene los id, name y entityType de la moneda de transacción del usuario actual. Ver Moneda de transacción
transactionCurrencyId string Obsoleto. Utilice la propiedad transactionCurrency
userId string El valor systemuser.systemuserid del usuario actual.
userName string El nombre del usuario actual.

dateFormattingInfo

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

roles

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

Esta propiedad solo es compatible con Interfaz unificada.

transactionCurrency

Este método solo se admite en la Interfaz unificada.

Los datos podrían verse así:

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

Métodos

El objeto userSettings tiene los siguientes métodos:

Método getSecurityRolePrivilegesInfo

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

Sintaxis

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

Parámetros

Name 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 devuelto

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

En caso de éxito, devuelve un objeto de 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 del 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 devuelto

Tipo: número

Descripción: Diferencia horaria en minutos.

Contexto del cliente
Configuración de la organización
Xrm.Utility.obtener contexto global
Tabla de configuración de usuario (UserSettings)