Partager via


Fonction SPLITLIST ER

La fonction SPLITLIST fractionne la liste spécifiée en sous-listes (ou lots), dont chacun contient le nombre d’enregistrements spécifié. Elle renvoie ensuite le résultat en tant que nouvelle valeur de Liste des enregistrements constituée des lots.

Syntaxe 1

SPLITLIST (list, number)

Syntaxe 2

SPLITLIST (list, number, on-demand reading flag)

Arguments

list : Liste d’enregistrements

Chemin d’accès valide d’une source de données du type de données Liste d’enregistrements.

number : Entier

Nombre maximal d’enregistrements par lot.

on-demand reading flag : Booléen

Une valeur Booléenne qui spécifie si les éléments des sous-listes doivent être générés à la demande.

Valeurs de retour

Liste d’enregistrements

Liste des enregistrements résultante.

Notes d’utilisation

La liste des traitements par lots renvoyée contient les éléments suivants :

  • Valeur :Liste

    Liste des enregistrements qui appartiennent au lot en cours.

  • Numéro de lot :Entier

    Numéro du lot actuel dans la liste renvoyée.

Lorsque l’indicateur de lecture à la demande est défini sur True, les sous-listes sont générées sur demande, ce qui permet de réduire la consommation de mémoire mais peut entraîner une dégradation des performances si les éléments ne sont pas utilisés séquentiellement.

Exemple

Dans l’illustration suivante, une source de données Lignes est créée sous la forme d’une liste avec trois enregistrements. Cette liste est divisée en lots, dont chacun contient jusqu’à deux enregistrements.

Source de données qui est divisée en des traitements par lots

L’illustration suivante présente la structure de format conçue. Dans cette structure de format, les liaisons à la source de données Lignes sont créées pour générer une sortie au format XML. Cette sortie répertorie les nœuds individuels de chaque lot et les enregistrements qu’il contient.

Structure de format ayant des liaisons avec une source de données

L’illustration suivante présente le résultat de l’exécution du format conçu.

Résultat de l’exécution du format

Ressources supplémentaires

Fonctions de liste