NAME

ACME::PIA::Export - Export contacts, calendars or todos from Arcor's PIA messaging

DESCRIPTION

This module is intended to help export data from the PIA messaging web application that comes with the free Arcor mail account at www.arcor.de

It lets the user retrieve his data in CSV or XLS (not yet implemented) format or as hashes.

EXAMPLE

use ACME::PIA::Export;

my $pia = ACME::PIA::Export->new(

        "username" => "mylogin",
        "password" => "verysecret"

);

$pia->export( "contacts" );

foreach my $contact ( $pia->entries() ) {

        print "$contact->{NAME}, $contact->{VORNAME}\n";
        

}

$pia->export_csv( file => "C:/my/piacontacts.csv" );

FUNCTIONS

new( [ key => value, ...] )

Creates and returns a new ACME::PIA::Export object.

Parameters are given as key => value pairs. The most commonly used are "username" and "password". If you expirience problems you can also give the parameter "DEBUG" => 1 to get verbose output from all functions.

export( SCOPE )

Export all objects for the given scope (contacts, calendar etc.) and stores them in the ACME::PIA::Export object.

entries()

Retrieve a list with all entries as hashes.

entries_csv( [key => value, ...] ) [NOT YET IMPLEMENTED]

Retrieve entries in csv format. Without arguments they are returned as a list of lines, including column headers as first row. The column headers can be turned off by setting the option 'headers => 0'.

If the parameter 'file => "/path/to/file.csv"' is given, then the output is saved to the given file directly and the number of rows written (excluding the column headers) is returned.

entries_xls( file => /path/to/file.xls [, key => value, ...] ) [NOT YET IMPLEMENTED]

Retrieve entries in xls format.

The parameter 'file => "/path/to/file.xls"' is mandatory. The output is saved to the given file directly and the number of rows written (excluding the column headers) is returned.

The column headers can be turned off by setting the option 'headers => 0'.

AUTHOR

Christian Winter <chrwin@cpan.org>

LICENSE

This peace of code is licensed under the same terms as Perl itself. You should have received a copy of this license together with your Perl version. You can read it at http://www.perl.org or by typing "perldoc perlartistic" or "perldoc perlgpl"

BUGS

Please report those to the author.