getGlobalContext.userSettings (การอ้างอิง API ไคลเอ็นต์)

ส่งกลับข้อมูลเกี่ยวกับการตั้งค่าผู้ใช้ปัจจุบัน

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

คุณสมบัติ

วัตถุ userSettings มีคุณสมบัติต่อไปนี้:

ชื่อ	ประเภท	คำอธิบาย
dateFormattingInfo	ออบเจ็กต์	ส่งกลับข้อมูลการจัดรูปแบบวันที่สําหรับผู้ใช้ปัจจุบัน ดู dateFormattingInfo
defaultDashboardId	สตริง	แสดง ID ของแดชบอร์ดเริ่มต้นสําหรับผู้ใช้ปัจจุบัน
isGuidedHelpEnabled	บูลีน	เปิดใช้งานตัวช่วยแนะนําสําหรับผู้ใช้ปัจจุบันหรือไม่
isHighContrastEnabled	บูลีน	เปิดใช้งานความคมชัดสูงสําหรับผู้ใช้ปัจจุบันหรือไม่
isRTL	บูลีน	ไม่ว่าภาษาสําหรับผู้ใช้ปัจจุบันจะเป็นภาษาที่จากขวาไปซ้าย (RTL) หรือไม่
languageId	เลข	รหัสภาษา LCID สําหรับผู้ใช้ปัจจุบัน
roles	คอลเลกชัน	คอลเลกชันของวัตถุการค้นหาที่ประกอบด้วย GUID และชื่อที่แสดงของแต่ละบทบาทความปลอดภัยที่กําหนดให้กับผู้ใช้และบทบาทความปลอดภัยใด ๆ ที่กําหนดให้กับทีมที่ผู้ใช้เชื่อมโยงด้วย ดู บทบาท
securityRolePrivileges	string[]	อาร์เรย์ของสตริงที่แสดงค่า GUID ของแต่ละสิทธิ์การใช้งานบทบาทความปลอดภัยที่ผู้ใช้เชื่อมโยงด้วยหรือทีมใดก็ตามที่ผู้ใช้เชื่อมโยงด้วย
securityRoles	string[]	ยกเลิกแล้ว ใช้คุณสมบัติroles
transactionCurrency	ออบเจ็กต์	ออบเจ็กต์ที่มี id, nameและ entityType ของสกุลเงินธุรกรรมสําหรับผู้ใช้ปัจจุบัน ดู transactionCurrency
transactionCurrencyId	สตริง	ยกเลิกแล้ว ใช้คุณสมบัติtransactionCurrency
userId	สตริง	ค่า systemuser.systemuserid ของผู้ใช้ปัจจุบัน
userName	สตริง	ชื่อของผู้ใช้ปัจจุบัน

dateFormattingInfo

วัตถุที่มีคุณสมบัติสตริงเกี่ยวกับการจัดรูปแบบวันที่ เช่น FirstDayOfWeek, LongDatePattern, MonthDayPattern, TimeSeparator, และอื่น ๆ

บทบาท

คอลเลกชันมีวัตถุ และidnameคุณสมบัติสําหรับแต่ละบทบาทความปลอดภัยหรือทีมที่ผู้ใช้ถูกกําหนดความสัมพันธ์ด้วย

คุณสมบัตินี้ได้รับการสนับสนุนเฉพาะบนอินเทอร์เฟซแบบรวม

transactionCurrency

วิธีนี้ได้รับการสนับสนุนเฉพาะบนอินเทอร์เฟซแบบรวมศูนย์เท่านั้น

ข้อมูลอาจมีลักษณะดังนี้:

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

วิธีการ

วัตถุ userSettings มีวิธีการต่อไปนี้:

getSecurityRolePrivilegesInfo method

แสดงสัญญาที่แก้ไขด้วยออบเจ็กต์ที่มีคีย์เป็น GUID ของสิทธิ์บทบาทความปลอดภัยและค่าเป็นออบเจ็กต์ที่ businessUnitIdประกอบด้วย , depthและ privilegeName ของสิทธิ์บทบาทความปลอดภัย

ไวยากรณ์

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

พารามิเตอร์

ชื่อ	ประเภท	ต้องมี	คำอธิบาย
successCallback	ฟังก์ชัน	ไม่ใช่	ฟังก์ชันที่จะเรียกใช้เมื่อมีการเรียกใช้ข้อมูลสิทธิ์การใช้งานบทบาทการรักษาความปลอดภัย พจนานุกรมจะถูกส่งผ่านไปยังการเรียกกลับความสําเร็จ ซึ่ง GUID ของสิทธิ์การใช้งานบทบาทความปลอดภัยจะเป็นคีย์และค่าจะเป็นวัตถุที่ประกอบด้วยคุณสมบัติต่อไปนี้: id:เชือก GUID สิทธิ์ของบทบาทความปลอดภัย businessUnitId:เชือก GUID ของหน่วยธุรกิจของสิทธิ์บทบาทความปลอดภัย privilegeName:เชือก ชื่อสิทธิพิเศษของบทบาทความปลอดภัย depth:เชือก ความลึกของสิทธิพิเศษของบทบาทความปลอดภัย
errorCallback	ฟังก์ชัน	ไม่ใช่	ฟังก์ชันที่จะเรียกใช้เมื่อการดําเนินการล้มเหลว วัตถุที่มีคุณสมบัติต่อไปนี้จะถูกส่งผ่าน: errorCode:เลข รหัสข้อผิดพลาด message:เชือก ข้อความแสดงข้อผิดพลาดที่อธิบายปัญหา

ค่าส่งกลับ

ชนิด: Promise<{[key: string]: {id: string, businessUnitId: string, privilegeName: string, depth: number}}>

ในความสําเร็จ ส่งกลับวัตถุสัญญาที่ประกอบด้วยค่าที่ระบุในคําอธิบายของพารามิเตอร์ successCallback ข้างต้น

คําอธิบาย GUID และรายละเอียดเพิ่มเติม เช่น ชื่อหน่วยธุรกิจและสิทธิพิเศษของแต่ละสิทธิ์ของบทบาทความปลอดภัย

ตัวอย่าง 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

ส่งกลับความแตกต่างเป็นนาทีระหว่างเวลาท้องถิ่นและเวลามาตรฐานสากล (UTC)

ไวยากรณ์

userSettings.getTimeZoneOffsetMinutes()

ค่าส่งกลับ

ชนิด: ตัวเลข

คําอธิบาย: ค่าชดเชยโซนเวลาเป็นนาที

บทความที่เกี่ยวข้อง

บริบทไคลเอ็นต์
การตั้งค่าองค์กร
Xrm.Utility.getGlobalContext
ตารางการตั้งค่าผู้ใช้ (UserSettings)