getGlobalContext.userSettings (Rujukan API Klien)

Mengembalikan maklumat tentang tetapan pengguna semasa.

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

Hartanah

Objek ini userSettings mempunyai sifat berikut:

Nama	Jenis	Keterangan
dateFormattingInfo	objek	Mengembalikan maklumat pemformatan tarikh untuk pengguna semasa. Lihat dateFormattingInfo
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	koleksi	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. Lihat peranan
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	objek	Objek yang mengandungi id, name, dan entityType mata wang transaksi untuk pengguna semasa. Lihat transaksiMata Wang
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

Kaedah ini hanya disokong pada Antara Muka Bersepadu.

Data mungkin kelihatan seperti ini:

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

Kaedah

Objek ini userSettings mempunyai kaedah berikut:

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.

Artikel berkaitan

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