إشعار
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تسجيل الدخول أو تغيير الدلائل.
يتطلب الوصول إلى هذه الصفحة تخويلاً. يمكنك محاولة تغيير الدلائل.
يقوم 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
جدول إعدادات المستخدم (إعدادات المستخدم)