DOCUMENTATION NTi

Méthode RetrieveUserInformation

Description

La méthode RetrieveUserInformation interroge l’API QSYRUSRI pour obtenir des informations complètes sur un profil utilisateur. Elle renvoie un objet UserInformation contenant des attributs associés au profil utilisateur, tels que la date de changement de mot de passe, le statut du profil, etc.

Syntaxe

RetrieveUserInformation(string userName)

Paramètres

Nom Type Description
userName string Le nom du profil utilisateur (max 10 caractères).

Retour

Retourne un objet de type UserInformation qui contient les informations complètes sur le profil utilisateur.
Cette méthode utilise le format USRI0300, qui renvoie toutes les informations disponibles sur l’utilisateur.

Classe UserInformation

Propriété Type Description
UserProfileName string Nom du profil utilisateur IBM i.
PreviousSignOnDateTime string Date et heure de la dernière connexion de l’utilisateur.
SignOnAttemptsNotValid int Nombre de tentatives de connexion échouées.
Status string État actuel du profil utilisateur, par exemple, actif ou inactif.
PasswordChangeDate DateTime Date du dernier changement de mot de passe.
NoPasswordIndicator string Indicateur si le mot de passe est absent
PasswordExpirationInterval int Intervalle en jours avant l’expiration du mot de passe.
DatePasswordExpires string Date d’expiration du mot de passe actuel.
DaysUntilPasswordExpires int Nombre de jours restants avant l’expiration du mot de passe.
SetPasswordToExpire string Indique si le mot de passe est configuré pour expirer.
UserClassName string Classe de l’utilisateur, qui détermine les privilèges de sécurité (par exemple, *USER ou *SECOFR).
SpecialAuthorities string Liste des autorisations spéciales de l’utilisateur.
GroupProfileName string Nom du profil de groupe principal associé.
Owner string Propriétaire du profil utilisateur.
GroupAuthority string Niveau d’autorité de groupe pour le profil utilisateur.
AssistanceLevel string Niveau d’assistance pour cet utilisateur (par exemple, *SYSOPR pour opérateur système).
CurrentLibraryName string Nom de la bibliothèque actuelle définie pour l’utilisateur.
InitialMenuName string Menu affiché lors de la connexion initiale.
InitialMenuLibraryName string Nom de la bibliothèque contenant le menu initial.
InitialProgramName string Programme initial exécuté lors de la connexion.
InitialProgramLibraryName string Bibliothèque du programme initial.
LimitCapabilities string Limitation des capacités utilisateur (par exemple, restreint ou illimité).
TextDescription string Description textuelle du profil.
DisplaySignOnInformation string Indicateur d’affichage des informations de connexion à l’utilisateur.
LimitDeviceSessions string Nombre maximal de sessions de périphériques autorisées.
KeyboardBuffering string Méthode de gestion du tampon de clavier pour l’utilisateur.
MaximumAllowedStorage int Quantité maximale de stockage autorisée, en Mo.
StorageUsed int Quantité de stockage utilisée, en Mo.
HighestSchedulingPriority string Priorité de planification la plus élevée pour cet utilisateur.
JobDescriptionName string Nom de la description de tâche associée.
JobDescriptionLibraryName string Nom de la bibliothèque contenant la description de tâche.
AccountingCode string Code comptable associé à cet utilisateur.
MessageQueueName string Nom de la file de messages de l’utilisateur.
MessageQueueLibraryName string Bibliothèque de la file de messages.
MessageQueueDeliveryMethod string Méthode de distribution des messages dans la file de l’utilisateur.
MessageQueueSeverity int Niveau de sévérité des messages dans la file de l’utilisateur.
OutputQueueName string Nom de la file de sortie des impressions.
OutputQueueLibraryName string Bibliothèque de la file de sortie.
PrintDevice string Nom du périphérique d’impression par défaut.
SpecialEnvironment string Environnement spécial pour l’utilisateur (par exemple, *S36 pour System/36).
AttentionKeyHandlingProgramName string Nom du programme de gestion de la touche Attention.
AttentionKeyHandlingProgramLibraryName string Bibliothèque du programme de gestion de la touche Attention.
LanguageID string Identifiant de la langue de l’utilisateur.
CountryOrRegionID string Code pays ou région de l’utilisateur.
CharacterCodeSetID int Identifiant du jeu de caractères utilisé.
UserOptions string Options configurées pour cet utilisateur.
SortSequenceTableName string Nom de la table de séquence de tri pour les données de l’utilisateur.
SortSequenceTableLibraryName string Bibliothèque de la table de séquence de tri.
ObjectAuditingValue string Valeur d’audit des objets de l’utilisateur.
UserActionAuditLevel string Niveau d’audit des actions de l’utilisateur.
GroupAuthorityType string Type d’autorité de groupe de l’utilisateur.
OffsetToArrayOfSupplementalGroups int Décalage vers le tableau des groupes supplémentaires.
NumberOfSupplementalGroups int Nombre de groupes supplémentaires associés.
UserIDNumber int Identifiant unique de l’utilisateur.
GroupIDNumber int Identifiant du groupe principal de l’utilisateur.
OffsetToHomeDirectory int Décalage vers le chemin du répertoire personnel de l’utilisateur.
LengthOfHomeDirectory int Longueur du chemin du répertoire personnel.
LocaleJobAttributes string Attributs de travail spécifiques à la localisation de l’utilisateur.
OffsetToLocalePathName int Décalage vers le chemin de localisation de l’utilisateur.
LengthOfLocalePathName int Longueur du chemin de localisation.
GroupMemberIndicator string Indicateur précisant si l’utilisateur est membre d’un groupe.
DigitalCertificateIndicator string Indicateur de présence de certificat numérique pour cet utilisateur.
CharacterIdentifierControl string Contrôle de l’identifiant de caractères pour l’utilisateur.
OffsetToArrayOfIndependentASPStorageUsageDescriptors int Décalage vers le tableau des descripteurs d’utilisation de stockage ASP indépendant.
NumberOfIndependentASPStorageUsageDescriptors int Nombre de descripteurs ASP indépendants.
NumberOfIndependentASPStorageUsageDescriptorsReturned int Nombre de descripteurs ASP indépendants retournés.
LengthOfIndependentASPStorageUsageDescriptor int Longueur d’un descripteur ASP indépendant.
LocalPasswordManagement string Gestion locale du mot de passe pour cet utilisateur.
BlockPasswordChange string Indicateur de blocage pour les changements de mot de passe.
UserEntitlementRequired string Indicateur des droits requis pour l’utilisateur.
UserExpirationInterval int Intervalle d’expiration du profil utilisateur.
UserExpirationDate string Date d’expiration du profil utilisateur.
UserExpirationAction string Action à prendre à l’expiration du profil utilisateur.
MaximumAllowedStorageLong long Limite maximale de stockage pour cet utilisateur (format long).
StorageUsedLong long Espace de stockage utilisé pour cet utilisateur (format long).
OffsetToStartAuthorityCollectionCommandParameters int Décalage vers les paramètres de commande de collecte d’autorité.
LengthOfStartAuthorityCollectionCommandParameters int Longueur des paramètres de commande de collecte d’autorité.
AuthorityCollectionActiveIndicator string Indicateur indiquant si la collecte d’autorité est active.
AuthorityCollectionRepositoryExistsIndicator string Indicateur de l’existence du référentiel de collecte d’autorité.
SupplementalGroups List<string> Groupes supplémentaires associés à l’utilisateur.
HomeDirectory string Répertoire personnel de l’utilisateur.
LocalePathName string Chemin de localisation spécifique à cet utilisateur.
IndependentASPStorageUsageDescriptors List<string> Descripteurs de stockage indépendants d’ASP pour l’utilisateur.
IndependentASPStorageUsageDescriptors string Paramètres de commande pour démarrer la collecte d’autorité.

Exceptions

  • InvalidOperationException : Lancée lorsque la taille des données retournées est insuffisante.

Exemples d’utilisation

var userInfo = conn.RetrieveUserInformation("USER"); 
Console.WriteLine($"User: {userInfo.UserName}, Last sign-on: {userInfo.PreviousSignOnDateTime}, Status: {userInfo.Status}");

Références

Pour plus d’informations sur l’API QSYRUSRI, consultez la documentation officielle IBM.