getGlobalContext.userSettings (Rujukan API Klien)

Objek ini getGlobalContext.userSettings mengembalikan maklumat tentang tetapan pengguna semasa dalam aplikasi berasaskan model, seperti peranan keselamatan, bahasa, dan zon masa.

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

Hartanah

Objek ini userSettings mempunyai sifat berikut:

Nama Jenis Keterangan
dateFormattingInfo tarikhFormattingInfo Mengembalikan maklumat pemformatan tarikh untuk pengguna semasa.
defaultDashboardId rentetan Mengembalikan ID papan pemuka lalai untuk pengguna semasa.
isGuidedHelpEnabled bool Sama ada bantuan berpandu didayakan untuk pengguna semasa.
isHighContrastEnabled bool Sama ada kontras tinggi didayakan untuk pengguna semasa.
isRTL bool Sama ada bahasa untuk pengguna semasa ialah bahasa kanan ke kiri (RTL).
languageId Nombor Kod bahasa LCID untuk pengguna semasa.
roles Peranan Koleksi objek carian yang mengandungi GUID dan nama paparan bagi setiap peranan keselamatan yang diperuntukkan kepada pengguna dan sebarang peranan keselamatan yang diperuntukkan kepada pasukan yang dikaitkan dengan pengguna.
securityRolePrivileges rentetan[] tatasusunan rentetan yang mewakili nilai GUID bagi setiap keistimewaan peranan keselamatan yang dikaitkan dengan pengguna atau mana-mana pasukan yang dikaitkan dengan pengguna.
securityRoles rentetan[] Ditamatkan. Gunakan harta roles itu.
transactionCurrency transaksiMata Wang Mata wang transaksi untuk pengguna semasa.
transactionCurrencyId rentetan Ditamatkan. Gunakan hartanah transactionCurrency
userId rentetan Nilai systemuser.systemuserid pengguna semasa.
userName rentetan Nama pengguna semasa.

dateFormattingInfo

Objek dengan sifat rentetan tentang pemformatan tarikh seperti FirstDayOfWeek, LongDatePattern, , MonthDayPatternTimeSeparator, dan sebagainya.

Peranan

Koleksi mengandungi objek dengan id dan name sifat untuk setiap peranan keselamatan atau pasukan yang dikaitkan dengan pengguna.

Sifat ini disokong hanya pada Antara Muka Disatukan.

transaksiMata Wang

Sifat ini disokong hanya pada Antara Muka Disatukan.

Rujukan kepada rekod Mata Wang (TransactionCurrency). Data mungkin kelihatan seperti ini:

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

Ketahui lebih lanjut tentang mata wang transaksi

Kaedah

Objek ini userSettings mempunyai kaedah berikut:

Kaedah perihalan
getSecurityRolePrivilegesInfo. Dapatkan nama keistimewaan, unit perniagaan, dan kedalaman akses untuk memeriksa keistimewaan peranan keselamatan pengguna semasa.
getTimeZoneOffsetMinutes Dapatkan offset zon waktu pengguna semasa dalam minit untuk mengira perbezaan antara waktu tempatan dan UTC.

kaedah getSecurityRolePrivilegesInfo

Mengembalikan janji yang diselesaikan dengan objek yang kuncinya ialah keistimewaan peranan keselamatan GUID dan nilai ialah objek yang mengandungi businessUnitId, depthdan privilegeName keistimewaan peranan keselamatan.

Sintaks

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

Parameter

Nama Jenis Wajib Keterangan
successCallback Function Tidak Fungsi untuk memanggil apabila maklumat keistimewaan peranan keselamatan diambil. Kamus akan dihantar kepada panggilan balik kejayaan di mana GUID keistimewaan peranan keselamatan akan menjadi kunci dan nilai akan menjadi objek yang mengandungi sifat berikut:
id:Rentetan. Keistimewaan peranan keselamatan GUID.
businessUnitId:Rentetan. GUID unit perniagaan keistimewaan peranan keselamatan.
privilegeName:Rentetan. Nama keistimewaan peranan keselamatan.
depth:Rentetan. Keistimewaan peranan keselamatan kedalaman.
errorCallback Function Tidak Fungsi untuk memanggil apabila operasi gagal. Objek dengan sifat berikut akan diluluskan:
errorCode:Nombor. Kod ralat.
message:Rentetan. Mesej ralat yang menerangkan isu tersebut.

Nilai pulangan

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

Apabila berjaya, mengembalikan objek janji yang mengandungi nilai yang ditentukan dalam perihalan parameter successCallback di atas.

Perihalan: GUID dan butiran tambahan seperti Unit Perniagaan dan Nama Keistimewaan bagi setiap keistimewaan peranan keselamatan.

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

kaedah getTimeZoneOffsetMinutes

Mengembalikan perbezaan minit antara waktu tempatan dan Waktu Sejagat Diselaraskan (UTC).

Sintaks

userSettings.getTimeZoneOffsetMinutes()

Nilai pulangan

Jenis: nombor

Penerangan: Zon waktu mengimbangi dalam beberapa minit.

Konteks pelanggan
Tetapan organisasi
Xrm.Utility.getGlobalContext
Jadual Tetapan Pengguna (Tetapan Pengguna)