Configuration de la pagination

Les différentes zones de l'explorateur de données du produit permettent de configurer la pagination afin que l'utilisateur puisse "feuilleter" un grand nombre de résultats à l'aide des boutons ou des liens Précédent et Suivant.

Plusieurs paramètres des zones sont concernés lors de la configuration de cette fonctionnalité. Les points ci-dessous décrivent la configuration.

  • Le paramètre Activer la pagination doit être configuré pour définir les éléments de base de la pagination pour la zone. Il indique si les actions Précédent et Suivant se présentent sous forme de boutons, de liens ou d'icônes et précise l'emplacement des actions. Il permet également d'indiquer si les lignes supplémentaires doivent simplement être ajoutées à la suite ou présentées dans une nouvelle page. Pour des informations sur la syntaxe précise, voir l'aide incorporée du paramètre.

  • Il est conseillé de définir pour la zone l'affichage du nombre d'enregistrements et d'informations sur les pages, à l'aide du paramètre Affichage du nombre d'enregistrements. Pour des informations sur la syntaxe précise, voir l'aide incorporée du paramètre.

  • Configurez le paramètre Nombre de lignes à récupérer pour SQL, afin de définir le nombre d'enregistrements affiché par page. En l'absence de ce paramètre, la valeur du paramètre Nombre de lignes à afficher est utilisée.

  • Configurez la clé qui sera utilisée pour la pagination afin que le système puisse suivre les sauts de page. Les données doivent être triées sur la clé de pagination ; de ce fait, le choix de la clé de pagination doit tenir compte de la conception de la zone et des données affichées. En outre, la clé de pagination doit être unique pour que les sauts de page se fassent correctement. Voir plus loin pour des exemples de configuration.

    • L'instruction SQL doit comporter des clauses supplémentaires PAGENEXT et PAGEPREV basées sur la clé de pagination. En outre, comme indiqué ci-dessus, la clé de pagination doit être utilisée dans la clause ORDER BY.

    • Les paramètres Colonne SQL doivent définir la mnémonique de clé de pagination à utiliser conjointement aux clauses de pagination de l'instruction SQL.

    • Il est recommandé de configurer le paramètre de la colonne d'affichage SQL pour qu'il affiche les données dans le même ordre que celui de la clause ORDER BY.

Cette fonctionnalité est prise en charge par les types de zone suivants :

  • Explorateur de données d'information - SQL unique (F1-DE-SINGLE).

  • Explorateur de données d'information - SQL multiples (F1-DE). A noter que les zones de ce type prennent en charge l'union des résultats de toutes les instructions SQL. Par conséquent, la pagination ne peut être activée pour les zones de ce type que si une même instruction SQL est utilisée. Le système n'est pas capable de suivre la pagination si les instructions SQL sont disparates.

  • Explorateur de données de requête - SQL multiples (F1–DE-QUERY).

  • Explorateur de données multirequête (F1–DE-MULQRY). Les zones de ce type ne comportent pas de configuration d'instructions SQL ou d'affichage de colonnes. Cependant, elles permettent de configurer le paramètre Activer la pagination. Celui-ci doit être configuré pour que la pagination fonctionne dans les zones individuelles.

Remarque :

Zones utilisées pour un service fonctionnel. Lorsqu'une zone d'explorateur de données est appelée via un service fonctionnel, la pagination est ignorée. Dans ce cas, la zone renvoie le premier "bloc" de lignes selon les paramètres Nombre de lignes.

Zones avec options de visualisation des données. La pagination n'est pas prise en charge pour les zones qui définissent des options de visualisation destinées à afficher les données sous forme graphique.

Exemples

Clé de pagination simple

Dans cet exemple, la valeur de consultation avancée est définie comme étant la colonne 1 (C1) et est marquée comme étant la clé de pagination. Ce champ est unique dans la table et fonctionne bien comme clé de pagination simple.

SELECT A.F1_EXT_LOOKUP_VALUE,A.BUS_OBJ_CD
FROM 
  F1_EXT_LOOKUP_VAL A, 
  F1_EXT_LOOKUP_VAL_L B
WHERE 
A.BUS_OBJ_CD = :H1
AND A.BUS_OBJ_CD = B.BUS_OBJ_CD
AND A.F1_EXT_LOOKUP_VALUE = B.F1_EXT_LOOKUP_VALUE
AND B.LANGUAGE_CD = :LANGUAGE
[(F1) AND UPPER(A.F1_EXT_LOOKUP_VALUE) like UPPER(:F1)]
[(F2) AND ((UPPER(B.DESCR_OVRD) like UPPER(:F2))
OR (B.DESCR_OVRD = ' ' AND UPPER(B.DESCR) like UPPER(:F2)))]
[(PAGENEXT) AND A.F1_EXT_LOOKUP_VALUE > :C1]
[(PAGEPREV) AND A.F1_EXT_LOOKUP_VALUE < :C1]
ORDER BY A.F1_EXT_LOOKUP_VALUE

Clé de pagination complexe

Dans la plupart des requêtes, le tri ne se fait pas sur une valeur unique. Dans ce cas, la clé de pagination doit être définie en fonction du tri de la requête et doit comporter un champ unique, tel que la clé primaire, comme dernière clé de pagination. Dans cet exemple, les résultats de la requête sont triés par type de tâche, rôle et utilisateur. Tous les champs, y compris l'ID d'entrée de tâche (clé primaire), sont marqués comme étant des clés de pagination.

SELECT TD_TYPE_CD, ROLE_ID, ASSIGNED_TO, ASSIGNED_DTTM, TD_PRIORITY_FLG, TD_ENTRY_ID
FROM  CI_TD_ENTRY
WHERE 
ENTRY_STATUS_FLG IN ('O', 'W')
[(F1) and TD_TYPE_CD = :F1]
[(F2) AND ASSIGNED_TO = :F2]
[(F3) AND ROLE_ID = :F3]
[(PAGENEXT) and ((TD_TYPE_CD>:C1) or (TD_TYPE_CD=:C1 and ROLE_ID>:C2) or (TD_TYPE_CD=:C1 and ROLE_ID=:C2 
and ASSIGNED_TO>:C3) or (TD_TYPE_CD=:C1 and ROLE_ID=:C2 and ASSIGNED_TO=:C3 AND TD_ENTRY_ID>:C4))] 
[(PAGEPREV) and ((TD_TYPE_CD<:C1) or (TD_TYPE_CD=:C1 and ROLE_ID<:C2) or (TD_TYPE_CD=:C1 and ROLE_ID=:C2 
and ASSIGNED_TO<:C3) or (TD_TYPE_CD=:C1 and ROLE_ID=:C2 and ASSIGNED_TO=:C3 AND TD_ENTRY_ID<:C4))] 
ORDER BY TD_TYPE_CD, ROLE_ID, ASSIGNED_TO, TD_ENTRY_ID