ActiveRowCount

Syntaxe

Paramètres

Description

Cette fonction permet de demander le nombre d'enregistrements actives pour la région de défilement dans la page active.

Remarques

• ActiveRowCount est essentielle pour manipuler dynamiquement des lignes dans une interface utilisateur : Cette fonction permet de savoir combien de lignes actives sont présentes dans un niveau de défilement donné. Cela facilite la navigation et le traitement des données affichées sur une page, en particulier lors de boucles ou de validations.
• Elle agit uniquement sur les lignes dites "actives", excluant les lignes supprimées ou masquées : Il est important de noter que les lignes ayant été supprimées ou rendues inactives ne sont pas comptées. Cela permet de se concentrer uniquement sur les enregistrements visibles ou valides dans le contexte d'exécution.
• ActiveRowCount est souvent utilisée en combinaison avec une boucle For pour parcourir les lignes : Grâce à cette fonction, il devient possible d'itérer efficacement sur les enregistrements d'une section de données, comme dans une structure For &i = 1 To ActiveRowCount(...), en garantissant qu'on ne dépasse jamais les bornes actives.
• Le paramètre Scrollpath doit être correctement spécifié pour cibler le bon niveau de données : Une mauvaise définition du chemin de défilement peut entraîner une valeur incorrecte ou zéro. Il est donc essentiel de bien comprendre la hiérarchie des niveaux dans la composante PeopleSoft pour utiliser cette fonction efficacement.
• Elle permet un traitement conditionnel basé sur le volume de données utilisateur : Par exemple, si aucune ligne active n'est présente (ActiveRowCount = 0), on peut afficher un message à l'utilisateur ou bloquer certaines actions. Cela rend le traitement plus robuste et interactif.
• La fonction est particulièrement utile dans les composants dynamiques ou multiligne : Dans les cas où les utilisateurs peuvent ajouter ou supprimer des lignes dynamiquement dans une sous-section de la page, ActiveRowCount offre une méthode fiable pour adapter le comportement de l'application en temps réel.
• Elle peut être combinée avec GetRow pour accéder précisément aux données : Après avoir déterminé le nombre de lignes avec ActiveRowCount, on peut utiliser GetRow(Scrollpath, i) pour accéder à une ligne particulière, permettant ainsi des opérations ciblées comme la lecture ou la mise à jour de champs.
• Bien que simple, cette fonction joue un rôle critique dans l'intégrité du traitement des données en interface : En s'assurant que seuls les enregistrements actifs sont manipulés, elle contribue à éviter les erreurs de logique ou de calcul, notamment dans les cas de validation métier, de reporting ou d'export de données utilisateurs.