getGlobalContext.userSettings (αναφορά API προγράμματος-πελάτη)

Επιστρέφει πληροφορίες σχετικά με τις τρέχουσες ρυθμίσεις χρήστη.

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

Ιδιότητες

Το αντικείμενο userSettings έχει τις ακόλουθες ιδιότητες:

'Ονομα	Τύπος	Περιγραφή
dateFormattingInfo	αντικείμενο	Επιστρέφει τις πληροφορίες μορφοποίησης ημερομηνίας για τον τρέχοντα χρήστη. Ανατρέξτε στην ενότητα dateFormattingInfo
defaultDashboardId	string	Επιστρέφει το αναγνωριστικό του προεπιλεγμένου πίνακα εργαλείων για τον τρέχοντα χρήστη.
isGuidedHelpEnabled	δυαδ.	Εάν ενεργοποιείται η καθοδηγούμενη βοήθεια για τον τρέχοντα χρήστη.
isHighContrastEnabled	δυαδ.	Εάν είναι ενεργοποιημένη η υψηλή αντίθεση για τον τρέχοντα χρήστη.
isRTL	δυαδ.	Εάν η γλώσσα για τον τρέχοντα χρήστη είναι μια γλώσσα από δεξιά προς τα αριστερά (RTL).
languageId	αριθμός	Ο κωδικός γλώσσας LCID για τον τρέχοντα χρήστη.
roles	συλλογή	Μια συλλογή αντικειμένων αναζήτησης που περιέχει το GUID και το εμφανιζόμενο όνομα καθενός από τους ρόλους ασφαλείας που έχουν εκχωρηθεί στον χρήστη καθώς και τυχόν ρόλους ασφαλείας που έχουν αντιστοιχιστεί στην ομάδα με την οποία έχει συσχετιστεί ο χρήστης. Εμφάνιση ρόλων
securityRolePrivileges	string[]	ένας πίνακας συμβολοσειρών που αντιπροσωπεύουν τις τιμές GUID για κάθε ένα από τα δικαιώματα ρόλου ασφαλείας με τα οποία είναι συσχετισμένος ο χρήστης ή με οποιεσδήποτε ομάδες με τις οποίες είναι συσχετισμένος ο χρήστης.
securityRoles	string[]	Απαρχαιούμενος. Χρησιμοποιήστε την roles ιδιότητα .
transactionCurrency	αντικείμενο	Αντικείμενο που περιέχει τα id, nameκαι entityType του νομίσματος συναλλαγής για τον τρέχοντα χρήστη. Ανατρέξτε στο θέμα transactionCurrency
transactionCurrencyId	string	Απαρχαιούμενος. Χρήση της ιδιότητας transactionCurrency
userId	string	Η τιμή systemuser.systemuserid του τρέχοντος χρήστη.
userName	string	Το όνομα του τρέχοντος χρήστη.

dateFormattingInfo

Ένα αντικείμενο με ιδιότητες συμβολοσειράς σχετικά με τη μορφοποίηση ημερομηνίας όπως FirstDayOfWeek, LongDatePattern, MonthDayPattern, TimeSeparatorκαι ούτω καθεξής.

Ρόλους

Η συλλογή περιέχει αντικείμενα με id ιδιότητες και name για κάθε έναν από τους ρόλους ασφαλείας ή τις ομάδες με τις οποίες έχει συσχετιστεί ο χρήστης.

Αυτή η ιδιότητα υποστηρίζεται μόνο στην Ενοποιημένη διασύνδεση.

transactionCurrency

Αυτή η μέθοδος υποστηρίζεται μόνο στην Ενοποιημένη διασύνδεση.

Τα δεδομένα μπορεί να μοιάζουν κάπως έτσι:

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

Μέθοδοι

Το userSettings αντικείμενο έχει τις ακόλουθες μεθόδους:

μέθοδος getSecurityRolePrivilegesInfo

Επιστρέφει μια υπόσχεση που επιλύεται με ένα αντικείμενο του οποίου τα κλειδιά είναι τα GUID δικαιωμάτων ρόλου ασφαλείας και οι τιμές είναι αντικείμενα που περιέχουν τα businessUnitId, depthκαι privilegeName του δικαιώματος ρόλου ασφαλείας.

Σύνταξη

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

Παράμετροι

'Ονομα	Τύπος	Απαραίτητο	Περιγραφή
successCallback	Function	No	Μια συνάρτηση για κλήση όταν ανακτώνται οι πληροφορίες δικαιωμάτων ρόλου ασφαλείας. Ένα λεξικό θα διαβιβαστεί στην επιστροφή κλήσης επιτυχίας όπου τα GUID δικαιωμάτων ρόλου ασφαλείας θα είναι τα κλειδιά και οι τιμές θα είναι αντικείμενα που περιέχουν τις ακόλουθες ιδιότητες: id:Σειρά. Το GUID δικαιώματος ρόλου ασφαλείας. businessUnitId:Σειρά. Το GUID της επιχειρηματικής μονάδας του δικαιώματος ρόλου ασφαλείας. privilegeName:Σειρά. Το όνομα του δικαιώματος του ρόλου ασφαλείας. depth:Σειρά. Το βάθος των δικαιωμάτων του ρόλου ασφαλείας.
errorCallback	Function	No	Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία. Θα περάσει ένα αντικείμενο με τις ακόλουθες ιδιότητες: errorCode:Αριθμός. Ο κωδικός σφάλματος. message:Σειρά. Ένα μήνυμα λάθους που περιγράφει το ζήτημα.

Τιμή επιστροφής

Τύπος: Promise<{[key: string]: {id: string, businessUnitId: string, privilegeName: string, depth: number}}>

Με επιτυχία, επιστρέφει ένα αντικείμενο υπόσχεσης που περιέχει τις τιμές που καθορίζονται στην περιγραφή της παραμέτρου 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
Πίνακας "Ρυθμίσεις χρήστη" (Ρυθμίσεις χρήστη)