$excel

Traitement de fichiers Excel.

L'édition d'un fichier Excel se fait généralement en 4 étapes:

1. Ouverture (ou création)
2. Modifications
3. Sauvegarde
4. Fermeture

Les opérations 2 et 3 peuvent être répétées.

La fermeture est optionnelle dans la mesure où le moteur se charge de la réaliser automatiquement si celle-ci n'a pas été faite expressément. Toutefois pour limiter la consommation en mémoire (en particulier sur les longs scripts ou si le script charge beaucoup de workbooks) il est préférable de fermer le workbook en fin d'utilisation. Pour ce faire, il est recommandé d'utiliser la notation try/finally afin que la fermeture se fasse, même en cas d'erreur. Voici un exemple de création de workbook avec fermeture explicite :

var filename = $uuid.get() & ".xlsx",
    destfile = $file.load($app.getWorkDirectory() & filename),
    workbook = $excel.create();

try {
    var sheet = $excel.addSheet(workbook, "exemple");
    $excel.setValue(workbook, { sheet: sheet, cell: "A1", value: 1 });

    $excel.autosize(workbook, { sheet: sheet, columns: "1-*" });
    $excel.save(workbook, destfile);
}
finally {
    $excel.close(workbook);
}

Convention

Dans cette librairie, toutes les méthodes utilisent des index de lignes ou de colonnes 1-based.