Objet @Tableur

• L'objet @Tableur permet de manipuler les données d'un fichier de type tableur (Excel, Open document Calc, etc).

  Méthodes

  .@Ajouter : (@Tableur) Ajouter une collection à la fin de la feuille active du tableur

  .@Afficher : (@HTML) Afficher tout ou partie de la feuille active du tableur

  .@Cellule : (valeur) extraction de la valeur d'une cellule accédée par ses coordonnées de feuille (ex : 6,"B")

  .@Colonnes : (@Collection) @Collection des colonnes du tableur. Chaque colonne est elle-même une @Collection de valeurs.

  .@Enregistrer : (@Tableur) effectue la sauvegarde des modifications effectuées dans le tableur ;

  .@Feuille : (valeur @Texte, @Nombre, @DateHeure) force ou restitue la feuille active

  .@FormatDate : (@Tableur) met à jour le format des dates du tableur

  .@Importer :  (@Collection) Importe des documents à partir des lignes d'un tableur

  .@Lignes : (@Collection) @Collection des lignes du tableur. Chaque ligne est elle-même une @Collection de valeurs.

  .@NoDerniereColonne : (@Nombre) numéro de la dernière colonne du tableur

  .@NoDerniereLigne : (@Nombre) numéro de la dernière ligne du tableur

  Exemples

  Exemple 1 : remplir des cellules et afficher

  @Tableur
     .@Cellule("1","A","Ma cellule A1")
     .@Cellule("1","B",@Aujourdhui)
     .@Cellule("1","C",@Maintenant)
     .@Cellule("1","D",2327)
     .@Afficher

  donne le résultat suivant :

  

  Exemple 2 : compter les lignes d'un tableur existant

  @Tableur("/tmp/Inscriptions 8 novembre-1.xlsx").@Lignes.@Compter

  permet d'afficher le nombre des lignes de la feuille de tableur

  Exemple 3 :

  On veut intégrer un fichier tableur dont chaque ligne contient la description d'une personne. On ne doit prendre qu'à partir de la 3ème ligne et laisser tomber les 4 dernières lignes.

  La variable 'champs' contient la collection des noms de propriétés dans l'ordre du tableur.

  L'utilisateur peut choisir les personnes à mettre à jour effectivement.

  champs=@Collection("Identifiant","Nom","Prenom","Adresse",...,"DateNaissance");
  @Tableur("tmp/Annuaire - Sept 2014.xls")
    .@Importer("Personne","Identifiant","A",champs,3,-4)
    .@PourChaque(.@Enregistrer)

  Aspects techniques

  Jusqu'à la version 22.09, cet objet utilise la bibliothèque PHPExcel.
  A partir de la version 22.12, l'objet utilise le logiciel PhpSpreadSheet.