Поделиться через

getGlobalContext.userSettings (справочник по API клиента)

Возвращает сведения о текущих параметрах пользователя.

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

Свойства

Объект userSettings имеет следующие свойства.

Имя Тип Description
dateFormattingInfo объект Возвращает сведения о форматировании дат для текущего пользователя. См. dateFormattingInfo
defaultDashboardId струна Возвращает идентификатор панели мониторинга по умолчанию для текущего пользователя.
isGuidedHelpEnabled bool Включена ли интерактивная справка для текущего пользователя.
isHighContrastEnabled bool Включена ли высокая контрастность для текущего пользователя.
isRTL bool Является ли язык для текущего пользователя языком справа налево (RTL).
languageId число/номер Код языка LCID для текущего пользователя.
roles коллекция Коллекция объектов подстановки, содержащая GUID и отображаемое имя каждой роли безопасности, назначенной пользователю, и все роли безопасности, назначенные команде, с которым связан пользователь. Просмотр ролей
securityRolePrivileges строка[] массив строк, представляющих значения GUID каждой из привилегий роли безопасности, с которыми связан пользователь, или с любыми командами, с которыми связан пользователь.
securityRoles строка[] Устарело. roles Используйте свойство.
transactionCurrency объект Объект, idnameсодержащий и entityType валюту транзакции для текущего пользователя. См . транзакциюCurrency
transactionCurrencyId струна Устарело. transactionCurrency Использование свойства
userId струна Значение systemuser.systemuserid текущего пользователя.
userName струна Имя текущего пользователя.

dateFormattingInfo

Объект со строковыми свойствами о форматировании дат, таких как FirstDayOfWeek, LongDatePattern, MonthDayPatternи TimeSeparatorт. д.

roles

Коллекция содержит объекты с idname свойствами для каждой из ролей безопасности или команд, с которыми связан пользователь.

Это свойство поддерживается только в едином интерфейсе.

валюта транзакции

Этот метод поддерживается только в едином интерфейсе.

Данные могут выглядеть примерно так:

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

Методы

Объект userSettings имеет следующие методы:

Метод getSecurityRolePrivilegesInfo

Возвращает обещание, которое разрешается с объектом, ключи которого являются идентификаторами GUID привилегий роли безопасности и значениями, являются объектами, содержащими businessUnitIdпривилегии depthроли безопасности, а также privilegeName привилегии роли безопасности.

Синтаксис

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

Параметры

Имя Тип Обязательно Description
successCallback Функция нет Функция, вызываемая при получении сведений о привилегиях роли безопасности. Словарь будет передан обратному вызову успешного выполнения, где идентификаторы GUID привилегированных ролей безопасности будут ключами, а значения — объектами, содержащими следующие свойства:
id:Струна. GUID привилегий роли безопасности.
businessUnitId:Струна. GUID бизнес-подразделения привилегии роли безопасности.
privilegeName:Струна. Имя привилегий роли безопасности.
depth:Струна. Глубина привилегий роли безопасности.
errorCallback Функция нет Функция, вызываемая при сбое операции. Будет передан объект со следующими свойствами:
errorCode:Число. Код ошибки.
message:Струна. Сообщение об ошибке с описанием проблемы.

Возвращаемое значение

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

При успешном выполнении возвращает объект promise, содержащий значения, указанные в описании параметра successCallback выше.

Описание: GUID и дополнительные сведения, такие как бизнес-единица и имя привилегий каждой роли безопасности.

Пример 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);
  });

Метод getTimeZoneOffsetMinutes

Возвращает разницу в минутах между местным временем и согласованным универсальным временем (UTC).

Синтаксис

userSettings.getTimeZoneOffsetMinutes()

Возвращаемое значение

Тип: число

Описание: смещение часового пояса в минутах.

Контекст клиента
Параметры организации
Xrm.Utility.getGlobalContext
Таблица "Параметры пользователя" (UserSettings)

  • Last updated on