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.

318 lines
11 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 cStringIO import StringIO
  6. import xlsxwriter
  7. from odoo.addons.report_xlsx.report.report_xlsx import ReportXlsx
  8. class AbstractReportXslx(ReportXlsx):
  9. def __init__(self, name, table, rml=False, parser=False, header=True,
  10. store=False):
  11. super(AbstractReportXslx, self).__init__(
  12. name, table, rml, parser, header, store)
  13. # main sheet which will contains report
  14. self.sheet = None
  15. # columns of the report
  16. self.columns = None
  17. # row_pos must be incremented at each writing lines
  18. self.row_pos = None
  19. # Formats
  20. self.format_right = None
  21. self.format_right_bold_italic = None
  22. self.format_bold = None
  23. self.format_header_left = None
  24. self.format_header_center = None
  25. self.format_header_right = None
  26. self.format_header_amount = None
  27. self.format_amount = None
  28. self.format_percent_bold_italic = None
  29. def create_xlsx_report(self, ids, data, report):
  30. """ Overrides method to add constant_memory option used for large files
  31. """
  32. self.parser_instance = self.parser(
  33. self.env.cr, self.env.uid, self.name2, self.env.context)
  34. objs = self.getObjects(
  35. self.env.cr, self.env.uid, ids, self.env.context)
  36. self.parser_instance.set_context(objs, data, ids, 'xlsx')
  37. file_data = StringIO()
  38. workbook = xlsxwriter.Workbook(file_data, {'constant_memory': True})
  39. self.generate_xlsx_report(workbook, data, objs)
  40. workbook.close()
  41. file_data.seek(0)
  42. return (file_data.read(), 'xlsx')
  43. def generate_xlsx_report(self, workbook, data, objects):
  44. report = objects
  45. self.row_pos = 0
  46. self._define_formats(workbook)
  47. report_name = self._get_report_name()
  48. filters = self._get_report_filters(report)
  49. self.columns = self._get_report_columns(report)
  50. self.sheet = workbook.add_worksheet(report_name[:31])
  51. self._set_column_width()
  52. self._write_report_title(report_name)
  53. self._write_filters(filters)
  54. self._generate_report_content(workbook, report)
  55. def _define_formats(self, workbook):
  56. """ Add cell formats to current workbook.
  57. Those formats can be used on all cell.
  58. Available formats are :
  59. * format_bold
  60. * format_right
  61. * format_right_bold_italic
  62. * format_header_left
  63. * format_header_center
  64. * format_header_right
  65. * format_header_amount
  66. * format_amount
  67. * format_percent_bold_italic
  68. """
  69. self.format_bold = workbook.add_format({'bold': True})
  70. self.format_right = workbook.add_format({'align': 'right'})
  71. self.format_right_bold_italic = workbook.add_format(
  72. {'align': 'right', 'bold': True, 'italic': True}
  73. )
  74. self.format_header_left = workbook.add_format(
  75. {'bold': True,
  76. 'border': True,
  77. 'bg_color': '#FFFFCC'})
  78. self.format_header_center = workbook.add_format(
  79. {'bold': True,
  80. 'align': 'center',
  81. 'border': True,
  82. 'bg_color': '#FFFFCC'})
  83. self.format_header_right = workbook.add_format(
  84. {'bold': True,
  85. 'align': 'right',
  86. 'border': True,
  87. 'bg_color': '#FFFFCC'})
  88. self.format_header_amount = workbook.add_format(
  89. {'bold': True,
  90. 'border': True,
  91. 'bg_color': '#FFFFCC'})
  92. self.format_header_amount.set_num_format('#,##0.00')
  93. self.format_amount = workbook.add_format()
  94. self.format_amount.set_num_format('#,##0.00')
  95. self.format_percent_bold_italic = workbook.add_format(
  96. {'bold': True, 'italic': True}
  97. )
  98. self.format_percent_bold_italic.set_num_format('#,##0.00%')
  99. def _set_column_width(self):
  100. """Set width for all defined columns.
  101. Columns are defined with `_get_report_columns` method.
  102. """
  103. for position, column in self.columns.iteritems():
  104. self.sheet.set_column(position, position, column['width'])
  105. def _write_report_title(self, title):
  106. """Write report title on current line using all defined columns width.
  107. Columns are defined with `_get_report_columns` method.
  108. """
  109. self.sheet.merge_range(
  110. self.row_pos, 0, self.row_pos, len(self.columns) - 1,
  111. title, self.format_bold
  112. )
  113. self.row_pos += 3
  114. def _write_filters(self, filters):
  115. """Write one line per filters on starting on current line.
  116. Columns number for filter name is defined
  117. with `_get_col_count_filter_name` method.
  118. Columns number for filter value is define
  119. with `_get_col_count_filter_value` method.
  120. """
  121. col_name = 1
  122. col_count_filter_name = self._get_col_count_filter_name()
  123. col_count_filter_value = self._get_col_count_filter_value()
  124. col_value = col_name + col_count_filter_name + 1
  125. for title, value in filters:
  126. self.sheet.merge_range(
  127. self.row_pos, col_name,
  128. self.row_pos, col_name + col_count_filter_name - 1,
  129. title, self.format_header_left)
  130. self.sheet.merge_range(
  131. self.row_pos, col_value,
  132. self.row_pos, col_value + col_count_filter_value - 1,
  133. value)
  134. self.row_pos += 1
  135. self.row_pos += 2
  136. def write_array_title(self, title):
  137. """Write array title on current line using all defined columns width.
  138. Columns are defined with `_get_report_columns` method.
  139. """
  140. self.sheet.merge_range(
  141. self.row_pos, 0, self.row_pos, len(self.columns) - 1,
  142. title, self.format_bold
  143. )
  144. self.row_pos += 1
  145. def write_array_header(self):
  146. """Write array header on current line using all defined columns name.
  147. Columns are defined with `_get_report_columns` method.
  148. """
  149. for col_pos, column in self.columns.iteritems():
  150. self.sheet.write(self.row_pos, col_pos, column['header'],
  151. self.format_header_center)
  152. self.row_pos += 1
  153. def write_line(self, line_object):
  154. """Write a line on current line using all defined columns field name.
  155. Columns are defined with `_get_report_columns` method.
  156. """
  157. for col_pos, column in self.columns.iteritems():
  158. value = getattr(line_object, column['field'])
  159. cell_type = column.get('type', 'string')
  160. if cell_type == 'string':
  161. self.sheet.write_string(self.row_pos, col_pos, value or '')
  162. elif cell_type == 'amount':
  163. self.sheet.write_number(
  164. self.row_pos, col_pos, float(value), self.format_amount
  165. )
  166. self.row_pos += 1
  167. def write_initial_balance(self, my_object, label):
  168. """Write a specific initial balance line on current line
  169. using defined columns field_initial_balance name.
  170. Columns are defined with `_get_report_columns` method.
  171. """
  172. col_pos_label = self._get_col_pos_initial_balance_label()
  173. self.sheet.write(self.row_pos, col_pos_label, label, self.format_right)
  174. for col_pos, column in self.columns.iteritems():
  175. if column.get('field_initial_balance'):
  176. value = getattr(my_object, column['field_initial_balance'])
  177. cell_type = column.get('type', 'string')
  178. if cell_type == 'string':
  179. self.sheet.write_string(self.row_pos, col_pos, value or '')
  180. elif cell_type == 'amount':
  181. self.sheet.write_number(
  182. self.row_pos, col_pos, float(value), self.format_amount
  183. )
  184. self.row_pos += 1
  185. def write_ending_balance(self, my_object, name, label):
  186. """Write a specific ending balance line on current line
  187. using defined columns field_final_balance name.
  188. Columns are defined with `_get_report_columns` method.
  189. """
  190. for i in range(0, len(self.columns)):
  191. self.sheet.write(self.row_pos, i, '', self.format_header_right)
  192. row_count_name = self._get_col_count_final_balance_name()
  193. col_pos_label = self._get_col_pos_final_balance_label()
  194. self.sheet.merge_range(
  195. self.row_pos, 0, self.row_pos, row_count_name - 1, name,
  196. self.format_header_left
  197. )
  198. self.sheet.write(self.row_pos, col_pos_label, label,
  199. self.format_header_right)
  200. for col_pos, column in self.columns.iteritems():
  201. if column.get('field_final_balance'):
  202. value = getattr(my_object, column['field_final_balance'])
  203. cell_type = column.get('type', 'string')
  204. if cell_type == 'string':
  205. self.sheet.write_string(self.row_pos, col_pos, value or '',
  206. self.format_header_right)
  207. elif cell_type == 'amount':
  208. self.sheet.write_number(
  209. self.row_pos, col_pos, float(value),
  210. self.format_header_amount
  211. )
  212. self.row_pos += 1
  213. def _generate_report_content(self, workbook, report):
  214. pass
  215. def _get_report_name(self):
  216. """
  217. Allow to define the report name.
  218. Report name will be used as sheet name and as report title.
  219. :return: the report name
  220. """
  221. raise NotImplementedError()
  222. def _get_report_columns(self, report):
  223. """
  224. Allow to define the report columns
  225. which will be used to generate report.
  226. :return: the report columns as dict
  227. :Example:
  228. {
  229. 0: {'header': 'Simple column',
  230. 'field': 'field_name_on_my_object',
  231. 'width': 11},
  232. 1: {'header': 'Amount column',
  233. 'field': 'field_name_on_my_object',
  234. 'type': 'amount',
  235. 'width': 14},
  236. }
  237. """
  238. raise NotImplementedError()
  239. def _get_report_filters(self, report):
  240. """
  241. :return: the report filters as list
  242. :Example:
  243. [
  244. ['first_filter_name', 'first_filter_value'],
  245. ['second_filter_name', 'second_filter_value']
  246. ]
  247. """
  248. raise NotImplementedError()
  249. def _get_col_count_filter_name(self):
  250. """
  251. :return: the columns number used for filter names.
  252. """
  253. raise NotImplementedError()
  254. def _get_col_count_filter_value(self):
  255. """
  256. :return: the columns number used for filter values.
  257. """
  258. raise NotImplementedError()
  259. def _get_col_pos_initial_balance_label(self):
  260. """
  261. :return: the columns position used for initial balance label.
  262. """
  263. raise NotImplementedError()
  264. def _get_col_count_final_balance_name(self):
  265. """
  266. :return: the columns number used for final balance name.
  267. """
  268. raise NotImplementedError()
  269. def _get_col_pos_final_balance_label(self):
  270. """
  271. :return: the columns position used for final balance label.
  272. """
  273. raise NotImplementedError()