getGlobalContext.userSettings (Tài liệu tham khảo về API máy khách)

Trả về thông tin về thiết đặt người dùng hiện tại.

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

Thuộc tính

Đối userSettings tượng có các thuộc tính sau:

Tên Kiểu Sự miêu tả
dateFormattingInfo đối tượng Trả về thông tin định dạng ngày cho người dùng hiện tại. Xem dateFormattingInfo
defaultDashboardId chuỗi Trả về ID của bảng điều khiển mặc định cho người dùng hiện tại.
isGuidedHelpEnabled bool Liệu trợ giúp có hướng dẫn có được bật cho người dùng hiện tại hay không.
isHighContrastEnabled bool Người dùng hiện tại có bật độ tương phản cao hay không.
isRTL bool Liệu ngôn ngữ cho người dùng hiện tại có phải là ngôn ngữ từ phải sang trái (RTL).
languageId số Mã ngôn ngữ LCID cho người dùng hiện tại.
roles bản sưu tập Tuyển tập các đối tượng tra cứu có chứa GUID và tên hiển thị của từng vai trò bảo mật được gán cho người dùng và mọi vai trò bảo mật được gán cho nhóm mà người dùng được liên kết. Xem vai trò
securityRolePrivileges chuỗi[] một loạt các chuỗi đại diện cho các giá trị GUID của mỗi đặc quyền vai trò bảo mật mà người dùng được liên kết hoặc bất kỳ nhóm nào mà người dùng được liên kết.
securityRoles chuỗi[] Phản đối. Sử dụng thuộc roles tính.
transactionCurrency đối tượng Đối tượng chứa id, và namecủa entityType tiền tệ giao dịch cho người dùng hiện tại. Xem Tiền tệ giao dịch
transactionCurrencyId chuỗi Phản đối. Sử dụng thuộc transactionCurrency tính
userId chuỗi Giá trị systemuser.systemuserid của người dùng hiện tại.
userName chuỗi Tên của người dùng hiện tại.

dateFormattingInfo

Một đối tượng có thuộc tính chuỗi về định dạng ngày FirstDayOfWeeknhư , LongDatePatternMonthDayPattern, , TimeSeparator, v.v.

Vai trò

Bộ sưu tập chứa các đối id tượng name có và thuộc tính cho mỗi vai trò bảo mật hoặc nhóm mà người dùng được liên kết.

Thuộc tính này chỉ được hỗ trợ trên Giao diện Hợp nhất.

tiền tệ giao dịch

Phương pháp này chỉ được hỗ trợ trên Giao diện Hợp nhất.

Dữ liệu có thể trông như thế này:

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

Phương pháp

Đối userSettings tượng có các phương pháp sau đây:

phương pháp getSecurityRolePrivilegesInfo

Trả lại lời hứa giải quyết bằng một đối tượng có khóa là GUID businessUnitIdđặc quyền vai trò bảo mật và giá trị là các đối tượng chứa , depthprivilegeName và của đặc quyền vai trò bảo mật.

Cú pháp

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

Tham số

Tên Kiểu Bắt buộc Sự miêu tả
successCallback Hàm Không Hàm để gọi khi thông tin đặc quyền vai trò bảo mật được truy xuất. Một từ điển sẽ được chuyển đến lời gọi lại thành công, trong đó GUID đặc quyền vai trò bảo mật sẽ là các khóa và các giá trị sẽ là các đối tượng có chứa các thuộc tính sau:
id:Xâu. GUID đặc quyền vai trò bảo mật.
businessUnitId:Xâu. GUID của đơn vị kinh doanh của đặc quyền vai trò bảo mật.
privilegeName:Xâu. Tên đặc quyền vai trò bảo mật.
depth:Xâu. Độ sâu đặc quyền vai trò bảo mật.
errorCallback Hàm Không Một hàm để gọi khi hoạt động không thành công. Một đối tượng có các thuộc tính sau sẽ được truyền:
errorCode:Số. Mã lỗi.
message:Xâu. Thông báo lỗi mô tả sự cố.

Trả về giá trị

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

Khi thành công, trả về một đối tượng promise chứa các giá trị được xác định trong mô tả của tham số successCallback ở trên.

Mô tả: GUID và các chi tiết bổ sung như Đơn vị Kinh doanh và Tên Đặc quyền của từng đặc quyền vai trò bảo mật.

ví dụ về 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);
  });

phương pháp getTimeZoneOffsetMinutes

Trả về chênh lệch theo phút giữa giờ địa phương và Giờ Quốc tế Phối hợp (UTC).

Cú pháp

userSettings.getTimeZoneOffsetMinutes()

Trả về giá trị

Loại: số

Mô tả: Múi giờ bù trừ trong vài phút.

Ngữ cảnh máy khách
Thiết đặt tổ chức
Xrm.Utility.getGlobalContext
Bảng Thiết đặt Người dùng (UserSettings)

  • Last updated on