构建“管理信息系统”报告和仪表板
项目描述
此模块允许您构建管理信息系统仪表板。这种风格的报告以行表示 KPI,以列表示时间段。报告主要从账户移动中获取数据,但也可以组合来自任意 Odoo 模型的数据。报告可以导出为 PDF、Excel,也可以添加到 Odoo 仪表板。
目录
<nav class="contents local" id="contents" role="doc-toc">安装
您安装插件的首选方式将与 MIS Builder 一起使用。
使用 pip 安装它及其所有依赖项的一种简单方法是:
pip install --pre odoo11-addon-mis_builder
然后重新启动 Odoo,更新数据库中的插件列表,并安装 MIS Builder 应用程序。
用法
要配置此模块,您需要:
转到会计 > 配置 > MIS 报告 > MIS 报告模板,您可以在其中通过定义 KPI 来创建报告模板。KPI 构成报告的行。此类报告模板与时间无关。
然后在会计 > 报告 > MIS 报告 > MIS 报告中,您可以通过将模板绑定到时间段来创建报告实例,从而定义报告的列。
从 MIS 报告视图中,您可以预览报告,将其添加到 Odoo 仪表板,并将其导出为 PDF 或 Excel。
发展
一个典型的扩展是提供一种机制来过滤分析维度或操作单元的报告。要实现这一点,您可以覆盖 _get_additional_move_line_filter 和 _get_additional_filter 以根据用户选择进一步过滤移动线或查询。一个典型的用例可能是在 mis.report.instance 上添加一个分析帐户字段,如果您希望不同的列显示不同的分析帐户,甚至可以在 mis.report.instance.period 上添加一个分析帐户字段。
已知问题/路线图
变更日志
11.0.3.6.9 (2022-07-19)
Bug修复
支持没有时区的用户。(#388)
11.0.3.6.8 (2022-07-19)
Bug修复
允许删除具有子报表的报表。(#431)
11.0.3.6.5 (2021-04-23)
Bug修复
在自定义帐户模型时修复向下钻取操作名称。(#350)
11.0.3.6.4 (2020-11-05)
特征
面包屑上显示的向下钻取操作名称已修改。显示的是 kpi 描述和帐户display_name,而不是 kpi 的技术定义。(#304)
11.0.3.6.3 (2020-08-28)
Bug修复
在 KPI 上添加“比较列”以及使用因子/分隔符的关联样式确实导致在导出到 XLSX 时将所述因子应用于百分比。(#300)
杂项
11.0.3.6.2 (2020-04-22)
Bug修复
现在,“设置”按钮会在预览报告时为具有“显示完整会计功能”的用户显示。(#281)
11.0.3.6.1 (2020-04-22)
Bug修复
修复TypeError: 'module' 对象在按帐户使用预算时不可迭代。(#276)
11.0.3.6.0 (2020-03-28)
特征
11.0.3.5.0 (2019-10-26)
特征
在 Period 表单的“Move lines source”中选择的模型的account_id字段现在可以与任何具有代码字段的模型(不仅是 account.account模型)是 Many2one 关系。为此,可以在报表模板上配置用于实际移动线的模型。它可以是移动线以外的东西,唯一的限制是它的account_id字段有一个代码字段。(#149)
添加source_aml_model_name字段,以便提供替代数据源的扩展模块可以更轻松地自定义其数据源。(#214)
在后端视图和预览小部件中支持分析标签过滤器。在过滤器中选择多个标签意味着过滤设置了所有这些标签的移动线。这是为了支持将标签用于不同维度的最常见用例。该过滤器还与分析帐户过滤器进行 AND。(#228)
在多公司模式下在帐户详细信息行中显示公司。(#242)
Bug修复
将上下文传播到 xlsx 报告,因此分析帐户过滤器在导出到 xslx 时也可以工作。这也需要修复 report_xlsx(参见https://github.com/OCA/reporting-engine/pull/259)。(#178)
在 Sum 类型的列中,保留不可求和的 KPI 的样式(例如百分比值)。在此修复之前,此类单元格的显示没有样式。(#219)
在 Excel 导出中,保留百分比后缀 (pp) 而不是用 % 替换它。(#220)
11.0.3.4.0 (2019-07-09)
特征
用于定义期间的新年初至今模式。(#165)
添加对带有负借方或贷方的移动行的支持。被一些人用于 storno 会计。没有官方支持。(#175)
在 Excel 导出中,使用带有千位分隔符的数字格式。使用的特定分隔符取决于 Excel 配置(例如区域设置)。(#190)
在 XLS 导出结束时添加生成日期/时间。(#191)
在存在子 KPI 的情况下,当非多表达式产生长度不正确的元组时,报告更多信息性用户错误。(#196)
Bug修复
修复 Excel 导出中百分比类型的呈现。(#192)
11.0.3.3.0 (2019-01-26)
特征
报表预览中的动态分析过滤器在 11 中尚不可用,这需要对迄今为止难以实现的 JS 小部件进行更新。欢迎帮助。
分析帐户过滤器。在报告中,可以选择分析帐户进行过滤。过滤器将应用于移动线查询。小部件中还提供了一个过滤器框,让用户在报告预览期间选择分析帐户。(#15)
控制小部件中分析过滤器组合框的可见性。这对于隐藏报表上没有意义的分析过滤器很有用,例如资产负债表报表。(#42)
在导出的 pdf 和 xls 的标题中显示分析过滤器。(#44)
用 fontawesome 图标替换最后的旧 gtk 图标。(#104)
在 AEP 查询中使用 active_test=False。这对于涉及非活动税的报告很重要。这不会对现有报告产生负面影响,因为会计报告必须考虑所有现有的移动行,即使它们引用了自创建以来已停用的税收、日记帐、帐户类型等对象。(#107)
对 AccountingNone 的 int()、float() 和 round() 支持。(#108)
允许通过在表达式中写入kpi_x.subkpi_y来按名称引用 subkpi 。(#114)
添加一个选项来控制列标题中开始/结束日期的显示。默认情况下它被禁用(与以前的行为相比,这是一个变化)。(#118)
将评估方法添加到 mis.report。这是在一段时间内评估报告的 kpi 的简化方法,无需创建 mis.report.instance。(#123)
错误
在样式的形式中,当所有其他Syle元素检查“隐藏始终继承”时,请隐藏“隐藏”复选框。(#121)
从 3.2 升级(重大更改)
如果您将实际(替代)数据源与分析过滤器结合使用,则基础模型现在必须具有analytic_account_id字段。
11.0.3.2.2 (2018-06-30)
11.0.3.2.1 (2018-05-29)
[修复] AccountingNone 缺少比较运算符导致 pbal 计算错误 ( #93 )
10.0.3.2.0 (2018-05-02)
11.0.3.1.2 (2018-02-04)
迁移到 Odoo 11。没有新功能。(#67)
10.0.3.1.1 (2017-11-14)
新的功能:
[添加] 月份和年份相对时间段,比最常见情况下的日期范围更易于使用。(#2)
【新增】在移动线域的评估上下文中提供ref、datetime、dateutil、time、user;除其他外,这允许在查询移动行 ( #26 )时使用对 xml id 的引用(例如帐户类型或税标签)。
[添加] 扩展帐户选择器:您现在可以使用 account.account 上的任何域选择帐户,而不仅仅是帐户代码 balp[('user_type_id', '=', ref('account.data_account_type_receivable').id)] ( #4)。
[IMP] 在报告实例配置表单中,过滤器现在分组在笔记本页面中,这提高了可读性和可扩展性(#39)。
Bug修复:
从 3.0 升级(重大更改):
备选移动线数据源必须有 company_id 字段。
10.0.3.0.4 (2017-10-14)
错误修复:
[修复] 初始余额四舍五入的问题。 #30
10.0.3.0.3 (2017-10-03)
错误修复:
[FIX] 修复在新创建的报告中保存 KPI 的错误。 #18
10.0.3.0.2 (2017-10-01)
新的功能:
[添加] 每个报告列的替代移动线源。这使得 mis buidler 会计表达式适用于任何具有借方、贷方、account_id 和日期字段的模型。假设您可以将承诺的购买或预算作为借方、贷方和 account_id 的视图公开,这会带来很多可能性
[添加] 比较列源(比以前更灵活,现已弃用的比较机制)。警告:没有自动迁移到新机制。
[添加] 求和列源,以创建添加/减去其他列的列。
[添加] mis.kpi.data 抽象模型作为手动KPI值的基础,支持自动调整到报告时间段(预算项目的基础,但也可以用于其他目的,例如手动输入一些KPI值,例如数字员工)
[添加] mis_builder_budget 模块提供新的预算数据源
[添加] 新的“隐藏空”样式属性
[IMP] 新的 AEP 方法来获取涉及表达式的帐户(这有助于查找与给定损益帐户相关的 KPI,以实现预算控制)
[IMP] 许多 UI 改进
[IMP] 许多代码样式改进和一些重构
[IMP] 在表达式评估上下文中添加 date_from、date_to 列,以及 time、datetime 和 dateutil 模块
主要错误修复:
[FIX] 删除模板和报告(级联和限制)(https://github.com/OCA/account-financial-reporting/issues/281)
[修复] 报告副本 ( https://github.com/OCA/account-financial-reporting/issues/282 )
[FIX] 当期间有错误/缺失日期时更好的错误消息(https://github.com/OCA/account-financial-reporting/issues/283)
[FIX] 字符串类型 KPI 的 xlsx 导出(https://github.com/OCA/account-financial-reporting/issues/285)
[FIX] 按账户分类明细
[修复] KPI中使用多个会计表达式时,按帐户详细计算错误
[修复] 使用非管理员用户将报告添加到仪表板时的权限问题
10.0.2.0.3(未发布)
[IMP] 在缺少表达式的情况下更稳健的行为
[FIX] 缩进样式
[FIX] 生成没有对象的报告时,在赋值之前引用了局部变量 'ctx'
[IMP] 使用 fontawesome 图标
[MIG] 迁移到 10.0
[FIX] 导出到 Excel 时出现 unicode 错误
[IMP] 为 group Adviser 提供对 mis builder 样式的完全访问权限。
9.0.2.0.2 (2016-09-27)
[IMP] 在错误报告预览中添加刷新按钮。
[IMP] 小部件代码更改以允许更轻松地在小部件中添加字段。
9.0.2.0.1 (2016-05-26)
[IMP] 删除 declare_and_compute_period() 中未使用的参数以获得更简洁的 API。这是一个在其他模块使用之前紧急合并的破坏性 API 更改。
9.0.2.0.0 (2016-05-24)
此版本的部分工作已在 2016 年 4 月 26 日至 29 日的 Sorrento sprint 中完成。其余的(即重大重构)已在之后的几周内完成。
[IMP] 在报表实例设置表单的编辑模式下隐藏按钮框
[FIX] 修复非存储字段的总和聚合 ( https://github.com/OCA/account-financial-reporting/issues/178 )
[IMP] 报表级别现在有默认样式
[CHG] 数字显示属性(舍入、前缀、后缀、因子)现在在样式中定义
[CHG] 百分比差异舍入到 1 位而不是 kpi 的舍入,因为在这种情况下 KPI 舍入没有意义
[CHG] 分隔符后缀(k、M 等)不再自动插入,因为它在使用前缀时不一致;您需要在后缀中手动添加它
[IMP] AccountingExpressionProcessor 现在支持 'balu' 表达式来获取以前会计年度的未分配损益;get_unallocated_pl 是对应的便捷方法
[IMP] AccountingExpressionProcessor 现在有按账户获取余额的简单方法:get_balances_initial、get_balances_end、get_balances_variation
[IMP] 现在有一个自动扩展功能,可以按帐户自动显示所选 kpi 的详细信息
[IMP] 现在通过表单而不是直接在树视图中操作 kpi 和周期列表
[IMP] 现在可以通过向导创建报告,此类报告被视为临时报告,可通过“上次生成的报告”菜单获得,它们被自动收集,除非永久保存,可以使用“保存”按钮完成
[IMP] 现在有一种初学者模式可以配置只有一个句点的简单报告
[IMP] 现在更容易配置具有固定开始/结束日期的期间
[IMP] 新的 sub-kpi 机制允许创建具有多个值的列,或者具有不同值的列
[IMP] 由于新的样式模型,现在 Excel 导出样式
[IMP] 一种新的样式模型现在用于集中样式配置
[FIX] 使用 =like 而不是 like 来搜索帐户,因为 % 是用户在表达式中添加的
[修复] 正确计算基于财政年度开始的收支账户初始余额
[IMP] 支持日期范围(来自 OCA/server-tools/date_range)作为会计期间的更灵活替代方案
v9 迁移:财务期间已删除,会计科目表已删除,合并科目已删除
8.0.1.0.0 (2016-04-27)
MIS 报告实例的副本现在复制期间。 https://github.com/OCA/account-financial-reporting/pull/181
MIS 报告模板的副本现在复制 KPI 和查询。 https://github.com/OCA/account-financial-reporting/pull/177
可用性:MIS 报表实例的默认视图现在是呈现的预览,并且可以通过列表视图中的齿轮图标和预览中的按钮访问设置。 https://github.com/OCA/account-financial-reporting/pull/170
没有数据时显示空白单元格而不是 0.0。 https://github.com/OCA/account-financial-reporting/pull/169
可用性:MIS 报告期间设置在小屏幕上的更好布局。 https://github.com/OCA/account-financial-reporting/pull/167
在 MIS Builder 小部件中包含下载按钮,并重构小部件以在预览中打开分析过滤的大门。 https://github.com/OCA/account-financial-reporting/pull/151
添加 KPI 呈现前缀(以便您可以在值前面打印 $)。 https://github.com/OCA/account-financial-reporting/pull/158
添加用于分析过滤的钩子。 https://github.com/OCA/account-financial-reporting/pull/128 https://github.com/OCA/account-financial-reporting/pull/131
8.0.0.2.0
史前。或者更确切地说,您需要查看 git 日志。
错误追踪器
在GitHub 问题上跟踪错误。如果遇到问题,请检查您的问题是否已被报告。如果您首先发现它,请通过提供详细且受欢迎的 反馈来帮助我们粉碎它。
不要就技术问题的支持或帮助直接联系贡献者。
学分
贡献者
斯蒂芬·比杜尔 < 斯蒂芬· . 比杜尔@acsone 。 _ 欧盟>
Laetitia Gangloff < laetitia . gangloff @ acsone 。欧盟>
阿德里安·佩弗 <阿德里安. 佩弗@acsone 。_ 欧盟>
亚历克西斯·德·拉特雷 < 亚历克西斯. 德拉特@akretion 。_ com >
亚历山大·法约尔 <亚历山大. 法约尔@camptocamp 。com >
乔迪·巴列斯特 < jordi . 芭蕾舞者@高效。com >
托马斯·宾斯菲尔德 <托马斯. 宾斯菲尔德@gmail 。com >
乔瓦尼卡帕尔博<乔瓦尼@therp 。nl >
塞巴斯蒂安博 <塞巴斯蒂安. 美女@akretion 。_ com >
洛朗·米尼翁 <洛朗。米尼翁@acsone 。_ 欧盟>
吕克·德迈耶 < luc . 德迈耶@noviat 。 _ com >
本杰明威利格 <本杰明. 威利格@acsone 。 _ 欧盟>
Martronic SA <信息@martronic 。ch >
nicomacr < nmr @ adhoc 。com 。阿尔>
胡安·何塞·斯卡拉菲亚 < jjs @ adhoc 。com 。阿尔>
埃里克·考达尔 <埃里克。尾部@ elico-corp 。com >
安德里亚·斯蒂普 <一个。斯蒂普@onestein 。 _ nl >
Maxence Groine < mgroine @ fiefmanage 。ch >
Arnaud Pineux <阿尔诺。松树@acsone 。_ 欧盟>
埃内斯托·特赫达 <埃内斯托. tejeda @ tecnativa 。com >
Pedro M. Baeza <佩德罗. baeza @ tecnativa 。com >
-
阿列克谢·佩雷赫 < alexey . 佩雷赫@corphub 。 _ 欧盟>
维护者
该模块由 OCA 维护。
OCA 或 Odoo 社区协会是一个非营利组织,其使命是支持 Odoo 功能的协作开发并促进其广泛使用。
当前维护者:
该模块是GitHub 上OCA/mis-builder项目的一部分。
欢迎您贡献。要了解如何,请访问https://odoo-community.org/page/Contribute。