getGlobalContext.userSettings (חומר עזר עבור API של לקוח)

מחזירה מידע אודות הגדרות המשתמש הנוכחיות.

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

Properties

האובייקט userSettings כולל את המאפיינים הבאים:

שם	Type	Description
dateFormattingInfo	אובייקט	החזרת מידע עיצוב התאריך עבור המשתמש הנוכחי. ראה dateFormattingInfo
defaultDashboardId	מחרוזת	הפונקציה מחזירה את המזהה של לוח המחוונים המהווה ברירת מחדל עבור המשתמש הנוכחי.
isGuidedHelpEnabled	bool	אם עזרה מונחית זמינה עבור המשתמש הנוכחי.
isHighContrastEnabled	bool	אם חדות גבוהה זמינה עבור המשתמש הנוכחי.
isRTL	bool	אם השפה עבור המשתמש הנוכחי היא שפת מימין לשמאל (RTL).
languageId	מספר	קוד השפה של LCID עבור המשתמש הנוכחי.
roles	אוסף	אוסף של אובייקטי בדיקת מידע המכילים את ה- GUID ואת שם התצוגה של כל אחד מתפקידי האבטחה שהוקצו למשתמש ותפקידי אבטחה שהוקצו לצוות אליו משויך המשתמש. ראה תפקידים
securityRolePrivileges	מחרוזת []	מערך של מחרוזות המייצגות את ערכי ה- GUID של כל אחת מההרשאות של תפקיד האבטחה שהמשתמש משויך או צוותים כלשהם שהמשתמש משויך איתם.
securityRoles	מחרוזת []	הוצאה משימוש. השתמש במאפיין roles .
transactionCurrency	אובייקט	אובייקט המכיל את idמטבע הטרנזקציה entityTypename, ו- , עבור המשתמש הנוכחי. ראה טרנזקציהCurrency
transactionCurrencyId	מחרוזת	הוצאה משימוש. השתמש במאפיין transactionCurrency
userId	מחרוזת	הערך systemuser.systemuserid של המשתמש הנוכחי.
userName	מחרוזת	שם המשתמש הנוכחי.

DateFormattingInfo

אובייקט עם מאפייני מחרוזת אודות עיצוב תאריך כגון FirstDayOfWeek, LongDatePattern, MonthDayPattern, TimeSeparatorוכן הלאה.

תפקידי

האוסף מכיל אובייקטים עם id ומאפיינים name עבור כל אחד מתפקידי האבטחה או הצוותים שהמשתמש משויך איתם.

מאפיין זה נתמך בממשק מאוחד בלבד.

טרנזקציהCurrency

שיטה זו נתמכת בממשק מאוחד בלבד.

הנתונים עשויים להיראות בערך כך:

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

Methods

האובייקט userSettings כולל את השיטות הבאות:

getSecurityRolePrivilegesInfo method

החזרת הבטחה שמתבצעת באמצעות אובייקט שמפתחות שלו הם מזהי GUID businessUnitIdשל הרשאות תפקיד אבטחה וערכים הם אובייקטים המכילים את , depthואת privilegeName ההרשאה של תפקיד האבטחה.

תחביר

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

Parameters

שם	Type	נדרש	Description
successCallback	פונקציה	לא	פונקציה להתקשרות כאשר מידע הרשאות תפקיד האבטחה מאוחזר. מילון יועבר להתקשרות חזרה להצלחה שבה מזהי ה- GUID של הרשאות תפקיד האבטחה יהיו המפתחות והערכים יהיו אובייקטים המכילים את המאפיינים הבאים: id:מחרוזת. GUID של הרשאת תפקיד האבטחה. businessUnitId:מחרוזת. ה- GUID של היחידה העסקית של הרשאת תפקיד האבטחה. privilegeName:מחרוזת. שם ההרשאה של תפקיד האבטחה. depth:מחרוזת. עומק ההרשאה של תפקיד האבטחה.
errorCallback	פונקציה	לא	פונקציה שיש לקרוא לה כאשר הפעולה נכשלת. אובייקט עם המאפיינים הבאים יועבר: errorCode:מספר. קוד השגיאה. message:מחרוזת. הודעת שגיאה המתארת את הבעיה.

ערך החזרה

סוג סוג: Promise<{[key: string]: {id: string, businessUnitId: string, privilegeName: string, depth: number}}>

בעת הצלחה, החזרת אובייקט promise המכיל את הערכים שצוינו בתיאור של הפרמטר 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
טבלת הגדרות משתמש (הגדרות משתמש)