You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
kmymoney/kmymoney2/mymoney/mymoneyreport.h

498 lines
20 KiB

/***************************************************************************
mymoneyreport.h
-------------------
begin : Sun July 4 2004
copyright : (C) 2004-2005 by Ace Jones
email : acejones@users.sourceforge.net
***************************************************************************/
/***************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
***************************************************************************/
#ifndef MYMONEYREPORT_H
#define MYMONEYREPORT_H
#ifdef HAVE_CONFIG_H
#include <config.h>
#endif
// ----------------------------------------------------------------------------
// QT Includes
#include <tqmap.h>
#include <tqvaluelist.h>
#include <tqstring.h>
class TQDomElement;
class TQDomDocument;
// ----------------------------------------------------------------------------
// Project Includes
#include <kmymoney/mymoneyobject.h>
#include <kmymoney/mymoneyaccount.h>
#include <kmymoney/mymoneytransactionfilter.h>
#include <kmymoney/export.h>
/**
* This class defines a report within the MyMoneyEngine. The report class
* contains all the configuration parameters needed to run a report, plus
* XML serialization.
*
* A report is a transactionfilter, so any report can specify which
* transactions it's interested down to the most minute level of detail.
* It extends the transactionfilter by providing identification (name,
* comments, group type, etc) as well as tqlayout information (what kind
* of tqlayout should be used, how the rows & columns should be presented,
* currency converted, etc.)
*
* As noted above, this class only provides a report DEFINITION. The
* generation and presentation of the report itself are left to higher
* level classes.
*
* @author Ace Jones <acejones@users.sourceforge.net>
*/
class KMYMONEY_EXPORT MyMoneyReport: public MyMoneyObject, public MyMoneyTransactionFilter
{
public:
// When adding a new row type, be sure to add a corresponding entry in kTypeArray
enum ERowType { eNoRows = 0, eAssetLiability, eExpenseIncome, eCategory, eTopCategory, eAccount, ePayee, eMonth, eWeek, eTopAccount, eAccountByTopAccount, eEquityType, eAccountType, eInstitution, eBudget, eBudgetActual, eSchedule, eAccountInfo, eAccountLoanInfo, eAccountReconcile, eCashFlow};
enum EReportType { eNoReport = 0, ePivotTable, eQueryTable, eInfoTable };
enum EColumnType { eNoColumns = 0, eDays = 1, eMonths = 1, eBiMonths = 2, eQuarters = 3, eWeeks = 7, eYears = 12 };
// if you add bits to this bittqmask, start with the value currently assigned to eTQCend and update its value afterwards
// also don't forget to add column names to kQueryColumnsText in mymoneyreport.cpp
enum EQueryColumns { eTQCnone = 0x0, eTQCbegin = 0x1, eTQCnumber = 0x1, eTQCpayee = 0x2, eTQCcategory = 0x4, eTQCmemo = 0x8, eTQCaccount = 0x10, eTQCreconciled = 0x20, eTQCaction = 0x40, eTQCshares = 0x80, eTQCprice = 0x100, eTQCperformance = 0x200, eTQCloan = 0x400, eTQCbalance = 0x800, eTQCend = 0x1000 };
enum EDetailLevel { eDetailNone = 0, eDetailAll, eDetailTop, eDetailGroup, eDetailTotal, eDetailEnd };
enum EChartType { eChartNone = 0, eChartLine, eChartBar, eChartPie, eChartRing, eChartStackedBar, eChartEnd };
static const TQStringList kRowTypeText;
static const TQStringList kColumnTypeText;
static const TQStringList kQueryColumnsText;
static const TQStringList kDetailLevelText;
static const TQStringList kChartTypeText;
static const EReportType kTypeArray[];
public:
MyMoneyReport(void);
MyMoneyReport(ERowType _rt, unsigned _ct, dateOptionE _dl, EDetailLevel _ss, const TQString& _name, const TQString& _comment );
MyMoneyReport(const TQString& id, const MyMoneyReport& right);
/**
* This constructor creates an object based on the data found in the
* TQDomElement referenced by @p node. If problems arise, the @p id of
* the object is cleared (see MyMoneyObject::clearId()).
*/
MyMoneyReport(const TQDomElement& node);
// Simple get operations
const TQString& name(void) const { return m_name; }
bool isShowingRowTotals(void) const { return (m_showRowTotals); }
EReportType reportType(void) const { return m_reportType; }
ERowType rowType(void) const { return m_rowType; }
EColumnType columnType(void) const { return m_columnType; }
bool isRunningSum(void) const { return (m_rowType==eAssetLiability); }
bool isConvertCurrency(void) const { return m_convertCurrency; }
unsigned columnPitch(void) const { return static_cast<unsigned>(m_columnType); }
bool isShowingColumnTotals(void) const { return m_convertCurrency; }
const TQString& comment( void ) const { return m_comment; }
EQueryColumns queryColumns(void) const { return m_queryColumns; }
const TQString& group( void ) const { return m_group; }
bool isFavorite(void) const { return m_favorite; }
bool isTax(void) const { return m_tax; }
bool isInvestmentsOnly(void) const { return m_investments; }
bool isLoansOnly(void) const { return m_loans; }
EDetailLevel detailLevel(void) const { return m_detailLevel; }
EChartType chartType(void) const { return m_chartType; }
bool isChartDataLabels(void) const { return m_chartDataLabels; }
bool isChartGridLines(void) const { return m_chartGridLines; }
bool isChartByDefault(void) const { return m_chartByDefault; }
uint chartLineWidth(void) const { return m_chartLineWidth; }
bool isIncludingSchedules(void) const { return m_includeSchedules; }
bool isColumnsAreDays(void) const { return m_columnsAreDays; }
bool isIncludingTransfers(void) const { return m_includeTransfers; }
bool isIncludingUnusedAccounts(void) const { return m_includeUnusedAccounts; }
bool hasBudget(void) const { return !m_budgetId.isEmpty(); }
const TQString& budget(void) const { return m_budgetId; }
bool isIncludingBudgetActuals(void) const { return m_includeBudgetActuals; }
bool isIncludingForecast(void) const { return m_includeForecast; }
bool isIncludingMovingAverage(void) const { return m_includeMovingAverage; }
int movingAverageDays(void) const { return m_movingAverageDays; }
bool isIncludingPrice(void) const { return m_includePrice; }
bool isIncludingAveragePrice(void) const { return m_includeAveragePrice; }
bool isUserDefined(void) const { return m_dateLock == userDefined; }
// Simple set operations
void setName(const TQString& _s) { m_name = _s; }
void setConvertCurrency(bool _f) { m_convertCurrency = _f; }
void setRowType(ERowType _rt);
void setColumnType(EColumnType _ct) { m_columnType = _ct; }
void setComment( const TQString& _comment ) { m_comment = _comment; }
void setGroup( const TQString& _group ) { m_group = _group; }
void setFavorite(bool _f) { m_favorite = _f; }
void setQueryColumns( EQueryColumns _qc ) { m_queryColumns = _qc; }
void setTax(bool _f) { m_tax = _f; }
void setInvestmentsOnly(bool _f) { m_investments = _f; if (_f) m_loans = false; }
void setLoansOnly(bool _f) { m_loans = _f; if (_f) m_investments = false; }
void setDetailLevel( EDetailLevel _detail ) { m_detailLevel = _detail; }
void setChartType ( EChartType _type ) { m_chartType = _type; }
void setChartDataLabels ( bool _f ) { m_chartDataLabels = _f; }
void setChartGridLines ( bool _f ) { m_chartGridLines = _f; }
void setChartByDefault ( bool _f ) { m_chartByDefault = _f; }
void setChartLineWidth ( uint _f ) { m_chartLineWidth = _f; }
void setIncludingSchedules( bool _f ) { m_includeSchedules = _f; }
void setColumnsAreDays( bool _f ) { m_columnsAreDays = _f; }
void setIncludingTransfers( bool _f ) { m_includeTransfers = _f; }
void setIncludingUnusedAccounts( bool _f ) { m_includeUnusedAccounts = _f; }
void setShowingRowTotals( bool _f ) { m_showRowTotals = _f; }
void setIncludingBudgetActuals( bool _f ) { m_includeBudgetActuals = _f; }
void setIncludingForecast( bool _f ) { m_includeForecast = _f; }
void setIncludingMovingAverage( bool _f ) { m_includeMovingAverage = _f; }
void setMovingAverageDays( int _days ) { m_movingAverageDays = _days; }
void setIncludingPrice( bool _f ) { m_includePrice = _f; }
void setIncludingAveragePrice( bool _f ) { m_includeAveragePrice = _f; }
/**
* Sets the budget used for this report
*
* @param _budget The ID of the budget to use, or an empty string
* to indicate a budget is NOT included
* @param _fa Whether to display actual data alongside the budget.
* Setting to false means the report displays ONLY the budget itself.
* @warning For now, the budget ID is ignored. The budget id is
* simply checked for any non-empty string, and if so, hasBudget()
* will return true.
*/
void setBudget( const TQString& _budget, bool _fa = true ) { m_budgetId = _budget; m_includeBudgetActuals=_fa; }
/**
* This method allows you to clear the underlying transaction filter
*/
void clear(void);
/**
* This method allows you to set the underlying transaction filter
*
* @param _filter The filter which should replace the existing transaction
* filter.
*/
void assignFilter(const MyMoneyTransactionFilter& _filter) { MyMoneyTransactionFilter::operator=(_filter); }
/**
* Set the underlying date filter and LOCK that filter to the specified
* range. For example, if @p _u is "CurrentMonth", this report should always
* be updated to the current month no matter when the report is run.
*
* This updating is not entirely automatic, you should update it yourself by
* calling updateDateFilter.
*
* @param _u The date range constant (MyMoneyTransactionFilter::dateRangeE)
* which this report should be locked to.
*/
void setDateFilter(dateOptionE _u)
{
m_dateLock = _u;
if (_u != userDefined)
MyMoneyTransactionFilter::setDateFilter( _u );
}
/**
* Set the underlying date filter using the start and end dates provided.
* Note that this does not LOCK to any range like setDateFilter(unsigned)
* above. It is just a reimplementation of the MyMoneyTransactionFilter
* version.
*
* @param _db The inclusive begin date of the date range
* @param _de The inclusive end date of the date range
*/
void setDateFilter(const TQDate& _db,const TQDate& _de) { MyMoneyTransactionFilter::setDateFilter( _db,_de ); }
/**
* Set the underlying date filter using the 'date lock' property.
*
* Always call this function before executing the report to be sure that
* the date filters properly match the plain-language 'date lock'.
*
* For example, if the report is date-locked to "Current Month", and the
* last time you loaded or ran the report was in August, but it's now
* September, this function will update the date range to be September,
* as is proper.
*/
void updateDateFilter(void) { if (m_dateLock != userDefined) MyMoneyTransactionFilter::setDateFilter(m_dateLock); }
/**
* Retrieves a VALID beginning & ending date for this report.
*
* The underlying date filter can return en empty TQDate() for either the
* begin or end date or both. This is typically unacceptable for reports,
* which need the REAL begin and end date.
*
* This function gets the underlying date filter range, and if either is
* an empty TQDate(), it determines the missing date from looking at all
* the transactions which match the underlying filter, and returning the
* date of the first or last transaction (as appropriate).
*
* @param _db The inclusive begin date of the date range
* @param _de The inclusive end date of the date range
*/
void validDateRange(TQDate& _db, TQDate& _de);
/**
* This method turns on the account group filter and adds the
* @p type to the list of allowed groups.
*
* Note that account group filtering is handled differently
* than all the filters of the underlying class. This filter
* is meant to be applied to individual splits of matched
* transactions AFTER the underlying filter is used to tqfind
* the matching transactions.
*
* @param type the account group to add to the allowed groups list
*/
void addAccountGroup(MyMoneyAccount::accountTypeE type);
/**
* This method returns whether an account group filter has been set,
* and if so, it returns all the account groups set in the filter.
*
* @param list list to append account groups into
* @return return true if an account group filter has been set
*/
bool accountGroups(TQValueList<MyMoneyAccount::accountTypeE>& list) const;
/**
* This method returns whether the specified account group
* is allowed by the account groups filter.
*
* @param type group to append account groups into
* @return return true if an account group filter has been set
*/
bool includesAccountGroup( MyMoneyAccount::accountTypeE type ) const;
/**
* This method is used to test whether a specific account
* passes the accountGroup test and either the Account or
* Category test, depending on which sort of Account it is.
*
* The m_tax and m_investments properties are also considered.
*
* @param acc the account in question
* @return true if account is in filter set, false otherwise
*/
bool includes( const MyMoneyAccount& acc ) const;
/**
* This method writes this report to the DOM element @p e,
* within the DOM document @p doc.
*
* @param e The element which should be populated with info from this report
* @param doc The document which we can use to create new sub-elements
* if needed
* @param anonymous Whether the sensitive parts of the report should be
* masked
*/
void write(TQDomElement& e, TQDomDocument *doc, bool anonymous=false) const;
/**
* This method reads a report from the DOM element @p e, and
* populates this report with the results.
*
* @param e The element from which the report should be read
*
* @return bool True if a report was successfully loaded from the
* element @p e. If false is returned, the contents of this report
* object are undefined.
*/
bool read(const TQDomElement& e);
/**
* This method creates a TQDomElement for the @p document
* under the tqparent node @p tqparent. (This version overwrites the
* MMObject base class.)
*
* @param document reference to TQDomDocument
* @param tqparent reference to TQDomElement tqparent node
*/
virtual void writeXML(TQDomDocument& document, TQDomElement& tqparent) const;
/**
* This method checks if a reference to the given object exists. It returns,
* a @p true if the object is referencing the one requested by the
* parameter @p id. If it does not, this method returns @p false.
*
* @param id id of the object to be checked for references
* @retval true This object references object with id @p id.
* @retval false This object does not reference the object with id @p id.
*/
virtual bool hasReferenceTo(const TQString& id) const;
private:
/**
* The user-assigned name of the report
*/
TQString m_name;
/**
* The user-assigned comment for the report, in case they want to make
* additional notes for themselves about the report.
*/
TQString m_comment;
/**
* Where to group this report amongst the others in the UI view. This
* should be assigned by the UI system.
*/
TQString m_group;
/**
* How much detail to show in the accounts
*/
enum EDetailLevel m_detailLevel;
/**
* Whether to convert all currencies to the base currency of the file (true).
* If this is false, it's up to the report generator to decide how to handle
* the currency.
*/
bool m_convertCurrency;
/**
* Whether this is one of the users' favorite reports
*/
bool m_favorite;
/**
* Whether this report should only include categories marked as "Tax"="Yes"
*/
bool m_tax;
/**
* Whether this report should only include investment accounts
*/
bool m_investments;
/**
* Whether this report should only include loan accounts
* Applies only to querytable reports. Mutually exclusive with
* m_investments.
*/
bool m_loans;
/**
* What sort of algorithm should be used to run the report
*/
enum EReportType m_reportType;
/**
* What sort of values should show up on the ROWS of this report
*/
enum ERowType m_rowType;
/**
* What sort of values should show up on the COLUMNS of this report,
* in the case of a 'PivotTable' report. Really this is used more as a
* QUANTITY of months or days. Whether it's months or days is determiend
* by m_columnsAreDays.
*/
enum EColumnType m_columnType;
/**
* Whether the base unit of columns of this report is days. Only applies to
* 'PivotTable' reports. If false, then columns are months or multiples thereof.
*/
bool m_columnsAreDays;
/**
* What sort of values should show up on the COLUMNS of this report,
* in the case of a 'QueryTable' report
*/
enum EQueryColumns m_queryColumns;
/**
* The plain-language description of what the date range should be locked
* to. 'userDefined' means NO locking, in any other case, the report
* will be adjusted to match the date lock. So if the date lock is
* 'currentMonth', the start and end dates of the underlying filter will
* be updated to whatever the current month is. This updating happens
* automatically when the report is loaded, and should also be done
* manually by calling updateDateFilter() before generating the report
*/
dateOptionE m_dateLock;
/**
* Which account groups should be included in the report. This filter
* is applied to the individual splits AFTER a transaction has been
* matched using the underlying filter.
*/
TQValueList<MyMoneyAccount::accountTypeE> m_accountGroups;
/**
* Whether an account group filter has been set (see m_accountGroups)
*/
bool m_accountGroupFilter;
/**
* What format should be used to draw this report as a chart
*/
enum EChartType m_chartType;
/**
* Whether the value of individual data points should be drawn on the chart
*/
bool m_chartDataLabels;
/**
* Whether grid lines should be drawn on the chart
*/
bool m_chartGridLines;
/**
* Whether this report should be shown as a chart by default (otherwise it
* should be shown as a textual report)
*/
bool m_chartByDefault;
/**
* Width of the chart lines
*/
uint m_chartLineWidth;
/**
* Whether to include scheduled transactions
*/
bool m_includeSchedules;
/**
* Whether to include transfers. Only applies to Income/Expense reports
*/
bool m_includeTransfers;
/**
* The id of the budget associated with this report.
*/
TQString m_budgetId;
/**
* Whether this report should print the actual data to go along with
* the budget. This is only valid if the report has a budget.
*/
bool m_includeBudgetActuals;
/**
* Whether this report should include all accounts and not only
* accounts with transactions.
*/
bool m_includeUnusedAccounts;
/**
* Whether this report should include columns for row totals
*/
bool m_showRowTotals;
/**
* Whether this report should include forecast balance
*/
bool m_includeForecast;
/**
* Whether this report should include moving average
*/
bool m_includeMovingAverage;
/**
* The amount of days that spans each moving average
*/
int m_movingAverageDays;
/**
* Whether this report should include prices
*/
bool m_includePrice;
/**
* Whether this report should include moving average prices
*/
bool m_includeAveragePrice;
};
#endif // MYMONEYREPORT_H