From Code to Community: Sponsoring The Perl and Raku Conference 2025 Learn more

 / 
Spreadsheet-WriteExcel-FromDB-1.00
River stage one • 1 direct dependent • 1 total dependent
/ Spreadsheet::WriteExcel::FromDB

NAME

Spreadsheet::WriteExcel::FromDB - Convert a database table to an Excel spreadsheet

SYNOPSIS


            

              
              
 use Spreadsheet::WriteExcel::FromDB;
 my $dbh = DBI->connect(...);
 my $ss = Spreadsheet::WriteExcel::FromDB->read($dbh, $table_name);
 $ss->ignore_columns(qw/foo bar/); 
 # or
 $ss->include_columns(qw/foo bar/); 
 $ss->restrict_rows('age > 10');
 print $ss->as_xls;
 # or
$ss->write_xls('spreadsheet.xls');

DESCRIPTION

This module exports a database table as an Excel Spreadsheet.

The data is not returned in any particular order, as it is a simple task to perform this in Excel. However, you may choose to ignore certain columns, using the 'ignore_columns' method.

METHODS

read

Creates a spreadsheet object from a database handle and a table name.

dbh / table

Accessor / mutator methods for the database handle and table name.

restrict_rows


            

              
              
$ss->restrict_rows('age > 10');

An optional 'WHERE' clause for restricting the rows returned from the database.

ignore_columns


            

              
              
$ss->ignore_columns(qw/foo bar/);

Output all columns, except these ones, to the spreadsheet.

include_columns


            

              
              
$ss->include_columns(qw/foo bar/);

Only include these columns into the spreadsheet.

as_xls


            

              
              
print $ss->as_xls;

Return the table as an Excel spreadsheet.

write_xls


            

              
              
$ss->write_xls('spreadsheet.xls');

Write the table to a spreadsheet with the given filename.

BUGS

Dates are handled as strings, rather than dates.

AUTHOR

Tony Bowden

BUGS and QUERIES

Please direct all correspondence regarding this module to: bug-Spreadsheet-WriteExcel-Simple@rt.cpan.org

COPYRIGHT AND LICENSE


            

              
              
Copyright (C) 2001-2005 Tony Bowden.
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License; either version 2 of the License,
or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
FOR A PARTICULAR PURPOSE.

SEE ALSO

Spreadsheet::WriteExcel::Simple. Spreadsheet::WriteExcel. DBI