Compartir vía

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:

Nombre. Type Description
dateFormattingInfo objeto Devuelve la información del formato de fecha para el usuario actual. Consulte 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 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 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 los roles de seguridad asignados al equipo con el que está asociado el usuario. Ver roles
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 objeto Objeto que contiene el id, name y entityType de la moneda de la transacción para el usuario actual. Consulte transactionCurrency
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 id y name propiedades 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

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

Los datos podrían tener un aspecto similar a este:

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

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

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)