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

إرجاع معلومات حول إعدادات المستخدم الحالية.

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

الخصائص

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

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

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

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

ادوار

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

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

المعاملاتCurrency

يتم اعتماد هذا الأسلوب فقط على الواجهة الموحدة.

قد تبدو البيانات كما يلي:

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

أساليب

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

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