getGlobalContext.userSettings (مرجع واجهة برمجة تطبيقات العميل)

يقوم getGlobalContext.userSettings الكائن بإرجاع معلومات حول إعدادات المستخدم الحالية في التطبيقات المستندة إلى النموذج، مثل أدوار الأمان واللغة والمنطقة الزمنية.

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

الخصائص

يحتوي userSettings الكائن على الخصائص التالية:

Name النوع الوصف
dateFormattingInfo معلومات تنسيق التاريخ إرجاع معلومات تنسيق التاريخ للمستخدم الحالي.
defaultDashboardId string إرجاع معرف لوحة المعلومات الافتراضية للمستخدم الحالي.
isGuidedHelpEnabled منطقي ما إذا كانت التعليمات الإرشادية ممكنة للمستخدم الحالي.
isHighContrastEnabled منطقي ما إذا كان التباين العالي ممكنا للمستخدم الحالي.
isRTL منطقي ما إذا كانت لغة المستخدم الحالي هي لغة من اليمين إلى اليسار (RTL).
languageId رقم رمز لغة LCID للمستخدم الحالي.
roles الأدوار مجموعة من عناصر البحث التي تحتوي على GUID واسم العرض لكل دور من أدوار الأمان المعينة للمستخدم وأي أدوار أمان معينة للفريق المقترن بها المستخدم.
securityRolePrivileges سلسلة[] صفيف من السلاسل التي تمثل قيم GUID لكل امتياز من امتيازات دور الأمان التي يرتبط بها المستخدم أو أي فرق يرتبط بها المستخدم.
securityRoles سلسلة[] اهمالها. استخدم الخاصية roles .
transactionCurrency transactionCurrency عملة المعاملة للمستخدم الحالي.
transactionCurrencyId string اهمالها. استخدام الخاصية transactionCurrency
userId string قيمة systemuser.systemuserid للمستخدم الحالي.
userName string اسم المستخدم الحالي.

معلومات تنسيق التاريخ

كائن بخصائص سلسلة حول تنسيق التاريخ مثل FirstDayOfWeekو LongDatePatternMonthDayPatternTimeSeparatorوهكذا.

ادوار

تحتوي المجموعة على كائنات مع id وخصائص name لكل من أدوار الأمان أو الفرق التي يرتبط بها المستخدم.

هذه الخاصية معتمدة فقط في الواجهة الموحدة.

المعاملاتCurrency

هذه الخاصية معتمدة فقط في الواجهة الموحدة.

مرجع إلى سجل العملة (TransactionCurrency). قد تبدو البيانات كما يلي:

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

تعرف على المزيد حول عملة المعاملة

أساليب

userSettings يحتوي الكائن على الطرق التالية:

الطريقة description
getSecurityRolePrivilegesInfo استرداد أسماء الامتيازات ووحدات العمل وعمق الوصول لفحص امتيازات دور الأمان للمستخدم الحالي.
getTimeZoneOffsetMinutes احصل على إزاحة المنطقة الزمنية للمستخدم الحالي بالدقائق لحساب الفرق بين التوقيت المحلي و UTC.

طريقة getSecurityRolePrivilegesInfo

إرجاع وعد يحل مع كائن مفاتيحه هي معرفات GUID الخاصة بدور الأمان والقيم هي كائنات تحتوي على businessUnitIdو depthو privilegeName لامتياز دور الأمان.

بناء الجملة

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

المعلمات

Name النوع مطلوبة الوصف
successCallback الوظيفة لا دالة لاستدعاء عند استرداد معلومات امتيازات دور الأمان. سيتم تمرير قاموس إلى رد اتصال النجاح حيث ستكون معرفات المستخدم الرسومية لامتيازات دور الأمان هي المفاتيح وستكون القيم كائنات تحتوي على الخصائص التالية:
id:خيط. المعرف الفريد العمومي لامتياز دور الأمان.
businessUnitId:خيط. المعرف الفريد العمومي لوحدة العمل لامتياز دور الأمان.
privilegeName:خيط. اسم امتياز دور الأمان.
depth:خيط. عمق امتياز دور الأمان.
errorCallback الوظيفة لا وظيفة للاتصال عند فشل العملية. سيتم تمرير كائن بالخصائص التالية:
errorCode:رقم. رمز الخطأ.
message:خيط. رسالة خطأ تصف المشكلة.

قيمة الإرجاع

النوع: Promise<{[key: string]: {id: string, businessUnitId: string, privilegeName: string, depth: number}}>

عند النجاح، ترجع كائن وعد يحتوي على القيم المحددة في وصف المعلمة successCallback أعلاه.

الوصف: GUID وتفاصيل إضافية مثل وحدة الأعمال واسم الامتياز لكل امتيازات دور الأمان.

الحصول على مثال علىSecurityRolePrivilegesInfo

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
جدول إعدادات المستخدم (إعدادات المستخدم)