getGlobalContext.userSettings (Referensi API Klien)

Objek getGlobalContext.userSettings mengembalikan informasi tentang pengaturan pengguna saat ini di aplikasi berbasis model, seperti peran keamanan, bahasa, dan zona waktu.

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

Karakteristik

Objek userSettings memiliki properti berikut:

Nama Tipe Description
dateFormattingInfo dateFormattingInfo Mengembalikan informasi pemformatan tanggal untuk pengguna saat ini.
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 Peran 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.
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 transactionCurrency Mata uang transaksi untuk pengguna saat ini.
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

Properti ini hanya didukung pada Antarmuka Terpadu.

Referensi ke rekaman Mata Uang (TransactionCurrency). Data mungkin terlihat seperti ini:

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

Pelajari selengkapnya tentang mata uang transaksi

Methods

Objek userSettings memiliki metode berikut:

Method description
getSecurityRolePrivilegesInfo Ambil nama hak istimewa, unit bisnis, dan kedalaman akses untuk memeriksa hak istimewa peran keamanan pengguna saat ini.
getTimeZoneOffsetMinutes Dapatkan offset zona waktu pengguna saat ini dalam hitungan menit untuk menghitung perbedaan antara waktu lokal dan UTC.

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)

  • Terakhir diperbarui pada