跳转至
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 仪表板以及地图视图中。仅当活动项目配置为将事件分配给用户时才会显示。

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

对事件、技术教育指标(基于其事件)和数据集进行筛选,可使用以下时间段: - 昨天 - 上周 - 本双月 - 最近 3 天 - 本双周 - 上个月 - 明天 - 下周 - 下个月 - 从 - 其他(打开日期选择器) - 随时

机关单位{ #capture_app_generic_filter_orgunit }

允许用户键入搜索或从树形结构中选择一个组织单位。如果用户只配置了一个组织单位,则过滤器将不可见。

同步{ #capture_app_generic_filter_sync }

申报人: - 同步(事件、TEI、数据集) - 未同步 - 同步错误 - 短信同步

事件状态{ #capture_app_generic_filter_event }

按以下条件筛选事件 - 打开 - 时间安排 - 逾期 - 已完成 - 跳过

允许选择多个状态。打开 TEI 后,过滤器将保留在仪表板中,只显示所选状态的事件。

显示的是 5 年前的活动。

注册日期{ #capture_app_generic_filter_date_enroll }

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

注册情况{ #capture_app_generic_filter_enroll_status }

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

后续{ #follow-up }

跟进 "过滤器允许用户筛选出已标记为 "跟进 "的 TEI。可以在 TEI Dashbaord 中标记要跟进的 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 源的事件排序得到了统一。这可确保在同步过程中按照正确的顺序处理事件,从而提高整个系统的数据一致性和计算可靠性。