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.

398 lines
15 KiB

  1. # -*- coding: utf-8 -*-
  2. # Author: Julien Coux
  3. # Copyright 2016 Camptocamp SA
  4. # License AGPL-3.0 or later (http://www.gnu.org/licenses/agpl.html).
  5. from odoo.addons.report_xlsx.report.report_xlsx import ReportXlsx
  6. class AbstractReportXslx(ReportXlsx):
  7. def __init__(self, name, table, rml=False, parser=False, header=True,
  8. store=False):
  9. super(AbstractReportXslx, self).__init__(
  10. name, table, rml, parser, header, store)
  11. # main sheet which will contains report
  12. self.sheet = None
  13. # columns of the report
  14. self.columns = None
  15. # row_pos must be incremented at each writing lines
  16. self.row_pos = None
  17. # Formats
  18. self.format_right = None
  19. self.format_right_bold_italic = None
  20. self.format_bold = None
  21. self.format_header_left = None
  22. self.format_header_center = None
  23. self.format_header_right = None
  24. self.format_header_amount = None
  25. self.format_amount = None
  26. self.format_percent_bold_italic = None
  27. def get_workbook_options(self):
  28. return {'constant_memory': True}
  29. def generate_xlsx_report(self, workbook, data, objects):
  30. report = objects
  31. self.row_pos = 0
  32. self._define_formats(workbook)
  33. report_name = self._get_report_name()
  34. filters = self._get_report_filters(report)
  35. self.columns = self._get_report_columns(report)
  36. self.workbook = workbook
  37. self.set_sheet(self.add_sheet(workbook, report_name[:31]))
  38. self._set_column_width()
  39. self._write_report_title(report_name)
  40. self._write_filters(filters)
  41. self._generate_report_content(workbook, report)
  42. def add_sheet(self, workbook, sheet_name):
  43. return workbook.add_worksheet(sheet_name)
  44. def set_sheet(self, sheet):
  45. self.sheet = sheet
  46. def _define_formats(self, workbook):
  47. """ Add cell formats to current workbook.
  48. Those formats can be used on all cell.
  49. Available formats are :
  50. * format_bold
  51. * format_right
  52. * format_right_bold_italic
  53. * format_header_left
  54. * format_header_center
  55. * format_header_right
  56. * format_header_amount
  57. * format_amount
  58. * format_percent_bold_italic
  59. """
  60. self.format_bold = workbook.add_format({'bold': True})
  61. self.format_right = workbook.add_format({'align': 'right'})
  62. self.format_right_bold_italic = workbook.add_format(
  63. {'align': 'right', 'bold': True, 'italic': True}
  64. )
  65. self.format_header_left = workbook.add_format(
  66. {'bold': True,
  67. 'border': True,
  68. 'bg_color': '#FFFFCC'})
  69. self.format_header_center = workbook.add_format(
  70. {'bold': True,
  71. 'align': 'center',
  72. 'border': True,
  73. 'bg_color': '#FFFFCC'})
  74. self.format_header_right = workbook.add_format(
  75. {'bold': True,
  76. 'align': 'right',
  77. 'border': True,
  78. 'bg_color': '#FFFFCC'})
  79. self.format_header_amount = workbook.add_format(
  80. {'bold': True,
  81. 'border': True,
  82. 'bg_color': '#FFFFCC'})
  83. currency_id = self.env['res.company']._get_user_currency()
  84. self.format_header_amount.set_num_format(
  85. '#,##0.'+'0'*currency_id.decimal_places)
  86. self.format_amount = workbook.add_format()
  87. self.format_amount.set_num_format(
  88. '#,##0.'+'0'*currency_id.decimal_places)
  89. self.format_percent_bold_italic = workbook.add_format(
  90. {'bold': True, 'italic': True}
  91. )
  92. self.format_percent_bold_italic.set_num_format('#,##0.00%')
  93. def _set_column_width(self):
  94. """Set width for all defined columns.
  95. Columns are defined with `_get_report_columns` method.
  96. """
  97. self._set_columns_width(self.columns)
  98. def _set_columns_width(self, columns):
  99. """Set width for all defined columns.
  100. Columns are defined with `_get_report_columns` method.
  101. """
  102. for position, column in columns.iteritems():
  103. self.sheet.set_column(position, position, column['width'])
  104. def _write_report_title(self, title):
  105. """Write report title on current line using all defined columns width.
  106. Columns are defined with `_get_report_columns` method.
  107. """
  108. self.sheet.merge_range(
  109. self.row_pos, 0, self.row_pos, len(self.columns) - 1,
  110. title, self.format_bold
  111. )
  112. self.row_pos += 3
  113. def _write_filters(self, filters):
  114. """Write one line per filters on starting on current line.
  115. Columns number for filter name is defined
  116. with `_get_col_count_filter_name` method.
  117. Columns number for filter value is define
  118. with `_get_col_count_filter_value` method.
  119. """
  120. col_name = 1
  121. col_count_filter_name = self._get_col_count_filter_name()
  122. col_count_filter_value = self._get_col_count_filter_value()
  123. col_value = col_name + col_count_filter_name + 1
  124. for title, value in filters:
  125. self.sheet.merge_range(
  126. self.row_pos, col_name,
  127. self.row_pos, col_name + col_count_filter_name - 1,
  128. title, self.format_header_left)
  129. self.sheet.merge_range(
  130. self.row_pos, col_value,
  131. self.row_pos, col_value + col_count_filter_value - 1,
  132. value)
  133. self.row_pos += 1
  134. self.row_pos += 2
  135. def write_array_title(self, title):
  136. """Write array title on current line using all defined columns width.
  137. Columns are defined with `_get_report_columns` method.
  138. """
  139. self.sheet.merge_range(
  140. self.row_pos, 0, self.row_pos, len(self.columns) - 1,
  141. title, self.format_bold
  142. )
  143. self.row_pos += 1
  144. def write_array_header(self):
  145. """Write array header on current line using all defined columns name.
  146. Columns are defined with `_get_report_columns` method.
  147. """
  148. for col_pos, column in self.columns.iteritems():
  149. self.sheet.write(self.row_pos, col_pos, column['header'],
  150. self.format_header_center)
  151. self.row_pos += 1
  152. def write_line(self, line_object):
  153. """Write a line on current line using all defined columns field name.
  154. Columns are defined with `_get_report_columns` method.
  155. """
  156. self._write_line(self.columns, line_object)
  157. def _write_line(self, columns_descriptions, line_object):
  158. for col_pos, column in columns_descriptions.iteritems():
  159. value = getattr(line_object, column['field'])
  160. cell_type = column.get('type', 'string')
  161. if cell_type == 'string':
  162. self.sheet.write_string(self.row_pos, col_pos, value or '')
  163. elif cell_type == 'amount':
  164. self.sheet.write_number(
  165. self.row_pos, col_pos, float(value), self.format_amount
  166. )
  167. elif cell_type == 'amount_currency':
  168. if line_object.currency_id:
  169. format_amt = self._get_currency_amt_format(line_object)
  170. self.sheet.write_number(
  171. self.row_pos, col_pos, float(value), format_amt)
  172. elif cell_type == 'many2one':
  173. self.sheet.write_string(
  174. self.row_pos, col_pos, value.name or '', self.format_right)
  175. self.row_pos += 1
  176. def write_initial_balance(self, my_object, label):
  177. """Write a specific initial balance line on current line
  178. using defined columns field_initial_balance name.
  179. Columns are defined with `_get_report_columns` method.
  180. """
  181. col_pos_label = self._get_col_pos_initial_balance_label()
  182. self.sheet.write(self.row_pos, col_pos_label, label, self.format_right)
  183. for col_pos, column in self.columns.iteritems():
  184. if column.get('field_initial_balance'):
  185. value = getattr(my_object, column['field_initial_balance'])
  186. cell_type = column.get('type', 'string')
  187. if cell_type == 'string':
  188. self.sheet.write_string(self.row_pos, col_pos, value or '')
  189. elif cell_type == 'amount':
  190. self.sheet.write_number(
  191. self.row_pos, col_pos, float(value), self.format_amount
  192. )
  193. elif cell_type == 'amount_currency':
  194. if my_object.currency_id:
  195. format_amt = self._get_currency_amt_format(
  196. my_object)
  197. self.sheet.write_number(
  198. self.row_pos, col_pos,
  199. float(value), format_amt
  200. )
  201. elif column.get('field_currency_balance'):
  202. value = getattr(my_object, column['field_currency_balance'])
  203. cell_type = column.get('type', 'string')
  204. if cell_type == 'many2one':
  205. if my_object.currency_id:
  206. self.sheet.write_string(
  207. self.row_pos, col_pos, value.name or '',
  208. self.format_right
  209. )
  210. self.row_pos += 1
  211. def write_ending_balance(self, my_object, name, label):
  212. """Write a specific ending balance line on current line
  213. using defined columns field_final_balance name.
  214. Columns are defined with `_get_report_columns` method.
  215. """
  216. for i in range(0, len(self.columns)):
  217. self.sheet.write(self.row_pos, i, '', self.format_header_right)
  218. row_count_name = self._get_col_count_final_balance_name()
  219. col_pos_label = self._get_col_pos_final_balance_label()
  220. self.sheet.merge_range(
  221. self.row_pos, 0, self.row_pos, row_count_name - 1, name,
  222. self.format_header_left
  223. )
  224. self.sheet.write(self.row_pos, col_pos_label, label,
  225. self.format_header_right)
  226. for col_pos, column in self.columns.iteritems():
  227. if column.get('field_final_balance'):
  228. value = getattr(my_object, column['field_final_balance'])
  229. cell_type = column.get('type', 'string')
  230. if cell_type == 'string':
  231. self.sheet.write_string(self.row_pos, col_pos, value or '',
  232. self.format_header_right)
  233. elif cell_type == 'amount':
  234. self.sheet.write_number(
  235. self.row_pos, col_pos, float(value),
  236. self.format_header_amount
  237. )
  238. elif cell_type == 'amount_currency':
  239. if my_object.currency_id:
  240. format_amt = self._get_currency_amt_header_format(
  241. my_object)
  242. self.sheet.write_number(
  243. self.row_pos, col_pos,
  244. float(value), format_amt
  245. )
  246. elif column.get('field_currency_balance'):
  247. value = getattr(my_object, column['field_currency_balance'])
  248. cell_type = column.get('type', 'string')
  249. if cell_type == 'many2one':
  250. if my_object.currency_id:
  251. self.sheet.write_string(
  252. self.row_pos, col_pos, value.name or '',
  253. self.format_header_right)
  254. self.row_pos += 1
  255. def _get_currency_amt_format(self, line_object):
  256. """ Return amount format specific for each currency. """
  257. format_amt = getattr(self, 'format_amount')
  258. if line_object.currency_id:
  259. field_name = \
  260. 'format_amount_%s' % line_object.currency_id.name
  261. if hasattr(self, field_name):
  262. format_amt = getattr(self, field_name)
  263. else:
  264. format_amt = self.workbook.add_format()
  265. setattr(self, 'field_name', format_amt)
  266. format_amount = \
  267. '#,##0.' + ('0' * line_object.currency_id.decimal_places)
  268. format_amt.set_num_format(format_amount)
  269. return format_amt
  270. def _get_currency_amt_header_format(self, line_object):
  271. """ Return amount header format for each currency. """
  272. format_amt = getattr(self, 'format_header_amount')
  273. if line_object.currency_id:
  274. field_name = \
  275. 'format_header_amount_%s' % line_object.currency_id.name
  276. if hasattr(self, field_name):
  277. format_amt = getattr(self, field_name)
  278. else:
  279. format_amt = self.workbook.add_format(
  280. {'bold': True,
  281. 'border': True,
  282. 'bg_color': '#FFFFCC'})
  283. setattr(self, 'field_name', format_amt)
  284. format_amount = \
  285. '#,##0.' + ('0' * line_object.currency_id.decimal_places)
  286. format_amt.set_num_format(format_amount)
  287. return format_amt
  288. def _generate_report_content(self, workbook, report):
  289. pass
  290. def _get_report_name(self):
  291. """
  292. Allow to define the report name.
  293. Report name will be used as sheet name and as report title.
  294. :return: the report name
  295. """
  296. raise NotImplementedError()
  297. def _get_report_columns(self, report):
  298. """
  299. Allow to define the report columns
  300. which will be used to generate report.
  301. :return: the report columns as dict
  302. :Example:
  303. {
  304. 0: {'header': 'Simple column',
  305. 'field': 'field_name_on_my_object',
  306. 'width': 11},
  307. 1: {'header': 'Amount column',
  308. 'field': 'field_name_on_my_object',
  309. 'type': 'amount',
  310. 'width': 14},
  311. }
  312. """
  313. raise NotImplementedError()
  314. def _get_report_filters(self, report):
  315. """
  316. :return: the report filters as list
  317. :Example:
  318. [
  319. ['first_filter_name', 'first_filter_value'],
  320. ['second_filter_name', 'second_filter_value']
  321. ]
  322. """
  323. raise NotImplementedError()
  324. def _get_col_count_filter_name(self):
  325. """
  326. :return: the columns number used for filter names.
  327. """
  328. raise NotImplementedError()
  329. def _get_col_count_filter_value(self):
  330. """
  331. :return: the columns number used for filter values.
  332. """
  333. raise NotImplementedError()
  334. def _get_col_pos_initial_balance_label(self):
  335. """
  336. :return: the columns position used for initial balance label.
  337. """
  338. raise NotImplementedError()
  339. def _get_col_count_final_balance_name(self):
  340. """
  341. :return: the columns number used for final balance name.
  342. """
  343. raise NotImplementedError()
  344. def _get_col_pos_final_balance_label(self):
  345. """
  346. :return: the columns position used for final balance label.
  347. """
  348. raise NotImplementedError()