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.
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.
L’illustration suivante présente le résultat de l’exécution du format conçu.