posts

Nous allons raisonner sur le même tableau que dans l’exemple précédent :

Pour lire les cellules une par une et les afficher dans la console, on commence par récupérer la plage avec la fonction getRange() qui retourne un array de array.

Pour parcourir ces éléments, vous pouvez utiliser une boucle for of ou une boucle forEach.

Avec une boucle for of

Voici le code à utiliser avec une boucle for of :

async function run() {

  await Excel.run(async function (context) {

    const ws = context.workbook.worksheets.getActiveWorksheet();

    let plage = ws.getRange('A1:D6');

    plage.load('values');

    await context.sync();

    for (let i of plage.values) // Récupère les lignes

      for (let j of i) // Récupère les cellules

        console.log(j);

  });

}

La boucle for (a of b) parcourt un a un tous les éléments de b. A chaque étape de la boucle, a contient un des éléments de b. Ici, les données parcourues se trouvent dans un tableau de tableau :

[

    ["Référence", "HT", "Quantité", "TTC"],

    ["A34", 120.5, 12, "=R[-1]C[-2]*R[-1]C[-1]"],

    ["B18", 45.6, 45, "=R[-1]C[-2]*R[-1]C[-1]"],

    ["A66", 12.25, 120, "=R[-1]C[-2]*R[-1]C[-1]"],

    ["C42", 146.65, 26, "=R[-1]C[-2]*R[-1]C[-1]"],

    ["G29", 10, 84, "=R[-1]C[-2]*R[-1]C[-1]"]

]

La première boucle for of récupère un à un chacun des tableaux internes, c’est-à-dire chacune des lignes de la plage. La seconde boucle parcourt chacun des éléments extraits par la première boucle et extrait une à une les valeurs, c’est-à-dire le contenu des cellules de la ligne examinée.

Voici ce qui s’affiche dans la console :

Référence

HT

Quantité

TTC

34

120.5

12

1446

B18

45.6

45

2052

A66

12.25

120

1470

C42

146.65

26

3812.9

G29

10

84

840

Avec une boucle forEach()

Ce code est disponible en cliquant ici

Une deuxième possibilité s’offre à vous : l’utilisation de la boucle forEach(). Voici la syntaxe de la fonction forEach() pour un tableau à une dimension :

tableau.forEach((item,index)=>{

  // Traitement

})

Voici la syntaxe de la fonction forEach() pour un tableau à deux dimensions :

tableau.forEach((ligne,index1)=>{

  ligne.forEach((cellule,index2)=>{

    // Traitement

  });

})

plage.values contient un tableau de tableaux qui représente les cellules A1 à D6. Pour le parcourir, il faut donc utiliser deux boucles forEach() imbriquées :

async function run() {

  await Excel.run(async function (context) {

    const ws = context.workbook.worksheets.getActiveWorksheet();

    let plage = ws.getRange('A1:D6');

    plage.load('values');

    await context.sync();

    plage.values.forEach((ligne, index1)=>{

      ligne.forEach(function (cellule, index2) {

        console.log(cellule);

      });

    });

  });

}

Les données affichées dans la console sont les mêmes qu’avec les boucles for of.