跳转到主要内容

构建“管理信息系统”报告和仪表板

项目描述

Production/Stable License: AGPL-3 OCA/mis-builder Translate me on Weblate Try me on Runbot

此模块允许您构建管理信息系统的仪表板。这种风格的报告将KPI显示在行中,时间周期显示在列中。报告主要从会计分录中获取数据,但也可以结合来自任意Odoo模型的数据。报告可以导出为PDF、Excel,并且可以添加到Odoo仪表板中。

目录

安装

您首选的安装插件方式将与MIS Builder一起工作。

使用pip安装它的所有依赖项的一种简单方法是

  • pip install --pre odoo12-addon-mis_builder

  • 然后重启Odoo,更新数据库中的插件列表,并安装MIS Builder应用程序。

使用

要配置此模块,您需要

  • 转到会计 > 配置 > MIS报告 > MIS报告模板,您可以在其中通过定义KPI创建报告模板。KPI构成了您报告的行。此类报告模板是时间无关的。

Sample report template
  • 然后在会计 > 报告 > MIS报告 > MIS报告,您可以通过将模板绑定到时间周期来创建报告实例,从而定义您报告的列。

Sample report configuration
  • 从MIS报告视图,您可以预览报告,将其添加到Odoo仪表板,并将其导出为PDF或Excel。

Sample preview

开发

通常的扩展是提供一个机制来过滤分析维度或操作单元的报告。为了实现这一点,你可以重写_get_additional_move_line_filter和_get_additional_filter方法,以便根据用户的选择进一步过滤行或查询。一个典型的用例可能是向mis.report.instance添加分析账户字段,或者如果你想让不同的列显示不同的分析账户,甚至可以在mis.report.instance.period中添加。

已知问题/路线图

mis_builder的路线图已知问题可以在GitHub上找到。

变更日志

13.0.4.0.8 (2022-07-19)

错误修复

  • 支持没有时区的用户。(#388

13.0.4.0.7 (2022-07-19)

错误修复

  • 允许删除包含子报告的报告。(#431

13.0.4.0.0 (2022-01-07)

功能

  • 移除各种字段大小限制。(#332

错误修复

  • 支持Odoo 13+多公司模型。在多公司模式下,可以在MIS报告实例中声明多个允许的公司,报告将在报告公司和用户上下文中选择的公司交集上运行。(#327

  • evaluate()的get_additional_query_filter参数现在正确传播。(#375

  • 使用account.move.line的parent_state字段来仅过滤已发布和草稿状态下的条目。之前,在草稿模式下报告时,使用所有条目(即没有过滤),并开始包括Odoo 13.+中的已取消条目/发票。

    此更改还包含内部API中的重大更改。相当长一段时间以来,AEP和其他方法的target_move参数未被MIS Builder本身使用,而是保留以保持向后兼容性。为了避免使用parent_state的必要更改的连锁反应,我们现在删除此参数。(#377

13.0.3.7.2 (2021-04-23)

错误修复

  • 当账户模型已被定制时,修复了钻取操作名称。(#350

13.0.3.7.1 (2021-04-23)

错误修复

  • 在复制MIS报告实例时,比较列被忽略,因为否则会引发错误,因为它们保留了原始记录中的旧source_cmpcol_from_id和source_cmpcol_to_id。(#343

13.0.3.7.0 (2021-02-11)

功能

  • 在报告实例、期间和交互视图中添加分析分组过滤器。(#320

13.0.3.6.4 (2020-11-05)

功能

  • 在面包屑上显示的钻取操作名称已被修订。现在显示KPI描述和账户display_name,而不是KPI的技术定义。(#304

13.0.3.6.3 (2020-08-28)

错误修复

  • 在KPI上添加“比较列”,并使用因子/分隔符关联样式时,会导致该因子在导出到XLSX时应用于百分比。(#300

杂项

13.0.3.6.2 (2020-04-22)

错误修复

  • 当预览报告时,对于具有“显示完整会计功能”权限的用户,现在显示“设置”按钮。(#281

13.0.3.6.1 (2020-04-22)

错误修复

  • 修复使用账户预算时的TypeError: 'module' object is not iterable错误。(#276

13.0.3.6.0 (2020-03-28)

功能

  • 在分析账户和分析标签上添加列级过滤器。这些过滤器与报告级过滤器进行AND组合,并且在预览中不能修改。(#138

  • 在KPI表达式中从其他报告中访问KPI,即子报告。在报告模板中,可以列出名为“子报告”(其他报告模板)。在评估表达式时,您可以使用点前缀符号访问子报告的KPI。例如:您可以定义一个针对“资产负债表”的MIS报告,然后有一个名为“资产负债表比率”的另一个MIS报告,该报告从“资产负债表”中获取KPI以创建新的比率KPI(例如,balance_sheet.current_assets / balance_sheet.total_assets)。(《https://github.com/OCA/mis-builder/issues/155》#155)

13.0.3.5.0 (2020-01-??)

迁移到odoo 13.0。

12.0.3.5.0 (2019-10-26)

功能

  • 在“期间表”中的“移动行来源”中选定的模型的account_id字段现在可以是与任何具有code字段的模型(不仅仅是account.account模型)的Many2one关系。为此,可以在报告模板上配置用于实际移动行线的模型。它可以是除移动行线之外的其他内容,唯一约束是其account_id字段有一个code字段。(《https://github.com/oca/mis-builder/issues/149》#149)

  • 添加source_aml_model_name字段,以便提供替代数据源的扩展模块可以更容易地自定义其数据源。(《https://github.com/oca/mis-builder/issues/214》#214)

  • 支持后端视图和预览小部件中的分析标签过滤器。在过滤器中选择多个标签意味着过滤具有所有这些标签设置的移动行。这是为了支持使用标签对不同维度进行的最常见用法。过滤器还与分析账户过滤器进行AND操作。(《https://github.com/oca/mis-builder/issues/228》#228)

  • 在多公司模式下,在账户详情行中显示公司。(《https://github.com/oca/mis-builder/issues/242》#242)

错误修复

  • 将上下文传播到xlsx报告,以便在导出到xslx时分析账户过滤器也能正常工作。这还需要对report_xlsx进行修复(见《https://github.com/OCA/reporting-engine/pull/259》https://github.com/OCA/reporting-engine/pull/259)(《https://github.com/oca/mis-builder/issues/178》#178)

  • 在求和类型的列中,保留非可求和的KPI(例如,百分比值)的样式。在此修复之前,此类单元格显示时没有样式。(《https://github.com/oca/mis-builder/issues/219》#219)

  • 在Excel导出中,保留百分比点后缀(pp)而不是将其替换为%。(《https://github.com/oca/mis-builder/issues/220》#220)

12.0.3.4.0 (2019-07-09)

功能

  • 为定义期间添加新的年度至今模式。(《https://github.com/oca/mis-builder/issues/165》#165)

  • 添加对具有负借方或贷方移动行的支持。某些人使用storno会计。不支持。(《https://github.com/oca/mis-builder/issues/175》#175)

  • 在Excel导出中使用带千位分隔符的数字格式。使用的具体分隔符取决于Excel配置(例如,区域设置)。(《https://github.com/oca/mis-builder/issues/190》#190)

  • 在XLS导出的末尾添加生成日期/时间。(《https://github.com/oca/mis-builder/issues/191》#191)

  • 在存在子KPI的情况下,当非多表达式产生长度不正确的元组时,报告更有用的用户错误。(《https://github.com/oca/mis-builder/issues/196》#196)

错误修复

  • 修复Excel导出中百分比类型的渲染。(《https://github.com/oca/mis-builder/issues/192》#192)

12.0.3.3.0 (2019-01-26)

功能

在报告预览中,动态分析过滤器在11中尚不可用,这需要更新JS小部件,迄今为止这很困难。欢迎提供帮助。

  • 分析账户过滤器。在报告中,可以选择分析账户进行过滤。该过滤器将应用于移动行查询。在预览报告中,小部件中也提供了一个过滤器框,以便用户在预览报告期间选择分析账户。(《https://github.com/oca/mis-builder/issues/15》#15)

  • 控制小部件中分析过滤器组合框的可见性。这对于在分析过滤器在报告中没有意义的情况下隐藏它们很有用,例如资产负债表报告。(《https://github.com/oca/mis-builder/issues/42》#42)

  • 在导出的PDF和XLS文件头部显示分析过滤器。(#44

  • 将最后一个旧gtk图标替换为fontawesome图标。(#104

  • 在AEP查询中使用active_test=False。这对于涉及非活动税的报告很重要。这不应负面影响现有报告,因为会计报告必须考虑到所有现有的移动行,即使它们引用的对象,如税、日记账、账户类型,自创建以来已被停用。(#107

  • 为AccountingNone提供int()、float()和round()支持。(#108

  • 允许通过在表达式中写入kpi_x.subkpi_y来按名称引用子KPI。(#114

  • 添加一个选项来控制列头中显示的开始/结束日期。默认情况下是禁用的(与以前的行为相比这是一个变化)。(#118

  • 将评估方法添加到mis.report。这是一个简化方法,用于评估报告在一段时间内的KPI,而无需创建mis.report.instance。(#123

错误

  • 在样式表单中,当“始终隐藏继承”被选中时,隐藏“始终隐藏”复选框,就像所有其他样式元素一样。(#121 <https://github.com/OCA/mis-builder/pull/121>

从3.2升级(破坏性更改)

如果您使用Actuals (alternative)数据源与分析过滤器结合使用,则底层模型现在必须有一个analytic_account_id字段。

11.0.3.2.2 (2018-06-30)

  • [修正] 修正公司_default_get调用返回id而不是recordset的错误(#103

  • [改进] 添加“始终隐藏”样式属性,以隐藏KPI(对于作为其他公式基础的KPI,但不需要显示)。(#46

11.0.3.2.1 (2018-05-29)

  • [修正] AccountingNone缺少比较运算符,导致pbal计算错误(#93

10.0.3.2.0 (2018-05-02)

  • [修正] 使子KPI排序确定性(#71

  • [新增] 在mis.report实例级别添加禁用账户展开的选项,以便在报告实例中推迟是否渲染详细信息的决策,从而创建详细模板(#74

  • [新增] 添加pbal和nbal会计表达式,分别求正负余额之和(即忽略负余额,分别忽略正余额的账户)(#86

11.0.3.1.2 (2018-02-04)

迁移到Odoo 11。没有新功能。(#67

10.0.3.1.1 (2017-11-14)

新功能

  • [新增] 添加月份和年份相对期间,比日期范围更容易使用,适用于大多数情况。(#2

  • [新增] 多公司合并支持,包括货币转换(转换率日期是报告期末)(#7#3

  • [新增] 在移动行域的评估上下文中提供ref、datetime、dateutil、time、user;例如,当查询移动行时,这允许使用对xml id的引用(如账户类型或税标签)(#26)。

  • [新增] 扩展账户选择器:现在您可以使用任何在account.account上的域来选择账户,而不仅仅是账户代码 balp[('user_type_id', '=', ref('account.data_account_type_receivable').id)]#4)。

  • [改进] 在报告实例配置表单中,现在过滤器被分组在笔记本页面中,这提高了可读性和可扩展性(#39)。

错误修复

  • [修复] 修复在比较模式下保存新创建(尚未保存)报告实例中的期间时出现的错误。 #50

  • [修复] 改善基日期报告实例视图的显示。 #51

从3.0版本升级(破坏性变更)

  • 替代移动行数据源必须具有company_id字段。

10.0.3.0.4 (2017-10-14)

错误修复

  • [修复] 初始余额四舍五入问题。 #30

10.0.3.0.3 (2017-10-03)

错误修复

  • [修复] 修复在新创建报告中保存KPI时出现的问题。 #18

10.0.3.0.2 (2017-10-01)

新功能

  • [新增] 每个报告列的替代移动行来源。这使得mis buidler会计表达式可以在任何具有借方、贷方、account_id和日期字段的模型上工作。只要你能够将已承诺的采购或预算等作为带有借方、贷方和account_id的视图公开,这就会打开很多可能性

  • [新增] 比较列来源(比之前已弃用的比较机制更灵活)。注意:没有自动迁移到新机制。

  • [新增] 求和列来源,用于创建添加/减去其他列的列。

  • [新增] mis.kpi.data抽象模型作为支持手动KPI值的基础,支持自动调整到报告时间周期(预算项的基础,但也可以用于其他目的,例如手动输入某些KPI值,例如员工数量)

  • [新增] 提供新预算数据源的mis_builder_budget模块

  • [新增] 新的“隐藏空值”样式属性

  • [改进] 新的AEP方法来获取表达式中的账户(这有助于找到与特定损益账户相关的KPI,以实现预算控制)

  • [改进] 许多UI改进

  • [改进] 许多代码风格改进和一些重构

  • [改进] 在表达式评估上下文中添加列date_from、date_to,以及time、datetime和dateutil模块

主要错误修复

10.0.2.0.3 (未发布)

  • [改进] 缺失表达式时更稳健的行为

  • [修复] 缩进样式

  • [修复] 在生成没有对象时生成报告时,在赋值前引用局部变量‘ctx’

  • [改进] 使用fontawesome图标

  • [迁移] 迁移到10.0

  • [修复] 导出到Excel时出现Unicode错误

  • [改进] 为集团顾问提供对mis builder样式的完全访问权限

9.0.2.0.2 (2016-09-27)

  • [改进] 在mis报告预览中添加刷新按钮

  • [改进] 小部件代码更改,以便更容易地添加字段

9.0.2.0.1 (2016-05-26)

  • [改进] 在declare_and_compute_period()中删除未使用的参数,以获得更干净的API。这是一个破坏性API,在它被其他模块使用之前紧急合并。

9.0.2.0.0 (2016-05-24)

本版本的部分工作是在2016年4月26日至29日的索伦托冲刺中完成的。其余部分(即主要重构)是在之后的几周中完成的。

  • [改进] 在编辑模式下,在报告实例设置表单上隐藏按钮框

  • [修复] 修复非存储字段的求和聚合错误(https://github.com/OCA/account-financial-reporting/issues/178

  • [改进] 现在在报告级别有一个默认样式

  • [变更] 数字显示属性(舍入、前缀、后缀、因子)现在在样式中定义

  • [变更] 百分比差异现在舍入到1位,而不是KPI的舍入,因为KPI的舍入在这种情况下没有意义

  • [变更] 分隔符后缀(k、M等)不再自动插入,因为与前缀一起使用时会导致不一致;您需要手动在后缀中添加它。

  • [改进] AccountingExpressionProcessor 现在支持“balu”表达式以获取以前年度的未分配利润/亏损;get_unallocated_pl 是相应的便捷方法。

  • [改进] AccountingExpressionProcessor 现在提供方便的方法通过账户获取余额:get_balances_initial、get_balances_end、get_balances_variation。

  • [改进] 现在有一个自动展开功能,可以自动显示选定 KPI 的详细账户信息。

  • [改进] 现在通过表单而不是直接在树视图中操作 KPI 和期间列表。

  • [改进] 现在可以通过向导创建报告,此类报告被视为临时报告,可通过“上次生成的报告”菜单访问,除非永久保存,否则将自动回收,可以使用“保存”按钮进行保存。

  • [改进] 现在有一个入门模式,可以配置只有一个期间的简单报告。

  • [改进] 现在更容易配置具有固定开始/结束日期的期间。

  • [改进] 新的次级 KPI 机制允许创建具有多个值的列,或者具有不同值的列。

  • [改进] 鉴于新的样式模型,Excel 导出现在具有样式。

  • [改进] 现在正在使用新的样式模型来集中样式配置。

  • [修复] 使用 =like 而不是 like 搜索账户,因为用户在表达式中添加了百分号。

  • [修复] 正确计算收入和支出账户的期初余额,基于财政年度开始。

  • [改进] 支持日期范围(从 OCA/server-tools/date_range),作为比财政期间更灵活的替代方案。

  • v9 迁移:移除了财政期间,移除了账户图表,合并账户已被移除。

8.0.1.0.0 (2016-04-27)

8.0.0.2.0

历史记录。或者,你需要查看 git 日志。

错误追踪器

错误在 GitHub Issues 上跟踪。如果遇到问题,请检查是否已报告您的问题。如果您是第一个发现它的人,请通过提供详细且受欢迎的 反馈 来帮助我们解决问题。

不要直接联系贡献者以获取支持或技术问题的帮助。

鸣谢

作者

  • ACSONE SA/NV

贡献者

维护者

本模块由OCA维护。

Odoo Community Association

OCA,或Odoo社区协会,是一个非营利组织,其使命是支持Odoo功能的协作开发并推广其广泛使用。

当前维护者

sbidoul

本模块是GitHub上OCA/mis-builder项目的一部分。

欢迎您贡献。要了解如何贡献,请访问https://odoo-community.org/page/Contribute

项目详情


下载文件

下载适合您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源代码分发

此版本没有提供源代码分发文件。请参阅生成分发存档的教程。

构建分发

odoo13_addon_mis_builder-13.0.4.1.1-py3-none-any.whl (547.0 kB 查看哈希值)

上传时间 Python 3

支持者:

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面