跳转至
For the complete DHIS2 documentation index, see llms.txt.

通用功能

登录

在 3.3.0 版中,登录屏幕经过重新设计,界面更加现代,可用性得到提高,以支持未来基于 OAuth 的双因素身份验证 (2FA),确保应用项目为即将到来的安全改进做好准备。

登录的第一步是输入服务器 URL。这有两种方法:

  1. 手动:用户必须键入要使用的服务器的相应 URL

    Note

    Take note that login is only possible with servers from version 2.29.

  2. QR:用户可以使用 QR 码代替输入 URL,但用户名和密码必须手动输入。

第二步是添加用户名和密码。

注

1.登录成功后,DHIS2 Android 应用项目将缓存这些值(URL 和用户名),并在今后连接时提示这些值,而无需键入。

成功登录后,用户应只能执行*离线*登录(仅适用于最后一个 URL/用户名组合)。离线使用可以在没有任何连接的情况下使用应用项目。所有数据仍将保存,一旦重新建立或可以连接,用户就可以执行同步。

警告

在 2.30 之前的 DHIS2 版本中,如果用户尝试在线登录,但其账户已按照 DHIS 2 手册 - 禁用用户 中的说明被禁用,则手机中的所有数据都将被清除。在禁用用户之前,请确保所有数据都已同步,或使用此功能远程清除敏感数据,以防设备丢失。

由于登录 API 的更改,该功能从 2.31 版起不可用。

离线多用户

重新设计了 "管理帐户 "屏幕,以与 3.3.0 版中引入的最新登录体验保持一致。保存的账户现在显示为更清晰、更有条理的卡片,显示从每个 DHIS2 实例检索到的关键信息。每张卡片现在包括

  • 应用项目标题(在系统设置 → 外观中配置)
  • 服务器 URL
  • 用户名
  • 系统设置中配置的国旗

这次重新设计提高了可读性,更容易区分多个已保存账户,并确保与新的身份验证流程保持视觉一致。

用户在首次登录每个账户时都需要访问互联网,之后无需访问互联网即可切换账户。

用户可以管理用户账户,并在必要时删除账户。

帐户恢复

如果用户启用了以下设置,则他们将能够恢复自己的密码:已启用用户帐户恢复。

封锁会话(PIN)(改进 3.4.0){ #capture_app_generic_PIN }

用户可以使用 4 位数密码锁定会话。这样就可以在不删除本地数据的情况下,移动到手机中的其他应用程序。

如果用户忘记了密码,也可以通过输入凭证登录。 尝试 3 次无效后,应用程序会要求用户使用密码登录。

生物识别登录

如果设备激活了指纹扫描仪或面部 ID 功能,用户就可以使用该功能。只有在只有一个账户的情况下才能使用(不支持多个账户)。

  • 启用指纹扫描器而不启用PIN时,每次应用关闭,进入后台或设备被阻止时,会话将被锁定。一旦再次打开该应用程序,用户需要点击指纹图标以激活扫描仪。
  • 如果设置了PIN和指纹,则在会话被锁定并且用户再次打开应用程序时,将询问PIN。

如果 biomtric 验证失败,用户将被要求输入密码以完成登录过程。

说明/信息按钮

TEI 面板屏幕中提供了上下文指南。

提示

用户可以通过单击屏幕右上角的三个点来重新打开说明。

过滤

在所有列表界面(主页、事件列表、TEI 搜索和数据集)中都可以应用过滤器,以缩小显示数据的范围。可用的筛选器有:时间段、组织单位、同步状态、事件状态、类别选项组合和 "分配给我"。

过滤器将适应不同的项目和数据集。

  1. 未经注册的项目:日期,组织。单元、同步状态、事件状态和类别组合。
  2. 注册计划:活动日期、注册日期、组织单位、同步、注册状态、活动状态和分配给我。单位、同步、注册状态、活动状态和分配给我。筛选器图标只有在有活动列表时才会显示(显示首页列表功能或搜索)
  3. 数据集:周期、机构、单位和同步状态。单位和同步状态。

分配给我{ #capture_app_generic_filter_assigned }

可以根据分配给当前用户的事件过滤事件。 “分配给我”过滤器已添加到单个事件项目列表、TEI 列表和 TEI 仪表板以及地图视图中。仅当活动项目配置为将事件分配给用户时才会显示。

注意 Android 应用只能根据现有分配情况对活动进行筛选和显示。将用户分配或重新分配给活动必须通过网页版 Capture 应用或 Tracker Capture 应用进行——目前 Android 应用本身不支持此功能。

活动日期/日期/时间段{ #capture_app_generic_filter_date }

筛选事件、TEI(基于其事件)和数据集时,可选的时间段如下: - 昨天 - 上周 - 本双月 - 最近 3 天 - 本双周 - 上个月 - 明天 - 下周 - 下个月 - 发件人-收件人 - 其他(打开日期选择器) - 随时

组织单位{ #capture_app_generic_filter_orgunit }

允许用户输入搜索内容或从树状结构中选择一个组织单位。如果用户仅配置了一个组织单位,则该筛选器将不可见。

同步{ #capture_app_generic_filter_sync }

按以下条件排序: - 已同步(事件、TEI、数据集) - 未同步 - 同步错误 - 短信已同步

活动状态{ #capture_app_generic_filter_event }

按以下条件筛选活动: - Tracker Program Ownership { #webapi_tracker_ownership } - 日程安排 - 逾期 - 已完成 - 已跳过

允许选择多个状态。一旦打开 TEI,该筛选条件将保留在仪表盘中,并仅显示具有所选状态的事件。

显示的活动最多可追溯至5年前。

入学日期{ #capture_app_generic_filter_date_enroll }

注册日期 "将适用于 TEI 在项目中的注册日期。如果有多个注册日期,则应按最近的日期对结果进行排序。该过滤器的标签将在可用时显示。

注册状态{ #capture_app_generic_filter_enroll_status }

筛选器 "注册状态 "提供三个选项:激活、已完成、已取消。每次只能选择一个选项。如果您使用 "已完成 "进行筛选,且 TEI 有一个以上的注册,则应用项目将打开 "活动 "注册。要查看已完成的注册,请选择仪表板右上角的三点菜单,然后选择 "计划注册"。

后续报道{ #follow-up }

“跟进”筛选器允许用户筛选出已被标记为“跟进”的 TEI。用户可以在 TEI 仪表盘中将 TEI 标记为需跟进。

TEI 仪表盘中新增了筛选功能:{ #capture_app_generic_filter_tei }

TEI 仪表盘中已添加筛选功能。现在可以按时间段、组织单位、同步状态、事件状态和用户分配来筛选“受追踪实体实例”注册的相关事件。

排序

排序功能已集成到筛选菜单中。

排序按钮将位于筛选栏上,其行为如下: - 每次仅适用一种排序方式。如果用户点击了另一种排序方式,之前的排序方式将被禁用。 - 已应用的排序图标显示其处于活动状态,其余图标则处于非活动状态。
- 反复点击会不断将顺序反转。

日期(时间段、日期、事件日期或注册日期){ #capture_app_generic_sorting_dates }

  • 如果活动日期早于截止日期,则仅在没有活动日期时才使用截止日期。
  • 按从最新到较旧的顺序排列。未来事件(截止日期)排在最前面。

组织单位{ #capture_app_generic_sorting_orgunits }

  • 列表将按组织单位名称的字母顺序排序。

注册状态{ #capture_app_generic_sorting_enrollment }

  • 列表将按状态名称的字母顺序进行排序。

同步信息{ #capture_app_generic_sync_info }

登录同步

在元数据下载过程中,应用项目将保持在闪屏状态,并在元数据进入设备后打开主屏幕。

在主屏幕上,当数据正在下载时,应用项目会在每个项目上显示一个加载旋转器。同步过程结束后,项目会显示两个图标中的一个:

  • 如果项目成功下载数据且无错误,则显示绿色复选标记(该图标将在三秒后消失),否则显示绿色复选标记、
  • 如果在同步过程中出现错误,且数据未能全部或部分下载,则会显示一个灰色箭头

用户将能看到有多少项目正在下载数据或已完成下载,从而使等待过程更加透明,并能了解其进展情况。

注意: 所有项目和数据集都将被阻止,直到同步过程完全结束。

后续登录

应用项目仅在用户首次登录时启动数据和元数据同步进程。为了便于在最困难的情况下开展工作,后续登录的同步进程已被移除。这意味着,当用户打开应用项目时,即使用户注销了账户,也无需执行完全同步即可打开。

如果用户删除了账户,那么下次登录时就会启动同步项目。

此外,用户还可以随时通过“刷新”按钮与服务器进行同步。

同步状态

每个项目或数据集旁边都会显示一个图标,允许用户检查同步信息。同步记录不显示任何图标。未同步(灰色箭头)、错误(红色箭头)、警告(橙色)或 SMS(蓝色,内含 SMS 字样)图标将根据状态显示。

细粒度同步

用户可以点击灰色箭头(表示在线存储在设备中的记录)来执行同步。这些选项可在顶层(项目/数据集)或单独(TEI、事件、数据值)使用。

短信同步

在没有互联网连接(通过 WiFi 或移动数据)但仍有移动连接的情况下,如果事先在应用项目中建立了网关并在服务器级别进行了正确配置,用户就可以通过短信进行同步。

如果应用项目是从 Google Play 下载的,用户必须从其默认的 SMS 应用项目手动发送短信(其默认的 SMS 应用项目将在短信编好后打开)。用户应在不修改信息的情况下发送信息,然后切换回 DHIS2 应用项目以确认信息已发送。

不过,如果应用项目是从 Github 下载的(或使用的是培训版本),应用项目只会要求确认发送一条或数条短信(SMS),并在后台发送(无需打开默认的 SMS 应用项目)。

提示

在短信设置(设置菜单)中编辑与短信网关相关的参数,或通过 [#capture_app_android_settings_webapp_general](安卓设置 Web 应用项目)进行全局设置

注意

请注意,要使用短信同步功能,必须按照 https://docs.dhis2.org/master/en/dhis2_user_manual_en/mobile.html#sms-service 中的说明在服务器端启用短信服务。 您还可以在 https://docs.dhis2.org/master/en/dhis2_android_implementation_guideline/about-this-guide.html 中找到有关如何使用不同网关的更多信息。

元数据同步错误

如果在同步过程中出错,则会在设置菜单中显示一条消息(“同步数据”或“同步配置”部分)。此外,在主屏幕中,该项目旁边会显示一个红色的同步图标。同步错误日志提供了有关错误的详细信息,并准备与管理员共享。

您也可以从**设置**中打开同步错误日志:

刷新数据{ #capture_app_generic_refresh_data }

用户现在可以在输入新数据之前从服务器获取最新数据。以下界面中现已添加“刷新”按钮,用于触发精细同步:

  • 首页
  • 搜索
  • TEI 仪表盘
  • 活动节目单
  • 活动详情
  • 数据集列表
  • 数据集详情

组织单位

将显示整个组织单位树。不可进行数据录入的组织单位将显示为灰色。 用户必须勾选复选框以选择所需的组织单位。选择组织单位后,其上级组织单位将以粗体显示,以便在打开层次结构时提示已选中的组织单位。

注意

不希望移动用户访问组织。整个国家的单位层次结构。组织单位的最大数量很难设置,因为应用项目没有设置限制,而是设备(内存,处理器)上的资源。我们可以说低于250个单位部门应该是安全的,但仍然认为对于移动用例来说这是一个很大的数字。

数据集

用户现在可以输入组织单位,期间和一组数据元素的汇总数据,并将其发送到服务器。

首页

DHIS2 Android 应用项目的主屏幕显示了可供用户使用的项目和数据集列表。在这种情况下,用户收集数据的第一件事就是选择要使用的项目或数据集。

在 3.1.0 中,新的动态主屏幕可根据可用项目的数量(最多 4 个项目)进行调整。响应式设计能更好地利用屏幕空间,提供更具吸引力和功能性的主屏幕布局。

提示

区分它们的一种简单方法是查看左下角的单词。 “事件”一词将始终存在于事件项目中。在跟踪器中将出现被跟踪实体类型的名称(人,患者,建筑物等)。对于数据集,单词“ DataSets”将显示在记录数旁边。

对于用户只能访问一个项目或数据集的实施情况,应用项目将跳过主页,直接打开项目或数据集屏幕,显示事件、技术教育指标或数据集列表,以减少点击次数,简化数据录入过程。

共享资料

用户可以通过二维码分享TEI文件。这使得设备之间无需通过服务器即可传输/分享信息(在网络连接可能中断的情况下非常有用)。要执行此操作,用户应打开任意一个TEI文件,然后点击*分享*按钮。

捕捉坐标

TEI坐标

在注册表中获取TEI坐标。在TET功能类型中启用此功能。

多边形

该应用项目现在支持geoJSON格式,并且用户能够捕获多边形。

图片

ValueType 图像可在 Android 中用于捕获数据,也可根据项目配置显示在 TEI 面板中。当该值类型是项目配置中标记为显示的第一个数据元素/属性时,它将被用作 TEI 配置文件图像。

点击 TEI 个人资料图片以打开它。

在地图中显示事件和TEI

当项目阶段或被跟踪实体类型具有特征类型时(并且对于已注册的项目,启用了 displayFrontPageList 选项),可以切换列表以在地图中显示信息。通过单击导航面板中的地图图标进行切换。

如果 TEI 有头像,地图上会显示该头像。

个性化日历视图{ #capture_app_personalized_calendar }

在 DHIS2 Android 捕捉应用项目中,用户可以将日期选择从旋转器切换到日历视图。在该版本中,应用项目将记住用户上次选择的可视化,并在用户下次需要选择日期时使用。

数据不可编辑的原因{ #capture_app_reason_non_editable }

在 DHIS2 中,数据可能因多种原因被屏蔽,例如访问限制或过期等。当某个事件、TEI 或数据集不可编辑时,用户可在“详细信息”部分查看具体原因。

以下列表包含所有可能的原因:

  • 活动完成
  • 注册完成
  • 已过期的活动
  • 已关闭的组织单位
  • 组织单位不在捕获范围内
  • 无法访问项目或数据集中的捕获数据
  • 无法访问项目或数据集中的类别选项

配置故障排除{ #capture_app_configuration_troubleshooting }

配置故障排除功能仅在**DHIS2 Android 培训应用项目**中提供。它不包括在生产版本的捕获应用项目中。

该工具适用于需要在设置或培训过程中测试项目规则或翻译并排除故障的管理员和实施人员。它不需要特殊的用户角色或权限。

您可以从 DHIS2 Training App on GitHub 下载最新版本的 DHIS2 Android 培训应用项目 (APK)。 查找标有 "培训 "的 APK)。

  • 语言: 用户将能够更改应用项目用户界面的语言,以识别有错误或无翻译的标签、按钮或提示。

  • 项目规则验证: 该验证器将检查设备中的项目规则,并显示配置不一致的地方。

导航错误{ #capture_app_error_navigation }

安卓应用项目改进了用户界面上的同步错误导航功能。该应用项目将以简单明了的方式显示同步错误,允许用户从主屏幕导航到事件或数据集中导致错误的确切字段。

用户必须点击列出的任何一个错误,应用项目就会移动到相应的屏幕。找到并修复错误后,用户可以点击 "刷新 "按钮进行同步。

LMIS 模块{ #capture_app_lmis_module }

用于实际库存监控用例的新模块使用户能够实时管理和监控库存水平。集成模块意味着应用项目将打开一个全新的、不同的用户界面和体验,以应对不同的数据输入流程。要使用该模块,需要使用新的网络应用项目对项目用例进行配置。

事件上传行为{ #capture_app_lmis_module_sync }

默认情况下,Android 应用项目将以 "已完成 "状态上传事件。如果项目配置阻止事件在服务器上完成(例如,由于强制数据元素或 "完成时出错 "的项目规则),应用项目将以 "激活 "状态上传事件。这样既能防止因服务器端配置错误导致的上传失败,又能确保数据的发送。

跨平台的事件排序对齐(在 3.4.0 版本中已改进){ #capture_app_lmis_module_event_ordering }

通过此次更新,Web、Android 和 API 源中的事件排序已实现统一。这确保了事件在同步过程中按正确顺序处理,从而提高了整个系统中的数据一致性和计算可靠性。