Introduction

La bibliothèque de fonctions de la DLL XlsxToolBx permet la manipulation de documents Excel au format xlsx Office 2007 et versions supérieures ou au format xls Office 1997/2003.

Elle permet de construire intégralement un classeur ou de manipuler un classeur existant.

Cette bibliothèque est disponible pour Visual Adélia, Adélia Web et Adélia Cloud.

Limitations

La DLL XlsxToolBx ne permet pas de travailler avec des fonctions localisées. Cela signifie que les noms de fonctions dans les formules, ainsi que les formats de cellules doivent être exprimés en langue anglaise.

Configuration

La XlsxToolBx est disponible pour Visual Adélia, Adélia Web et Adélia Cloud. Elle est basée sur une libraire Java de manipulation des classeurs Excel Apache POI (https://poi.apache.org/spreadsheet).

La version Windows de la librairie est en fait implémentée sous la forme d'un proxy utilisant le client/serveur Adélia pour appeler directement la version Java via des services Middleware.

Configuration pour la version Java

Concerne les programmes Adélia Web, Adélia Cloud et Visual Adélia générés en Java. La XlsxToolBx est nativement supportée dans cette configuration, aucune action n'est nécessaire pour la mettre en place.

Néanmoins, la librairie utilisée est relativement gourmande en mémoire, et pour manipuler de gros documents il est préférable d'augmenter l'espace mémoire disponible (paramètres -Xms et -Xmx, valeurs recommandées -Xms256m -Xmx1024m pour une JVM 32bits).

Configuration pour la version Windows

Concerne les programmes Visual Adélia générés en C.

Dans cette configuration, le programme fait appel à un service Middleware utilisant le serveur logique *DOC_SERVER.

Vous devez configurer ce serveur logique dans votre configuration client.

Le serveur physique doit pointer sur un démon Java.

Attention, si le traitement est déporté, les noms de fichier (fonctions d'ouverture et de sauvegarde) seront relatifs au serveur.

Utilisation

Cette section présente les principes de fonctionnement de la bibliothèque XlsxToolBx.

Handle d'objet

Un handle est une référence à un objet manipulable par la toolbox. Il est représenté dans un programme Adélia par une valeur numérique de type NUM_BIN_4.

Contrairement à la DocxToolBx, chaque cellule d'un document Excel peut être adressée individuellement (nom feuille + ligne / colonne).

La XlsxToolBx n'utilise qu'un handle pour référencer le classeur lui-même, et ne fournit pas de fonction de manipulation des handles.

Toutes les fonctions de manipulations de XlsxToolBx prennent en paramètre le handle du document auquel elles s'appliquent.

Par exemple, ouverture et fermeture d'un document :

APPELER_DLL 'XlsxToolBx' 'WorkbookOpen' nomFichier handleClasseur rc

APPELER_DLL 'XlsxToolBx' 'WorkbookClose' handleClasseur rc

Manipulation des cellules

Un classeur Excel est constitué d'un ensemble de feuilles qui sont elles-mêmes des tableaux 2D contenant des cellules.

La XlsxToolBx vous permet de manipuler directement des cellules ou des plages de cellules à l'intérieur d'une feuille du classeur.

De façon générale, les fonctions permettant de récupérer une information (fonctions XXXGetXXX) ne s'adressent qu'a la première cellule de la plage spécifiée, alors que les fonctions de modification (XXXSetXXX) permettent d'appliquer le traitement à l'ensemble des cellules de la plage spécifiée.

Les plages de cellules doivent être spécifiée sous la forme A1:C3 (colonne A ligne 1 à colonne C ligne 3).

La plage peut comporter le nom de la feuille de calcul référencée, la sélection est alors de la forme Feuil1!A1:C3.

Si le nom de la feuille de calcul est omis, la sélection est considérée comme relative à la feuille active du classeur.

Vous pouvez traiter plusieurs plages de cellule simultanément.

Dans ce cas, séparez les plages par le caractère ";". Par exemple : Feuil1!A1:C3;Feuil2!A1:C3.

Exemple : modification de la fonte de la première cellule de la feuille Feuil1

APPELER_DLL 'XlsxToolBx' 'StyleSetFont' handleDocument 'Feuil1!A1' 'Comic Sans MS' rc

Classes

Les fonctions de la XlsxToolBx sont regroupées en classes définies par le périmètre d'application de la fonction.

Les différentes classes sont répertoriées dans le tableau ci-dessous :

Classe	Description
Workbook	Cette classe fournit des fonctions de gestion d'un classeur Excel.
Sheet	Cette classe fournit des fonctions de gestion des feuilles d'un classeur.
Selection	Cette classe fournit des fonctions de calcul et de gestion des données des cellules.
Style	Cette classe fournit des fonctions de gestion des styles appliqués aux cellules.
Image	Cette classe fournit des fonctions de gestion des images.