getGlobalContext.userSettings (Referensi API Klien)

Mengembalikan informasi tentang pengaturan pengguna saat ini.

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

Karakteristik

Objek userSettings memiliki properti berikut:

Nama Tipe Description
dateFormattingInfo objek Mengembalikan informasi pemformatan tanggal untuk pengguna saat ini. Lihat dateFormattingInfo
defaultDashboardId string Mengembalikan ID dasbor default untuk pengguna saat ini.
isGuidedHelpEnabled bool Apakah bantuan terpandu diaktifkan untuk pengguna saat ini.
isHighContrastEnabled bool Apakah kontras tinggi diaktifkan untuk pengguna saat ini.
isRTL bool Apakah bahasa untuk pengguna saat ini adalah bahasa kanan-ke-kiri (RTL).
languageId nomor/angka Kode bahasa LCID untuk pengguna saat ini.
roles koleksi Kumpulan objek pencarian yang berisi GUID dan nama tampilan masing-masing peran keamanan yang ditetapkan untuk pengguna dan peran keamanan apa pun yang ditetapkan ke tim yang terkait dengan pengguna. Lihat peran
securityRolePrivileges string[] array string yang mewakili nilai GUID dari setiap hak istimewa peran keamanan yang dikaitkan dengan pengguna atau tim apa pun yang terkait dengan pengguna.
securityRoles string[] Deprecated. roles Gunakan properti .
transactionCurrency objek Objek yang berisi id, name, dan entityType mata uang transaksi untuk pengguna saat ini. Lihat transactionCurrency
transactionCurrencyId string Deprecated. transactionCurrency Gunakan properti
userId string Nilai systemuser.systemuserid pengguna saat ini.
userName string Nama pengguna saat ini.

dateFormattingInfo

Objek dengan properti string tentang pemformatan tanggal seperti FirstDayOfWeek, , LongDatePatternMonthDayPattern, TimeSeparator, dan sebagainya.

roles

Koleksi berisi objek dengan id properti dan name untuk setiap peran keamanan atau tim yang dikaitkan dengan pengguna.

Properti ini hanya didukung pada Antarmuka Terpadu.

mata uang transaksi

Metode ini hanya didukung pada Antarmuka Terpadu.

Data mungkin terlihat seperti ini:

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

Methods

Objek userSettings memiliki metode berikut:

metode getSecurityRolePrivilegesInfo

Mengembalikan janji yang diselesaikan dengan objek yang kuncinya adalah GUID dan nilai hak istimewa peran keamanan adalah objek yang berisi businessUnitId, depth, dan privilegeName hak istimewa peran keamanan.

Syntax

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

Parameter-parameternya

Nama Tipe Diperlukan Description
successCallback Function Tidak. Fungsi yang akan dipanggil saat informasi hak istimewa peran keamanan diambil. Kamus akan diteruskan ke panggilan balik keberhasilan di mana GUID hak istimewa peran keamanan akan menjadi kunci dan nilainya akan menjadi objek yang berisi properti berikut:
id:Tali. GUID hak istimewa peran keamanan.
businessUnitId:Tali. GUID unit bisnis hak istimewa peran keamanan.
privilegeName:Tali. Nama hak istimewa peran keamanan.
depth:Tali. Kedalaman hak istimewa peran keamanan.
errorCallback Function Tidak. Fungsi untuk memanggil saat operasi gagal. Objek dengan properti berikut akan diteruskan:
errorCode:Angka. Kode kesalahan.
message:Tali. Pesan kesalahan yang menjelaskan masalah.

Mengembalikan Nilai

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

Setelah berhasil, mengembalikan objek janji yang berisi nilai yang ditentukan dalam deskripsi parameter successCallback di atas.

Deskripsi: GUID dan detail tambahan seperti Unit Bisnis dan Nama Hak Istimewa dari setiap hak istimewa peran keamanan.

contoh 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);
  });

Metode getTimeZoneOffsetMinutes

Mengembalikan selisih dalam menit antara waktu lokal dan Waktu Universal Terkoordinasi (UTC).

Syntax

userSettings.getTimeZoneOffsetMinutes()

Mengembalikan Nilai

Jenis: angka

Deskripsi: Offset zona waktu dalam menit.

Konteks klien
Pengaturan organisasi
Xrm.Utility.getGlobalContext
Tabel Pengaturan Pengguna (UserSettings)