ulferts
d09d4d7155
|
6 years ago | |
|---|---|---|
| .. | ||
| app | 6 years ago | |
| config | 6 years ago | |
| db/migrate | 6 years ago | |
| doc | 6 years ago | |
| features/step_definitions | 6 years ago | |
| lib | 6 years ago | |
| spec | 6 years ago | |
| Gemfile | 6 years ago | |
| Gemfile.plugins | 6 years ago | |
| README.md | 6 years ago | |
| openproject-reporting.gemspec | 6 years ago | |
README.md
OpenProject Reporting Plugin
The OpenProject Reporting plugin allows to create custom reports for costs associated to projects using the OpenProject Costs plugin. Various attributes including custom fields can be used to filter the data and the results can be grouped by these attributes.
The OpenProject Reporting plugin is built on top of the ReportingEngine Rails engine, providing the base functionality for customized database reports.
Requirements
The OpenProject Reporting plugin requires the OpenProject Core in version greater or equal to 3.0.0. It also requires the ReportingEngine Rails engine in version greater or equal to 1.0.0. Finally, it also requires the OpenProject Costs plugin.
Installation
Reporting depends on the OpenProject Costs plugin. If you have not installed it yet, you can do so by adding the following line to the Gemfile.plugins in your OpenProject installation:
gem "openproject-costs", git: "https://github.com/finnlabs/openproject-costs.git", :branch => "stable/5"
Furthermore, OpenProject reporting depends on the ReportingEngine which should be installed by adding the following line to your Gemfile.plugins in your OpenProject installation folder:
gem "reporting_engine", git: "https://github.com/finnlabs/reporting_engine.git", :branch => "dev"
Finally, add the following line to your Gemfile.plugins in your OpenProject installation folder to use the Reporting plugin:
gem "openproject-reporting", git: "https://github.com/finnlabs/openproject-reporting.git", :branch => "stable/5"
Afterwards, run:
bundle install
Deinstallation
Remove the lines
gem "reporting_engine", git: "https://github.com/finnlabs/reporting_engine.git", :branch => "dev"
gem "openproject-reporting", git: "https://github.com/finnlabs/openproject-reporting.git", :branch => "stable/5"
from your Gemfile.plugins in your OpenProject installation folder and run:
bundle install
to uninstall the ReportingEngine and the OpenProject Reporting plugin.
Configuration
cost_reporting_cache_filter_classes: true
OpenProject Reporting, when not configured otherwise, optimizes response time by caching the filters and group by options generated for work package custom fields. Only when the custom fields are invalidated, does reporting recreate the elements by information from the database. In some scenarios, such a behavior might not be desirable. Especially, when databases are switched between requests to serve information from another installation, caching will almost always fail as the information is outdated and in some edge cases, filters and group by options are displayed erroneously. In such a setting, it is advisible to deactivate the caching by setting cost_reporting_cache_filter_classes to false in OpenProject's config/configuration.yml
Bug Reporting
If you find any bugs, you can create a bug ticket at
https://www.openproject.org/projects/plugin-reporting
Development
To contribute, you can create pull request on the official repository at
https://github.com/finnlabs/openproject-reporting
Credits
Special thanks go to
- Deutsche Telekom AG (opensource@telekom.de) for project sponsorship
Licence
Copyright (C) 2010 - 2015 OpenProject Foundation (OPF)
This plugin is licensed under the GNU GPL v3. See doc/COPYRIGHT.md and doc/GPL.txt for details.