Comment supprimer correctement toutes les lignes d’une sous-liste NetSuite à l’aide de SuiteScript 2.x

Observez les deux extraits de code ci-dessous, qui illustrent respectivement une approche incorrecte et une approche correcte pour supprimer des éléments d’une sous-liste dans SuiteScript 2.x. La différence essentielle réside dans la manière dont l’opération de suppression gère la réindexation dynamique des lignes de la sous-liste.

APPROCHE INCORRECTE

javascript
for(var i = 0; i < currentRecord.getLineCount({ sublistId: 'item' }); i++){
    currentRecord.removeLine({ sublistId: 'item', line: i });
}

Dans l’extrait ci-dessus, qui illustre une approche courante et intuitive, le problème survient car, dès qu’un élément de ligne est supprimé, la sous-liste est réindexée. Cet ajustement entraîne une modification du nombre de lignes et des indices des éléments restants. Par exemple, si une sous-liste comporte trois éléments (indexés 0, 1, 2) :

LIGNE 1 [index 0] LIGNE 2 [index 1] LIGNE 3 [index 2]

1. currentRecord.removeLine({ sublistId: 'item', line: 0 }) supprime la LIGNE

   1.

   Résultat : LIGNE 2 [index 0] LIGNE 3 [index 1]

2. La boucle incrémente i à 1. currentRecord.removeLine({ sublistId: 'item', line: 1 }) supprime LIGNE 3 (qui était à l’origine LIGNE 3, désormais à l’index 1).

   Résultat : LIGNE 2 [index 0]

   La boucle s’arrête alors, car i est désormais supérieur au nombre de lignes, laissant la LIGNE 2 intacte.

   APPROCHE CORRECTE

   Une méthode simple et fiable pour résoudre ce problème consiste à supprimer systématiquement le premier élément (index 0) jusqu’à ce qu’il ne reste plus aucun élément dans la sous-liste. Cette approche fonctionne car la suppression du premier élément décale toujours les éléments suivants pour combler le vide, ce qui fait que le « nouveau » premier élément est toujours disponible à l’index 0.

javascript
while(currentRecord.getLineCount({ sublistId: 'item' }) > 0){
    currentRecord.removeLine({ sublistId: 'item', line: 0 });
}

Cela donnera lieu à l’exécution suivante :

Considérez la même sous-liste initiale :

LINE 1 [index 0] LINE 2 [index 1] LINE 3 [index 2]

1. currentRecord.removeLine({ sublistId: 'item', line: 0 }) supprime LINE

   1.

   Résultat : LINE 2 [index 0] LINE 3 [index 1]

2. currentRecord.removeLine({ sublistId: 'item', line: 0 }) supprime LIGNE

   2.

   Résultat : LIGNE 3 [index 0]

3. currentRecord.removeLine({ sublistId: 'item', line: 0 }) supprime LIGNE

   3.

   Résultat : (sous-liste vide)

   Cela garantit que tous les éléments sont correctement supprimés sans aucune complication liée à l'indexation.