NAME

tj3ts_summary - send out individual copies and a summary of accepted time sheets

SYNOPSIS

tj3ts_summary [options]

DESCRIPTION

This program can be used to send out individual copies and a summary of all accepted time sheets a list of email addresses. The directory structures for templates and submitted time sheets must be present. The project data will be accesses via tj3client from a running TaskJuggler server process.

OPTIONS

-c, --config <FILE>: Use the specified YAML configuration file
--silent: Don't show program and progress information
--no-color: Don't use ANSI contol sequences to color the terminal output. Colors should only be used when spooling to an ANSI terminal. In case the detection fails, you can use this option to force colors to be off.
--debug: Enable Ruby debug mode
-d, --directory <DIR>: Use the specified directory as working directory
--dryrun: Don't send out any emails or do SCM commits
-r, --resource <ID>: Only generate summary for given resource
-t, --to <EMAIL>: Send all individual reports and a summary report to this email address
--sheet <EMAIL>: Send all reports to this email address
--digest <EMAIL>: Send a summary report to this email address
-e, --enddate <DAY>: The end date of the reporting period. Either as YYYY-MM-DD or day of week. 0: Sunday, 1: Monday and so on. The default value is 2020-06-22.
-h, --help: Show this message
--version: Show version info

ENVIRONMENT

HOME: The user's home folder. Used to search for configuration file if not specified.

FILES

.taskjugglerrc or taskjuggler.rc tj3d searches for a config file named .taskjugglerrc or taskjuggler.rc in the current path, the user's home path as specified by the HOME environment variable or /etc/. At a minimum the file must configure an authentication key, an e-mail delivery method, project id, sender e-mail and receipients e.g.:

_global:
authKey: ********
smtpServer: smtp.your_company.com
projectId: acso
_timesheets:
senderEmail: 'TaskJuggler <statussheets@taskjuggler.amd.com>'
_summary:
sheetRecipients:
- team@your_company.com

(the user should specify their own auth key and set file permissions accordingly). An alternative config file location may be specified using the -c, --config FILE option.

timesheets.log: The timesheets log file, created in the working directory.
TimeSheetTemplates: Base directory of the sheet templates, created in the working directory.

COPYRIGHT

: by Chris Schlaeger <cs@taskjuggler.org>

This program is free software; you can redistribute it and/or modify it under the terms of version 2 of the GNU General Public License as published by the Free Software Foundation.

For more info about TaskJuggler see http://www.taskjuggler.org