事件报告到行列表过渡指南{ #event-reports-to-line-listing-transition-guide }¶
***注：本指南使用了老挝人民民主共和国演示数据库的截图。老挝人民民主共和国卫生部慷慨地允许我们访问他们的报告单位、地理和元数据，用于创建培训材料、指南和进行测试；但数据项是虚构的，不代表老挝人民民主共和国境内的任何人或任何价值。
介绍¶
在 DHIS 2.38 中，引入了行列表应用程序 。线路列表应用程序取代并补充了事件报告应用程序中的线路列表功能。由于其功能集得到了增强，因此在实施过程中引入行列表应用程序可能会很有用；但是，如果不经过仔细考虑就引入一个新的应用程序，可能会有很大的障碍。对于可能已经接受过如何使用事件报告应用程序培训的用户群来说，情况尤其如此，因为在他们当前的工作流程中使用一个新的应用程序可能会遇到很大的阻力。本文件旨在概述成功实施线路列表应用程序的方法，以及可用于更好地了解其功能的参考资料。
该应用程序是在DHIS2 应用程序中心内的连续发布周期下发布的。这意味着该应用程序被视为一个独立的 DHIS2 应用程序；它需要独立于 DHIS2 核心软件按自己的周期进行安装和更新。
线路列表应用程序给实施工作带来了几个不同的挑战，主要实施人员需要了解这些挑战，以便在新用户和现有用户群中有效地扩展和利用其功能集。
由于是连续发布，线路列表应用程序需要在 DHIS2 应用程序中心内进行管理和更新。 有些用户权限只有在线路列表应用程序安装后才会添加到 DHIS2 中。这些权限需要添加到新的或现有的用户角色中，以便用户能够访问线路列表应用程序。 该应用程序的界面和功能与其他分析应用程序有很大不同，因此可能需要进行培训才能有效地引入该应用程序。 它并不能完全取代事件报告应用程序，因为任何类型的汇总透视表仍然需要在事件报告中制作，而建议在线路列表应用程序中制作线路列表。用户很可能需要对这一过程有敏感认识。
为了成功引入线路列表应用程序，我们建议实施人员列出一个活动程序，直到该应用程序成功实施为止。我们将在本指南中使用和概述的一套任务示例包括以下内容：
- 了解线路列表应用程序的功能和使用方法
- 了解何时使用线路列表应用程序，何时使用事件报告应用程序
- 熟悉持续发布周期，以及这对行列式应用程序管理的影响
- 了解如何通过 DHIS2 应用中心安装和更新线路列表应用程序
- 了解与线路列表应用程序相关的用户权限
- 制定计划，通过培训和其他交流方式，提高用户对线路列表应用程序的认识
- 为用户创建并实施培训和交流材料，向他们展示如何使用线路列表应用程序
- 评估用户对线路列表应用程序的反应，并根据需要为他们提供支持
线路列表应用程序{ #features-of-the-line-listing-app } 的功能¶
要开始查看行列表应用程序的功能，首先请查看 用户文档 。该文档讨论了一些主要功能，并概述了行列表应用程序的界面。
为进一步补充文档，还提供了一系列演示线路列表应用程序功能的视频。这些视频位于 YouTube 上。我们创建了一个播放列表 此处，每个视频都可以在下面找到。
行列表界面回顾](https://www.youtube.com/embed/AwqLT35fjCg)
事件报告线路列表与线路列表应用程序{ #feature-comparison-of-event-reports-line-listing-and-the-line-listing-app } 的功能比较¶
| 特色 | 线路列表应用程序 | 活动报告 |
|---|---|---|
| 报告类型 | 行列表应用程序只能制作行列表类型的报告。 | 事件报告应用程序既可以制作数据透视表风格的报告，也可以制作行列表类型的报告。不过，与行列表应用程序相比，事件报告中的行列表类型报告功能较少，建议使用行列表应用程序创建行列表。 |
| 布尔类型数据元素（是/否） | 视为 "是 "或 "否 "和 "未回答" | 显示为 "是"、"否 "和 "不适用"。 |
| 用户界面/导航 | 按选项卡对尺寸进行分组。选项卡包括输入（事件/注册）、计划（日期、状态、组织单位、数据项）、您的维度（OU 组集等）、全局维度。布局现在保留在行列表的顶部，你可以根据需要拖放项目来修改布局 通过 "视图 "选项可以折叠项目。可以通过表格选项更改显示密度、字体大小和数字分隔符。可在输出中包含组织单位层次结构 | 采用与其他应用程序非常相似的输入方法（内容、地点、时间--数据、时间段、组织单位），然后是 OU 组集。需要选择行列表或数据透视表类型的报告。打开布局选项卡可重新排列列顺序。可通过箭头选择器折叠选项。可通过表格选项更改显示密度、字体大小、数字分隔符（也存在于 DV 中）。可在输出中包含组织单位层次结构 |
User: {0}, has no write access to relationship: {1}. | 在行列表应用程序中，您将看到日期为 yyyy/mm/dd。如果只是日期-时间字段，则会添加时间。 | 在事件报告应用程序中，您将看到日期为 yyyy/mm/dd 00:00:00:0（无论数据元素/属性类型如何，都包含时间）。 |
| 根据不同日期筛选出事件 | 您可以根据报告日期、到期日期、计划日期、注册日期和事件日期筛选出事件 | 不适用。您无法使用与计划相关的不同日期来筛选事件。 |
| 全球层面 | 您可以看到创建/修改事件的用户以及事件的最后更新时间。 | 不适用。事件报告中没有全局维度选项。 |
| 以 excel 格式下载 | 根据您在应用程序中选择的输入内容下载表格。 | 即使未选择，也会在下载时添加额外列（如事件/计划状态、事件 ID、计划阶段 ID 等）。 |
| 重复事件 | 每一行都可以代表一个单独的事件；但您也可以使用附加功能，通过 DE 将所有重复事件添加到同一行中。 | 只能将重复事件显示为单独的行/列。不过，它允许在数据透视表中汇总事件与注册人数。 |
| 传说 | 图例可用于使用数值类型（数字、正整数或零整数等）的值。 | 不适用。事件报告中的数字数据元素不能使用图例。 |
| 跨多个阶段的数据 | 创建跨多个阶段的行列表；这包括跨阶段重复使用的数据元素。行列表应用程序将动态更新，以包含重复数据元素的源阶段。 | 跨多个阶段创建行列表。一个数据元素只能选择一次；如果在另一个阶段重复使用，则不能再次选择。 |
| 条件/过滤器 | 在文本属性上 ：数字项目的筛选器与事件报告相同 选项集的筛选器与事件报告相同 | 关于文本属性 ：包含 完全相同 # 项目相同 选项设置相同 |
| 时间维度 | 事件 ： 从事件日期、注册日期或事件日期中选择 注册：从注册日期或事件日期中选择 根据需要添加全局维度。事件或注册将这些作为行列表的期间选择，过滤掉不符合所选时间维度标准的事件或注册。 | 事件 ： 显示事件日期、注册日期和事件日期（即使程序中不使用事件日期）：事件：使用事件日期在行列表中显示事件。注册使用注册日期在行列表中显示注册。这是基于 "期间 "选择器中指定的期间。 |
如何同时使用事件报告和行列表{ #how-to-use-event-reports-and-line-listing-together }¶
目前，事件报告应用程序和线路列表应用程序应同时使用，因为线路列表应用程序并不能完全取代事件报告中的所有功能。需要注意的是，在事件报告中创建的任何行列表都可以在行列表应用程序中打开。您可以对这些行列表进行更改，但无法在行列表应用程序中覆盖它们。更新后，您必须保存该报告的新副本。
下面是一个在事件报告中创建、在行列表应用程序中打开然后更新的行列表示例。我们可以看到 "保存 "选项是灰色的。要保存这些更改，我们需要选择 "另存为"，这将创建一个新的行列表副本。
如果您要将现有线路列表从事件报告过渡到线路列表应用程序，请记住这一点。
活动报告{ #event-reports }¶
如果您想制作数据透视表样式的报告，应随时使用事件报告应用程序，如下所示
在事件报告中制作数据透视表时，有两种输出类型：
- 事件
- 注册
在制作表格时，事件类型输出将计算输出中的事件，即使是重复事件。注册类型输出将只计算注册人数，因此重复事件不会计入这些总数中（使用注册人数时，事件数据将取自最近的事件）。下面是一个疫苗接种剂量的比较示例，其中疫苗接种包含在一个可重复阶段中。
从输出结果中可以看到，使用事件输出时的剂量数大于使用注册类型输出时的注册数。这是因为注册类型输出只计算唯一注册。当您在事件报告中制作数据透视表时，请记住这一点。
线路列表{ #line-listing }¶
在任何时候，您都可以使用行列表应用程序来制作行列表，如下所示
线路列表应用程序还允许您使用事件和注册类型来制作列表。在线路列表应用程序中，这两种类型之间存在一些差异。请查看 用户文档 和功能演示视频，其中进一步强调了这些差异。
产品系列列表 连续发布{ #line-listing-continuous-release }¶
线路列表应用程序通过持续发布周期提供。这意味着线路列表应用程序的更新与 DHIS2 核心软件无关。因此，线路列表应用程序不与 DHIS2 核心软件捆绑，必须通过 DHIS2 应用程序中心进行安装和更新。
安装线路列表应用程序{ #installing-the-line-listing-app }¶
要安装线路列表应用程序，用户必须有访问 DHIS2 中应用程序管理应用程序的权限。
在应用程序管理应用程序中：
- 选择应用程序中心
- 搜索线路列表应用程序
- 选择线路列表应用程序
选择线路列表应用程序后，您可以选择将该程序安装到系统中。
您会看到有不同版本的应用程序。建议您安装最新版本，尤其是第一次使用该程序的用户。
选择 "安装"，将应用程序安装到系统中。
你应该会在屏幕底部收到应用程序已成功安装的通知。蓝色的安装按钮现在也将变为 "卸载 "按钮。
用户访问{ #user-access }¶
安装线路列表应用程序后，用户需要获得访问该应用程序的权限。此外，用户可能需要获得特定权限，才能以不同方式创建和保存他们制作的线路列表。这可以通过两种方式实现：
创建新用户角色并将该用户角色分配给相关用户 更新现有用户角色。拥有该角色访问权限的用户将自动获得使用线路列表应用程序所需的新权限。 在大多数情况下，建议更新现有的用户角色。从根本上说，任何有权限使用事件报告的人都应该能够访问线路列表应用程序；因此，那些提供访问事件报告权限的角色也应该相应更新，以包括对线路列表应用程序的访问权限。
安装线路列表应用程序后，在管理用户角色时会在列表中添加一个新的权限。该权限为 "线路列表应用程序"，位于 "其他权限 "部分。将此权限添加到新的或现有的用户角色中，即可访问线路列表应用程序。
您可能还需要验证用户角色是否具有与创建行列表相关的正确权限。这些列表仍附在事件报告的元数据权限中。
更新线路列表应用程序{ #updating-the-line-listing-app }¶
审查应用程序的更改{ #reviewing-changes-to-the-app }¶
线路列表应用程序将定期更新，但不会自动更新。这样做的目的是，虽然更新应用程序相对容易，但建议在实际更新之前对应用程序中实施的更改进行审查。
让我们看看早期版本的线路列表应用程序
在此版本的应用程序中，您在一个选项卡中选择输入，而在 "程序尺寸 "选项卡中选择程序。组织单位和时间段等维度位于应用程序的左侧。
将其与更新版的线路列表应用程序进行比较。
在这个更新版本中，我们可以看到，我们在输入选项卡中选择程序，组织单位和时间维度是在程序维度选项卡中选择的，而不是在屏幕左侧。此外，还新增了 "全局维度 "部分。
这些都是工作流程中的重大变化，在推出之前需要让用户了解这些变化。随着时间的推移，应用程序还可能增加新的功能，用户了解这些功能也会很有帮助。
为了查看这些更改，您可以在 https://play.dhis2.org 上查看最新的 DHIS2 演示，或者最好在开发服务器上安装最新版本的应用程序，该服务器是您自己系统的副本。使用第二种方法时，在升级生产系统上的版本之前，还值得测试一下应用程序，以确保其功能与预期一致（如果不一致，则值得暂缓升级，直到发现的问题得到解决）。
要查看最新更改摘要，请访问 https://dhis2.org/downloads/ 上的软件发布说明。向下滚动到 "核心软件"，然后访问 "功能概览"，了解新功能的说明。
***根据测试过程中看到的情况，制定并实施一项策略，将应用程序中的新功能、功能变化、布局等告知用户。
更新应用程序{ #updating-the-app }¶
要更新线路列表应用程序，用户必须能够访问 DHIS2 中的应用程序管理应用程序。
在应用程序管理应用程序中：
- 选择应用程序中心
- 搜索线路列表应用程序
- 选择线路列表应用程序
选择线路列表应用程序后，您可以选择更新系统中已有的应用程序。
如果您已按照 "审查应用程序的更改 "一节中概述的程序****，那么您只应更新到您已测试并制定了推出策略以通知用户更改的应用程序版本****。如果这是应用程序的最新版本，您可以选择蓝色的 "更新到最新版本 "按钮。如果这是另一个版本的应用程序，请向下滚动并选择 "安装"，将当前应用程序升级到更新的版本。
更新应用程序后，您将收到应用程序已成功更新的通知。
参考培训材料{ #reference-training-materials }¶
DHIS2 学院的培训材料 "追踪器数据采集与分析基础 "可根据国家的当地情况进行调整，该材料位于此处：
请注意，本指南包括在事件报告中创建数据透视表类型报告的回顾，因为事件报告和行列表应一起使用。