Notă
Accesul la această pagină necesită autorizare. Puteți încerca să vă conectați sau să modificați directoarele.
Accesul la această pagină necesită autorizare. Puteți încerca să modificați directoarele.
Obiectul getGlobalContext.userSettings returnează informații despre setările curente de utilizator din aplicațiile bazate pe modele, cum ar fi rolurile de securitate, limba și fusul orar.
var userSettings = Xrm.Utility.getGlobalContext().userSettings
Proprietăți
Obiectul userSettings are următoarele proprietăți:
| Nume | Tip | Descriere |
|---|---|---|
dateFormattingInfo |
dateFormattingInfo | Returnează informațiile de formatare a datei pentru utilizatorul curent. |
defaultDashboardId |
string | Returnează ID-ul tabloului de bord implicit pentru utilizatorul curent. |
isGuidedHelpEnabled |
boolean | Dacă ajutorul ghidat este activat pentru utilizatorul curent. |
isHighContrastEnabled |
boolean | Dacă este activat contrastul înalt pentru utilizatorul curent. |
isRTL |
boolean | Dacă limba pentru utilizatorul curent este o limbă de la dreapta la stânga (RTL). |
languageId |
număr | Codul lingvistic LCID pentru utilizatorul curent. |
roles |
roluri | O colecție de obiecte de căutare care conțin GUID-ul și numele afișat al fiecărui rol de securitate atribuit utilizatorului și orice roluri de securitate atribuite echipei cu care este asociat utilizatorul. |
securityRolePrivileges |
șir[] | o matrice de șiruri care reprezintă valorile GUID ale fiecărui privilegiu de rol de securitate cu care este asociat utilizatorul sau orice echipe cu care este asociat utilizatorul. |
securityRoles |
șir[] | Învechit.
roles Utilizați proprietatea. |
transactionCurrency |
Valută tranzacție | Moneda tranzacției pentru utilizatorul curent. |
transactionCurrencyId |
string | Învechit. Utilizarea proprietății transactionCurrency |
userId |
string | Valoarea systemuser.systemuserid a utilizatorului curent. |
userName |
string | Numele utilizatorului curent. |
dateFormattingInfo
Un obiect cu proprietăți șir despre formatarea datei, cum FirstDayOfWeekar fi , LongDatePatternMonthDayPattern, , TimeSeparator, și așa mai departe.
Roluri
Colecția conține obiecte cu id și name proprietăți pentru fiecare dintre rolurile de securitate sau echipele cu care este asociat utilizatorul.
Această proprietate este acceptată numai în Interfața unificată.
transactionCurrency
Această proprietate este acceptată numai în Interfața unificată.
O referință la o înregistrare Monedă (TransactionCurrency). Datele ar putea arăta astfel:
{id: "e7dd9bc6-d239-ea11-a813-000d3a35b14a", entityType: "transactioncurrency", name: "US Dollar"}
Aflați mai multe despre moneda tranzacției
Metode
Obiectul userSettings are următoarele metode:
| Metodă | descriere |
|---|---|
| getSecurityRolePrivilegesInfo | Regăsiți numele privilegiilor, unitățile de afaceri și adâncimile de acces pentru a inspecta privilegiile de rol de securitate ale utilizatorului curent. |
| getTimeZoneOffsetMinutes | Obțineți decalajul fusului orar al utilizatorului curent în minute pentru a calcula diferența dintre ora locală și UTC. |
getSecurityRolePrivilegesInfo method
Returnează o promisiune care se rezolvă cu un obiect ale cărui chei sunt GUID-urile privilegiilor de rol de securitate și valorile sunt obiecte care conțin businessUnitIdprivilegiul , depthși privilegeName al privilegiilor de rol de securitate.
Sintaxă
userSettings.getSecurityRolePrivilegesInfo().then(successCallback, errorCallback);
Parametri
| Nume | Tip | Obligatoriu | Descriere |
|---|---|---|---|
successCallback |
Funcţie | Nu | O funcție de apelat atunci când sunt regăsite informațiile despre privilegiile rolului de securitate. Un dicționar va fi transmis apelului invers cu succes, unde GUID-urile de privilegii de rol de securitate vor fi cheile, iar valorile vor fi obiecte care conțin următoarele proprietăți:id:Șir. GUID-ul privilegiilor de rol de securitate.businessUnitId:Șir. GUID-ul unității de business a privilegiilor de rol de securitate.privilegeName:Șir. Numele privilegiilor pentru rolul de securitate.depth:Șir. Adâncimea privilegiilor rolului de securitate. |
errorCallback |
Funcţie | Nu | O funcție de apelat atunci când operațiunea eșuează. Un obiect cu următoarele proprietăți va fi transmis:errorCode:Număr. Codul de eroare.message:Șir. Un mesaj de eroare care descrie problema. |
Valoare returnată
Tip: Promise<{[key: string]: {id: string, businessUnitId: string, privilegeName: string, depth: number}}>
La succes, returnează un obiect promisiune care conține valorile specificate în descrierea parametrului successCallback de mai sus.
Descriere: GUID și detalii suplimentare, cum ar fi Unitatea de business și Privilegiu Numele fiecăruia dintre privilegiile de rol de securitate.
getSecurityRolePrivilegesInfo example
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 metoda
Returnează diferența în minute dintre ora locală și Ora universală (UTC).
Sintaxă
userSettings.getTimeZoneOffsetMinutes()
Valoare returnată
Tip: număr
Descriere: Decalajul fusului orar în minute.
Articole asociate
Context client
Setări organizație
Xrm.Utility.getGlobalContext
Tabel Setări utilizator (Setări utilizator)