Partager via

getGlobalContext.userSettings (référence de l’API client)

  • Article

Renvoie des informations sur les paramètres de l’utilisateur actuel.

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

Propriétés

L’objet userSettings a les propriétés suivantes :

Nom  Type Description
dateFormattingInfo object Renvoie les informations de mise en forme de la date pour l’utilisateur actuel. Voir dateFormattingInfo
defaultDashboardId chaine Renvoie l’ID du tableau de bord par défaut de l’utilisateur actuel.
isGuidedHelpEnabled bool Si l’aide guidée est activée pour l’utilisateur actuel.
isHighContrastEnabled bool Si contraste élevé est activé pour l’utilisateur actuel.
isRTL bool Si la langue de l’utilisateur actuel est une langue s’écrivant de droite à gauche (RTL).
languageId nombre Le code de langue LCID de l’utilisateur actuel.
roles collecte Une collection d’objets de recherche contenant le GUID et le nom complet de chacun des rôle de sécurité attribués à l’utilisateur et tous les rôles de sécurité attribués à l’équipe à laquelle l’utilisateur est associé. Voir les rôles
securityRolePrivileges string[] Un tableau de chaînes qui représentent les valeurs GUID de chacun des privilèges rôle de sécurité auxquels l’utilisateur est associé ou de toutes les équipes auxquelles l’utilisateur est associé.
securityRoles string[] Déconseillé. Utilisez la propriété roles .
transactionCurrency object Objet contenant les id, name et entityType de la devise de transaction pour l’utilisateur actuel. Voir transactionCurrency
transactionCurrencyId chaine Déconseillé. Utilisez la propriété transactionCurrency
userId chaine La valeur systemuser.systemuserid de l’utilisateur actuel.
userName chaine Le nom de l’utilisateur actuel.

dateFormattingInfo

Un objet avec des propriétés de chaîne sur le formatage de date telles que FirstDayOfWeek, LongDatePattern, MonthDayPattern, TimeSeparator, etc.

rôles

La collection contient des objets avec des propriétés id et name pour chacun des rôles ou équipes de sécurité auxquels l’utilisateur est associé.

Cette propriété est prise en charge uniquement sur Unified Interface.

transactionCurrency

Cette méthode est uniquement prise en charge sur Unified Interface.

Les données pourraient ressembler à ceci :

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

Méthodes

L’objet userSettings possède les méthodes suivantes :

Méthode getSecurityRolePrivilegesInfo

Renvoie une promesse qui se résout avec un objet dont les clés sont les GUID de privilège rôle de sécurité et les valeurs sont des objets contenant les businessUnitId, depth et privilegeName du privilège rôle de sécurité.

Syntaxe

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

Paramètres

Nom Type Requise Description
successCallback Function Non Fonction à appeler si les informations de privilège de rôle de sécurité sont récupérées. Un dictionnaire est transmis au rappel de réussite où les GUID du privilège de rôle de sécurité sont les clés et les valeurs sont les objets contenant les propriétés suivantes :
id : Chaîne. GUID du privilège de rôle de sécurité.
businessUnitId : Chaîne. GUID de la division du privilège de rôle de sécurité.
privilegeName : Chaîne. Nom du privilège de rôle de sécurité.
depth : Chaîne. Profondeur du privilège de rôle de sécurité.
errorCallback Function Non Fonction à appeler lorsque l’opération échoue. Un objet avec les propriétés suivantes est transmis :
errorCode : Nombre. Code d’erreur.
message : Chaîne. Message d’erreur décrivant le problème.

Valeur renvoyée

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

En cas de succès, renvoie un objet de promesse contenant les valeurs spécifiées dans la description du paramètre successCallback ci-dessus.

Description : GUID et détails supplémentaires tels que l’unité commerciale et le nom de privilège de chacun des privilèges rôle de sécurité.

Exemple de 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);
  });

Méthode getTimeZoneOffsetMinutes

Renvoie la différence en minutes entre l’heure locale et le temps universel coordonné (UTC).

Syntaxe

userSettings.getTimeZoneOffsetMinutes()

Valeur renvoyée

Type : nombre

Description : Décalage horaire en minutes.

Contexte client
Paramètres de l’organisation
Xrm.Utility.getGlobalContext
Tableau des paramètres utilisateur (UserSettings)