跳转到主要内容

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

项目描述

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

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

目录

安装

您首选的安装插件的方式将与MIS Builder兼容。

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

  • pip安装 --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 上找到。

变更日志

14.0.4.2.2 (2024-02-08)

错误修复

  • 解决创建报告周期时无管理员权限的用户权限问题。(#596

14.0.4.1.2 (2023-01-27)

错误修复

  • 修复 PDF 和 Excel 报告中分析标签的显示。(#353

14.0.4.0.6 (2022-07-19)

错误修复

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

14.0.4.0.5 (2022-07-19)

错误修复

  • 允许删除具有子报告的报告。(#431

14.0.4.0.2 (2022-02-16)

错误修复

  • 修复在 MIS 报告实例表单上单击“保存”按钮时的访问权限问题。(#410

14.0.4.0.0 (2022-01-08)

功能

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

错误修复

  • 支持 Odoo 13+ 多公司模型。在多公司模式下,可以在 MIS 报告实例上声明多个允许的公司,并且报告在报告公司和用户上下文中选择的公司之间操作。(#327

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

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

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

14.0.3.6.7 (2021-06-02)

错误修复

  • 如果您在 MIS 报告实例上,并且想要生成新的一行比较类型,您目前不能选择任何现有期间进行比较。这是因为字段域在 NewId 上下文中搜索,因此找不到正确的期间。更改域并使其使用一个计算字段,该字段使用对 _origin 记录的搜索来解决问题。(#361

14.0.3.6.6 (2021-04-23)

错误修复

  • 修复当账户模型已被自定义时钻取动作名称的问题。(#350

14.0.3.6.5 (2021-04-23)

错误修复

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

14.0.3.6.4 (2021-04-06)

功能

  • 修订了在面包屑中显示的钻取动作名称。显示 kpi 描述和账户 display_name 而不是 kpi 的技术定义。(#304

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

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)。(#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字段。(#149

  • 添加source_aml_model_name字段,以便提供替代数据源的扩展模块可以更容易地定制其数据源。(#214

  • 在后台视图和预览小部件中支持分析标签过滤器。在过滤器中选择多个标签意味着过滤出具有所有这些标签设置的移动行。这是为了支持使用标签进行不同维度最常见的用例。过滤器还与分析账户过滤器进行AND组合。(#228

  • 在多公司模式下显示账户详细信息行的公司。(#242

错误修复

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

  • 在类型为总和的列中,保留非可求和KPI(例如百分比值)的样式。在此修复之前,此类单元格没有显示样式。(#219

  • 在Excel导出中,保持百分号后缀(pp),而不是用%替换。(#220

12.0.3.4.0 (2019-07-09)

功能

  • 为定义期间添加新的“本年度至今”模式。(#165

  • 添加对具有负借方或贷方的移动行的支持。一些用于冲账会计。不支持官方支持。(#175

  • 在Excel导出中使用带有千位分隔符的数字格式。使用的特定分隔符取决于Excel配置(例如区域设置)。(#190

  • 在XLS导出末尾添加生成日期/时间。(#191

  • 在存在子KPI的情况下,当非多表达式产生不正确长度的元组时,报告更具有信息性的用户错误。(#196

错误修复

  • 修复Excel导出中百分比类型的渲染问题。(#192

12.0.3.3.0 (2019-01-26)

功能

在报告预览中,动态分析过滤器在11版本中尚未提供,这需要更新JS小部件,但到目前为止实现起来比较困难。欢迎提供帮助。

  • 分析账户过滤器。在报告中,可以选择分析账户进行过滤。该过滤器将应用于移动行查询。小部件中也有一个过滤器框,允许用户在报告预览时选择分析账户。(#15

  • 控制小部件中分析过滤器组合框的可见性。这在隐藏在报告中没有意义的分析过滤器上很有用,例如资产负债表报告。(#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升级(破坏性更改)

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

11.0.3.2.2 (2018-06-30)

  • [修复] 修复在company_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

  • [添加] 在报告实例级别添加禁用账户展开的选项,允许创建详细模板,同时将渲染详细信息的决策推迟到报告实例(#74

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

11.0.3.1.2 (2018-02-04)

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

10.0.3.1.1 (2017-11-14)

新功能

  • [添加] 月份和年份相对时间段,比日期范围更容易使用,对于最常见的案例。

  • [添加] 支持多公司合并,包括货币转换(转换率日期是报告期末)。(#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

  • 修复:改进了Base Date报告实例视图的显示。 #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

项目详情


发布历史 发布通知 | RSS源

下载文件

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

源代码分发

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

构建分发

odoo14_addon_mis_builder-14.0.4.2.2-py3-none-any.whl (570.5 kB 查看散列值)

上传时间 Python 3

由以下组织支持

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