Udostępnij przez

getGlobalContext.userSettings (dokumentacja interfejsu API klienta)

Zwraca informacje o bieżących ustawieniach użytkownika.

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

Właściwości

Obiekt userSettings ma następujące właściwości:

Name Typ Description
dateFormattingInfo obiekt Zwraca informacje o formatowaniu daty dla bieżącego użytkownika. Zobacz dateFormattingInfo
defaultDashboardId ciąg Zwraca identyfikator domyślnego pulpitu nawigacyjnego dla bieżącego użytkownika.
isGuidedHelpEnabled bool Czy pomoc z przewodnikiem jest włączona dla bieżącego użytkownika.
isHighContrastEnabled bool Czy dla bieżącego użytkownika jest włączony duży kontrast.
isRTL bool Czy język bieżącego użytkownika jest językiem od prawej do lewej (RTL).
languageId Liczba Kod języka LCID dla bieżącego użytkownika.
roles kolekcja Kolekcja obiektów odnośników zawierających identyfikator GUID i nazwę wyświetlaną każdej roli zabezpieczeń przypisanej do użytkownika oraz wszystkie role zabezpieczeń przypisane do zespołu, z którym jest skojarzony użytkownik. Zobacz role
securityRolePrivileges string[] tablica ciągów reprezentujących wartości identyfikatora GUID każdego uprawnienia roli zabezpieczeń, z którymi jest skojarzony użytkownik, lub z dowolnymi zespołami, z którymi jest skojarzony użytkownik.
securityRoles string[] Deprecated. roles Użyj właściwości .
transactionCurrency obiekt Obiekt zawierający idname, i entityType waluty transakcji dla bieżącego użytkownika. Zobacz transactionCurrency
transactionCurrencyId ciąg Deprecated. transactionCurrency Korzystanie z właściwości
userId ciąg Wartość systemuser.systemserid bieżącego użytkownika.
userName ciąg Nazwa bieżącego użytkownika.

dateFormattingInfo

Obiekt z właściwościami ciągu dotyczącymi formatowania dat, takich jak FirstDayOfWeek, LongDatePattern, MonthDayPattern, TimeSeparatori tak dalej.

roles

Kolekcja zawiera obiekty z właściwościami id i name dla każdej z ról zabezpieczeń lub zespołów, z którymi jest skojarzony użytkownik.

Ta właściwość jest obsługiwana tylko w ujednoliconym interfejsie.

waluta transakcji

Ta metoda jest obsługiwana tylko w ujednoliconym interfejsie.

Dane mogą wyglądać mniej więcej tak:

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

Methods

Obiekt userSettings ma następujące metody:

getSecurityRolePrivilegesInfo, metoda

Zwraca obietnicę, która rozwiązuje problem z obiektem, którego klucze są identyfikatorami GUID ról zabezpieczeń i wartościami są obiektami zawierającymi businessUnitId, depthi privilegeName uprawnienia roli zabezpieczeń.

Składnia

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

Parametry

Name Typ Wymagane Description
successCallback Funkcja Nie. Funkcja, która ma być wywoływana po pobraniu informacji o uprawnieniach roli zabezpieczeń. Słownik zostanie przekazany do wywołania zwrotnego sukcesu, gdzie identyfikatory GUID roli zabezpieczeń będą kluczami, a wartości będą obiektami zawierającymi następujące właściwości:
id:Struna. Identyfikator GUID roli zabezpieczeń.
businessUnitId:Struna. Identyfikator GUID jednostki biznesowej uprawnień roli zabezpieczeń.
privilegeName:Struna. Nazwa uprawnień roli zabezpieczeń.
depth:Struna. Głębokość uprawnień roli zabezpieczeń.
errorCallback Funkcja Nie. Funkcja wywoływana, gdy operacja zakończy się niepowodzeniem. Zostanie przekazany obiekt o następujących właściwościach:
errorCode:Numer. Kod błędu.
message:Struna. Komunikat o błędzie opisujący problem.

Wartość zwracana

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

W przypadku powodzenia zwraca obiekt obietnicy zawierający wartości określone w opisie powyższego parametru successCallback .

Opis: identyfikator GUID i dodatkowe szczegóły, takie jak jednostka biznesowa i nazwa uprawnień każdej z uprawnień roli zabezpieczeń.

przykład 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, metoda

Zwraca różnicę w minutach między czasem lokalnym a uniwersalnym czasem koordynowanym (UTC).

Składnia

userSettings.getTimeZoneOffsetMinutes()

Wartość zwracana

Typ: liczba

Opis: Przesunięcie strefy czasowej w minutach.

Kontekst klienta
Ustawienia organizacji
Xrm.Utility.getGlobalContext
Tabela Ustawienia użytkownika (UserSettings)

  • Last updated on