getGlobalContext.userSettings (client-API-verwijzing)

Retourneert informatie over de huidige gebruikersinstellingen.

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

Eigenschappen

Het userSettings-object heeft de volgende eigenschappen:

Naam	Typologie	Description
dateFormattingInfo	Voorwerp	Retourneert de datumopmaakgegevens voor de huidige gebruiker. Zie dateFormattingInfo
defaultDashboardId	touw	Retourneert de id van het standaarddashboard voor de huidige gebruiker.
isGuidedHelpEnabled	bool	Of begeleide hulp is ingeschakeld voor de huidige gebruiker.
isHighContrastEnabled	bool	Of hoog contrast is ingeschakeld voor de huidige gebruiker.
isRTL	bool	Of de taal voor de huidige gebruiker een taal van rechts naar links (RTL) is.
languageId	nummer	De LCID-taalcode voor de huidige gebruiker.
roles	collectie	Een verzameling opzoekobjecten met de GUID en weergavenaam van elke beveiligingsrol die is toegewezen aan de gebruiker en eventuele beveiligingsrollen die zijn toegewezen aan het team waaraan de gebruiker is gekoppeld. Rollen weergeven
securityRolePrivileges	string[]	een matrix met tekenreeksen die de GUID-waarden vertegenwoordigen van elk van de beveiligingsrolbevoegdheden waaraan de gebruiker is gekoppeld of aan teams waaraan de gebruiker is gekoppeld.
securityRoles	string[]	Afgeschreven Gebruik de roles eigenschap.
transactionCurrency	Voorwerp	Object met de id, nameen entityType van de transactievaluta voor de huidige gebruiker. Zie transactionCurrency
transactionCurrencyId	touw	Afgeschreven transactionCurrency De eigenschap gebruiken
userId	touw	De systemuser.systemuserid-waarde van de huidige gebruiker.
userName	touw	De naam van de huidige gebruiker.

dateFormattingInfo

Een object met tekenreekseigenschappen over datumopmaak, zoals FirstDayOfWeek, LongDatePatternMonthDayPattern, , TimeSeparatorenzovoort.

roles

De verzameling bevat objecten met id en name eigenschappen voor elk van de beveiligingsrollen of teams waaraan de gebruiker is gekoppeld.

Deze eigenschap wordt alleen ondersteund in Unified Interface.

transactievaluta

Deze methode wordt alleen ondersteund in Unified Interface.

De gegevens kunnen er ongeveer als volgt uitzien:

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

Methods

Het userSettings object heeft de volgende methoden:

methode getSecurityRolePrivilegesInfo

Retourneert een belofte die wordt omgezet met een object waarvan de sleutels de GUID's voor beveiligingsrolbevoegdheden zijn en waarden objecten zijn die de businessUnitIddepth, en privilegeName van de beveiligingsrolbevoegdheden bevatten.

Syntaxis

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

Parameterwaarden

Naam	Typologie	Verplicht	Description
successCallback	Functie	Nee.	Een functie die moet worden aangeroepen wanneer informatie over de beveiligingsrolbevoegdheden wordt opgehaald. Er wordt een woordenlijst doorgegeven aan de callback voor geslaagde bewerking waarbij de GUID's voor beveiligingsrolbevoegdheden de sleutels zijn en de waarden objecten zijn die de volgende eigenschappen bevatten: id:Snaar. De GUID voor beveiligingsrolbevoegdheden. businessUnitId:Snaar. De GUID van de bedrijfseenheid van de beveiligingsrolbevoegdheden. privilegeName:Snaar. De naam van de beveiligingsrolbevoegdheden. depth:Snaar. De uitgebreide bevoegdheden van de beveiligingsrol.
errorCallback	Functie	Nee.	Een functie om aan te roepen wanneer de bewerking mislukt. Een object met de volgende eigenschappen wordt doorgegeven: errorCode:Getal. De foutcode. message:Snaar. Een foutmelding die het probleem beschrijft.

Retourwaarde

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

Retourneert bij succes een promise-object met de waarden die zijn opgegeven in de beschrijving van de bovenstaande successCallback-parameter .

Beschrijving: GUID en aanvullende informatie, zoals Business Unit en Privilege Name van elk van de beveiligingsrolbevoegdheden.

voorbeeld 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);
  });

methode getTimeZoneOffsetMinutes

Retourneert het verschil in minuten tussen de lokale tijd en Coordinated Universal Time (UTC).

Syntaxis

userSettings.getTimeZoneOffsetMinutes()

Retourwaarde

Type: getal

Beschrijving: Tijdzoneverschil in minuten.

Verwante artikelen

Clientcontext
Organisatie-instellingen
Xrm.Utility.getGlobalContext
Tabel Gebruikersinstellingen (UserSettings)