NAME

WebService::Toggl::Report::Details - Toggl detailed report object

SYNOPSIS

use WebService::Toggl;
my $toggl = WebService::Toggl->new({api_key => 'foo'});

my $report = $toggl->details({workspace_id => 1234});

say $report->total_billable;  # billable milliseconds
say $report->total_count;     # max($all_entries, $per_page)
for $entry (@{ $report->data }) {
  say "User: $entry->{user} logged " . ($entry->{dur} / 1000)
    . " second on task: '" . $entry->{description} . "'";
}

DESCRIPTION

This module is a wrapper object around the Toggl detailed report described here. It returns all of the time entries that match the request criteria.

REQUEST ATTRIBUTES

Request attributes common to all reports are detailed in the ::Role::Request pod.

page

Detailed reports are paged. This attribute sets the requested page. If left empty, Toggl will return the first page by default.

RESPONSE ATTRIBUTES

Response attributes common to all reports are detailed in the ::Role::Request pod.

per_page

How many time entries are being returned per page. Current default is 50. This is not settable.

total_count

The total number of records found. This will be the greater of the actual number of entries returned and the per_page parameter.

REPORT DATA

The data() attribute of a ::Report::Details object is an arrayref of time entry hashrefs. For the contents of this structure, see the Toggl API docs.

LICENSE

Copyright (C) Fitz Elliott.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

Fitz Elliott <felliott@fiskur.org>