相关文章推荐
直接或您可以单击坐标字段左侧的**地图**图标。 后者将打开一张地图,您可以在其中搜索位置或设置 直接点击地图。 - 如果该字段是多边形字段,您可以单击左侧的 **map** 图标 场。这将打开一个地图,您可以在其中搜索位置并捕获 一个多边形(地图右上角的按钮)。
  1. Click the Save person button to register the tracked entity instance.

  2. 现在将提示您进入跟踪的实体实例仪表板。

仪表板将显示有关新创建的跟踪实体实例的相关信息。

报名参加

  1. 打开**捕获**应用。

  2. 选择一个组织单位。

  3. Select a tracker program of your choice.

  4. Click Create new person . Please note that the label of this button corresponds to the tracked entity type of the program, which could vary, such as "Building," "Person," etc.

    create new event

  5. 现在,您将能够看到类似于下图的表单。

    The enrollment form has different layouts depending on how the program is customized. The top section has the title "Enrollment", and it holds all the relevant information about the enrollment details. This section will always be present, regardless of layout. Underneath, the different data input fields relevant to the tracked entity instance will be displayed. These fields will either be displayed within sections or as a completely custom form. The sections, or custom form, mainly contains all the tracked entity attributes linked to the program or tracked entity type.

    create new event

  6. Fill in the required information for the enrollment. 如果将跟踪的实体类型配置为捕获位置:

    • 如果该字段是坐标字段,您可以输入坐标 直接或您可以单击坐标字段左侧的**地图**图标。 后者将打开一张地图,您可以在其中搜索位置或设置 直接点击地图。

    • 如果该字段是多边形字段,您可以单击左侧的 map 图标 场。这将打开一个地图,您可以在其中搜索位置并捕获 一个多边形(地图右上角的按钮)。

  7. Click Save person to register the tracked entity instance. The Save button shows a loading spinner and the Cancel button is disabled while the request is processing.

  8. 现在将提示您进入跟踪的实体实例仪表板。

仪表板将显示有关新创建的跟踪实体实例的相关信息。

注意

事件中的某些数据元素可能是必需的(在数据元素标签旁边标有红色星号)。 必须先填写所有必填数据元素,然后才能允许用户完成事件。 例外情况是,如果用户具有称为__**忽略跟踪器和事件捕获中必填字段的验证**的权限。__ 如果用户拥有此权限,则不需要强制性数据元素,并且 红色星形将不会显示在数据元素标签旁边。请注意,具有__“ ALL” __权限的超级用户会自动 拥有此权限。

提示

数据输入表单也可以在**行视图**中显示。在这种模式下,数据元素是水平排列的。这可以是 通过单击数据输入表单右上角的**切换到行视图**按钮来实现。如果您当前处于**行视图**中,那么您 可以通过单击数据输入表单右上角的“切换到表单视图”按钮切换到默认表单视图。

使用自动生成的事件注册

Events can automatically be created when enrolling in a program.

To automatically generate events, you can do the necessary configuration in the maintenance app. 1. 打开维护应用程序

  1. 选择程序选项卡

  2. 选择跟踪器程序

  3. 选择程序阶段选项卡

  4. Click on the program stage you would like to generate an event for

  5. Select "Auto-generate event"

You can set multiple program stages within a program to be auto-generating (this will create an event for each program stage configured this way)

Enrollment with open data entry form

A program can be configured to automatically take the user to register a new event immediately after enrolling a tracked entity instance. To enable this behavior, the program must have at least one program stage with the "Open data entry form after registration" option checked. If more than one program stage has this option enabled, the first stage will be used.

To configure it, you must follow the steps described in the Enrollment with auto generated events section and then check the option "Open data entry form after enrollment".

Enrollment with first stage on registration page

For tracker programs enable the "First stage appears on registration page" flag in the Maintenance. The enrollment registration page will now display the first program stage the user has access to.

活动类型

If the stage has the "Open data entry form after enrollment" selected, then the event will be generated into the ACTIVE status. Also its execution date will be calculated for the event, in addition to a due date. The generation happens based on either the enrollment date or the incident date. You can choose the reporting date from the dropdown menu "Report date to use".

如图所示,您有三个选项,a) 事件日期 b) 注册日期或 c) 无值。 选择报告日期为“事件日期”表示事件执行日期和截止日期都将与事件日期相同。 选择报告日期为“注册日期”或“无值”表示事件执行日期和截止日期都将与注册日期相同。

日程安排类型

When the "Open data entry after enrollment" is not checked, it means that the event generated will be a SCHEDULE event. The scheduled event does not have an execution date, but only a due date. The due date for these future events are calculated based on either enrollment date or incident date. If the flag below is checked, the reference date is the enrollment date, if the flag is not checked, the incident date is used.

如果没有事件日期,则无论是否选中上述标志,参考日期都将退回到注册日期。

On SCHEDULE type of events the user can also configure the "Scheduled days from start". Which means if a stage has a number in "Scheduled days from start" the reference date will increased by that number. In the example below we increase the due date by 30 days.

当“从开始的预定天数”不包含数字或包含 0 时,使用参考日期而不添加任何天数。

可能的重复检测

In both cases of registering a tracked entity instance, (with enrollment or without enrollment) the system will start looking for possible duplicates. Note that, programs need to be correctly configured through the maintenance app for the system to start detecting duplicates when enrolling a new person in a program.

要通过维护应用程序配置程序,您必须:

  1. 打开维护应用程序。

  2. 在程序部分选择您的程序。我们为此示例选择儿童计划。

  3. 选择属性选项卡。

  4. 通过将程序属性检查为可搜索来启用重复搜索

您选择为“可搜索”的属性将是系统用来检测可能的重复项的属性。 让我们通过一个示例来解释这一点,该示例演示在为儿童计划注册儿童时检测可能的重复项。

  1. 打开**捕获**应用。

  2. 从顶部的菜单中选择您的组织单位和计划。

  3. Click Create new person

  4. 在表格中填写名字。 请记住,我们在维护应用程序中检查为“可搜索”的名字。 Click Save person . The system will start looking for possible duplicates that match the name Sarah.

  5. The system will automatically show a list of possible duplicates if there are any.

  6. You can choose to make a new enrollement by clicking Save as new or if you see the right person in the list - you can view the dashboard.

提示

您可以像我们为程序所做的那样,为跟踪的实体类型配置重复检测。

程序规则执行

在注册跟踪实体实例的两种情况下(有注册或没有注册),系统将运行您配置的程序规则。 请注意,可以在维护应用程序中配置规则。

要在注册跟踪实体实例时查看正在执行的规则,您必须执行以下步骤。

  1. 在维护应用程序中配置规则。对于下面的示例,我们配置了一个规则,当出生日期小于一年时会发出警告。

  2. 打开**捕获**应用。

  3. 从顶部的菜单中选择您的组织单位和计划。

  4. 用小于一年的值填写出生日期。在我们的例子中,这是 2021 年 1 月 27 日。

  5. 您现在将能够在出生日期字段下方看到程序规则产生的警告。

Re-enroll an existing tracked entity instance

When you are on the re-enroll page, the teId will be visible in the URL parameters. The attributes of the tracked entity instance will be pre-fielded with the current values.

添加关系

可以在注册,编辑或查看事件期间添加关系。 目前,**捕获应用**仅支持*事件到跟踪的实体实例*关系。

  1. 如果发生事件,请单击**添加关系**。

  2. 选择您要创建的关系类型。

您现在有两个选择:

  • **链接到现有的跟踪实体实例**或

  • 创建新的跟踪实体实例

relationship options

  1. Click Link to an existing Tracked Entity Instance .

  2. 您将看到一些用于搜索 Tracked Entity Instance 的选项。 您可以选择**程序**。如果选择了**程序**,则属性源自所选的**程序**。 如果未选择 program ,则只有属于 Tracked Entity Instance 的属性可见。

    search for Tracked Entity Instance

    • 如果 Tracked Entity Instance program 配置了唯一属性,则该属性可以是 用于查找特定的 Tracked Entity Instance program 。此属性应单独显示。 填写完唯一属性字段后,单击位于右下方的 Search 按钮 唯一属性字段。

    • 如果 Tracked Entity Instance program 具有属性,则可以通过展开 Search by attributes 框来进行搜索。 填写完所有所需的属性字段后,单击位于底部的**按属性搜索** 按钮。您还可以通过设置**组织单位范围**来限制搜索。如果设置为*所有可访问*,您将在您有权访问的所有组织单位中搜索**跟踪实体实例**。如果您选择 Selected ,系统会要求您选择要在哪些组织单位内进行搜索。

  3. 成功搜索后,您将看到与搜索条件匹配的 Tracked Entity Instances 列表。 要创建关系,请单击要与其创建关系的 Tracked Entity Instance 上的 Link 按钮。

  4. 如果您没有找到您要查找的 Tracked Entity Instance ,您可以单击 New search Edit search 按钮。 新搜索 将带您进入新的空白搜索,而 编辑搜索 将带您返回到您刚刚执行的搜索,并保留搜索条件。

创建新的跟踪实体实例

  1. 点击**新建 追查实体 实例**。

  2. 您现在会看到一个用于注册新 Tracked Entity Instance 的表单。您可以选择注册或不注册程序。 如果选择了一个程序,新的 Tracked Entity Instance 将被注册到该程序中。您还可以通过删除自动设置的组织单位并选择新的组织单位来更改 组织单位

register new Tracked Entity Instance

  1. 填写所需的(可能是必填的)属性和注册详细信息。

  2. Click Create Tracked Entity Instance and Link .

注意

填写数据时,您可能会遇到警告,告诉您已发现可能的重复项。您可以单击警告以查看这些 重复项,如果重复项匹配,您可以通过单击 Link 按钮选择链接该 Tracked Entity Instance 。 如果完成数据填写后警告仍然存在,您将不会看到 Create Tracked Entity Instance and Link 按钮。 相反,您将看到一个名为 查看重复项 的按钮。单击此按钮时,将显示可能重复的列表。 如果这些重复项中的任何一个与您尝试创建的 Tracked Entity Instance 匹配,您可以单击 Link 按钮,否则您可以单击 Save as new person 按钮注册一个新的 Tracked Entity Instance

编辑活动

  1. 打开**捕获**应用。

  2. 选择一个程序。

  3. Select an organisation unit or click the all events -link to view all events accessible to you.

    注册到所选程序的所有事件均显示在列表中。

  4. 单击您要修改的事件。

  5. 点击**编辑事件**按钮。

  6. 修改 事件 详细信息,然后单击**保存**。

删除活动

  1. 打开**捕获**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。

注册到所选程序的所有事件均显示在列表中。

  1. 单击 三点 图标 事件 你想删除。

  2. 在显示的菜单中点击**删除事件**。

    delete event

修改事件列表布局

您可以选择在事件列表中显示或隐藏哪些列。这个可以 例如当您有很长的数据元素列表时很有用 分配到程序阶段。

  1. 打开**捕获**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。

注册到所选程序的所有事件均显示在列表中。

  1. Click the gear icon on the top right of the event list.

  2. Select the columns you want to display and click Save .

    modify event list

提示

您可以通过将数据元素拖放到列表中来重新组织数据元素的顺序。

过滤事件列表

  1. 打开**捕获**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。

注册到所选程序的所有事件均显示在列表中。

事件列表顶部是按钮,其名称与列表中的列标题相同。

  1. 使用列表顶部的按钮可根据报告日期或特定数据元素进行过滤。

    filter event

注意

不同的数据元素类型以不同的方式进行拟合。例如, Number 数据元素将显示要筛选的范围,而 Text 数据元素将要求您输入要筛选的搜索查询。

排序活动清单

  1. 打开**捕获**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。 注册到所选程序的所有事件均显示在列表中。

  4. 单击列标题之一,以按升序对该数据元素上的列表进行排序。

列旁边会显示一个向上的小箭头,以表明列表是按升序排序的。

  1. 再次单击列标题,以降序对该数据元素上的列表进行排序。

该列旁边会显示一个小的向下箭头,以显示该列表以降序排列。

![sort event](resources/images/sort_event.png)

下载活动清单

  1. 打开**捕获**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。 注册到所选程序的所有事件均显示在列表中。

  4. Click the three dots icon on the top right of the event list.

  5. Click Download data .

  6. 选择您要下载的格式。

    download event list

Note

You can download an event list in JSON or CSV formats.

预定义列表视图

您可以设置自己的视图并保存以供以后使用。这些视图也可以与其他人共享。视图由过滤器,列顺序和事件排序顺序组成。

保存新视图

  1. 选择一个组织单位和一个程序。

  2. 使用事件列表上方的过滤器按钮设置过滤器(在此处详细说明(#capture_filter_event_list))。

  3. 通过单击齿轮图标设置列顺序,然后在弹出窗口中根据您的偏好指定布局(如何修改布局在[此处](#capture_modify_event_list_layout)详细说明)。

  4. 通过单击列标题之一对事件进行排序(在[此处](#capture_sort_event_list)详细说明)。

  5. 打开右侧的更多菜单(三个点图标),然后选择“保存当前视图...”

  6. 填写视图的名称,然后单击“保存”。

加载视图

  1. 选择具有预定义视图的组织单位和程序。

  2. 这些视图应在事件列表本身上方。单击一个视图以加载它。

  3. 加载视图的示例。

更新视图

  1. 加载您要更新的视图(请参见[加载视图](#capture_view_load))。

  2. 对过滤器,列顺序和/或事件排序顺序进行更改。

    Note

    An asterisk(*) is appended to the view name when the view has unsaved changes.

  3. 打开右侧的更多菜单(三个点图标),然后选择“更新视图”。

分享观点

  1. 加载您要共享的视图(请参见[加载视图](#capture_view_load))。

  2. 打开右侧的更多菜单(三个点图标),然后选择“共享视图...”

  3. 进行更改。通常,您将添加用户/组(1)和/或更改先前添加的用户/组的访问权限(2)。

删除视图

  1. 加载您要删除的视图(请参见[加载视图](#capture_view_load))。

  2. 打开右侧的更多菜单(三个点图标),然后选择“删除视图”。

User assignment in events programs

可以将事件分配给用户。必须为每个程序启用此功能。

Assigning user to new events

  1. 选择启用了用户分配的组织单位和程序。

  2. Click New Event in the upper right corner.

  3. 您会在数据输入页面底部附近找到受让人部分。搜索并选择要将事件分配给的用户。保存事件时将保留受让人。

变更受让人

  1. 选择启用了用户分配的组织单位和程序。

  2. 单击列表中的事件

  3. 在右列中,您将找到“受让人”部分。

  4. Click the Edit button, or the Assign button if the event is not currently assigned to anyone.

  5. Search for and select the user you would like to reassign the event to. Click the Save button.

事件列表中的受让人

在事件列表中,您将可以查看每个事件的受让人。此外,您可以由受让人对列表进行排序和过滤。

按受让人过滤

  1. 单击**分配给**过滤器。

  2. 选择您的首选受理人筛选器,然后单击“更新”。

追踪程式

The Capture app supports the workinglists in tracker programs, but when you open a tracked entity instance, you will be redirected to the enrollment dashboard in the Tracker Capture app.

搜索跟踪的实体实例

在计划范围内

  1. 打开**捕获**应用。

  2. 选择一个程序。

您将仅看到与所选组织单位相关联的程序以及您有权访问的程序,并且这些程序通过数据级别共享与用户组共享。

  1. Click the Search button.

  2. 从下拉菜单中单击第一个选项。

这些步骤将带您进入搜索页面。在这里,根据组织的配置,您将看到可以搜索的不同属性。下面是一个如何看起来的示例。

![](resources/images/search-by-attributes-on-scope-program-overview-0.png)

要立即执行搜索:

  1. 填写要搜索的属性。

  2. 单击**按属性搜索**按钮。

  3. 搜索结果将显示如下。

在此列表中,您可以看到与搜索匹配的条目。对于每个条目,您总共可以有三个选项。

一种。您可以通过单击“查看仪表板”按钮来选择查看 **Tracked Entity Instance** 的仪表板
![](resources/images/search-by-attributes-on-scope-program-overview-5.png)
湾您可以通过单击“查看活动注册”按钮查看 **跟踪实体实例** 的活动注册
![](resources/images/search-by-attributes-on-scope-program-overview-3.png)
C。您可以将 **Tracked Entity Instance** 重新注册到您正在搜索的当前程序中。
![](resources/images/search-by-attributes-on-scope-program-overview-4.png)

您进行了完整的搜索结果,则您明确显示了这些结果。但是,正在搜索的具体**T 跟踪真实实例** 可能不同的中。如果在这种情况下,您可能希望将搜索扩展到其他项目。

To execute a fallback search, simply press the button on the bottom saying "Search in all programs". You will see the Results in all programs be appended below the search in the current program. These two modules are collapsible to save space.

If the fallback can not be done, you will be presented with a modal to go Back to search so that you can change the search terms.

注意

只有在程序内搜索时才可以进行后备搜索。

Create new Tracked entity instance

When none of the results match, you can create a new user by clicking Create new button on the bottom of the search page.

Based on the search domain, you will be navigated to the registration of the selected Tracked entity type , with or without program enrollment preselected. The search terms that you typed in before will be prefilled in the registration form.

在“跟踪的实体类型”范围中

  1. 打开**捕获**应用。

  2. Click the Search button to open the search page.

  3. 单击下拉菜单,然后选择要搜索的实体类型。

  4. 从列表中进行选择。

根据组织的配置,您将看到可以搜索的不同属性。下面是一个如何看起来的示例。

![](resources/images/search-by-attributes-on-scope-tetype-overview-0.png)

要立即执行搜索:

  1. 填写要搜索的属性。

  2. 单击按属性搜索按钮。

  3. 搜索结果将显示如下。

    在此列表中,您可以看到与您的搜索匹配的条目。对于每个条目,您都可以选择单击“查看仪表板”按钮以查看 Tracked Entity Instance 的仪表板。

结果功能过多

您正在其中搜索的程序或跟踪的实体类型可能配置有对从搜索中检索到的结果数的限制。如果您的搜索结果超过了此限制,则会显示一条警告消息,如下所示。

分页

结果页面一次最多显示五个结果。您应该尝试使用特定的搜索条件,以便没有太多的匹配项。但是,如果有五个以上的结果,则可以使用页面末尾的**> **按钮查看下一个结果。

列出在程序 { #list-tracked-entity-instances-enrolled-in-program } 中注册的跟踪实体实例

  1. 打开**捕获**应用。

  2. 选择一个组织单位。

  3. Select a tracker program with "Display front page list" set to true.

  4. 该程序可以具有与其关联的类别(实施合作伙伴将是此类类别的一个示例)。如果是这种情况,请填写它们。

Custom TEI working list for programs with "Display front page list" set to false.

  1. 打开**捕获**应用。

  2. 选择一个组织单位。

  3. Select a tracker program with "Display front page list" set to false.

  4. If the program has any custom working list you are able to click and load it.

过滤列表

使用列表本身上方的按钮对其进行过滤。

例如,您可以过滤列表以仅显示已分配事件的跟踪实体实例:单击“分配给”过滤器 (1),选择“我”(2),然后“应用”更改 (3 )。

对列表进行排序

单击列标题之一以按该列对列表进行排序。列标题旁边会显示一个小箭头,以指示当前的排序顺序。再次单击可在升序和降序之间切换。

修改列表布局

您可以选择要在列表中显示的列,还可以重新组织列的顺序。

单击列表右上角的**齿轮** 图标。勾选要显示的列的复选框 (1) 并通过拖放 (2) 重新组织列。

加载预定义的列表视图

您将在列表过滤器上方找到预定义的列表视图。单击以加载视图。

Download the tracked entities list

  1. 打开**捕获**应用。
  2. 选择一个组织单位。
  3. Select a tracker program with "Display front page list" set to true.
  4. Click the three dots icon on the top right of the tracked entities list.
  5. Click Download data .
  6. 选择您要下载的格式。
    download tracked entities list

    Note You can download the tracked entities list in JSON or CSV formats.

Tracker program stage working list

You can show data elements from a single stage in a working list. Select the "Program stage" option from the "More filters" dropdown, then choose a program stage.

The tracker program stage list can be filtered , sorted , modified , saved , updated , deleted and shared in the same way as other working lists.

实施者/管理员信息

元数据缓存

出于性能原因,Capture应用程序在客户端浏览器中缓存元数据。在服务器上更新元数据时,需要将更改传播到已经缓存了元数据的客户端。根据更改,可以通过以下三种方式之一完成此操作:

  1. 如果更改绑定到某个程序,则需要为该特定程序增加程序版本。例如,如果您更改程序或程序规则中的数据元素,则需要增加绑定程序的版本。

  2. 如果更改未绑定到程序,则需要增加任何程序版本,以将更改传播到客户端。这里的示例是对常量,组织单位级别或组织单位组的更改。

  3. 上面两个规则的例外是选项集。选项集具有自己的版本属性,即,增加选项集版本应确保将选项集元数据传播到客户端。

注册仪表板

Enabling the enrollment dashboard

Opt in

Enable the enrollment dashboard for a Tracker program for all the users. The dialog is visible for users with program write access.

Opt out

Disable the enrollment dashboard for a Tracker program for all the users.

通过 url { #reaching-the-enrollment-dashboard-via-url } 到达注册仪表板

您可以通过在浏览器的地址栏中键入或使用捕获应用程序的用户界面来访问注册仪表板。 在本节中,我们关注第一个用例,您可以在地址栏中键入或粘贴要访问的 url。

One way to reach the enrollment dashboard and view a specific tracked entity instance's enrollment is by using only the enrollment id. For example the link .../dhis-web-capture/#/enrollment?enrollmentId=wBU0RAsYjKE will take you the dashboard for the enrollment with id wBU0RAsYjKE .

仪表板的顶部定义了您的上下文。例如下图中的上下文如下,选择的程序是“Child Programme”,组织单位是“Ngelehun CHC”,选择的人是“Anna Jones”,选择的招生是“2017-11-16 11 :38"。

您可以通过单击“x”按钮来更改上下文。

取消选择程序

当您取消选择该程序时,您会看到以下内容

选择一个有注册的程序

当程序_和_注册选择为空时,您首先必须选择一个程序。 如果被跟踪实体实例(在本例中为“Anna Jones”)在您选择的程序下注册,您将看到以下消息。

选择零注册的程序

如果被跟踪的实体实例(在本例中为“Anna Jenkins”)在您选择的计划下没有注册,您将看到一条消息,说明该计划没有注册。 您还可以选择在该计划中注册“安娜·詹金斯”。

选择活动程序

当您选择一个事件程序时,您将看到以下内容。 (请记住,事件程序在系统中没有注册,只有跟踪程序有)。

您还可以选择为所选节目创建新事件或查看所选节目的工作列表。

选择具有不同跟踪实体类型的程序

当您选择的跟踪实体类型是人时,如我们的 Anna Jenkins 示例,并且您选择的程序不是人类型而是疟疾病例类型,您将看到以下内容。

您还可以选择在您选择的程序中注册跟踪实体实例。

取消选择组织单位

当您取消选择组织单位时,您会看到以下内容

取消选择跟踪实体实例

当您取消选择被跟踪实体实例时,在本例中为“Anna Jones”,您将被带到该 Tracker 程序中的工作列表。

取消选择注册

当您取消选择注册时,您会看到以下内容

Quick actions

The quick actions widget offers shortcuts for frequently used actions for the current enrollment.

Program stage list

Stages can be collapsed or expanded to reveal the events inside.

Collapsed stages

In the collapsed state, you can view the summary information about this stage including: - Icon - Program stage name - Program stage description (on hovering the information icon) - Total number of events - Last updated date Depending on the status of events, there can be additional information regarding: total number of overdue events or total number of scheduled events.

Expanded stages

When you expand the list, you will see the table contains the data of events in the stage. This includes mandatory columns: Status , Report date and Registering unit , the following columns depend on the data elements that have been selected as Display in list of event.

Events are sorted with most recent on top and other columns are also sortable.

When clicking New {stage event name} button, you will be redirected to the Add new event page for this selected stage.

When clicking Go to full {stage event name} button, you will be redirected to the Program stage list page for this selected stage.

Expanded stages with more than 5 events

In case there are more than 5 events in the list, only the first 5 are shown. You will be able to view the rest by clicking Show more .

If you want to collapse events, you can use Reset list button which will return the table back to the default sorting and initial 5 events.

Enrollment widget

On the enrollment page you can see the enrollment widget

Enrollment actions

When you click on the enrollment actions button, a menu with all the available actions will open. You can change the enrollment status to Active, Canceled or Completed using the buttons in the menu. You can mark or remove the enrollment for a follow-up.

There can only be one active enrollment at a time. If there are no active enrollments, there will be a button Add new to enroll the tracked entity instance in the program again. If the program only allows one enrollment per tracked entity instance, the Add new button will be disabled with a tooltip saying Only one enrollment per {TET} is allowed in this program .

In the enrollment actions, you could also choose to transfer the enrollment to another organisation unit. Click the transfer button and select the organisation unit you want to transfer the enrollment to.

Delete the enrollment

You can delete the enrollment by clicking the delete button and confirming the action in the modal.

Complete the enrollment

You can complete the enrollment by clicking the complete button. When there are active events, you can choose to complete the enrollment along with the events from the confirmation modal.

Enrollment comment widget

The enrollment comment widget displays comments and allows addition of comments, associated with the current enrollment.

By clicking in the text field, you will be able to enter new text and see action buttons Save comment and Cancel . Note that Enrollment comments are attributed to a user and cannot be deleted.

Relationship widget

The Relationships widget on the enrollment dashboard is used for viewing the record’s linked relationships to other records. The number next to the title signifies the total number of relationships

For tracked entity instance relationships, the key attributes shown in the widget are the attributes that have been selected to be displayed on the relationship type page in Maintenance.

If no attributes are selected, it will just show a row per record with tracked entity type name and relationship creation date.

When clicking a tracked entity instance you should be taken to the Enrollment Dashboard. If the relationship type includes a program, you should be taken to the latest enrollment for that program. If no program is specified, you should still be sent to the enrollment dashboard, but without a program.

Click the Add new button to add a new relationship. Adding a new relationship opens a dialog where you can select the applicable relationship type.

Choose between linking to an existing tracked entity instance or creating a new one.

Existing tracked entity instance

Use the search form to find any existing record to link to.

New tracked entity instance

Use the form to create a new record and link.

Tracked entity instance profile widget

On the enrollment dashboard, you can view the tracked entity instance profile widget. Inside the profile widget you can view the key attributes values.

Click the Edit button to make changes to the tracked entity instance profile. Editing the profile opens a dialog where the profile attributes can be changed.

Click the Delete ${tracked entity type} button to delete the tracked entity. You can confirm the action from the dialog. Once confirmed, tracked entity and all its associated enrollment and events across all programs will be deleted. To delete a tracked entity that has any enrollments, the user needs the authority Delete tracked entity instance and associated enrollments and events .

Feedback widget

On the enrollment dashboard, the feedback widget displays text and values that are triggered by certain conditions. If the current dashboard triggers some rules set up in the program, the text or values will be automatically displayed.

Empty state

If there isn't any feedback for the current dashboard, the widget shows a short empty message. If there aren't any program rules that could show feedback for the current dashboard then the widget is hidden.

Indicator widget

On the enrollment dashboard, the indicator widget displays indicator text and values output related to the current dashboard. The indicators will be sorted alphabetically.

Empty state

If there aren't any related indicators or indicator output for the current dashboard, the widget shows a short empty message. If the current dashboard can't show any indicator output (because it has no related indicators) then the widget is hidden.

Legends

Some indicator values show a colored circle next to the value. The colored circle shows the related legend color for that indicator value. Colored legend circles are only shown for indicator values that have them set up.

Warning widget

On the enrollment dashboard, the warning widget displays warnings related to the current dashboard. The widget shows warnings that are not associated with any specific data item. If there aren't any warnings to show for the current dashboard then the widget is hidden.

Enrollment event view and edit page

You can reach the enrollment event edit page is by clicking any event in the Program stage list from the Enrollment Overview page.

Top bar context

At the top of the page you can see various information related to the current context. You can see the program, the organization unit, the tracked entity, the enrollment date, the stage and the enrollment event date.

To go to Enrollment Overview page you can: - click the "Back to all stages and events" button. - deselect the stage from the top bar. - deselect the event from the top bar.

Error Widget

On the enrollment dashboard, the errors widget displays errors related to the current dashboard. The widget shows errors that are not associated with any specific data item. If there aren't any errors to show for the current dashboard then the widget is hidden.

View/Edit event form

This is the form where you can see and edit the enrollment event details.

Form header

In the view/edit event form you can see the stage name and icon.

Top bar context

At the top of the page you can see different informations related with the current context. You can see the program, the organization unit, the tracked entity, the enrollment date, the stage.

To go to Enrollment Overview page you can: - deselect the stage from the top bar. - deselect the event from the top bar.

Scheduled date in edit event form

If an event has the status Scheduled or Overdue, you will be able to see the Report and Schedule tab.

In the Report tab, the scheduled date field will still be shown, but will be greyed out, and there will be an icon next to it with a tooltip saying “Go to Schedule tab to reschedule this event”.

In the Schedule tab, the similar information about scheduling an event as in New event workspace will be shown. You will be able to edit the schedule date and save the change by clicking Schedule button.

If an active event has a scheduled date before becoming active or a completed event has scheduled date, this date should still be shown in the workspace. It’ll be locked with an icon next to it and a tooltip saying “Scheduled date cannot be changed for active/completed events”.

Scheduled date with Hide due date enabled

If the flag “Hide due date” in the Maintenance configuration is enabled, scheduled date will not be shown in the form.

However, you can still schedule an event, but it automatically chooses the date based on "Scheduled days from start" that has been configured in Maintenance, and this can not be changed. In the Schedule tab, there will be “Schedule info” saying “Scheduled automatically for xx/xx/xx”, and the user can click Schedule button.

Ask user to complete program when stage is complete

If this flag has been enabled for the stage in Stage details in Maintenance, a modal will show up after the user checks the Complete event checkbox and clicks save.

View mode

When the form is in the view mode the title of the page will appear as: Enrollment: View Event . You can see in the page all the information related to the event. Click the Edit event button to switch to the edit mode. This mode is bypassed for events that are scheduled.

Edit mode

When the form is in the edit mode the title of the page will appear as: Enrollment: Edit Event . You can modify the event and click the Save button. Click the Cancel button to switch to the view mode without saving the changes. Scheduled events are are the exception and they are opened in edit mode directly, without the user having to click Edit event . Click the Cancel button to go back to the enrollment dashboard page without saving the changes.

在此表单中,您还可以通过单击 删除 按钮来删除事件,将出现一个模式来确认您是否要删除此事件。然后,您将被导航回注册仪表板页面。

Widgets in View/Edit event page

The widgets seen in the right-hand column will display and function the same way as mentioned in the enrollment dashboard .

Widget assignee
  1. In View/Edit enrollment event page

  2. In the right column you will find the assignee widget.

  3. Click the Edit button, or the Assign button if the event is not currently assigned to anyone.

  4. Search for and select the user you would like to reassign the event to. Click the Save button.

Enrollment event new page

You can reach this page add event page by clicking in the New {stage event name} button in the overview page. In this page you can switch between different tabs: Report to add new event, Schedule to schedule an event and Refer to refer event. If you have unsaved changes in one tab and switch to another tab, there will be a warning displayed.

New event widget form

This is the form where you can modify the event details before saving. In the header you can see the stage name and icon.

New event page without a stage

If you enter the new event page with no stage selected, a list of available stages will be displayed. Select the stage you want to add a new event in by clicking the associated button. To navigate back to the enrollment overview, click the Cancel without saving -button

Ask user to complete program when stage is complete

If this flag has been enabled for the stage in Stage details in Maintenance, a modal will show up after the user clicks the Complete button.

Ask user to create new event when stage is complete

If this flag has been enabled for the stage in Stage details in Maintenance, a modal will show up after the user clicks the Complete button or checks the Complete event checkbox and clicks save. The user can choose the button Yes, create new event to navigate to the New Event page or No, cancel to navigate back to the enrollment dashboard. If there is only one possible stage available, the user will be taken directly to the New event workspace for that stage.

Assigning user to new events

When reporting or scheduling an event, you can assign a user to it. This feature must be enabled per program stage in a tracker program by clicking the "Allow user assignment of events" check box.

您会在数据输入页面底部附近找到受让人部分。搜索并选择要将事件分配给的用户。保存事件时将保留受让人。

Schedule event widget form

Instead of reporting an event the user can select to schedule an event for later. The form will open with a suggested scheduled date. This date is determined by a set of rules as explained below.

The suggested date for the first event of a program stage in an enrollment is always based on the enrollment date or the incident date (depending on the program configuration). The program stage configuration setting "scheduled days from start" will be added to the base date to cumpute the suggested date.

1. Default next scheduled date

If a program stage has a default next scheduled date configured, the suggested date is the most recent next scheduled date. Below is an example of how this can work.

  1. A data element with value type date needs to be created and assigned to the particular program stage with access to future dates. The name of the data element could for example be: Next suggested follow up date. The program stage is configured to use the data element as default when scheduling a new event by assigning the data element to default next scheduled date.

  1. A program rule based on the data entered in the program stage, will determine how many days until the next suggested follow up will be. For example: A program rule with the following condition: #{penta_dose} == '1' (The program rule will trigger when the TEI has received Penta Dose 1), Assign value to the data element: next suggested follow up date with expression: d2:addDays(V{event_date}, '30') The number suggest how many days from event date the next scheduled event should be.

  2. Open the Capture app and create a TEI. As long as Penta Dose has value Dose 1, the suggested next scheduled event is 30 days forward from event date. When scheduling a new event, the system will pick up from the data element as long it has value.

User can also find more information about how many events that scheduled on the same selected date or the interval of selected date and the suggested date from the information box.

Below the schedule date entry, user can choose to add a comment to the scheduled event.

After clicking Schedule button, user will be navigated back to enrollment overview page.

2. Standard interval days

  1. If the program stage has standard interval days configured, the suggested date is calculated by the most recent event date plus the standard interval days value.

  1. If the program stage do not have a default next scheduled date configured, the system will use the standard interval days to calculate the next scheduled event date.

3. If no value is found on either, the suggested date will be defined by enrollment date and incident date.

  1. In case the option Generate events based on enrollment date is checked in the Maintenance app, the next suggested event date is calculated by the enrollment date plus the value of scheduled days from start.

  1. In case the option Show incident date is checked, the next suggested event date is calculated by the incident date plus the value of scheduled days from start.

Program stage event list

You can reach the program stage event list by clicking Go to full {stage event name} button in the overview page.

Stage Event list

In this view you can see all events in a stage

Stage Event list header

In the header, you can see the stage name and icon

Attribute option combo for Tracker

You can add segregation to your Tracker event data using attribute option combos. To get started, add a category combination to your Tracker program configuration.

The attribute option combo selector will be displayed when you are adding or changing/viewing Tracker events. Additionally, the selector will be displayed when enrolling if events are being auto-generated as part of the enrollment process.

Example from new Tracker event:

使用事件捕获应用

关于事件捕获应用

Event Capture 应用程序中,您可以注册在某个时间发生的事件 特定的时间和地点。事件可以在任何给定点发生 时间。这与常规数据形成对比,常规数据可以为 预定义的定期间隔。事件有时被称为案例或 记录。在 DHIS2 中,事件与程序相关联。 事件捕获 应用程序可让您选择组织单位和计划并指定日期 事件发生时,在输入事件信息之前。

Event Capture 应用程序可在线和离线工作。如果互联网 连接性下降,您可以继续捕获事件。活动将 本地存储在您的 Web 浏览器(客户端)中。当连通性有 返回后,系统会要求您上传本地存储的数据。这 系统然后将数据发送到存储数据的服务器。

注意

如果您在离线模式下关闭网络浏览器,则无法 重新打开一个新的 Web 浏览器窗口并继续工作会话。 但是数据还是会保存在本地,可以上传到 下次机器在线并且您已登录时的服务器 进入服务器。

  • 您只能看到与您所拥有的组织单位相关联的计划 通过您的用户角色选择的和您有权查看的程序。

  • 支持跳过逻辑和验证错误/警告消息 在注册过程中。

  • 当您关闭组织单位时,您无法注册或编辑 在 Event Capture 应用程序中将事件发送到此组织单位。你 仍然可以查看和过滤事件列表并查看事件的详细信息 事件。

  • 支持即时指标表达式评估。如果一个 程序为其定义了指标以及所有值的时刻 相关指标表达式被填充,系统将 计算指标并显示结果。

  • 排序: 这可以通过单击每个排序图标来完成 列标题。红色排序图标表示当前排序 柱子。但是,排序功能仅在 页面显示。目前,无法从 服务器端。

  • **过滤:**这是通过单击显示的小搜索图标来完成的 在每个列标题的右侧。单击它们提供输入 字段以键入过滤条件。系统开始应用 过滤用户开始输入的那一刻。在过滤过程中,它是 可以定义日期类型数据元素的开始和结束日期 以及数字类型的下限和上限。服务器端过滤 暂时不支持。

注册活动

  1. 打开**事件采集**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。

    您只会看到与所选组织关联的计划 您可以通过您的用户角色访问的单元和程序。

  4. 点击**注册事件**。

  5. 选择一个日期。

  6. 填写必填信息。

    如果程序的程序阶段配置为捕获 GPS 坐标,您可以通过两种方式输入坐标:

    • 直接在相应字段中输入值。

    • 在地图中选择一个位置。地图选项还显示 为组织单位定义的多边形和点。

  7. 点击**保存并添加新**或**保存并返回**。

注意:事件中的某些数据元素可能是强制性的(在数据元素标签旁边标有红星)。 这意味着在允许用户保存事件之前,必须填写所有必填数据元素。 例外情况是,如果用户具有名为 “忽略跟踪器和事件捕获中必填字段的验证”的权限。 如果用户有此权限,则在保存和保存前无需填写必填数据元素 红星不会显示在数据元素标签旁边。请注意,自动拥有 "ALL" 权限的超级用户 有这个权限。

编辑活动

  1. 打开**事件采集**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。

    注册到所选程序的所有事件均显示在列表中。

  4. 点击事件您要修改并选择**编辑**。

  5. 修改事件详细信息并点击**更新**。

编辑网格中的事件

在网格中编辑 功能允许您在网格中编辑选定的事件 表,但只有那些列(数据元素)在网格中可见。如果 您需要更多列,请使用 Show/hide columns 指定哪个 列应显示在列表中。

  1. 打开**事件采集**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。

    注册到所选程序的所有事件均显示在列表中。

  4. 点击 事件 您要修改并选择**在网格中编辑**。

  5. 修改事件详细信息。

  6. 单击另一个事件以关闭编辑模式。

在编辑模式下分享活动

您可以通过事件的网址以编辑模式共享事件。

  1. 打开**事件采集**应用。

  2. 在编辑模式下打开要共享的事件。

  3. 复制URL。

    确保 URL 包含“事件”和“ou”(组织单位) 参数。

  4. 将 URL 粘贴到您选择的共享方法中,例如 电子邮件或 DHIS2 中的消息。

    如果您在单击链接时未登录到 DHIS2,您将被 要求这样做,然后带到仪表板。

查看事件审核历史记录

  1. 打开**事件采集**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。

    注册到所选程序的所有事件均显示在列表中。

  4. 单击一个 事件 并选择**审计历史**。

删除活动

  1. 打开**事件采集**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。

    注册到所选程序的所有事件均显示在列表中。

  4. 单击一个 事件 并选择**删除**。

  5. 点击**删除**确认删除。

修改事件列表的布局

您可以选择在事件列表中显示或隐藏哪些列。这个可以 例如当您有很长的数据元素列表时很有用 分配到程序阶段。一旦你修改了布局,它就会被保存 在您的用户个人资料上。您可以针对不同的布局使用不同的布局 程式。

  1. 打开**事件采集**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。

    注册到所选程序的所有事件均显示在列表中。

  4. 点击**显示/隐藏列**图标。

  5. 选择要显示的列,然后单击**关闭**。

打印事件列表

  1. 打开**事件采集**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。

    注册到所选程序的所有事件均显示在列表中。

  4. 点击**打印列表**。

下载活动清单

  1. 打开**事件采集**应用。

  2. 选择一个组织单位。

  3. 选择一个程序。

    注册到所选程序的所有事件均显示在列表中。

  4. 点击** Downlad **图标,然后选择一种格式。

    您可以下载XML,JSON或CSV格式的事件列表。

使用Tracker Capture应用

关于Tracker Capture应用

Tracker Capture 应用程序是 **Event 的高级版本 捕捉**应用程序。

  • 事件捕获 :处理单个事件 *无需*注册

  • Tracker Capture :处理多个事件(包括单个事件) 事件)*与*注册。

  • 您为已注册的跟踪实体实例捕获事件数据 (泰)。

  • 您只能看到与您所拥有的组织单位相关联的计划 通过您的用户角色选择的和您有权查看的程序。

  • 您在搜索和注册功能中看到的选项取决于 您选择的程序。程序属性控制这些 选项。属性还决定了 TEI 中的列名称 列表。

    如果未选择程序,则系统将选择默认属性。

  • 支持跳过逻辑和验证错误/警告消息 在注册过程中。

  • 当您关闭组织单位时,您无法注册或编辑 在 Tracker Capture 应用程序中将事件发送到此组织单位。你 仍然可以搜索 TEI 并过滤搜索结果。你可以 还可以查看特定 TEI 的仪表板。

关于跟踪的实体实例(TEI)仪表板

您可以通过 Tracker Capture 应用程序中的 TEI 仪表板管理 TEI。

  • 仪表板由小部件组成。拖放小部件以放置 它们按照您想要的顺序和位置。

  • 单击图钉图标将右侧的小部件列固定到固定位置 位置。这在数据输入期间尤其有用。

    如果您有许多数据元素或大表格要填写,请粘贴 右侧小部件列。然后你放置在右边的所有小部件 在数据输入部分滚动时,列保持可见。

  • 为您选择的程序定义的任何指标都将具有 计算并显示在 指标 小部件中的值。

  • 导航:

    • 返回 :带您返回搜索和注册页面

    • 上一个和下一个按钮:带您到上一个或下一个 TEI TEI 搜索结果列表中的仪表板

    • **其他项目**字段:如果 TEI 注册在其他项目中 程序,它们在此处列出。单击程序以更改 为所选 TEI 输入数据的程序。当你 更改程序,小部件中的内容也会更改。

工作流程

母婴健康工作流程 程序

  1. 创建新的或找到现有的TEI。

    您可以搜索已定义的属性,例如名称或地址。

  2. 将TEI注册到程序中。

  3. 应用程序根据时间的服务,创建一个 TEI 活动计划。

  4. 根据计划,TEI 提供各种服务。 所有服务都被记录下来。

  5. 使用有关个别案例的信息来创建报告。

链接到Tracker Capture应用

您可以在“主屏幕上共享程序选择。

  1. 打开 随访采集 应用程序。

  2. Select the program you want to link to.

  3. 复制URL。

    • 确保URL包含“ program”参数。
  4. 将 URL 粘贴到您选择的共享方法中,例如 电子邮件或 DHIS2 中的消息。

Note: If the program does not exist in the selected organisation unit (that is stored in the local cache) the system will instead select the first available program for that organisation unit. If the local cache is empty/clean and the root organisation unit of the current user does not have the specified program, the system will also here select the first available program for the root organisation unit.

链接到TEI仪表板

您可以通过其网址共享TEI仪表板。

  1. 打开 随访采集 应用程序。

  2. 打开您要共享的仪表板。

  3. 复制URL。

    确保 URL 包含“tei”、“program”和“ou” (组织单位)参数。

  4. 将 URL 粘贴到您选择的共享方法中,例如 电子邮件或 DHIS2 中的消息。

    如果您在单击链接时未登录到 DHIS2,您将被 要求这样做,然后带到仪表板。

创建TEI并将其注册到程序中

您可以创建TEI并通过一次操作将该TEI注册到程序中:

  1. 打开 随访采集 应用程序。

  2. 在左侧窗格的组织单位树中,选择一个 组织单位。

  3. 选择一个程序。

  4. 点击**注册**。

  5. 填写必填信息。

    跟踪实体类型和程序都可以配置为使用特征类型。 这使得捕获 TEI 或注册的几何图形成为可能。 支持的要素类型是点和面。请参阅**如何使用几何体**。

  6. If the selected program is configured to display first stage during registration, 必须填写阶段中的所有必填字段。在阶段结束时 系统还会询问您是否要完成已为其输入数据的阶段。 如果您选择**是**,则该阶段将在保存后处于完成状态。如果您选择**否**, the stage will have the status active.

  7. 如果配置了搜索程序,将进行后台搜索 在可搜索字段上执行以帮助您防止注册 重复。如果有任何匹配的 TEI,则会出现一个蓝色框 显示在表格的右侧,可以查看 这些匹配 TEI。

如果有任何匹配的 TEI,请单击 Continue 以查看可能的 在注册新的之前重复。

如果没有匹配的 TEI,请单击 Save and continue Save and 添新

  • 保存并继续 :完成注册并打开 注册 TEI 的仪表板

  • 保存并添加新 :完成注册但保留在 同一页。当您想注册和登记一个时使用此选项 TEI 接连输入数据。

Note: All mandatory attributes have to be filled in to be able to save. Mandatory attributes are marked with a red star next to the attribute label. If the user has the authority called "Ignore validation of required fields in Tracker and Event Capture" you will not be required to fill in the mandatory attributes and will not see the red star next to the attribute label. Note that super user that have the "ALL" authority automatically have this authority.

打开现有的TEI仪表板

有多种方法可以找到 TEI:使用“列表” 当前选择中的预定义列表,或“搜索”全局 抬头。

列表用于查找和显示所选组织单位中的 TEI 和程序。

  1. 打开跟踪的捕获应用程序

  2. 在左侧窗格的组织单位树中,选择一个 组织单位

  3. 选择一个程序

  4. 如果尚未选择,请单击“列表”按钮

如果未配置,则一组预定义列表将可用:

  1. 具有任何注册状态的任何TEI

  2. 积极注册当前计划的TEI

  3. 已完成当前课程注册的TEI

  4. 已取消当前课程注册的TEI

您可以选择在列表中为每个列显示或隐藏哪些列 程序。这将保存在您的用户设置中。

  1. 单击**网格**图标按钮

  2. 检查您要包括的列

  3. 点击**保存**

还可以选择使用自己的方式创建自定义工作列表 过滤器。这可用于动态创建自定义列表。

列表也可以下载或打印。

自定义预定义列表

如果程序有任何与之关联的自定义跟踪实体过滤器, 这些将取代上面提到的四个预定义列表。 预定义列表在配置良好时将成为查找的有效方法 或在该程序中使用与用户相关的数据。

可以使用多种选项定义工作列表,这里有一些 例子:

  • Display all TEIs with at least one event in a given program stage that has a due date on the current date.
  • Display all TEIs that has at least one event that is assigned to the logged in user.
  • 显示所有活动的但未分配给任何用户的TEI。

跟踪器捕获中的预定义工作列表

有关支持的功能的完整列表,请参阅 API 文档 这些预定义的跟踪实体实例过滤器。

Search is used to search for TEIs in the organisation units the user has search access to. This can be used if you want to find a TEI, but you don't know which organisation unit or program the TEI was enrolled in. There are two ways of doing this: With and without a program context. Searchable fields needs to be configured. For configuring searching with program context, this is done individually for each program in the program maintenance app. For configuring searching without a program context, this is done individually for each tracked entity type in the tracked entity type maintenance app.

在没有程序上下文的情况下进行搜索:

  1. 打开 Tracker Capture 应用程序

  2. 点击**搜索**按钮

  3. 可搜索的字段将分组显示。唯一属性是 只能单独搜索。可以组合非唯一属性。

  4. 填写搜索条件并点击**搜索**图标按钮。

在程序上下文中搜索:

  1. 打开 Tracker Capture 应用程序

  2. 选择具有您要搜索的程序的组织单位 在

  3. 选择程序

  4. 点击**搜索**按钮

  5. 可搜索的字段将分组显示。唯一属性是 只能单独搜索。可以组合非唯一属性。

  6. 填写搜索条件并点击**搜索**图标按钮

搜索完成后,您将看到搜索 结果。显示的内容取决于搜索结果。

对于唯一属性搜索:

  • 如果未找到匹配的 TEI,您将有机会打开 报名表格。

  • 如果在所选组织单位中找到 TEI,则 TEI 仪表板将自动打开。

  • 如果在所选组织单位之外发现 TEI,您 将有机会打开 TEI。

对于非唯一属性搜索:

  • 如果没有找到匹配的 TEI,您将有机会打开 报名表格。

  • 如果找到匹配的 TEI,您可以单击 结果列表,或打开注册表。

  • 如果找到的匹配项过多,系统会提示您 优化您的搜索条件

搜索结果具有标记跟踪实体实例的功能 尽可能重复,请参阅下一章。

选择打开注册表时,搜索值将 自动填写到注册表中。

将跟踪的实体实例标记为潜在重复项

在跟踪器捕获应用程序中搜索被跟踪实体实例时,用户 有时会怀疑一个或多个搜索命中是重复的 其他跟踪的实体实例。用户可以选择点击 **在搜索结果网格的最右列中标记可能的重复**链接。

以这种方式标记的跟踪实体实例将被标记为“可能重复” 在 DHIS2 数据库中。该标志表示被跟踪的实体实例是/具有 复制。用户可以在两个位置看到此类标志的存在。一个是 结果列表本身(在这个例子中,Mark Robinson 已经被标记为潜在的 复制):

Tracker 捕获搜索结果

另一个位置在跟踪的实体实例仪表板中:

被跟踪的实体实例标记为重复

除了潜在地通知用户被跟踪的实体实例 作为重复,该标志将被底层系统用于查找和 在即将发布的 DHIS2 版本中合并重复项。

打破玻璃

If the program is configured with access level protected , and the user searches and finds tracked entity instances that is owned by organisation unit that the user does not have data capture authority for, the user is presented with the option of breaking the glass. The user will give a reason for breaking the glass, then gain temporary ownership of the tracked entity instance.

在程序中注册现有的TEI

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 选择一个程序。

  4. 在**注册**小元件中,点击**添加新**。

  5. 填写需要信息,然后点击**注册**。

输入TEI的事件数据

数据输入小部件

在 TEI 仪表板中,您在 时间线数据条目 中输入事件数据 或**表格数据输入**小部件。

Data entry widgets in the Tracker Capture app
Widget name 描述
Timeline Data entry For data entry using either default or custom forms.

Depending on program definition, in particular program stages, events will be displayed in a timely fashion. Clicking on any of them displays the corresponding data entry. If a stage needs new event, a plus icon is displayed for new event creation. To proceed with data entry, it is mandatory to have event date. Once an event date is specified it is not possible to change due date. The assumption is that by specifying event date, the event has already taken place. If the event hasn't occurred yet, it is possible to change due date - this is effectively doing nothing but rescheduling. The buttons at the bottom help to change the status of a selected event.

Another key feature from this widget is addition of multiple notes for an event. Normally data recording is through data elements, however there are cases where it is necessary to record additional information or comments. This is where the notes section comes handy. However it is not possible to delete a note. The idea is notes are more like log books. Both skip-logic and validation error/warning messages are supported during data entry.

Also included in the Timeline Data entry is the option to compare your data entry to previous entries. This can be enabled by clicking the "Switch to compare form" button (Two sheets of paper) in the top right corner of the Timeline Data entry widget.
Tabular data entry For tabular-style data entry.

The widget displays the list of program stages as left-hand side labels. Events will be listed in table for repeatable program stage, and allows for in-line edits of event data values.

建立活动

您可以通过以下方式为TEI创建事件:

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 时间线数据条目 表格数据条目 小部件中, 单击 + - 按钮。

  4. Select a Program stage and set a Report date .

    程序阶段可以配置为使用特征类型。 这使得捕获事件的几何图形成为可能。 支持的要素类型是点和面。请参阅**如何使用几何体**。

  5. 点击**保存**。

安排活动

You can schedule an event for a future date by:

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 时间线数据条目 表格数据条目 小部件中, 单击**日历** 图标。

  4. Select a Program stage and set a Schedule date .

  5. 点击**保存**。

推荐活动

Sometimes it might be necessary to refer a patient to a different Organisation unit . To refer a TEI:

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 时间线数据条目 表格数据条目 小部件中, 单击**箭头**图标。

  4. Select a Program stage , Organisation unit and set a ****报告日期****。

  5. 单击 一次性推荐 ,这将只推荐一个 TEI 单个事件或**永久移动**,这将移动 TEI 所有权 到选定的**组织单位**。进一步访问 TEI 将基于所有权组织单位。

事件中的强制数据元素

Some data elements in an event might be mandatory (marked with a red star next to the data element label). What this means is that all mandatory data elements must be filled in before the user is allowed to complete the event. The exception to this is if the user has the authority called "Ignore validation of required fields in Tracker and Event Capture". If the user has this authority, the mandatory data elements will not be required to be filled in before saving and the red star will not be displayed next to the data element label. Note that super user that have the "ALL" authority automatically have this authority.

如何使用几何

跟踪实体类型、程序和程序阶段可以配置为 使用特征类型。这使得捕获几何图形成为可能 TEI、计划或活动。支持的特征类型是点和多边形。

捕捉坐标

**选项1:**在字段中填写纬度和经度。

选项2: 1. 点击**地图图标** 2. 通过搜索或定位来找到您想要的位置 地图 3. 详细您的目的的位置,然后选择**设置坐标** 4. 点击底部的**捕获**

捕捉多边形

  1. 点击**地图图标**
  2. 通过搜索或定位来找到您想要的位置 地图
  3. 在地图左上角,点击**多边形图标**
  4. 在地图上绘制一个多边形。最后,连接最后一个点 第一点
  5. 点击底部的**捕获**

多边形也可以删除 1. 点击**地图图标** 2. 点击地图左侧的**垃圾桶图标**,然后选择 清除所有

如何为事件分配用户

在维护应用程序中,可以配置程序阶段以允许用户分配。 如果启用了用户分配,您将能够为事件分配用户。

  1. 单击**分配的用户** 字段。
  2. 滚动或搜索用户。
  3. 单击用户。

管理TEI的注册

注册小部件提供对信息和功能的访问 用于注册所选课程。

注册小部件

TEI 所有权

显示所选程序中所有注册的当前所有权 在注册小部件的“所有者”部分中。所有权将始终开始 作为首先将 TEI 注册到给定计划的组织单位。

TEIS 不同项目的所有权可能不同,例如一个诊所可以 对 HIV 患者进行随访,而另一家诊所则对 MCH 中的同一患者进行随访。

要更新 TEI/程序组合的所有权,用户必须使用 推荐功能并在推荐时选择“永久移动”选项。

A user that has capture access to the organisation unit that is the current owner of the TEI/Program will have write access to all enrollments for that TEI/Program combination. A user that has search access to the organisation unit that is the current owner will have access to search and find the TEI/Program combination.

停用TEI的注册

如果您停用 TEI 仪表板,TEI 将变为“只读”。你 无法输入数据、注册 TEI 或编辑 TEI 的配置文件。

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 在里面**注册**小点,点击**手指**。

  4. 单击**是**进行确认。

激活TEI的注册

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 在里面 注册 小部件,单击 激活

  4. 点击**是** 确认。

将TEI的注册标记为已完成

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 在里面 注册 小部件,单击 完成

  4. 点击**是** 确认。

重新打开已完成的注册

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 在里面**注册**小点,点击**打开**。

  4. 点击**是** 确认。

显示TEI的注册历史

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 在**Profile**小元件中,点击**Audit history**图标。

创建TEI注册说明

注册说明可用于记录有关例如原因的信息 取消了注册。

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 在** Notes 小部件中,键入您的注释,然后单击 Add **。

发信息给TEI

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. Messaging 小部件中并选择 SMS E-mail

  4. 输入所需的联系信息。

    如果 TEI 的个人资料包含电子邮件地址或电话号码, 这些字段是自动填写的。

  5. 键入一条消息。

  6. 点击**发送**。

将TEI标记为后续

您可以使用标记 TEI 的注册进行跟进,然后使用此 当您创建 Upcoming events 和 **Overdue 时作为过滤器的状态 事件**报道。例如,这可以用于监控高风险 怀孕计划期间的病例。

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 在里面 注册 小部件,单击 标记为跟进 图标。

编辑TEI的个人资料

您在 Profile 中编辑 TEI 的配置文件或跟踪的实体属性 小部件。

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. Profile 小部件中,单击 Edit

  4. 修改配置文件并单击**保存**。

将关系添加到TEI

例如,您可以创建从一个 TEI 到另一个 TEI 的关系 将母亲和孩子或丈夫和妻子联系在一起。依赖 关于如何配置关系类型,亲属可以继承 属性。

假设有两个项目:母亲的产前护理和 为孩子接种疫苗。如果名字、姓氏和地址 两个程序都需要属性,可以配置 姓氏和地址属性是可继承的。然后在孩子期间 注册,不需要输入这些可继承的属性。 您可以根据母亲的值自动添加它们。如果你想 要为孩子设置不同的值,您可以覆盖 自动生成的值。

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 在**关系** 小部件中,单击**添加**。

  4. 选择一种关系类型。

  5. 搜索亲戚并选择它。搜索遵循与从跟踪器首页搜索被跟踪实体实例时相同的模式。默认情况下,搜索覆盖用户的搜索范围。

  6. 在弹出窗口中选择与搜索条件匹配的跟踪实体实例。

  7. 点击**保存**。

注意:如果关系是双向关系,则该关系将显示在该关系的 TEI 中 在关系链接到的 TEI 中创建。此外,如果关系是双向的,则该关系的每一端 关系将有一个唯一的名称,该名称将显示在“关系”列下的关系小部件中。

共享TEI仪表板

您可以通过其网址共享TEI仪表板。

  1. 打开 随访采集 应用程序。

  2. 打开您要共享的仪表板。

  3. 复制URL。

    确保 URL 包含“tei”、“program”和“ou” (组织单位)参数。

  4. 将 URL 粘贴到您选择的共享方法中,例如 电子邮件或 DHIS2 中的消息。

    如果您在单击链接时未登录到 DHIS2,您将被 要求这样做,然后带到仪表板。

停用TEI

如果您停用某个 TEI,该 TEI 将变为“只读”。相关数据 与 TEI 不删除。

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 在右上角,单击 button > 停用

  4. 单击**是**进行确认。

激活TEI

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 在右上角,单击 button > 启用

  4. 单击**是**进行确认。

删除TEI

警告

删除TEI时,将删除与TEI相关的所有数据。

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 在右上角,单击 button > 删除

  4. 点击**是** 确认。

配置TEI仪表板

显示或隐藏小部件

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 单击**设置** 图标,然后选择**显示/隐藏小部件**。

  4. 选择要显示或隐藏的小部件。

  5. 点击**关闭**。

将仪表板的布局保存为默认布局

您可以将仪表板的布局保存为程序的默认设置。

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 单击**设置**图标,然后选择**将仪表板布局另存为 默认**。

锁定仪表板的布局

如果您是**管理员**,您可以选择锁定 所有用户的仪表板布局。

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 将小部件组织到所需的布局并将其保存为默认值 (见上节)。

  4. 单击 Settings 图标,然后选择 Lock layout for all 用户

用户仍然可以暂时重新组织小部件,但 页面刷新后,布局将重置为管理员保存的布局。这 当仪表板布局为时,删除小部件按钮将被隐藏 锁定。

顶栏

顶部栏是一个有用的工具,可以快速查看重要数据。 简单的方法。要开始使用顶部栏:

  1. 打开 随访采集 应用程序。

  2. 打开现有的TEI仪表板。

  3. 单击**设置**图标,然后选择**顶栏设置**。

  4. 点击**激活顶栏**并点击您想要的数据 显示在顶部栏中。

更改 时间线数据输入 小部件 { #change-table-display-mode-for-timeline-data-entry-widget } 的表格显示模式

The Timeline Data Entry widget has 5 different table display modes that can be selected. The different options are: - Default form - Shows all data elements vertically.

  • Compare form previous - Shows the previous (repeatable) program stage next to the current selected program stage.

  • Compare form all - Shows all previous (repeatable) program stages next to the current selected program stage.

  • Grid form - Shows the data elements horizontally.

  • ** POP表单**-与** Grid表单**相同,但是单击时,数据元素将显示在弹出窗口中。

要更改当前的显示模式,请单击小部件顶部栏中的第二个图标(请参见下图):

Once an option is selected the selection is stored for that specific program stage. This mean that you can have different table modes for the different program stages in a program.

Notes: 1. The Compare form options will function best if you have multiple repeatable events (of the same program stage) present. 2. The Grid form and POP-over form options are not selectable if the program stage has more than 10 data elements. 3. The icon in the widgets bar will change depending on the option you have selected.

建立报告

  1. 打开 随访采集 应用程序。

  2. 点击**报告**。

  3. 选择报告类型。

    Report types in the Tracker Capture app
    Report type Description
    Program summary A summary report for a particular program, organisation unit and time frame. The report consist of a list of TEIs and their records organised based on program stages.
    Program statistics A statistics report for a particular program. The report provides for example an overview of drop-outs or completion rates in a given time frame at a particular organisation unit.
    Upcoming events A tabular report showing tracked entity instances and their upcoming events for a selected program and time. You can sort the columns and search the values. Show/hide operations are possible on the columns. You can also export the table to Microsoft Excel.
    Overdue events A list of events for a selected program. The report displays a list of TEIs and their events that are not completed on time. You can sort the columns and search the values You can also export the table to Microsoft Excel.

摘要报告显示 TEI 列表及其记录 “MNCH/PNC(成年女性)”计划。记录按以下形式组织 选项卡,其中每个选项卡是一个程序阶段。表中的列是 配置为显示在报告中的数据元素 程序阶段定义。

Data approval overview

DHIS2 有一个可选功能,允许授权用户批准 输入的数据。它允许审查和批准数据 在组织单位层次结构中的选定级别,因此批准 遵循从低到高的层次结构 水平。

数据被批准用于 (a) 期间、(b) 组织单位的组合 (c) 工作流程。可以为组织单位批准数据 它被输入,以及为更高级别的组织单位 数据是聚合的。作为系统设置的一部分,您可以选择 批准数据的组织单位级别。有可能 只有在所有这些都得到批准后才能在更高级别上批准 同一工作流的较低级别的组织单位的后代 和时期。当您批准工作流程时,它会批准任何数据的数据 已分配给该工作流的集合。

一段时间后,组织单元和工作流组合已经 批准后,与该工作流关联的数据集将被锁定 那个时期和组织单位,以及任何进一步的数据输入或 除非首先未经批准,否则将禁止修改。

例如,下图说明数据已经 已批准用于组织单位 C 和 D,在特定时期内,并且 工作流程。现在可以为组织单位 B 批准相同的 期间和工作流程。但它还没有准备好被组织批准 单元 A。在它被批准为组织单元 A 之前,它必须是 批准用于 B,以及组织单元 A 的任何其他子级,用于 那个时期和工作流程。

组织批准 单位

批准并接受

DHIS2 支持两种不同类型的审批流程: 在每个级别批准数据的一步过程,或两步 数据首先被批准然后在每个级别被接受的过程。 如下图所示:

批准和 接受

在一步流程中,数据经过一级审批,然后 上一级批准。直到下次批准 更高级别,可能在第一级未获批准。 (例如,如果 数据被批准我的错误,这允许批准者撤消他们的 错误。)一旦数据被上一级批准,它可能不会 除非在下一级未经批准,否则不得在较低级别获得批准 更高层次。

在两步过程中,数据在一级批准,然后 批准在同一级别被接受。这种接受是由一个 被授权在下一个更高级别批准数据的用户。一次 数据被接受,除非它被接受,否则不得更改或未经批准 首先*不接受*。

DHIS2 不需要两步过程。这是一个可选步骤 供用户查看下一个更高级别的数据。它有好处 从下面的级别锁定接受,因此审稿人不会 必须担心数据可能会从下面发生变化 正在审核中。它也可以被更高级别的用户用来保持 跟踪哪些较低级别的数据已被审查。

可以通过勾选**需要接受来激活两步流程 在“常规”部分下的“系统设置”应用中获得批准**。

数据审批机关

要批准数据,您必须被分配一个包含以下其中一项的角色 当局:

  • 批准数据 - 您可以批准组织单位的数据 你被分配到的。请注意,此权限不允许 您批准组织单位以下级别的数据 你被分配到的。这对于分离用户很有用 授权用户在一级批准 批准以下级别。

  • 批准较低级别的数据 - 允许您批准数据 分配给您的组织单位以下的所有较低级别。这 例如,如果您是一个地区级用户,其角色是 包括批准该范围内所有设施的数据 区,但不是针对区本身。如果你被分配了这个 以及*批准数据*机构,您可以在 您被分配到的组织单位的级别, 以及以下任何级别。

  • 接受较低级别的数据 - 允许您接受以下级别的数据 级别略低于分配给您的组织单位。这 可以将权限授予与批准数据相同的用户。或者它可能 给不同的用户,如果你想让一些用户 接受来自以下级别的数据,以及一组不同的用户 批准数据上升到上一个级别。

配置数据批准

在*数据批准级别*下的*维护应用程序*部分,您可以 指定您希望在系统中批准数据的级别。 单击此页面上的添加新按钮并选择组织单位 您希望获得批准的级别。它将被添加到列表中 审批设置。您可以在以下位置配置系统以批准数据 每个组织单位级别,或仅在选定的组织单位 水平。

请注意,当您添加新的批准级别时,您可以选择一个 类别选项组集。此功能将在本文后面讨论 章节。

同样在*数据审批工作流*下的维护中,您可以定义 将用于批准数据的工作流。每个工作流都可以 与一个或多个审批级别相关联。任何两个工作流都可以 在所有相同的批准级别上运作,其中一些相同 还有一些不同的层次,或者完全不同的层次。

如果您希望根据工作流程批准数据集的数据, 然后在添加或编辑数据时将工作流分配给数据集 放。如果您不希望某个数据集的数据受到批准, 然后不要为该数据集分配任何工作流程。对于您的数据集 想同时审批,分配给同一个 工作流程。对于要独立审批的数据集,分配 每个数据集到自己的工作流程。

在*系统设置* -> 分析 下,您可以控制哪些未经批准的数据(如果有)将出现在分析中。请参阅本用户指南的“分析设置”部分。请注意,分配到已准备好批准数据的组织单位的用户始终可以在分析中查看此数据,分配到更高级别组织单位的用户(如果他们具有*在较低级别批准数据* 权限或*查看未批准的数据)也可以数据*权限。

数据可视性

如果启用选项*在分析中隐藏未经批准的数据*,数据将 被与更高级别相关联的用户隐藏而无法查看。什么时候 确定是否应为特定用户隐藏数据记录, 系统将用户与特定批准级别相关联并比较 它达到数据记录已被批准的级别。一个用户 与与审批级别相匹配的审批级别相关联 她链接到的组织单位,或者如果不存在审批级别 该级别,与组织单位级别相关联的下一个审批级别 在她下面。用户将被允许查看已被访问的数据 被批准到紧接在她相关批准之下的级别 等级。这背后的基本原理是用户必须能够查看 下面已经批准的数据,以便她最终可以查看 并自己批准。

请注意,如果用户已被授予*查看未批准的数据* 或 *所有*权限,她将能够查看数据,而不管 审批状态。

让我们考虑以下示例: 有四个组织单位 级别,审批级别与级别 2 和 4 相关联。 用户 A 在 国家级别 (1) 与批准级别 1 相关联,因为 审批级别与组织单位级别处于同一级别。 用户 B 与批准级别 2 相关联,因为没有 审批级别与她的组织单位级别直接相关,并且 批准级别 2 是下面的直接级别。 用户 C 获得关联 具有批准级别 2。 用户 D 低于所有批准级别 意味着她可以看到在其组织内部或之下输入的所有数据 单位层面。

隐藏未经批准的 数据

使用此示例,让我们考虑一些方案:

  • 在设施级别输入数据:只有*用户 D* 可以看到数据, 因为数据还没有得到批准。

  • 数据由*用户 D* 在设施级别批准:数据变得可见 给用户 C 和用户 B,因为数据现在在他们的级别得到批准。

  • 数据由*用户 C* 在区级批准:数据可见 给用户 A,因为数据现在在紧接下面的级别获得批准 她自己。

批准数据

要批准数据,请转到 报告 并选择 数据批准 。当这 报告显示为批准配置的数据,它显示批准 报告中数据的状态。批准状态将是以下之一 下列的:

  • 等待下级组织单位批准 - 此数据不是 尚未准备好被批准,因为它首先需要被批准 此组织单位的所有子组织单位,对于 相同的工作流程和周期。

  • 准备批准 - 此数据现在可以由 授权用户。

  • 已批准 -此数据已被批准。

  • 已批准并已接受 - 此数据已被批准,并且 也接受了。

如果您正在查看的数据处于可以采取行动的批准状态 如果您有足够的权限,以下一项或多项 您可以在 数据批准 表格上采取行动:

  • 批准 - 批准尚未批准的数据,或者 之前已获批,一直未获批。

  • Unapprove - 返回到未批准状态的数据 批准或接受。

  • 接受 -接受已批准的数据。

  • 不接受 - 返回到不被接受(但仍被批准)的状态 已接受的数据。

要取消批准给定单位部门的数据,您必须拥有 批准该组织单位的数据或批准 数据所属的更高级别组织单位的数据 汇总。其原因如下: 如果您正在查看数据 要获得更高组织单位级别的批准,您应该考虑 下级组织单位的数据是否合理。我摔倒 下级数据看起来不错,可以在上级批准数据 等级。如果某些较低级别的数据看起来可疑,您可以取消批准 较低级别的数据。这允许在以下位置再次查看数据 下级,必要时更正,并通过审核重新批准 根据层次结构划分的组织单位级别。

按类别选项组批准

定义审批级别时,指定组织单位级别 届时将批准数据。您还可以选择指定一个 类别选项组集。如果您使用类别,这很有用 选项组来定义数据的其他维度,并且您想要 批准基于这些尺寸。下面的例子 说明如何在单个类别选项组中完成此操作 集,并通过使用多个类别选项组集。

按一个类别选项组集批准

例如,假设您定义了一个类别选项组集来表示 在一个或多个组织单位担任医疗保健合作伙伴的非政府组织。 此集合中的每个类别选项组代表一个不同的 伙伴。合作伙伴 1 的类别选项组可以组合在一起 使用的类别选项(例如资金帐户代码) 合作伙伴作为数据的一个维度。所以合作伙伴 1 输入的数据是 归因于合作伙伴 1 的类别选项组中的类别选项。 而合作伙伴 2 输入的数据归因于 合作伙伴 2 的类别选项组:

Example Category Option Groups
Category option group set Category option group Category options
Partner Partner 1 Account 1A, Account 1B
Partner Partner 2 Account 2A, Account 2B

每个合作伙伴都可以独立于他们的帐户输入数据 其他,对于相同或不同的工作流程,相同或不同 设施。例如,数据可以在 每个合作伙伴的以下级别,彼此独立:

示例类别选项 组

提示

您可以在类别选项和类别上使用共享功能 选项组以确保用户可以输入数据(和/或查看数据) 仅适用于某些类别选项和组。如果你不想要用户 查看超出其指定类别的汇总数据 选项和/或类别选项组,您可以指定 Selected 数据分析的维度限制 ,当添加或更新一个 用户。

您可以选择在任何或 所有这些组织单位级别。例如,您可以定义任何 或以下所有批准级别:

示例类别选项组 设置批准级别
批准级别 组织单位级别 类别选项组设置
1 国家 合作伙伴
2 合作伙伴
3 设施 合作伙伴

通过多个类别选项组集批准

您还可以为不同的类别选项组定义批准级别 套。继续这个例子,假设你有不同的机构 管理向不同合作伙伴提供的资金。例如,机构 A 资金账户 1A 和 2A,而机构 B 资金账户 1B 和 2B。你 可以为机构 A 和机构 B 设置类别选项组,并使 它们都是名为 Agency 的类别选项组集的一部分。那么你 将有:

Example Multiple Category Option Group Sets
Category option group set Category option group Category options
Partner Partner 1 Account 1A, Account 1B
Partner Partner 2 Account 2A, Account 2B
Agency Agency A Account 1A, Account 2A
Agency Agency B Account 1B, Account 2B

现在假设在国家/地区级别,您希望每个合作伙伴批准 该合作伙伴输入的数据。完成此批准后,您需要 每个机构然后批准来自由管理的帐户的数据 那个机构。最后,您要批准国家/地区级别的数据 跨越所有机构。您可以通过定义以下内容来做到这一点 审批级别:

Example Multiple Category Option Group Set approval levels
Approval level Organisation unit level Category option group set
1 Country
2 Country Agency
3 Country Partner

请注意,可以为相同的权限定义多个审批级别 组织单位层面。在我们的示例中,合作伙伴 1 将批准 来自类别选项账户 1A 的批准级别 3 的全国数据 和账户 1B。接下来,A 机构将批准全国范围的数据 类别选项帐户 1A 中的批准级别 2(经批准后 合作伙伴 1) 和账户 2A(经合作伙伴 2 批准后。)最后,在 获得所有机构的批准,全国范围的数据可以在 所有类别选项的批准级别为 1。请注意,批准级别 1 不指定类别选项组集,这意味着它用于 批准所有类别选项的数据。

此示例仅用于说明。你可以定义尽可能多的 您需要的类别选项组,以及尽可能多的审批级别 不同类别选项需要在同一组织单位级别 组套。

如果您对不同类别选项组有多个审批级别 设置在同一组织单位级别,您可以更改批准 在*设置* 部分的*系统批准设置* 下订购。 只需点击您要移动的审批级别,然后选择*上移* 或*向下移动*。如果您的审批级别没有类别选项 组设置,它必须是该组织的最高批准级别 单位层面。

Data approval

The Data Approval app provides an intuitive interface to support the approval process in line with the configured approval workflows.

Selecting parameters

Select a workflow

Start by selecting a workflow in the top left of the screen. If you only have access to a single workflow, it will be preselected for you.

Select a workflow

Select a period

Proceed to select a period you would like to approve data for.

Select a period

Select an organisation unit

Finally, select an organisation unit you would like to approve data for. Each visible organisation unit in the tree is preceded with a status-icon. This icon serves as an indication of the actions available to your user profile for that organisation unit. In the screenshot below, "Badjia" is an organisation unit with status "ready for approval".

Select an organisation unit

Clear selection

Once a workflow, period, and organisation unit have been selected, a "Clear selections" button will appear. This button can be used to quickly clear all three fields and start a fresh selection.

Approving data

Review dataset reports

Once a workflow, period, and organisation unit have been selected, you can review the dataset reports for the datasets connected to the selected workflow. The data for each dataset is presented in a tab.

Datasets can have different period types than the workflow the are connected to. If this is the case, the approval app will show data for all the dataset-periods that end within the selected workflow period.

Review dataset reports

Take an approval action

Once you have reviewed the data in the datasets, you can proceed to take an approval action. The following actions are available:

  • Approve
  • Accept
  • Unapprove
  • Unaccept

Which of these actions are available for a given workflow at a given moment in time depends on the type of actions which have been taken already at the current and other levels of the organisational hierarchy.

In the example above the "approve" action is available. When you choose the "Approve" action, you are presented with a confirmation dialog as displayed below which summarises the datasets you are approving. The workflow is not approved until you click "Approve" to confirm there. Other actions take effect immediately and do not have a confirmation step.

Take an approval action

After taking one of the approval actions, in this case after confirming the approval, the workflow is updated immediately and you see a the new approval status.

Updated approval status

Approval status tags

As shown in the image above, the approval status is displayed in two places:

  1. Above the dataset tabs, after the workflow information
  2. Before the buttons on the bottom bar

These status tags may not always display the same information, because the have a slightly different meaning:

  1. The status tag above the dataset represents the approval status of the workflow for the selected period and selected organisation unit
  2. The status tag in the bottom bar does the same, but also takes your user profile.

A workflow may be ready to be approved at a given organisation unit level, but you do not have the appropriate authority to do so.

管理仪表板

About the Dashboards app

The Dashboards app makes it possible to present a high level overview of your data, including displaying analytical objects such as maps, charts, reports and tables, as well as displaying text-based information, resource links, and app widgets.

Features of the Dashboards app include:

  • View and print dashboards
  • Create and edit dashboards
  • Share dashboards with users and user groups
  • Apply temporary filters while viewing dashboards
  • Responsive view on mobile devices and small screens
  • Access dashboards while offline

Dashboards app layout

Dashboards have a title, description, and any number of dashboard items. Above the dashboard is the dashboards bar, which shows all your available dashboards, a dashboard search field, and a + button for creating a new dashboard.

The Dashboards app has two modes: view and edit/create . When you first log in to DHIS2, your most recently used dashboard will be displayed in view mode, if you are on the same computer as you were previously. If you are using a different computer or browser, then the first starred dashboard will be displayed. If there are no starred dashboards, then the first dashboard (alphabetically) will be displayed. Starred dashboards always show first in the dashboard list.

Below is an example of a dashboard named "Antenatal Care", which has been populated with charts and maps:

Personalization

The Dashboards app can be personalized in the following ways:

小屏幕上的响应视图

When viewing dashboards on small screens (for instance, portrait orientation on a mobile phone ), the dashboard will adapt to the screen and show all items in a single column. Some options, including editing, filtering and sharing, will not be available.

Searching for a dashboard

You can search for a specific dashboard using the search field in the upper left of the dashboards bar entitled “Search for a dashboard”. The search is case insensitive, and as you type, the list of dashboards will be narrowed down to those that match your search text.

Personalizing the height of the dashboards bar

You can set a specific height for the dashboards bar by down-clicking and dragging the bottom edge of the bar. When you finish dragging, the new height will be set. Clicking on the down arrow at the bottom of the dashboards bar will expand the bar to its maximum height (10 "rows"). Clicking on the up arrow will reset the height to your personalized height.

Creating and editing a dashboard

To create a new dashboard, click the + button in the left corner of the dashboards bar to enter create/edit mode:

To edit an existing dashboard, click the Edit button next to the dashboard title (you must have edit access to see this button):

In create/edit mode, you can add or change the dashboard title, description and dashboard items. If you do not add a title, the dashboard will automatically be titled "Untitled dashboard".

将项目添加到仪表板

Add items to the dashboard by searching for items using the Search for items to add to this dashboard drop down selector. Item types are:

  • Visualizations (charts and tables)
  • 地图
  • 活动报告
  • 活动图
  • Reports
  • 资源资源
  • 应用
  • Messages
  • 文字框
  • Spacers

The list of items in the drop-down initially displays 10 visualizations (charts and tables), and 5 from each of the other categories, based on the search text you enter. Messages (Email), text boxes and spacer items are also found in the list. To view more items, click on Show more , and the list for that type will be extended to 25 items. If you still do not find the item you want, try typing a more specific search text.

Dashboard layout and placement of new items

When adding items to the dashboard you can choose an overall layout by clicking on Change layout button. You can change this layout setting at any time.

  • With Freeflow layout, the added items can be moved using the mouse by down-clicking on the item and dragging it to the desired position. Items can also be resized with the mouse by down-clicking on the drag handle in the lower right corner of the item and dragging to the desired size.
  • With Fixed columns layout, you can choose the number of columns to have on the dashboard, and the dashboard will automatically be layed out for you. Items cannot be moved or resized in Fixed columns layout.

You can also configure whether newly added items are automatically placed at the start or end of the dashboard by choosing the desired option. This option can be changed at any time.

垫片项目

When adding items to the dashboard using Freeflow layout, they will "rise" upwards until they bump into another item. In order to force empty vertical space between items (like an empty row), you can add spacer items to the dashboard. They are only visible in edit/create mode. In view mode, they are not displayed, but take up the defined space.

**编辑/创建模式**中的空格:

查看模式下的垫片

移除物品

Remove items by clicking on the red trash can at the upper right of the item. Be aware that when you remove an item while in Freeflow layout, the items that are positioned below the removed item will "rise" upwards until they bump into an item above.

Actions in create/edit mode

在创建/编辑模式下,您将在页面顶部的操作栏中看到以下按钮: 保存更改 打印预览 过滤器设置 翻译 删除**和**退出而不保存 翻译 删除 按钮仅在您正在编辑现有仪表板时显示。

保存仪表板

When creating or editing a dashboard, changes are saved when you click the Save changes button. If you don't want to save your changes, click the Exit without saving button. You will then be returned to view mode with the dashboard you were previously viewing.

Click on the Print preview button to view what the dashboard will look like when being printed with the Dashboard layout option .

Click on Exit print preview to return to editing the dashboard.

Note that some items may be moved to the next page to avoid being split between two pages. Items may also be shortened to fit on one page. Items that are shortened show an info icon in the upper right corner of the item in preview. The info icon is not visible in the actual print.

限制仪表板过滤器

By default, users will be able to filter dashboard items by any dimension defined in the DHIS2 instance. Dashboard filter settings can be edited for a dashboard by clicking on Filter settings .

To restrict available filters, you can click Only allow filtering by selected dimensions and select the filters you wish to allow on the dashboard. Period and Organisation Unit are selected by default but can be removed if desired. When the dashboard is viewed, users will only be able to choose from among the filters selected.

In order to save updates to filter settings, you need to first click Confirm to close the Filter settings dialog and then click Save changes to save the dashboard changes.

翻译仪表板标题和描述

If you are editing an existing dashboard, then there will be a Translate button. Click on this button to open the Translation dialog, which provides a list of languages to translate to, and shows the original dashboard title underneath the name input field. First choose the language you want to translate for, then fill in the dashboard name and description translation.

删除仪表板

If you have access to delete the dashboard, then there will be a Delete button. When you click the Delete button, a confirmation dialog will first be displayed to confirm that you want to delete the dashboard.

查看仪表板

From view mode, you can toggle showing the description, star a dashboard, apply filters, print the dashboard, make the dashboard available offline, and share the dashboard with other users and user groups.

Show description

To toggle the description, open the ...More menu and choose Show description (or Hide description ). This setting will be remembered for all dashboards that you open. This setting applies to you, not other users.

Star dashboards

Your starred dashboards are listed first in the list of dashboards for quick access. To star a dashboard, click on the star button to the right of the title. You can also toggle the star from the ...More menu. When the star is “filled”, that means the dashboard is starred. Starring a dashboard only applies to you, not other users.

筛选仪表板

Applying filters to a dashboard change the data displayed in dashboard items containing visualizations. The filters are applied to each dashboard item in the same way: each added filter overrides the original value for that dimension in the original chart, table or map. It is possible to filter on Organisation Units and Periods, as well as dynamic dimensions, depending on the DHIS2 instance. You can apply multiple filters to the dashboard.

To add a filter, click on the Add Filter button and choose a dimension:

添加过滤器

将打开一个对话框,您可以在其中选择过滤器。

组织单位过滤器选择

单击对话框中的 Confirm 将过滤器应用到 当前仪表板。

Filters are not stored, so when switching to a different dashboard they are reset. Black filter badges appear above the dashboard items to indicate which filters have been applied to the dashboard's visualizations.

当前过滤器显示为仪表板上方的标志

You can edit a filter by clicking on the filter badge to open the filter selection dialog. A filter can be removed by clicking on the Remove button on the badge. Whenever a filter is added, edited or removed, the dashboard items reload to show the updated data. The filter badges are always visible at the top of the page when scrolling the dashboard content.

By default, users are able to filter dashboard items by any dimension defined in the DHIS2 instance. To limit available filters, see Restricting dashboard filters .

Making dashboards available offline

To make a dashboard available offline, choose the Make dashboard available offline option in the ...More menu. This will cause a reload of the dashboard where requests to the server are recorded and saved in browser storage. Note that offline dashboards are only available on the computer and browser where you set it to offline. If you currently have a filter applied when requesting the dashboard be made available offline, a dialog will appear to confirm the removal of the filters.

Dashboards that have been saved for offline have an indicator on the dashboard chip in the dashboards bar, as well as a tag showing the time it was saved.

If the dashboard has been changed since you made it available offline, either by you or someone else, you'll need to choose Sync offline data now from the ...More menu to save the latest version of the dashboard.

You can remove a dashboard from offline storaged by choosing Remove from offline storage in the ...More menu.

Other notes about Dashboards app when you are offline:

If you manually log out of the DHIS2 instance, all cached dashboards will be cleared and they will no longer be available offline.

If you are offline, any buttons or actions that require a connection to complete successfully are disabled. They will be re-enabled once connectivity is restored.

打印仪表板

From the ...More menu you can print the current dashboard. There are two styles of dashboard print: Dashboard layout and One item per page . For both styles, a title page is added that shows the dashboard title, description (if the Show description setting is enabled), and any applied dashboard filters.

为了获得最佳打印效果:

  • 使用Chrome或Edge
  • 等到所有仪表板项目都已加载后再打印
  • use A4 landscape setting with default margins set and background graphics turned on

Print dashboard layout

Dashboard layout print will approximate the dashboard layout as it is shown in the browser. Note that some adjustments may need to be made to the layout in order to prevent items being split onto multiple pages: items that would be cut off by a page break are moved to the next page, and items that are taller than one page are shortened to fit on one page.

Once in print mode, click on the Print button in the upper right to trigger the browser print functionality.

This style of print will print each dashboard item on a separate page, maximizing the use of the paper size.

单击右上角的**打印**按钮以触发浏览器打印功能。

带有图表、数据透视表或地图的仪表板项目

Dashboard items with charts, pivot table or maps may have an item menu button in the upper right corner of the item with additional viewing options, depending on the system settings that have been configured for the DHIS2 instance. If all the relevant system settings have been disabled by the DHIS2 instance, then there will not be an item menu button. Here are the possible item menu options:

在可视化之间切换

It is possible to toggle the visualization view for items containing charts, pivot tables and maps. Click on the item menu button and choose the desired view (e.g., View as Table , View as Map , View as Chart ):

全屏查看项目

要全屏查看图表、表格或地图,请单击**查看全屏**选项。要退出全屏,您可以按 esc 键或单击全屏视图右上角的退出按钮。

在应用程序中打开

To open the visualization in its corresponding app (e.g., Data Visualizer, Maps) click on the Open in [app name] app option.

显示解释和细节

您可以为图表、数据透视表、地图、事件编写解释 单击**显示解释和详细信息**以查看报告和事件图表项目:

该项目将在下方垂直展开以显示说明, 解释和答复。你可以喜欢一个解释,回复一个 解释,并添加您自己的解释。您可以编辑、分享或删除 您自己的解释和回复,如果您有版主访问权限, 你可以删除别人的解释。

可以格式化描述字段和解释 使用Markdown样式标记*和 带有**粗体**,_italic 分别代表**粗体**和_italic_。用于编写新文本的文本字段 解释具有用于添加富文本的工具栏。键盘快捷键 也可以使用:Ctrl / Cmd + B和Ctrl / Cmd +I。 smilies受支持,可以通过键入以下命令之一来使用 字符组合::) :-) :( :-(:+1:-1。URL是自动的 检测并转换为可点击的链接。

解释按日期降序排列,最新的显示在顶部。 解释回复按日期升序排列,最早的显示在顶部。

共享仪表板

In order to share a dashboard with users and user groups, click on the Share button to the right of the dashboard title to display the Sharing and access dialog.

There are three levels of sharing permissions available for a dashboard:

  • No access

The user or user group cannot view or edit the dashboard. If they try to access the dashboard with the url, the Dashboards app will display the message "Requested dashboard not found".

  • View only

The user or user group can view the dashboard but cannot edit it.

  • View and edit

The user or user group can view and edit the dashboard. This level of sharing allows for all types of changes, including altering the layout, resizing and removing items, renaming and deleting the dashboard, etc.

All dashboards have the All users group set to No access by default. The All users group includes all logged-in users.

Add users and user groups

To share a dashboard with specific users and user groups, type the name in the input field, choose the desired access level and click on Give access .

You can provide users with the url of the dashboard, allowing them to navigate directly to the dashboard. To get the dashboard url, just open the dashboard in view mode, and copy the browser url. For example, the url to the Antenatal Care dashboard in play.dhis2.org/dev is:

https://play.dhis2.org/dev/dhis-web-dashboard/#/nghVC4wtyzi

Cascade sharing of visualizations on the dashboard

To ensure that all charts, maps and tables on the dashboard are shared with the chosen users and user groups, click on the Apply sharing to dashboard items button.

使用数据可视化器应用

创建和编辑可视化

当从dhis2菜单打开data-visualizer应用程序时,将显示空白面板,您可以立即开始创建可视化。

选择可视化类型

从左上角的选择器中选择所需的可视化类型。 对于每种可视化类型,都有一个简要说明,并提供有关在布局中的何处使用主要维度的建议。

可视化类型 描述
将信息显示为垂直矩形列,其长度与它们代表的值成比例。

示例:比较不同地区的性能。

布局限制:正好为1个尺寸系列,正好为1个尺寸类别。
堆积柱 将信息显示为垂直的矩形列,其中代表多个类别的条形图相互堆叠。

示例:显示趋势或相关数据元素的总和。

布局限制:与“列”相同。
酒吧 与Column相同,仅带有水平条。
叠杆 与堆积列相同,仅带有水平条。
线 将信息显示为由直线连接的一系列点。也称为时间序列。

示例:可视化指标数据在一定时间间隔内的趋势。

布局限制:与“列”相同。
基于一条线(上方),轴与线之间的空间充满了颜色,并且线彼此堆叠。

示例:比较相关指标的趋势。

布局限制:与“列”相同。
堆积面积 与“面积”相同,但是各个尺寸项目的面积彼此堆叠。

示例:比较相关指标的趋势。

布局限制:与区域相同。
馅饼 将圆圈划分为多个扇区(或多个切片)。

示例:可视化单个数据元素的数据比例与所有数据元素的总和之比较。

布局限制:正好是1个尺寸的系列,没有类别。
雷达 在从同一点开始的轴上显示数据。也称为蜘蛛图。

布局限制:与“列”相同。
测量 半圆形,显示单个值,通常不超过100%(可配置起始值和终止值)。

布局限制:正好1个维,正好有1个项目作为序列,数据维被锁定为序列。
逐年(行) 当您想要将一年的数据与其他年份的数据进行比较时很有用。基于日历年。

布局限制:期间尺寸已禁用。
逐年(列) 与逐年(行)相同,仅具有列。
单值 Displays a single value in a dashboard friendly way. If the dimension displayed has an indicator type assigned, a % symbol or a string (per thousand, per hundred thousand, etc...) is appended to the value.

Layout restrictions: same as Gauge.
数据透视表 汇总更广泛的表的数据,并可能包括总和,平均值或其他统计数据,数据透视表以有意义的方式将它们分组在一起。

布局限制:无。
分散 散点图使用户能够将组织单位绘制为针对单个固定或相对时期的两个变量的点。

布局限制:垂直和水平各1个项目,数据维度锁定为垂直和水平,组织单位锁定为点。

选择尺寸

从左侧的维度菜单中,您可以选择要在可视化中显示的维度,包括数据,期间,组织单位和动态维度。可以通过单击尺寸,将尺寸拖放到布局区域或将鼠标悬停在尺寸上并使用其上下文菜单(三个点)来添加这些尺寸。

就像在尺寸菜单中一样,在布局区域中,您还可以通过单击尺寸,拖放尺寸或使用尺寸的上下文菜单(三个点)来更改选择。

  • 系列 :系列是一组连续的、相关的元素(对于 示例期间或数据元素),您要在其中可视化 以强调其数据中的趋势或关系。也称为数据透视表可视化的列。
  • 类别 :类别是一组元素(例如指标 或组织单位),您要比较其数据。也称为数据透视表可视化的行。
  • 过滤器 :过滤器选择将过滤显示在 可视化。请注意,如果使用数据维度作为过滤器,则可以 仅指定单个指标或数据集作为筛选项,而 对于其他维度类型,您可以选择任意数量的项目。

选择尺寸项目

维度是指描述系统中数据值的元素。系统中有三个主要维度:

  • 数据 :包括数据元素、指标和数据集(报告 率),描述数据的现象或事件。
  • 时段 :描述事件发生的时间。
  • 组织单位 :描述事件发生的地点。

Data Visualizer在允许您将这些维度用作系列,类别和过滤器方面具有高度的灵活性。

要选择尺寸项目,请通过单击尺寸打开尺寸模式窗口。在向布局中添加没有选定项目的尺寸时,该窗口也会自动打开。通过双击某个项目或单击一次并使用中间的箭头选择一个项目,选择要添加到可视化中的项目。出现的顺序将与它们的选择顺序相同。通过将所选项目拖放到“所选”部分中,可以对它们进行重新排序。

选择数据项

选择数据项时,有多种过滤显示项的方法。通过使用顶部的搜索字段,可以在当前选定的**数据类型** 中按项目名称执行全局搜索。通过从下拉列表中选择**数据类型**,可以按类型和子类型过滤项目,其中可用的子类型取决于所选数据类型。名称搜索和类型/子类型过滤也可以结合起来进行更详细的过滤。每个显示项目的类型由项目上的相应图标指示。通过将鼠标悬停在项目上,还可以查看类型的名称。

选择时期

When selecting a Period you have the option to choose between fixed periods and relative periods. These can also be combined. Overlapping periods are filtered so that they only appear once. For relative periods the names are relative to the current date, e.g. if the current month is March and Last month is selected, the month of February is shown in the visualization.

选择组织单位

组织单位对话框非常灵活,提供了三种选择组织单位的方式:

  • 显式选择:使用**树**显式选择要在可视化中显示的组织单位。如果您右键单击组织单位,则可以轻松选择以选择其下的所有组织单位。

  • 级别和组:**级别**和**组**下拉菜单是一种方便的方法,可以选择一个或多个组织单位组或特定级别的所有单位。示例:选择_Chiefdom_(级别3)以获取该级别的所有单位部门。

请注意,一旦至少选择了一个级别或组,组织单位树现在将作为级别/组的边界。例如:如果在树中选择_Chiefdom_(第3级)和_Kailahun_ org单位(第2级),则将获得Kailahun地区内的所有酋长单位。

  • 用户的组织单位:

  • 用户组织单位:这是一种动态选择已登录用户所关联的组织单位的方法。

  • 用户子单位:选择用户组织单位的子单位。

  • User sub-x2-units:选择用户组织单位下两级的单位。

Select dynamic dimensions

When selecting a dynamic dimension, either individual or all items can be selected. By default, the Manually select items option is selected, which allows for individual items to be picked out of a list, similar to how the Data and Period dimensions are selected above. To automatically select all items for a dimension, the Automatically include all items option can be selected. This will also include any additional items that are added in the future if the available dimension items are updated.

两个类别图

大多数图表可视化类型可以显示两个类别。 从 Pivot Table 切换到 Column、Bar、Area(以及它们的堆叠版本)和 Line 将前两个维度保留在 Category 中,任何额外的维度都移动到 Filter。 类别中第一个维度的标签显示在图表顶部,第二个维度的标签显示在底部。 生成的可视化由单独的图表组成,第一维中的每个项目一个。

更改可视化的显示

可视化的显示可以通过启用/禁用和配置多个选项来更改。每种可视化类型可以具有一组不同的可用选项。选项在**选项对话框**中的选项卡中以及每个选项卡内的部分中进行组织。

  1. 单击**选项**以打开**选项 对话框**。

  2. 浏览对话框中的选项卡以查看可用选项。

  3. 根据需要配置所需的选项。

  4. 单击**更新**以将更改应用于可视化。

可用选项列表

选项 描述
数据标签
聚集类型 定义如何在可视化中汇总数据元素或指标。一些聚合类型为“按数据元素”,“计数”,“最小”和“最大”。
基准线 在给定的域值上显示一条水平线。例如,在您想要可视化自流程开始以来性能如何变化时很有用。
列小计 在数据透视表中显示每个维的小计。
如果仅选择一个维度,则这些列的小计将被隐藏。这是因为值将等于小计。
列总计 在数据透视表中显示每一列的总计值,以及表中所有值的总计。
累计值 在列,堆积列,条形图,堆积条形图,线和面积可视化图中显示累积值
自定义排序顺序 控制值的排序顺序。
尺寸标签 将维度名称显示为数据透视表的一部分。
隐藏空类别 隐藏可视化中没有数据的类别项目。
在第一个**之前:仅在第一个值之前隐藏缺少的值
**在last **之后:仅在最后一个值之后隐藏缺少的值
**在第一个和最后一个之前
:仅在第一个之前值和最后一个值之后
全部 :隐藏所有缺少的值
例如,当您创建列和条形图时,这很有用。
隐藏空列 隐藏数据透视表中的空列。当您查看大型表时,其中很大一部分的维项目没有数据以保持表的可读性,这很有用。
隐藏空行 隐藏数据透视表中的空行。当您查看大型表时,其中很大一部分的维项目没有数据以保持表的可读性,这很有用。
号码类型 设置要在数据透视表中显示的值的类型:“值”,“行百分比”或“列百分比”。
选项行百分比和列百分比意味着您将以行总百分比或列总百分比显示值,而不是合计值。当您想查看数据元素,类别或组织单位对总价值的贡献时,此功能很有用。
仅包括已完成的事件 在聚合过程中仅包括已完成的事件。例如,这对于在指标计算中排除部分事件很有用。
行小计 在数据透视表中显示每个维的小计。
如果仅选择一个维度,则这些行的小计将被隐藏。这是因为值将等于小计。
行总计 显示数据透视表中每一行的总计值以及表中所有值的总计。
跳过舍入 跳过数据值的舍入,提供数据值的全精度。对于需要全额美元金额的财务数据很有用。
堆叠的值总计为100% 在堆积列和堆积条形图中显示100%堆积值。
目标线 在给定的域值上显示一条水平线。例如,当您想将性能与当前目标进行比较时很有用。
趋势线 显示趋势线,以可视化方式显示数据随时间的变化。例如,如果性能正在改善或恶化。选择期间作为类别时很有用。
值标签 在可视化中显示序列上方的值。
轴标签
轴范围 定义在范围轴上可见的最大值和最小值。
轴标题 Type a title here to display a label next to the x or y axis. Useful when you want to give context information to the visualization, for example about the unit of measure.
Auto generated from axis items provides a title based on the content of the axis.
None removes the title.
Custom allows you to type a custom title.
小数点 定义将用于范围轴值的小数位数。
脚步 定义在范围轴上可见的刻度线数。
传奇标签
Use legend for chart colors 将图例应用于可视化项,它是每个项的基于值的颜色。图例本身在 维护应用程序 中配置。
图例类型 控制应用哪个图例。
对每个数据项使用预定义的图例 根据在 维护应用 中分配给每个数据元素或指标的图例,分别将图例应用于每个数据元素或指标。
为整个可视化选择单个图例 将单个图例应用于所有数据项,在可用图例的下拉列表中选择。
图例风格 控制图例中的颜色应用于文本或背景的位置。您可以将此选项用于记分卡,以便一目了然地识别高值和低值。不适用于 单值 可视化。
显示图例键 Displays a key for the legend on the right side of the visualization, to indicate the value ranges and their respective color. If the visualization is added to a dashboard, this option can also be toggled from the top right corner of the dashboard item.
系列标签
在此选项卡中设置了用于添加更多轴和更改不同系列显示方式的选项。请在下面的相应部分中查看有关其工作原理的详细说明。
样式标签
数字组分隔符 控制使用哪个字符来分隔数字或“千”组。您可以将其设置为逗号,空格或无。
显示密度 控制数据透视表中单元格的大小。您可以将其设置为“舒适”,“普通”或“紧凑”。当您要将大型表放入浏览器屏幕时,
Compact很有用。
显示组织单位层次结构 显示组织单位的所有祖先的名称,例如,“三亚CHP”的名称为"塞拉利昂/孟买/塔马巴卡/三亚CHP”。然后,
按字母顺序对组织单位进行排序,这将根据层次结构对组织单位进行排序。
当您下载以单位部门为行的数据透视表并选择了显示单位部门层次结构时,每个单位部门级别均显示为单独的列。例如,当您在本地计算机上创建Excel数据透视表时,这很有用。
Fix column headers to top of table Freezes row headers in Pivot Tables so they are always visible when scrolling the table content.
Fix row headers to left of table Freezes column headers in Pivot Tables so they are always visible when scrolling the table content.
字体大小 控制数据透视表文本字体的大小。您可以将其设置为大,普通或小。
图表/表格标题 Controls the title that appears above the visualization.
Auto generated uses the default title generated from the visualization's dimensions/filters.
None removes the title.
Custom allows you to type a custom title.
图表/表格字幕 Controls the subtitle that appears above the visualization.
Auto generated uses the default subtitle generated from the visualization's dimensions/filters.
None removes the subtitle.
Custom allows you to type a custom subtitle.
显示图例键 打开和关闭图例,为可视化本身留出更多空间。
条/列之间没有空格 删除可视化中的列或条之间的空间。对于将可视化显示为EPI曲线很有用。
值标签 在可视化中显示序列上方的值。
颜色集 控制图表中使用的颜色。将显示可用颜色集的列表以及这些颜色的预览。还有一个“单声道图案”选项,该选项使用彩色图案而不是纯色。
限制值标签
限制最小值/最大值 允许在服务器端过滤数据。
您可以指示系统仅返回聚合数据值等于,大于,大于或等于,小于或小于或等于某些值的记录。
如果同时使用了过滤器的两个部分,则可以过滤掉一系列数据记录。
参数标签
自定义排序顺序 控制值的排序顺序。
包括累积 包含具有数据透视表累积值的列。
包括回归 包括具有对数据透视表的回归值的列。
组织单位 控制在“报告”应用中创建标准报告时是否要求用户输入组织单位。
上级组织单位 控制在“报告”应用中创建标准报告时是否要求用户输入上级组织单位。
报告期 控制在“报告”应用中创建标准报告时是否要求用户输入报告期间。
最高限额 控制要包含在数据透视表中的最大行数。
异常值选项卡
异常值检测方法 异常值分析是一个涉及识别数据集中异常观察的过程。在 Data Visualizer 中,通过首先将数据标准化为线性回归线,然后分析每个点与回归线的距离来检测异常值。目前支持三种方法。 四分位距 (IQR) 基于将数据集划分为四分位数,而 修正 z 分数 基于中值绝对偏差 (MAD)。 IQR 和 MAD 被认为是两种最常见的稳健规模度量。 **标准 z 分数**基于标准偏差,因此被认为不太稳健,因为它受异常值的影响很大。
阈值系数 与异常值阈值相乘的数量。控制阈值范围的灵敏度。 IQR 的默认因子为 1.5,z 分数的默认因子为 3。

Custom styling for text and series key in charts

The following options can be customized using the text styling tool: Chart title , Chart subtitle , Show series key , Target line , Base line , Axis title and Labels for both horizontal and vertical axes. The text styling tool allows to choose a font size, color and italic/bold variants. It's also possible to choose the position of the text.

添加分配的类别

分配的类别是一个组合维,表示与所选数据元素的类别组合相关的类别选项组合。可以通过从左侧维度菜单中将**分配的类别**维度拖动到可视化布局中来添加此维度:

添加分配的类别的另一种方法是访问 数据 维度的上下文菜单中的**添加分配的类别**选项(不适用于 计量 年度 单个值 )。

添加更多轴

当将数据与不同的测量比例组合在一起时,通过拥有多个轴,您将获得更有意义的可视化效果。对于 区域 线 ,您可以通过单击 选项 对话框中的**系列标签**来实现。如果禁用该选项,请确保 数据 维度位于 系列 轴上,并且至少添加了两个项目。

有四个轴可用,两个在图表的左侧(轴 1 和 3),两个在右侧(轴 2 和 4)。 每个轴都有不同的颜色,图表项目将相应地着色。

注意

当使用多个轴时, 样式 选项卡中的 颜色设置 选项将被禁用。 Target line Base line 选项在每个轴的 Axes 选项卡上可用。

使用多种可视化类型

可以将 柱形图 线形 项目组合在一起,反之亦然。这是通过单击 选项 对话框中的 **系列选项卡 **并更改 可视化类型 来完成的。也可以将其与使用多个轴组合(如上节所述)。

这将产生一个结合了 线 类型的图表。

数据钻探

此功能适用于 数据透视表 堆叠列 条形 条形堆叠 可视化类型,并允许通过单击可视化中的值单元格/列/条来钻取数据.一个带有各种选项的上下文菜单打开。

You can drill the data by organisation unit, meaning navigating up and down the org unit tree. The data drill affects the current dimension selection in the layout area. The organisation unit dimension must thus be present on either the Columns / Series axis or the Rows / Category axis for the drill feature to be enabled.

Data drilling in a pivot table

Data drilling in a column chart

管理保存的可视化

保存可视化文件可以方便以后查找。您也可以选择与其他用户共享或在仪表板上显示它们。

打开可视化

  1. 点击**文件** > 打开

  2. 在搜索字段中输入可视化的名称,或单击** <** and **> **箭头在不同页面之间导航。还可以使用右上角的相应菜单按类型和所有者过滤结果。

  3. 单击您要打开的名称。

保存可视化

  1. a)单击**文件** > 保存

  2. 为您的可视化输入 **名称 **和 **描述 **。

  3. 点击**保存**。

重命名可视化

  1. 点击**文件** > 重命名

  2. 输入新名称和/或描述。

  3. 点击 **重命名 **。

删除可视化

  1. 点击**文件** > 删除

  2. 点击**删除**。

  1. 点击**文件** > 获取链接

  2. 可以通过右键单击链接时打开的浏览器上下文菜单复制URL。

可视化解释

查看保存的可视化文件时,可以通过单击右上角的“解释”按钮来扩展右侧的解释。还将显示可视化说明。说明支持RTF格式。

可以通过在右下角的文本字段中键入来添加新的解释。其他用户可以用 @ username 提及。首先输入 @ ,再加上用户名或真实姓名的首字母,然后将显示匹配的用户列表。提及的用户将收到内部DHIS2消息以及解释或评论。解释也可以在 **仪表板 **应用中看到。

可以通过分别使用Markdown样式标记 * _ 分别代表**bold**和_italic_来用 粗体 ,_italic_设置文本格式(也提供键盘快捷键: Ctrl / Cmd + B Ctrl / Cmd + I )。支持有限的表情符号集,可通过键入以下字符组合之一来使用: :) :-) :( :-( :+1 :-1 . 。URL被自动检测并转换为可点击的链接。

要根据特定解释的日期查看可视化效果,请单击解释或它的 查看 按钮。这将重新生成具有相关日期的可视化文件,该日期显示在可视化文件标题旁边。单击 返回所有解释 将重新生成具有当前日期的可视化文件。

要订阅已保存的可视化,请单击右上角的响铃图标。每当其他用户喜欢/创建/更新此已保存的可视化中的解释时,您将收到内部消息。

共享可视化

可以通过单击 File > Share 访问共享设置。更改要修改的用户组的共享设置,可用设置有:

  • 可以编辑和查看 :可以查看和编辑可视化。

  • 只能查看 :仅可以查看可视化。

  • No access : Won't have access to the visualization. This setting is only applicable to Public access and External access . (Note that to enable access to everyone, both Public access and External access must be set to allow view.)

可以通过在 添加用户和用户组 下按名称搜索新用户来添加新用户。

下载

可视化可以使用 **下载 **菜单下载。除 数据透视表 类型外,所有可视化类型均支持 图形 纯数据源 下载,可将其下载为 表格布局 纯数据源

图形 下载

将图像(.png)或PDF(.pdf)文件下载到您的计算机。

表格布局 下载

将Excel(.xls),CSV(.csv)或HTML(.html)文件下载到您的计算机。

普通数据源 下载

您可以下载 JSON、XML、Excel 格式的可视化数据源, 具有不同标识方案的 CSV、JXRML 或原始数据 SQL 格式 (ID、代码和名称)。数据文档使用以下标识符 维度项目并在新的浏览器窗口中打开以显示 地址栏中对 Web API 的请求。这对 基于 DHIS2 Web API 的应用程序和其他客户端模块的开发人员 或者对于那些需要计划数据源的人,例如用于导入 进入统计包。

可用格式

格式 行动 描述
JSON格式 点击JSON 根据ID,Code或Name属性下载JSON格式。
XML格式 单击XML 根据ID,Code或Name属性下载XML格式。
微软Excel 单击Microsoft Excel 根据ID,Code或Name属性下载Microsoft Excel格式。
CSV 点击CSV 根据ID,代码或名称属性下载CSV格式。
XML数据值集 单击高级> XML。 将原始数据值下载为XML,而不是沿各个维度聚合的数据。
JSON数据值集 单击高级> JSON 将原始数据值下载为JSON,而不是沿各个维度聚合的数据。
JRXML 单击高级> JRXML 生成Jasper报告的模板,该模板可根据您的确切需求进行进一步定制,并用作DHIS 2中标准报告的基础。
原始数据SQL 单击高级>原始数据SQL 提供用于生成数据可视化的实际SQL语句。您可以将其用作Jasper报表中的数据源,或用作SQL视图的基础。

以地图查看可视化

要查看可视化效果在地图上的外观,请在完成可视化效果构建后选择 打开为地图 可视化效果类型。

Using the Line Listing app

The Line Listing app is a new app that replaces the line listing functionality in the Event Reports app, but also offers additional functionality.

NOTE

There will be a forward compatibility with the Event Reports app, which means that you can open the existing event reports of type line list in the Line Listing app, but you cannot save changes to them in the Line Listing app.

Creating and editing a line list

When you open the Line Listing app from the DHIS2 menu, you are presented with a blank slate, and you can start creating a line list.

Creating a line list

Line list

In the Line Listing app, you currently only have one type of selection which is Line list.

Input

( This is the same as you see in the Event Reports app ). When you open the Input tab you will see below two options:

  • Event (see individual event data from an event program or a tracker program stage)
  • Enrollment (see data from multiple stages in a tracker program)

Program Dimensions

(In the Event Reports app these are called data dimensions.)

The line list will always be based on event or tracker programs and you can do analysis on a range of dimensions. For programs with category combinations, you can use program categories and category option group sets as dimensions.

Tip

In the Line Listing app, all the dimensions related to a tracker or an event program are present in the program dimension component.

  • Choose a program

    Select program: All the event and tracker programs will be visible in the drop down.

    If you have selected the Event, then for tracker programs you need to select the program stage to get all the data elements, attributes for that particular stage. To be able to select data from multiple stages you need to select "Enrollment" as the input type.

If you select an event program you don’t have to select the stage (unlike the Event Reports app).

If you select Enrollment in the Input tab then all data elements associated with the program will be available from different stages within the program for the purpose of cross stage selection of data elements. Each data element will act as a dimension.

If you want to filter the data, by data elements, program attribute, program indicators, category, category option group set you can do so by clicking on the dropdown option.

There are multiple ways to add data elements to the layout. They can be added by hovering over the dimension and clicking the plus icon or by dragging and dropping a dimension straight to the layout area.

Alternatively, you can click on the respective data element and then choose to add it in column or filter as shown in below figure.

Each dimension can have criteria (filters). Data elements of the type option set allows for "in" criteria, where multiple options can be selected.

Numeric values can be compared to filter values using greater than, equal or less than operators. (Optional) For each data element, specify a filter with operators such as "greater than", "in" or "equal" together with a filter value.

Note

The enhancement in this feature is that you can add multiple conditions and there are also different operators which can be used. You can also filter by empty or not empty.

In the Line Listing app for BOOLEAN type data element, here in the analysis it will show “Yes”, ”No”, ”Not answered” instead of 0 and 1 as in the Event Reports app or the Data Visualizer app.

The line list will be displayed as a table with one row per event. Each dimension can be used as a column in the table or as a filter.

Your Dimension

All Organisation Unit group sets are present under Your dimension component for further evaluation or analysis.

Main and Program Dimensions

Select Organisation Unit

The organisation unit dialog is flexible, offering essentially three ways of selecting organisation units:

  • 显式选择:使用**树**显式选择要在可视化中显示的组织单位。如果您右键单击组织单位,则可以轻松选择以选择其下的所有组织单位。
  • Levels and groups: The Level and Group dropdowns are a convenient way to select all units in one or more org unit groups or at specific levels. Example: select CH Mahosot (level 3) to get all org units at that level.

    NOTE

    Please note that as soon as at least one level or group has been selected the org unit tree now acts as the boundary for the levels/groups. Example: if you select CH Mahosot (level 3) and Vientiane Capital org unit (at level 2) in the tree you get all units inside that district._

  • 用户的组织单位:

    • User organisation unit: This is a way to dynamically select the org units that the logged in user is associated with.
    • User sub-units: Selects the subunits of the user organisation unit.
    • User sub-x2-units:选择用户组织单位下两级的单位。

Event Status

Filters data based on the event status: Active , Completed , Scheduled .

You can visualize the data for a particular event status

Program Status

Filters data based on the program status: Active , Completed or Cancelled .

Created by / Last updated by

Will display the data based on who created the particular event.

Time Dimensions

This is a new feature in Line Listing app where you will be able to view the data on the basis of different time dimensions.

  • Event date/Report Compilation date
  • Date patient notified in the health system.
  • Incident date
  • Last updated on
  • Scheduled date

You can click on the above time dimension to visualize data on different period dimension, a window will open where you can select one or several periods.

You have three period options: relative periods, fixed periods and start/end dates. You can combine fixed periods and relative periods in the same table You cannot combine fixed periods and relative periods with start/end dates in the same table Overlapping periods are filtered so that they only appear once.

  • Fixed periods: In the Select period type box, select a period type. You can select any number of fixed periods from any period type. Fixed periods can for example be "January 2021".
  • Relative periods: In the lower part of the Periods section, select as many relative periods as you like. The names are relative to the current date. This means that if the current month is March and you select Last month , the month of February is included in the visualization. Relative periods have the advantage that it keeps the data in the report up to date as time goes.
  • Start/end dates: Next to Choose form presets, select Start/end dates . This period type lets you specify flexible dates for the time span in the report.

Column Header

You can sort on all column headers

You can filter the specific column by directly clicking the data elements or attributes at the column and you will be able to sort the data values

Example

In the below screenshot, we have selected AEFI – Headache.

Once we click on AEFI – Headache we will get a dialog box where we need to select the option we want to filter out. In this we have selected “Yes” only.

Once we click on update, we will get the line list with only “Yes” under AEFI – Headache.

Repeatable Events

This is a new feature in the Line Listing app.

If the program stage has a data element in a repeatable event you can click on the data element and the window will open up where you will be able to see the Repeated event tab

Then, you can define the most recent events and the oldest events you want in the output as displayed below.

Once you click on update you will be able to visualize the events of this repeatable program stage as shown below.

Applying legend colors

您可以使用图例功能将颜色应用于可视化,该功能可以在 选项 -> 图例 下找到

选项 描述
Use a legend for table cell colors 将图例应用于可视化项,它是每个项的基于值的颜色。图例本身在 维护应用程序 中配置。
图例风格 Controls where the color from the legend is applied, either to the text or the background. You can use this option for scorecards to identify high and low values at a glance.
图例类型 控制应用哪个图例。
对每个数据项使用预定义的图例 根据在 维护应用 中分配给每个数据元素或指标的图例,分别将图例应用于每个数据元素或指标。
为整个可视化选择单个图例 将单个图例应用于所有数据项,在可用图例的下拉列表中选择。
显示图例键 Displays a key for the legend on the right side of the visualization, to indicate the value ranges and their respective color.

Below is an example of a line list with legend colors applied to the background, per data item.

Showing the organisation unit hierarchy

You can show the full hierarchy path for organisation units by enabling the Show organisation unit hierarchy option in Options -> Style . When this is enabled, sorting on the organisation unit column will sort the organisation units alphabetically starting from the top level.

Skip rounding for numeric values

You can control how numeric values are formatted by toggling the Skip rounding option in Options -> Data . When this is enabled, the numeric values are not rounded and all decimals are shown. By default rounding is applied.

Below is an example of the same table with and without the option applied.

View options

To allow more space for the line list itself, there are various ways to hide panels on the top and sides:

  1. The "full screen button" in the title bar will hide the main sidebar on the left and the layout panel at the top of the screen.
  2. If the interpretations panel is expanded on the right, this can be hidden by clicking the "interpretations button" just below the user profile menu.
  3. Each panel can also be shown/hidden by using the "View menu" in the main toolbar.

使用地图应用

关于地图应用

The Maps App was introduced in release 2.29 and serves as a replacement of the GIS App offering a more intuitive and user-friendly interface. The mapping engine from version 2.34 is based on WebGL technology, capable of showing thousands of features on a map simultaneously.

With the Maps app you can overlay multiple layers and choose among different basemaps. You can create thematic maps of areas and points, view facilities based on classifications, and visualize catchment areas for each facility. You can add labels to areas and points, and search and filter using various criteria. You can move points and set locations on the fly. Maps can be saved as favorites and shared with other users and groups, or downloaded as an image.

注意

要在 Maps 应用程序中使用预定义的图例,您需要创建它们 首先在 Maintenance 应用程序中。

  • 工作区左侧的**图层面板**显示一个 当前地图的图层概览:

  • 添加图层时,使用 (+) 添加图层 按钮,它们 在此面板中安排和管理。

  • 底图 始终显示在面板中。默认的 basemap is OSM Light and is selected by default, unless a different basemap has been configured in the system settings. OpenStreetMap 详细包含更多地图特征和地名。有4个 来自 Bing Maps 的底图,替换之前提供的 Google Maps 版本。 Bing Road 和 Bing Dark 显示道路、边界和地点。 如果地图图层上的颜色很亮,请使用深色版本。 Bing 天线和 Bing 天线标签 shos 卫星和详细的天线 意象。通过选择所需的图像在它们之间切换。

  • 图层面板右侧的小箭头按钮,位于 顶部,允许隐藏或显示面板。

  • 文件按钮旁边的 **下载**按钮可让您将当前地图下载为PNG图像。
  • 右上角的**解释**按钮打开解释 panel on the right side of the workspace. See viewing interpretations for more information.
  • 地图上的 + - 按钮允许您放大和缩小 分别是地图。鼠标滚轮缩放是连续的, 使我们能够将地图完美地贴合您的内容。

  • **旋转地图**按钮(三角形箭头)允许您 旋转和倾斜地图以增强数据视图。按下按钮 (或键盘上的 Control 键)同时移动鼠标以更改 地图视图。再次单击以重置视图。

  • 全屏 (四个箭头)允许您全屏查看地图。 要退出全屏,请再次单击按钮或键盘上的退出键。

  • 缩放到内容 (有界放大镜符号)自动 调整缩放级别和地图中心位置以放置数据 你的地图是焦点。

  • 搜索 (放大镜符号)允许搜索和 跳到地图上的某个位置。

  • 使用**直尺**按钮,您可以测量地图上的距离和面积。

  • 右键单击地图以显示该地图的经度和纬度 地点。

底图

底图图层由图层面板中的图层 cards 表示,例如 作为:

在底图卡的顶部,从左到右分别是:

  • 所选底图的标题

  • 折叠和展开底图卡的箭头符号

底图卡片的中间是可用底图的列表。这 当前底图突出显示。

底图卡的底部是:

  • 用于切换图层可见性的眼睛符号

  • 用于修改图层透明度的滑块

建立新地图

  1. 应用 菜单中,单击 地图 。 **DHIS2 地图**窗口 打开。

  2. 单击左上角的 (+) 添加图层按钮。你被介绍 使用图层选择对话框:

  3. 选择要添加到当前地图的图层。可能的选项是:

    此外,Google Earth 还提供了几个图层 引擎和其他服务:

    • 人口

    • 人口年龄组

    • Building footprints

    • 海拔

    • 沉淀

    • 温度

    • 土地覆盖

    _标签覆盖_是一个 外部 layer 在维护应用程序中定义。

管理主题层

_专题图_代表地理分布的空间变化。 选择您想要的指标/数据元素、周期和 组织单位层面。如果您的数据库有坐标并聚合 这些组织单位的数据值,它们将出现在地图上。

注意

您必须生成 DHIS2 分析表才能拥有聚合数据 可用值。

专题图层由图层面板中的图层 cards 表示,例如 作为:

主题卡的顶部从左到右分别是:

  • 抓取字段,允许使用鼠标拖动和重新排序图层

  • 与图层关联的标题和时期

  • 折叠和展开主题卡片的箭头符号

主题卡的中间是一个图例,表示价值 显示在图层上的范围。

主题卡的底部从左到右分别是:

  • 编辑(铅笔)按钮以打开图层配置对话框

  • 用于切换图层可见性的眼睛符号

  • 用于修改图层透明度的滑块

  • 具有更多选项的更多操作(三个点)按钮:

  • 数据表 切换按钮,用于显示或隐藏数据表 与图层相关联

  • **下载数据**允许您以GeoJSON格式下载此图层的数据,以供其他地图软件使用

  • **编辑图层**与上方的编辑按钮相同

  • **移除图层**将从当前地图中移除该图层。

创建一个主题层

要创建事件层,请在 添加 层**选择**热力 。这将打开事件层配置对话框。

  1. 在**数据**标签中:

    • 选择一种数据类型,然后分别选择组和 目标元素。可用字段取决于类型 选择的项目。

    • 聚合类型 字段中为数据选择一个值 要在地图上显示的值。默认情况下,“按数据元素”是 被选中。替代值是: Count;平均数;和;标准 偏差;方差;分钟;最大限度。另见[聚合 运营商]( https://dhis2.github.io/dhis2-docs/master/en/user/html/ch10s05.html#d0e8082 )。

    • Only show completed events : Includes only completed events in the aggregation process. This is useful when you want to exclude partial events in indicator calculations. Available for indicators, program indictors and event data items.

  2. 在**期间**标签中

    • 选择映射专题数据的时间跨度。 您可以选择相对或固定时间段。

    • 相对时期

      Period type 字段中选择 Relative ,然后 选择一个相对时期,例如**去年**或 过去 12 个月 ,在 Period 字段中。

      **默认的分析相对周期**可以在**系统设置**中设置 应用程序。

      如果您选择涵盖多个年/月/周/天的相对时间段 该图层可以显示为

      • 单(合计)

      显示所选相对期间的汇总值(默认)。

      • 时间线

      包括一个时间线,让您可以逐步完成各个时期。 同一地图只能添加一个时间线图层。

      • 拆分地图视图

      显示多张地图,让您可以比较不同时期 并排。支持 12 个项目的相对时间段 或以下。不能与其他图层类型组合。

    • 固定期间

      Period type 字段中选择期间长度,然后 在 Period 字段中选择目标。

    • 开始/结束日期

      在**期间类型** 字段中选择**开始/结束日期** 并填写开始日期和结束日期。

  3. 在**ORG UNITS**标签中:

    • 选择要包含在图层中的组织单位。 可以选择任一

    • 一个或多个特定的组织单位,组织单位级别在 层次结构、组织单位组,或

    • 组织单位层次结构中的相对级别,具有 尊重用户。通过选择**用户组织 单位** 地图数据对用户的显示会有所不同 组织单位层次结构中的不同级别。

    • Use associated geometry : This dropdown will only show if there are any additional geometry available for your organisation units. This is typically used to show facility catchment areas.

  4. 在**过滤器**标签中:

    • 单击 ADD FILTER 并选择可用数据项以添加新的 过滤数据集。

    • Select a data dimension from the dropdown box. You can 使用搜索字段减少显示的维数。 单击名称以选择维度。

    • When a dimension is selected you get a second dropdown with 维度项。选中您要包含在 筛选。

    可以添加多个过滤器。点击右侧的垃圾桶按钮 过滤器将其删除。

  5. 在**样式**标签中:

    • 选择**钟形**或**气泡图**。

    • Choropleth 将根据 数据值。如果数据是标准化的,这是推荐的技术 (人均)。

    • 气泡图将数据值显示为比例圆圈。用这个 如果数据未标准化(绝对数字)的技术。圆圈是 放置在每个组织单位的中心。

    • 为比例圆设置 低半径 高半径 或 点设施。圆将根据低半径和高半径进行缩放 到数据值。半径需要在 0 到 50 像素之间。

    • 显示标签 :允许在图层上显示组织单位名称。字体大小、重量、 可以在这里修改样式和颜色。

    • 不显示数据 :默认情况下,地图上不会显示缺少数据值的组织单位。 如果您想用颜色显示它们,请选中此框。单击颜色以更改它。

    • 选择图例类型:

    • 自动颜色图例 :应用程序将根据以下内容为您创建图例 您选择的分类方法、类别数量和色阶。放 **分类**为:

      • 等间隔

      每个间隔的范围将是(最高数据值-最低数据值/类数)

      • 均数

      图例创建者将尝试平均分配组织单位。

    • 预定义的颜色图例 :在预定义的图例之间进行选择。

    • 单色图例 :选择气泡或圆圈的颜色。仅可用 用于气泡图。

  6. 点击**添加图层**。

修改主题层

  1. 在图层面板中,单击主题上的编辑(铅笔)图标 层卡。

  2. 根据需要修改任何选项卡上的设置。

  3. 点击**更新图层**。

筛选主题层中的值

专题图层有一个 data table 选项,可以打开或 从专题图层卡上关闭。

数据表显示构成主题层的数据。

  • 单击标题将根据该列对表格进行排序; 在上升和下降之间切换。

  • 在标题下方的过滤器字段中输入文本或表达式 将这些过滤器应用于数据,并且显示将调整 根据过滤器。过滤器应用如下:

  • 名称

    按包含给定文本的名称过滤

  • 按给定的数字和/或范围过滤值,例如: 2,>3&\<8

  • 传说

    按图例过滤并包含给定的文本

  • 范围

    按包含给定文本的范围过滤

  • 水平

    按数字和/或范围过滤级别,例如:2,> 3& <8

  • 父母

    按包含给定文本的父项名称过滤

  • ID

    按包含给定文本的ID进行过滤

  • 类型

    按包含给定文本的GIS显示类型过滤

  • 颜色

    按包含给定文本的颜色名称过滤

注意

数据表过滤器是临时的,不与地图层一起保存 作为收藏夹的一部分。

搜索组织单位

数据表中的 NAME 过滤器字段提供了一种有效的方法 搜索单个组织单位。

Open organisation unit profile

You can open the organisation unit profile in three ways:

  1. Click on any of the organisasjon units shown on the map, and click the View profile button in the popup.

  2. Right-click one of the organisation units on the map, and select View profile from the menu.

  3. Click on an organisation unit row in the data table .

当地图上有可见的组织单位时,您可以轻松地 在不使用级别/父级的情况下在层次结构中上下导航 用户界面。

  1. 右键单击组织单位之一。

  2. 选择**向上钻取一级**或**向下钻取一级**。

    如果您处于最低级别或 如果在下面的级别上没有可用的坐标。同样地 向上钻取选项从最高级别被禁用。

删除主题层

要清除主题层中的所有数据:

  1. 在左侧的图层卡中,单击_更多操作_(三个点)图标 然后在**删除图层**。

    该图层将从当前地图中删除。

管理事件层

事件层显示注册事件的地理位置 在 DHIS2 跟踪器中。只要事件具有关联的点或多边形 坐标,您可以使用此图层从聚合的 显示在专题层中的数据给底层个人 事件或案例。

You can also display aggregated events for facilities or organisation units. You do this through a thematic layer using event data items. This is useful when you only have the coordinates for the Org Unit under which the events are recorded.

事件层由层面板中的层 cards 表示,例如 作为:

在事件卡的顶部,从左到右分别是:

  • 抓取字段,允许使用鼠标拖动和重新排序图层

  • 与图层关联的标题和时期

  • 折叠和扩展事件卡的箭头符号

在事件卡的中间是一个说明样式的图例 层。

在事件卡的底部,从左到右分别是:

  • 编辑(铅笔)按钮以打开图层配置对话框

  • 用于切换图层可见性的眼睛符号

  • 用于修改图层透明度的滑块

  • 具有更多选项的更多操作(三个点)按钮:

  • **数据表**切换按钮可显示或隐藏与图层关联的数据表

  • **下载数据**允许您以GeoJSON格式下载此图层的数据,以供其他地图软件使用

  • **编辑图层**与上方的编辑按钮相同

  • **移除图层**将从当前地图中移除该图层。

创建一个事件层

要创建事件层,请在 Add 层**选择**事件 。这将打开事件层配置对话框。

  1. 在**数据**标签中:

    • 选择一个项目,然后选择一个项目阶段。 阶段 字段仅在选择程序后显示。

    如果所选程序只有一个阶段可用, 舞台是自动选择的。

    • Coordinate field 中为位置选择一个值 显示在地图上。默认情况下,选择“事件位置”。 根据属于一个的数据元素或属性 程序,其他坐标如“家庭位置”是 可用的。

    • 默认情况下,所有带有坐标的事件都显示在地图上。 使用 Event status 字段仅显示具有一个的事件 状态:活动、已完成、计划、过期或已跳过。

  2. 在**期间**标签中

    • 选择事件发生的时间跨度。你可以 选择固定期间或相对期间。

    • 相对时期

      Period 字段中,选择相对期间之一, 例如**本月**或**去年**。

      **默认的分析相对周期**可以在 **系统设置**应用程序。

    • 固定期间

      Period 字段中,选择 Start/end Dates 并填写 在开始日期和结束日期。

  3. 在**ORG UNITS**标签中:

    • 选择要包含在图层中的组织单位。 可以选择任一

    • 一个或多个特定的组织单位,或

    • 组织单位层次结构中的相对级别,具有 尊重用户。通过选择**用户组织 单位** 地图数据对用户的显示会有所不同 组织单位层次结构中的不同级别。

  4. 在**过滤器**标签中:

    • 单击 ADD FILTER 并选择可用数据项以添加新的 过滤数据集。

    • 对于 option set 类型的数据项,您可以选择任何一个 the options from the dropdown box by using the down-wards 箭头或直接在框中开始输入以过滤 选项。

    • 对于 number 类型的数据项,您可以选择运算符,例如 等于、不等于、大于或小于。

    • 对于 boolean 类型的数据项(是/否),您可以选中该框 条件是否应为有效或为真。

    • 对于 text 类型的数据项,您将有两个选择: Contains 表示查询将匹配所有值 其中包含您的搜索值,并且**是精确的**意味着 只有与您完全相同的值 将返回搜索查询。

    可以添加多个过滤器。点击右侧的垃圾桶按钮 过滤器将其删除。

  5. 在**样式**标签中:

    • 选择 Group events 将附近的事件(集群)分组,或 **查看所有事件**以单独显示事件。

    • 为事件或聚类点选择一种**颜色**。

    • 为事件选择**半径**(1到20之间)。

    • 选择 Show buffer 以显示每个周围的视觉缓冲区 事件。可以在此处修改缓冲区的半径。这 选项仅在您选择 查看所有事件 时可用 以上。

    • 选择 Style by data element 为事件着色 根据数据值。如果您还选择将事件分组, culsters 将显示为小圆环图显示 数据值的分布。选项因 不同的数据类型:

    • 选项集 :为选项中的每个选项选择一种颜色 放。您可以为选项中的选项设置默认颜色 维护应用程序。

    • 数字 :您可以在 相同的 作为专题图层的方式 使用 自动或预定义的图例。

    • 布尔值 :为真/是选择一种颜色,为真/是选择另一种颜色 假/没有。

  6. 点击**添加图层**。

修改事件层

  1. 在图层面板中,单击事件图层上的编辑(铅笔)图标 卡片。

  2. 修改 DATA、PERIOD、FILTER、ORG UNIT 和 STYLE 的设置 选项卡。

  3. 点击**更新图层**。

列出和过滤事件

事件层有一个 data table 选项,可以打开或 从事件层卡上关闭。

数据表显示构成事件层的数据。

  • 单击标题将根据该列对表格进行排序; 在上升和下降之间切换。

  • 在标题下方的过滤器字段中输入文本或表达式 将这些过滤器应用于数据,并且显示将调整 根据过滤器。过滤器应用如下:

  • ID

    按包含给定文本的事件ID进行过滤

  • 组织单位

    按包含给定文本的组织单位名称过滤

  • 活动时间

    按包含给定文本的事件时间过滤

  • 类型

    按包含给定文本的GIS显示类型过滤

  • 按数据元素设置样式 :如果事件按数据元素设置样式 (例如性别)数据值和颜色都可以过滤。

  • 在报告中显示 :选中以在报告中显示的数据元素将 显示在单独的列中(请参阅下文如何添加它们)。

  • 数字数据值可以通过给定的数字和/或范围进行过滤, 例如:2,>3&\<8

注意

数据表过滤器是临时的,不与地图层一起保存 作为收藏夹的一部分。

修改事件数据表和弹出窗口中的信息

您可以修改事件弹出窗口中显示的信息。

  1. 打开**维护**应用程序。

  2. 选择**程序**。

  3. 单击要修改的程序,然后选择** 2分配数据元素**。

  4. 对于要在弹出窗口中显示的每个数据元素, 选择相应的**在报告中显示**。

  5. 点击**保存**。

下载原始事件层数据

可以以GeoJSON格式下载事件层的原始数据,以便在桌面GIS软件(例如[QGIS] https://www.qgis.org/ )中进行更高级的地理分析和处理。下载的数据包括所有单独的事件,作为GeoJSON功能,包括为**在报告中显示**选择的每个数据元素的属性。

  • 在左侧的图层卡中,点击_more actions_(三个点)图标,然后点击**下载数据**

  • 选择** ID格式**用作下载的GeoJSON文件中数据元素值的键。共有三个选项:

  • ** ID **-使用数据元素的唯一ID

  • 名称 -使用数据元素的人性化名称(翻译)
  • 代码 -使用数据元素的代码

  • 选择是否对其他事件属性(例如程序阶段,纬度,经度,事件数据以及组织单位ID,名称和代码) 使用人类可读的键 。如果**未**选中此选项,则这些值将是计算机友好的ID,而不是人类可读(和翻译)的名称。

  • 单击**下载**按钮以生成和下载GeoJSON文件。数据将从DHIS2服务器请求并由地图应用程序处理。此操作可能需要几分钟才能完成。

  • 一旦下载了GeoJSON文件,就可以将其导入大多数标准GIS软件应用程序中。

请注意,下载的数据不包含样式信息,因为GeoJSON格式本身不支持它。可以选择使用每个要素的属性在外部GIS应用程序中重新创建样式。

清除事件层

要清除地图中的所有事件层数据:

  1. 在左侧的图层卡中,单击_更多操作_(三个点)图标 然后在**删除图层**。

    该图层将从当前地图中删除。

管理跟踪的实体层

被追踪实体图层显示被追踪的地理位置 在 DHIS2 中注册的实体。前提是被跟踪的实体有 关联的点或多边形坐标,您可以在地图上探索这些。

跟踪实体图层由图层面板中的图层卡片表示 如:

沿着跟踪实体卡的顶部,从左到右分别是:

  • 一个抓取字段,允许拖动和重新排序图层 鼠。

  • 与图层关联的标题和时期。

  • 箭头符号,用于折叠和展开被跟踪的实体卡。

被追踪实体卡片的中间是一个图例,表明 图层样式。

跟踪实体卡的底部从左到右分别是:

  • 编辑(铅笔)按钮以打开图层配置对话框

  • 用于切换图层可见性的眼睛符号

  • 用于修改图层透明度的滑块

  • 具有更多选项的更多操作(三个点)按钮:

  • **编辑图层**与上方的编辑按钮相同

  • **移除图层**将从当前地图中移除该图层。

创建一个跟踪实体层

要创建跟踪实体层,请在 添加图层**选择**跟踪实体 。这将打开 跟踪实体层 配置对话框。

  1. 在**数据**标签中:

    • 选择要在地图上显示的**跟踪实体类型**。

    • 选择被跟踪实体所属的**程序**。

    • 使用 Program status 字段选择被跟踪实体的注册状态 包括:全部、活动、已完成或已取消。

    • 为给定的跟踪实体设置 Follow up 状态 程序。

  2. 在**关系**标签中

    Caution

    Displaying tracked entity relationships in Maps is an experimental feature

    • 如果选择了跟踪的实体类型,则可以选中**显示跟踪的实体关系**复选框

    • 选中后,您可以从下拉列表中选择要显示在地图上的关系类型。仅来自所选“跟踪的实体”类型的关系可用。

  3. 在**期间**标签中

    • 如果没有选择节目,您可以设置开始和结束日期 跟踪的实体是最后更新的。

    • 如果选择了程序,您可以设置上次跟踪实体的时间段 更新或何时注册或注册该计划。

  4. 在**ORG UNITS**标签中:

    • 选择要包含在图层中的组织单位。 您有 3 种选择模式:

    • 仅选定 :包括属于 仅限选定的组织单位。

    • 选定及以下 :包括和中的跟踪实体 在所选组织单位的正下方。

    • 选定和所有以下 :包括和中的跟踪实体 所有低于选定的组织单位。

  5. 在**样式**标签中:

    • 为跟踪的实体点和多边形选择一种**颜色**。

    • 选择 点大小 (半径在 1 到 20 之间)作为 点。

    • 选择 Show buffer 以显示每个周围的视觉缓冲区 被跟踪的实体。可以修改以米为单位的缓冲距离 这里。

    • 如果在关系选项卡上选择了关系类型,则可以为关系和相关的跟踪实体实例选择**颜色**, 点大小**和**线颜色

  6. 点击**添加/更新图层**。

修改跟踪的实体层

  1. 在图层面板中,单击跟踪的编辑(铅笔)图标 实体层卡。

  2. 将 DATA、PERIOD、ORG UNIT 和 STYLE 选项卡上的设置修改为 想要的。

  3. 点击**更新图层**。

清除跟踪的实体层

要从地图上清除跟踪的实体层:

  1. 在左侧的图层卡中,单击_更多操作_(三个点)图标 然后在**删除图层**。

    该图层将从当前地图中删除。

管理设施层

设施层显示代表设施类型的图标。 多边形不会显示在地图上,因此请确保选择一个 具有设施的组织单位级别。

多边形是地图上代表一个国家的封闭区域, 区或公园。

设施层由层面板中的层 cards 表示,例如 作为:

在设施卡的顶部,从左到右分别是:

  • 抓取字段,允许使用鼠标拖动和重新排序图层

  • **设施**标题

  • 用于切换图层可见性的眼睛符号

  • 折叠和扩展设施卡的箭头符号

在设施卡的中间是一个指示组的图例 设置表示。

设施卡的底部从左到右分别是:

  • 编辑(铅笔)按钮以打开图层配置对话框

  • 用于修改图层透明度的滑块

  • 具有更多选项的更多操作(三个点)按钮:

  • 数据表 切换按钮,用于显示或隐藏数据表 与图层相关联

  • **下载数据**允许您以GeoJSON格式下载此图层的数据,以供其他地图软件使用

  • **编辑图层**与上方的编辑按钮相同

  • **移除图层**将从当前地图中移除该图层。

创建设施层

要创建设施层,请在 Add 图层**选择**机构 。这将打开设施层配置对话框。

  1. 在**组织单位**标签中

    • Select the organisation unit level(s) and/or group(s) from the 右侧的选择字段。

    • 选择要包含在图层中的组织单位。 可以选择任一

    • 一个或多个特定的组织单位,或

    • 组织单位层次结构中的相对级别,具有 尊重用户。通过选择**用户组织 单位** 地图数据对用户的显示会有所不同 组织单位层次结构中的不同级别。

    • The system administrator can set the default organsation unit level containing facilities in the System Settings app.

    • Use associated geometry : This dropdown will only show if there are any additional geometry available for your organisation units. This is typically used to show facility catchment areas.

  2. 在**样式**标签中:

    • Select any styling you wish to apply to the facilities.

    • 显示标签

      允许在图层上显示标签。字体大小、重量 和颜色可以在这里修改。

    • 显示缓冲区

      允许在周围的图层上显示视觉缓冲区 每个设施。可以修改缓冲区的半径 here. Buffer option is not available if asscoiated geometry is used.

    • Facilities can be styled an organisation unit group set using different icons. Select a group set from the list of organisation unit group sets defined for your DHIS2 instance. The system administrator can set the default organsation unit group set in the System Settings app.

    • If no group set is selected, the facilities will be shown as filled circles. The color and the circle radius can be changed.

  3. 点击**添加图层**。

创建或修改设施层

  1. 在图层面板中,单击设施上的编辑(铅笔)图标 层卡。

  2. 修改 GROUP SET、ORGANIZATION UNITS 和 STYLE 上的设置 选项卡。

  3. 点击**更新图层**。

过滤设施层中的值

设施层有一个**数据表**选项,可以打开或 离设施层卡。

数据表显示构成设施层的数据。

  • 单击标题将根据该列对表格进行排序; 在上升和下降之间切换。

  • 在标题下方的过滤器字段中输入文本或表达式 将这些过滤器应用于数据,并且显示将调整 根据过滤器。过滤器应用如下:

  • 名称

    按包含给定文本的名称过滤

  • ID

    按包含给定文本的ID进行过滤

  • 类型

    按包含给定文本的GIS显示类型过滤

注意

数据表过滤器是临时的,不与地图层一起保存 作为收藏夹的一部分。

搜索设施

数据表中的 NAME 过滤器字段提供了一种有效的方法 寻找个人设施。

Open organisation unit profile

You can open the organisation unit profile in three ways:

  1. Click on any of the organisasjon units shown on the map, and click the View profile button in the popup.

  2. Right-click one of the organisation units on the map, and select View profile from the menu.

  3. Click on an organisation unit row in the data table .

删除设施层

要清除设施层中的所有数据:

  1. 在左侧的图层卡中,单击_更多操作_(三个点)图标 然后在**删除图层**。

    该图层将从当前地图中删除。

Manage org unit layers

The org unit layer displays the borders and locations of your organisation units. This layer is particularly useful if you are offline and don't have access to background maps.

Org unit layers are represented by layer cards in the layer panel such as:

Along the top of the org unit card from left to right are:

  • 抓取字段,允许使用鼠标拖动和重新排序图层

  • The Organisation unit title

  • An arrow symbol to collapse and expand the org unit card

Along the bottom of the org unit card from left to right are:

  • 编辑(铅笔)按钮以打开图层配置对话框

  • 用于切换图层可见性的眼睛符号

  • 用于修改图层透明度的滑块

  • 具有更多选项的更多操作(三个点)按钮:

  • 数据表 切换按钮,用于显示或隐藏数据表 与图层相关联

  • **下载数据**允许您以GeoJSON格式下载此图层的数据,以供其他地图软件使用

  • **编辑图层**与上方的编辑按钮相同

  • **移除图层**将从当前地图中移除该图层。

Create an org unit layer

To create an org unit layer, choose Org units on the Add layer selection. This opens the org unit layer configuration dialog.

  1. 在**组织单位**标签中

    • 从组织单位级别和/或组中选择 右侧的选择字段。

    • 选择要包含在图层中的组织单位。 可以选择任一

    • 一个或多个特定的组织单位,或

    • 组织单位层次结构中的相对级别,具有 尊重用户。通过选择**用户组织 单位** 地图数据对用户的显示会有所不同 组织单位层次结构中的不同级别。

    • Use associated geometry : This dropdown will only show if there are any additional geometry available for your organisation units. This is typically used to show facility catchment areas.

  2. 在**样式**标签中:

    • select any styling you wish to apply to the org unitss.

    • Labels

      Allows labels to be shown on the layer. Font style can be modified here.

    • Boundary color

      Allows the boundary or outline color of the organisation units to be changed.

    • 点半径

      设置点类型元素时的基半径,例如 facilities, are presented on the org unit layer.

    • Organisation units can be styled an organisation unit group set using different colors. Select a group set from the list of organisation unit group sets defined for your DHIS2 instance.

  3. 点击**添加图层**。

Modify an org unit layer

  1. In the layer panel, click the edit (pencil) icon on the org unit 层卡。

  2. 将 ORGANIZATION UNITS 和 STYLE 选项卡上的设置修改为 想要的。

  3. 点击**更新图层**。

Filter values in an org unit layer

Org unit layers have a data table option that can be toggled on or off from the org unit layer card.

The data table displays the data forming the org unit layer.

  • 单击标题将根据该列对表格进行排序; 在上升和下降之间切换。

  • 在标题下方的过滤器字段中输入文本或表达式 将这些过滤器应用于数据,并且显示将调整 根据过滤器。过滤器应用如下:

  • 名称

    按包含给定文本的名称过滤

  • 水平

    按数字和/或范围过滤级别,例如:2,> 3& <8

  • 父母

    按包含给定文本的父项名称过滤

  • ID

    按包含给定文本的ID进行过滤

  • 类型

    按包含给定文本的GIS显示类型过滤

注意

数据表过滤器是临时的,不与地图层一起保存 作为收藏夹的一部分。

搜索组织单位

The NAME filter field in the data table provides an effective way of searching for individual organisational units displayed in the org unit layer.

Open organisation unit profile

You can open the organisation unit profile in three ways:

  1. Click on any of the organisasjon units shown on the map, and click the View profile button in the popup.

  2. Right-click one of the organisation units on the map, and select View profile from the menu.

  3. Click on an organisation unit row in the data table .

You can modify the target of the org unit layer in the hierarchy without using the level/parent user interface.

  1. 右键单击组织单位之一。

  2. 选择**向上钻取一级**或**向下钻取一级**。

    如果您处于最低级别,则禁用向下钻取选项。 同样,从最高级别禁用向上钻取选项。

Remove org unit layer

To clear all data in an org unit layer:

  1. 在左侧的图层卡中,单击_更多操作_(三个点)图标 然后在**删除图层**。

    该图层将从当前地图中删除。

管理地球引擎层

The layers from Google Earth Engine let you display and aggregate external data to your organisation units. Use the population layer to calculate the number of people living in a district, or within a distance from a health facility. The elevation layer allows you to find the lowest, highest and mean elevation. Use the landcover layer to see the forest cover, croplands or urban areas, and calculate the percentage for each organisation unit.

支持以下层:

  • 人口 :来自 WorldPop 的详细人口数据,显示了估计的 居住在一个地区的人口数量。可用于 2000 年和 向前。

  • 人口年龄组 :估计居住在一个地区的人数,分组 按年龄和性别。

  • Building footprints : The outlines of buildings derived from high-resolution satellite imagery. Only for the continent of Africa.

  • 海拔 :海拔高度。

  • 降水 :数值以 5 天内的毫米为单位。更新 每月,在下个月的第三周。从地面卫星和气象站收集。

  • 温度 :从卫星收集的地表温度。 有持续云层覆盖的区域会出现空白点。

  • 土地覆盖 :美国宇航局从卫星收集的 17 种不同的土地覆盖类型。

创建地球引擎图层

要创建 Earth Engine 图层,请从 **Add 层**选择。这将打开层配置对话框。

  1. 在**数据**标签中:

    • 对于“人口年龄组”,您可以选择年龄/性别**组** 您希望在汇总数据时包括在内。

    • 选择计算时要使用的**聚合方法** 所选组织单位的值。

    • 总和 :计算每个组织单位内的总数。 推荐用于人口图层。

    • Min :返回显示在图层单元下方的最小值 选择。对于人口层,它将是最小的 people per 公顷 .对于高程图层,它将返回最低高程(米 高于海平面)。

    • Max :返回图层单位的最大值。对于人口 层,它将是每公顷最少_人_。对于高程图层 将返回每个组织单位的最高海拔。

    • Mean :以层为单位返回平均值。对于人口图层 这将是平均_人每公顷_。对于降水层,它将 是整个组织单位的平均降雨量(以毫米为单位)。

    • 中值 :以层为单位返回平均值。对于人口图层 这将是每公顷_人_的中位数。对于温度层,它将 是组织单位白天的中值°C。

    • 标准差 :返回层中的标准差值 单元。

    • Variance :以层为单位返回方差值。

  2. 在**期间**标签中

    • 选择数据源的时间段。可用期间由 数据提供者。 “人口年龄组”层只有一个时期, 而“人口”层有 2000 年及以后的年度数据。 提供 5 天周期的降水数据,以及 5 天的温度数据 8天周期。
  3. 在**ORG UNITS**标签中:

    • 选择要查看聚合数据值的组织单位。 可以选择任一

    • 一个或多个特定的组织单位,组织单位级别在 层次结构、组织单位组,或

    • 组织单位层次结构中的相对级别,具有 尊重用户。通过选择**用户组织 单位** 地图数据对用户的显示会有所不同 组织单位层次结构中的不同级别。

    • Use associated geometry : This dropdown will only show if there are any additional geometry available for your organisation units. This is typically used to calculate values for facility catchment areas.

    • Building footprints : Building counts are only available for smaller organisation unit areas.

  4. 在**样式**标签中

    • 修改特定于图层类型的参数。

    • 根据需要调整图例范围,步长和颜色。

    • 如果选择具有单点坐标的组织单位 (设施)你可以设置一个半径缓冲区来计算 内的数据值。 5000 米的半径将聚合所有 values available within a 5 km distance from a facility. Buffer option is not available if associated geometry is used.

  5. 点击**添加图层**。

单击地图区域或设施以查看其聚合结果 组织单位。

数据值列表

地球引擎层有一个**数据表**选项,可以打开或 离层卡。

数据表显示所选组织单位的所有聚合值。

  • 单击标题将根据该列对表格进行排序; 在上升和下降之间切换。

  • 在标题下方的过滤器字段中输入文本或表达式 将这些过滤器应用于数据,并且显示将调整 根据过滤器。过滤器应用如下:

  • 名称

按包含给定文本的组织单位名称过滤

  • ID

按包含给定文本的事件ID进行过滤

  • 类型

按包含给定文本的GIS显示类型过滤

  • 聚合值

每个选择的聚合类型都有一列

数字数据值可以通过给定的数字和/或范围进行过滤, 例如:2,>3&\<8

注意

数据表过滤器是临时的,不会与地图图层一起保存。

添加外部地图图层

外部地图图层表示为:

  • 底图

这些在图层面板的 底图 卡中可用,并且 被选为任何其他底图。

  • 叠加层

这些在**添加图层** 选项中可用。与底图不同的是, 叠加层可以放置在任何其他叠加层的上方或下方。

叠加层由层中的附加层_cards_表示 面板如:

覆盖卡的顶部从左到右分别是:

  • 抓取字段,允许使用鼠标拖动和重新排序图层

  • 外部地图图层的标题

  • 折叠和展开覆盖卡的箭头符号

如果图层有图例,则卡的中间是图例。

覆盖卡的底部从左到右分别是:

  • 用于修改图层透明度的滑块

  • 删除(垃圾桶)图标,用于从当前图层中删除图层 专题地图。

Organisation unit profile

The organisation unit profile shows detailed information about each organisation unit. You can open the profile from org unit, facility and thematic layers.

You can open the organisation unit profile in three ways:

  1. Click on any of the organisasjon units shown on the map, and click the View profile button in the popup.

  2. Right-click one of the organisation units on the map, and select View profile from the menu.

  3. Click on an organisation unit row in the data table .

The profile will show on the right side of the map. The profile contents is set by the system administrator.

文件菜单

使用**文件菜单** 来管理您的地图。几个菜单项将是 禁用,直到您打开或保存地图。

保存您的地图可以轻松地在以后恢复它们。它还给你 有机会与其他用户分享它们作为解释或 把它放在仪表板上。您可以保存所有类型的图层配置 作为最爱。

建立新地图

点击**文件** > 新建

注意!这将清除您当前拥有的地图图层,而不进行保存。

开启新地图

  1. 点击**文件** > 打开 。将打开一个对话框,其中包含地图列表。

  2. 找到您要打开的收藏夹。您可以使用 \< and > 或 搜索字段以查找已保存的地图。该列表在每个 您输入的字符。您可以通过选择过滤列表 显示全部 由我创建**或**由他人创建

  3. 点击要打开的地图的名称。

保存地图

创建地图后,可以方便地将其保存以备后用:

  1. 单击**文件** > 保存

  2. 输入**名称**(必填)和**说明**(可选) 第一次保存地图。

  3. 点击**保存**。

保存地图副本

  1. 单击**文件** > **另存为... **

  2. 输入**名称**(必填)和**说明**(可选) 地图。

  3. 点击**保存**。

重命名地图

  1. 点击**文件** > 重命名

  2. 为您的地图输入新的**名称**和/或**描述**。

  3. 点击**重命名**。地图已更新。

翻译地图

  1. 点击**文件** > 翻译

  2. 选择您的翻译的**地方语言**(语言)。

  3. 输入翻译后的 Name Description 。原文 将显示在字段下方。

  4. 点击**保存**。

修改地图的共享设置

创建并保存地图后,您可以与以下人员共享地图 每个人或一个用户组。要修改共享设置:

  1. 点击**文件** > 共享 。共享设置对话框打开。

  2. Give access to a user or group : In the text box, search for the name of the user or group you want to share your favorite with and select it.

    Select the access level and click on Give access .

    Repeat the step to add more users or groups.

  3. Users and groups that currently have access : For each user or group, choose the access level. The options are:

    • No access: The public won't have access to the map. This setting is only applicable to All users.

    • View only

    • View and edit

    • Remove access: Remove the access for groups or individuals.

  4. Click Close to close the dialog.

  1. 点击**文件** > 获取链接 。将打开一个链接对话框。

  2. 复制链接。

删除地图

  1. 点击**文件** > 删除 。显示确认对话框。

  2. 单击**删除**以确认您要删除收藏夹。 您的地图被删除,图层从视图中清除。

地图解译

解释是在给定时期对地图的描述。这 信息在 仪表板应用 中可见。点击 Interpretations 在工作区的右上角打开 解释面板。该按钮仅在保存地图时才可点击。

查看基于相对期间的解释

要查看相对时期的解释,例如一年前:

  1. 用解释打开收藏夹。

  2. 点击工作区右上角的**Interpretations**打开 解释小组。

  3. Click on See interpretation . Your map displays the data and the date 基于解释的创建时间。查看其他 解释,点击它们。

为地图写解释

要创建解释,您首先需要创建地图并保存。 如果您与其他人分享了您的地图,您的解释 write 对那些人是可见的。

  1. Open a saved map.

  2. 点击工作区右上角的**Interpretations**打开 解释小组。

  3. 将出现一个文本字段,并为用户显示占位符“编写解释” 对收藏有读取权限。

  4. 在文本字段中,输入评论、问题或解释。你 也可以使用“@username”提及其他用户。首先输入“@” 加上用户名或真实姓名的第一个字母和提及 bar 将显示可用的用户。提及的用户将收到 带有解释或注释的内部 DHIS2 消息。你 可以在 Dashboard app 中看到解释。

  5. Click Post interpretation to save the interpretation.

更改解释的共享设置

  1. 单击一个解释(请参阅上面的查看解释)。

  2. Click the share icon below the interpretation. The sharing settings 对话框打开。

  3. 搜索并添加要共享的用户和用户组 your map with, and set the access level. Click on Give access .

  4. Change the access level for the users you want to modify:

    • View and edit : Everyone can view and edit the object.

    • View only : Everyone can view the object.

    • 无访问权限 :公众无权访问该对象。这 setting is only applicable to All users.

    • Remove access : Remove the access for groups or individuals.

  5. 共享设置更新后,单击**关闭**。

将地图另存为图像

您可以通过单击顶部菜单中的“下载”按钮将地图下载为图像

Internet Explorer 或 Safari 不支持地图下载,我们建议您 使用谷歌浏览器或火狐浏览器。

  1. 选择是否要包含地图名称。该选项仅 如果地图已保存,则可用。

  2. 选择是否要包括地图图例。您可以定位图例 在地图的 4 个角落之一。

  3. 点击**下载**以下载地图。

地点搜索功能可让您搜索几乎任何位置 或地址。此功能可用于定位例如 地图上的地点、设施、村庄或城镇。

  1. 在“地图”窗口的右侧,单击放大镜图标。

  2. 输入您要查找的位置。

    键入时会显示匹配位置的列表。

  3. 从列表中选择一个位置。一个大头针指示位置 地图。

测量地图中的距离和面积

  1. 在地图的左上角,将光标放在**Measure 距离和面积**(标尺)图标,然后单击**新建 测量**。

  2. 在地图上添加点。

  3. 点击**完成测量**。

获取任意位置的纬度和经度

右键单击地图上的一个点并选择**显示经度/纬度**。 值显示在弹出窗口中。

也可以看看

分析数据透视表中的数据

关于数据透视表应用

借助**数据透视表**应用,您可以基于所有内容创建数据透视表 DHIS2中的可用数据维度。数据透视表是用于 数据分析,可让您根据数据汇总和排列数据 方面。 DHIS2中的数据维度示例如下:

  • 数据维度本身(例如数据元素、指标和 事件)

  • 时间段(代表数据的时间段)

  • 组织层次结构(代表地理位置 数据)

您可以从这些维度中自由选择*维度项目*以包含 在数据透视表中。您可以在 DHIS2 中创建附加维度 组集功能。这允许不同的聚合 途径,例如按“合作伙伴”或设施类型聚合。

数据透视表可以在 columns rows 和 as 上排列数据维度 过滤器 。在列上放置数据维度时,数据透视表 将为每个维度项目显示一列。如果放置多个数据 列上的维度,数据透视表为所有显示一列 所选维度中项目的组合。当你放置一个 行上的数据维度,数据透视表每个维度显示一行 项目以类似的方式。您选择作为过滤器的维度不会 包含在数据透视表中,但会聚合和过滤表 基于所选过滤项的数据。

提示

  • 您必须在列或行上至少选择一个维度。

  • 您必须至少包括一个句号。

  • 数据元素组集和报告率不能出现在 相同的数据透视表。

  • 数据透视表不能包含超过最大数量 已在系统设置中指定的分析记录。 最大记录数也可能受到限制 浏览器可用的最大 RAM。你会 如果您请求的表超过一个警告提示 特定尺寸。在此提示中,您可以取消 请求或继续构建表。考虑缩小 表格而不是一张显示所有数据的表格 元素和指标结合在一起。

  • Pivot Table 应用程序支持对期间和 组织单位。这意味着您可以例如向下钻取 从年度到季度、月和周内的枢轴 桌子。您还可以从全局组织单位向下钻取 到国家、省份和设施。

创建数据透视表

  1. 打开**数据透视表**应用。

  2. 在左侧的菜单中,选择您想要的维度项 分析,例如数据元素或指标。

  3. 单击**布局**,然后将数据维排列为列,行 和过滤器。

    您可以根据需要保留默认选择。

  4. 点击**更新**。

在此示例中,指标被列为列,周期被列为行。

选择尺寸项目

左侧菜单列出了所有可用数据维度的部分。从 每个部分都可以选择任意数量的维度项。作为 例如,您可以打开数据元素部分并选择任何 可用列表中的数据元素数。您可以选择一个项目 通过标记它并单击部分标题中的箭头或简单地 双击该项目。在您可以使用数据维度之前 数据透视表您必须至少选择一个维度项目。如果你安排 一个维度作为列或行,但不选择任何维度项目, 维度被忽略。

您必须至少选择一种数据维度类型才能创建数据透视表 桌子。下表描述了可用的类型:

Data dimension types
Data dimension type Definition 例子
指标 An indicator is a calculated formula based on data elements. Coverage of immunization across a specific district.
资料元素 Represents the phenomenon for which data has been captured. Number of malaria cases; number of BCG doses given.
数据集 A collection of data elements grouped for data collection. You can select :
* Reporting rates : the percentage of actual reports compared to the expected number of reports
* Reporting rates on time : the reporting rates based on timely form submissions. A timely submission must happen within a number of days after the reporting period.
* Actual reports : the actual number of reports
* Actual reports on time : the actual number of reports based on timely form submissions. A timely submission must happen within a number of days after the reporting period.
* Expected reports : the number of expected reports based on organisation units where the data set and the reporting frequency has been assigned.
Reporting rates for immunization and morbidity forms.
Event data items A data element that is part of a program representing events that have been captured. Average weight and height for children in a nutrition program.
计划指标 A calculated formula based on data elements in a program representing events. Average BMI score for children in a nutrition program.

您可以组合这些维度来显示例如聚合数据 与报告率,或事件数据项与程序 指标,都在同一个数据透视表中。对于“数据元素”数据 维度,您还可以选择“总计”和“详细信息”, 将允许您一起查看不同的类别组合选项 在同一个数据透视表上。

对于期间维度,您可以选择使用固定期间或 相对时期。固定时间段的一个示例是“2012 年 1 月”。至 选择固定期间首先从期间中选择期间类型 类型列表。然后,您可以从可用的列表中选择期间 期间。

相对期间是相对于当前日期的期间。示例 相对期间为“上个月”、“过去 12 个月”、“过去 5 年”。 可以通过勾选每个旁边的复选框来选择相对期间 时期。使用相对期间的主要优点是,当您 保存一个喜欢的数据透视表,它会保持最新数据的更新 随着时间的推移,无需不断更新它。

对于组织单位维度,您可以选择任意数量的 层次结构中的组织单位。选择所有组织单位 在特定上级组织单位下方,右键单击并单击“选择 所有子级”。要手动选择多个组织单位,请单击 单击组织单位时按住 Ctrl 键。你可以打勾 “用户组织单位”、“用户子单位”或“用户子 x2 单位”以便 动态插入一个或多个与您的组织单位相关的单位 用户帐号。这在您保存数据透视表收藏夹时很有用,并且 想与其他用户共享,因为组织单位与 查看收藏夹时将使用其他用户的帐户。

动态维度可以由组织单位组集、数据 元素组集或类别选项组集 配置为“分解”类型。一旦组集有 已配置,它们将在数据透视表中可用,并且 可以用作额外的分析维度,例如分析 按组织单位或实施伙伴的类型汇总数据。 动态尺寸与固定尺寸的工作方式相同。

提示

一些动态维度可能包含许多项目。这可能会导致问题 与某些浏览器由于 URL 的长度时多维 成员被选中。一个特殊的“全部”复选框可用于 动态维度,它允许您包括所有可用的 数据透视表中隐含的维度,而不指定每个和 每个维度成员。

修改数据透视表布局

选择数据维度后,是时候安排您的数据透视表了。 单击顶部菜单中的“布局”以打开布局屏幕。在这个画面 您可以将数据维度定位为表格列、行或过滤器 通过单击尺寸列表中的尺寸并将其拖到 相应的列、行和过滤器列表。您可以设置任意数量 任何列表中的维度。例如,您可以单击 “组织单位”并将其拖到行列表中以定位 组织单位维度作为表行。注意指标, 数据元素和数据集报告率是共同“数据”的一部分 维度并将一起显示在数据透视表中。为了 例如,在左侧菜单中选择指标和数据元素后, 您可以将“组织单位”从可用维度列表中拖到 行维度列表,以便将它们排列为枢轴中的行 桌子。

设置数据透视表后,您可以单击“更新”进行渲染 您的数据透视表,或单击“隐藏”以隐藏布局屏幕而没有任何 更改生效。由于我们在我们的示例中同时选择了 期间和组织单位维度作为行,数据透视表将 生成这些维度中项目的所有组合并生成一个 像这样的表:

更改数据透视表的显示

  1. 打开**数据透视表**应用。

  2. 创建一个新的数据透视表或打开收藏夹。

  3. 点击**选项**。

  4. 根据需要设置选项。

    Pivot table options
    Option Description
    Data Show column totals

    Show row totals
    Displays total values in the table for each row and column, as well as a total for all values in the table.
    Show column sub-totals

    Show row sub-totals
    Displays subtotals in the table for each dimension.

    If you only select one dimension, subtotals will be hidden for those columns or rows. This is because the values will be equal to the subtotals.
    Show dimension labels Shows the dimension names as part of the pivot tables.
    Hide empty rows Hides empty rows from the table. This is useful when you look at large tables where a big part of the dimension items don't have data in order to keep the table more readable.
    Hide empty columns Hides empty columns from the table. This is useful when you look at large tables where a big part of the dimension items don't have data in order to keep the table more readable.
    Skip rounding Skips the rounding of data values, offering the full precision of data values. Can be useful for finance data where the full dollar amount is required.
    Aggregation type The default aggregation operator can be over-ridden here, by selecting a different aggregation operator. Some of the aggregation types are Count , Min and Max .
    Number type Sets the type of value you want to display in the pivot table: Value , Percentage of row or Percentage of column .

    The options Percentage of row and**Percentage of column** mean that you'll display values as percentages of row total or percentage of column total instead of the aggregated value. This is useful when you want to see the contribution of data elements, categories or organisation units to the total value.
    Measure criteria Allows for the data to be filtered on the server side.

    You can instruct the system to return only records where the aggregated data value is equal, greater than, greater or equal, less than or less or equal to certain values.

    If both parts of the filter are used, it's possible to filter out a range of data records.
    Events Include only completed events Includes only completed events in the aggregation process. This is useful for example to exclude partial events in indicator calculations.
    Organisation units Show hierarchy Shows the name of all ancestors for organisation units, for example "Sierra Leone / Bombali / Tamabaka / Sanya CHP" for Sanya CHP.

    The organisation units are then sorted alphabetically which will order the organisation units according to the hierarchy.

    When you download a pivot table with organisation units as rows and you've selected Show hierarchy , each organisation unit level is rendered as a separate column. This is useful for example when you create Excel pivot tables on a local computer.
    Legend Apply legend Applies a legend to the values. This mean that you can apply a colour to the values.

    Select By data item to color the table cells individually according to each data element or indicator.

    You configure legends in the Maintenance app.
    Style Colors the text or background of cells in pivot tables based on the selected legend.

    You can use this option for scorecards to identify high and low values at a glance.
    Style Display density Controls the size of the cells in the table. You can set it to Comfortable , Normal or Compact .

    Compact is useful when you want to fit large tables into the browser screen.
    Font size Controls the size of the table text font. You can set it to Large , Normal or Small .
    Digit group separator Controls which character to separate groups of digits or "thousands". You can set it to Comma , Space or None .
    General Table title Type a title here to display it above the table.
    Parameters (for standard reports only) Note
    You create standard reports in the Reports app.
    In the Pivot Table app you set which parameters the system should prompt the user for.
    Reporting period Controls whether to ask user to enter a report period.
    Organisation unit Controls whether to ask user to enter an organisation unit.
    Parent organisation unit Controls whether to ask user to enter a parent organisation unit.
    Include regression Includes a column with regression values to the pivot table.
    Include cumulative Includes a column with cumulative values to the pivot table.
    Sort order Controls the sort order of the values.
    Top limit Controls the maximum number of rows to include in the pivot table.
  5. 点击**更新**。

管理收藏夹

将您的图表或数据透视表保存为收藏夹,便于查找 他们后来。您还可以选择与其他用户共享它们作为 解释或显示在仪表板上。

您可以在**数据透视表**, 数据可视化器 事件可视化器 ,**事件报告**应用程序中查看收藏夹的详细信息和解释。使用**收藏夹**菜单管理您的收藏夹。

打开收藏夹

  1. 点击**收藏夹** > 打开

  2. 在搜索字段中输入收藏的名称,或单击 Prev 和**下一步**显示收藏夹。

  3. 单击您要打开的收藏夹的名称。

保存收藏夹

  1. 点击**收藏夹** > 另存为

  2. 输入您喜欢的**名称**和**描述**。 description字段支持RTF格式,有关更多详细信息,请参见解释部分。

  3. 点击**保存**。

重命名收藏夹

  1. 点击**收藏** > 重命名

  2. 输入您喜欢的新名称。

  3. 点击**更新**。

为最喜欢的人写一个诠释

解释是指向具有数据描述的资源的链接 在给定的时期。该信息在**仪表板**应用中可见。 要创建解释,您首先需要创建收藏夹。如果 您已经与其他人分享了自己的最爱, 写给那些人看。

  1. 点击**收藏夹** > 写入解释

  2. 在文本字段中,输入评论、问题或解释。你 也可以使用“@username”提及其他用户。首先输入“@” 加上用户名或真实姓名的第一个字母和提及 bar 将显示可用的用户。提及的用户将收到 带有解释或注释的内部 DHIS2 消息。你 可以在**仪表板**应用中查看解释。

    您可以使用**粗体**, 斜体*格式化文本 Markdown 样式标记 * 和 _ 分别用于 bold 和 *italic 。 也可以使用键盘快捷键:Ctrl/Cmd + B 和 Ctrl/Cmd + I。A 支持有限的一组表情符号,可以通过键入其中一个来使用 以下字符组合: :) :-) :( :-( :+1 :-1. URLs 自动检测并转换为可点击的链接。

  3. 搜索您想与之分享收藏夹的用户组, 然后单击 + 图标。

  4. 更改要修改的用户组的共享设置。

    • 可以编辑和查看 :每个人都可以查看和编辑对象。

    • 只能查看 :每个人都可以查看对象。

    • :公众将无法访问该对象。这 设置仅适用于**公共访问**。

  5. 点击**共享**。

订阅收藏

当您订阅收藏时,您会收到内部消息 每当另一个用户喜欢/创建/更新解释或 创建/更新此收藏夹的解释注释。

  1. 打开收藏夹。

  2. 单击工作区右上方的** > > > **。

  3. 单击右上角的响铃图标以订阅此收藏。

  1. 点击**收藏夹** > 获取链接

  2. 选择以下之一:

    • 在此应用程序中打开 :您将获得您最喜欢的 URL 可以通过电子邮件或聊天与其他用户共享。

    • 在 web api 中打开 :您将获得 API 资源的 URL。经过 默认这是一个 HTML 资源,但您可以更改文件 扩展到“.json”或“.csv”。

删除收藏夹

  1. 点击**收藏** > 删除

  2. 点击**确定**。

查看基于相对期间的解释

要查看相对时期的解释,例如一年前:

  1. 用解释打开收藏夹。

  2. 单击工作区右上方的** > > > **。

  3. 单击一个解释。您的图表显示数据和日期 基于解释的创建时间。查看其他 解释,点击它们。

从数据透视表下载数据

下载表格布局数据格式

要下载当前数据透视表中的数据:

  1. 点击**下载**。

  2. 在**表格布局**下,单击要下载的格式: Microsoft Excel、CSV 或 HTML。

    数据表每个维度有一列并包含名称 维度项。

    Tip

    When you download a pivot table with organisation units as rows and you've selected Show hierarchy in Table options , each organisation unit level is rendered as a separate column. This is useful for example when you create Excel pivot tables on a local computer.

提示

您可以从下载的 Microsoft Excel 中创建数据透视表 Excel 文件。

下载纯数据源格式

您可以下载 JSON、XML、Excel 格式的当前数据透视表中的数据, 和 CSV 作为具有不同标识方案(ID、 代码和名称)。数据文档使用维度的标识符 项目并在新的浏览器窗口中打开以显示项目的 URL 地址栏中的 Web API 请求。这对开发人员很有用 基于 DHIS2 Web API 的应用程序和其他客户端模块 谁需要计划数据源,例如导入统计数据 包。

要下载纯数据源格式:

  1. 点击**下载**。

  2. 在**普通数据源**下,单击要下载的格式。

    Available formats
    Format Action Description
    JSON Click JSON Downloads JSON format based on ID property.

    You can also download JSON format based on Code or Name property.
    XML Click XML Downloads XML format based on ID property.

    You can also download XML format based on Code or Name property.
    Microsoft Excel Click Microsoft Excel Downloads XML format based on ID property.

    You can also download Microsoft Excel format based on Code or Name property.
    CSV Click CSV Downloads CSV format based on ID property.

    You can also download CSV format based on Code or Name property.
    JRXML Put the cursor on Advanced and click JRXML Produces a template of a Jasper Report which can be further customized based on your exact needs and used as the basis for a standard report in DHIS2.
    Raw data SQL Put the cursor on Advanced and click Raw data SQL Provides the actual SQL statement used to generate the pivot table. You can use it as a data source in a Jasper report, or as the basis for an SQL view.

下载CSV格式,而不在网络浏览器中呈现数据

可以直接下载CSV格式的数据,无需渲染数据 在网络浏览器中。这有助于减少系统中的任何约束 已设置的关于最大数量的设置 分析记录。这使您可以下载更大批量的数据 可用于以后的离线分析。

以 CSV 格式下载数据,而无需先在 Web 中呈现数据 浏览器:

  1. 单击**更新**旁边的箭头。

  2. 单击** CSV **以根据ID属性下载格式。

    该文件下载到您的计算机。

    Tip

    You can also download CSV format based on Code or Name property.

在外部网页中嵌入数据透视表

DHIS2 中某些与分析相关的资源,如数据透视表、图表 和地图,可以通过插件嵌入到任何网页中。你会 在 Web API 章节中找到有关插件的更多信息 DHIS2 开发人员手册

生成可用于显示数据透视表的 HTML 片段 在外部网页中:

  1. 点击**嵌入**。

  2. 单击**选择**以突出显示HTML片段。

将数据透视表数据可视化为图表或地图

制作数据透视表后,您可以在数据透视表之间切换, 数据的图表和地图可视化。

打开数据透视表作为图表

  1. 单击**图表** > 以图表形式打开此表

    当前的数据透视表将以图表的形式打开。

打开数据透视表选择作为图表

如果您想将数据透视表的一小部分可视化为图表,您可以 可以直接点击表格中的一个值而不是打开整个 桌子。

  1. 在数据透视表中,单击一个值。

  2. 要验证选择,请将光标悬停在 Open selection as 图表 。表中突出显示的维度标题表示 哪些数据将被可视化为图表。

  3. 点击**打开选择为图表**。

打开数据透视表作为地图

  1. 点击**图表** > 以地图形式打开该表格

    当前的数据透视表将作为地图打开。

打开数据透视表选择作为地图

  1. 在数据透视表中,单击一个值。

    显示菜单。

  2. 点击**将选择作为地图打开**。

    您的选择将作为地图打开。

使用事件报告应用

关于事件报告应用

With the Event Reports app you can analyse events in two types of reports:

  • 聚合事件报告:使用聚合的数据透视表式分析 事件数

    通过从左上角的菜单中选择 Aggregated values ,您可以 使用 Event Reports 应用程序创建聚合数据透视表 事件的数量。事件报告始终基于程序。你 可以根据一系列维度进行分析。每个维度都可以 有相应的过滤器。尺寸可以从 左侧菜单。类似于数据透视表应用程序,聚合事件 报告可能会受到可访问的 RAM 量的限制 浏览器。如果您要求的桌子超过设定的大小,您将 收到警告提示,询问您是否要继续。

  • 个别事件报告:事件列表

    通过从左上角菜单中选择 Events ,您可以使用 事件报告 应用程序,用于基于事件进行搜索或查询 一套灵活的标准。报告将显示为 每个事件一行的表格。每个维度都可以作为一列 在表中或作为过滤器。每个维度都可以有一个条件 (筛选)。类型选项集的数据元素允许“输入”条件, 可以选择多个选项。数值可以是 与使用大于、等于或小于的过滤器值相比 运营商。

创建事件报告

  1. Open the Event Reports app.

  2. Select Aggregated values or Events .

  3. 在左侧菜单中,选择要分析的元数据。

  4. Click Layout and arrange the dimensions.

    您可以根据需要保留默认选择。

  5. 点击**更新**。

选择尺寸项目

事件报告始终基于程序,您可以进行分析 基于一系列维度。对于具有类别组合的程序, 您可以使用程序类别和类别选项组集作为 表格和图表的维度。每个维度项可以有一个 相应的过滤器。

  1. 选择数据元素:

    1. 点击**数据**。

    2. 选择一个程序和一个程序阶段。

      与所选节目相关的数据元素是 列在**可用**下。每个数据元素作为一个 尺寸。

    3. 通过双击它们来选择您需要的数据元素 名称。

      可以按类型过滤数据元素(数据元素、程序 属性、程序指标)并加上前缀使它们 容易识别。

      选择数据元素后,它在 Selected 下可见 数据项

    4. (可选)为每个数据元素指定一个过滤器 运算符,例如“大于”、“在”或“等于”以及 一个过滤值。

  2. 选择期间。

    1. 点击**期间**。

    2. 选择一个或多个期间。

      您有三个期间选项:相对期间、固定期间 和开始/结束日期。您可以结合固定时期和相对 同一图表中的时期。您不能将固定期间和 在同一图表中具有开始/结束日期的相对时间段。 重叠的时间段会被过滤,以便它们只出现一次。

      • 固定期间:在**选择期间类型**框中,选择一个 期间类型。您可以从中选择任意数量的固定期间 任何时期类型。例如,固定期间可以是“一月 2014 年”。

      • 相对期间:在**期间**的下部 部分,根据需要选择任意数量的相对时间段。这 名称相对于当前日期。这意味着如果 当前月份是三月,您选择**上个月**, 图表中包含二月。相对的 期间的优点是它将数据保存在 随着时间的推移报告最新。

      • 开始/结束日期:在 Periods 选项卡下的列表中, 选择**开始/结束日期**。此期间类型可让您 为报告中的时间跨度指定灵活的日期。

  3. 选择组织单位。

    1. Click Organisation units .

    2. 点击齿轮箱图标。

    3. Select a Selection mode and an organisation unit.

      共有三种不同的选择模式:

      Selection modes
      Selection mode Description
      Select organisation units Lets you select the organisation units you want to appear in the chart from the organization tree.

      Select User org unit to disable the organisation unit tree and only select the organisation unit that is related to your profile.

      Select User sub-units to disable the organisation unit tree and only select the sub-units of the organisation unit that is related to your profile.

      Select User sub-x2-units to disable the organisation unit tree and only select organisation units two levels down from the organisation unit that is related to your profile.

      This functionality is useful for administrators to create a meaningful "system" favorite. With this option checked all users find their respective organisation unit when they open the favorite.
      Select levels Lets you select all organisation units at one or more levels, for example national or district level.

      You can also select the parent organisation unit in the tree, which makes it easy to select for example, all facilities inside one or more districts.
      Select groups Lets you select all organisation units inside one or several groups and parent organisation units at the same time, for example hospitals or chiefdoms.
  4. 点击**更新**。

选择系列,类别和过滤器

您可以定义要显示为列、行的数据维度 和数据透视表中的过滤器。每个数据元素都显示为单独的 尺寸,可以放置在任何轴上。

注意

连续值类型的数据元素(实数/十进制数) 只能用作过滤器,会自动定位为 布局对话框中的过滤器。这样做的原因是连续 数字不能分组到合理的范围内并用于列和 行。

  1. Click Layout .

  2. 将尺寸拖放到适当的空间。

  3. 点击**更新**。

更改表格的显示

您可以自定义事件报告的显示。

  1. 点击**选项**。

  2. 根据需要设置选项。可用选项不同 聚合事件报告和个别事件报告。

    Event reports options
    Option Description Available for report type
    Data Show column totals Displays totals at the end of each column in the pivot table. Aggregated event report
    Show column sub-totals Displays sub-totals for each column in the pivot table. Aggregated event report
    Show row totals Displays totals at the end of each row in the pivot table. Aggregated event report
    Show row sub-totals Displays sub-totals for each row in the pivot table. Aggregated event report
    Show dimension labels Displays labels for dimensions. Aggregated event report
    Hide empty rows Hides empty rows in the pivot table. Aggregated event report
    Hide n/a data Hides data tagged as N/A from the chart. Aggregated event report
    Include only completed events Includes only completed events in the aggregation process. This is useful when you want for example to exclude partial events in indicator calculations. Aggregated event report

    Individual event report
    Limit Sets a limit of the maximum number of rows that you can display in the table, combined with a setting for showing top or bottom values. Aggregated event report
    Output type Defines the output type. The output types are Event , Enrollment and Tracked entity instance . Aggregated event report
    Program status Filters data based on the program status: All , Active , Completed or Cancelled . Aggregated event report
    Event status Filters data based on the event status: All , Active , Completed , Scheduled , Overdue or Skipped . Aggregated event report
    Organisation units Show hierarchy Includes the names of all parents of each organisation unit in labels. Aggregated event report
    Style Display density Controls the size of the cells in the table. You can set it to Comfortable , Normal or Compact .

    Compact is useful when you want to fit large tables into the browser screen.
    Aggregated event report

    Individual event report
    Font size Controls the size of the table text font. You can set it to Large , Normal or Small . Aggregated event report

    Individual event report
    Digit group separator Controls which character to separate groups of digits or "thousands". You can set it to Comma , Space or None . Aggregated event report

    Individual event report
  3. 点击**更新**。

下载图表数据源

您可以下载 HTML、JSON、 XML、Microsoft Excel 或 CSV 格式。

  1. 点击**下载**。

  2. 在**普通数据源**下,单击要下载的格式。

    Available formats
    Format Description
    HTML Creates HTML table based on selected meta data
    JSON Downloads data values in JSON format based on selected meta data
    XML Downloads data values in XML format based on selected meta data
    Microsoft Excel Downloads data values in Microsoft Excel format based on selected meta data
    CSV Downloads data values in CSV format based on selected meta data

管理收藏夹

将您的图表或数据透视表保存为收藏夹,便于查找 他们后来。您还可以选择与其他用户共享它们作为 解释或显示在仪表板上。

您可以在**数据透视表**, 数据可视化器 事件可视化器 ,**事件报告**应用程序中查看收藏夹的详细信息和解释。使用**收藏夹**菜单管理您的收藏夹。

打开收藏夹

  1. 点击**收藏夹** > 打开

  2. 在搜索字段中输入收藏的名称,或单击 Prev 和**下一步**显示收藏夹。

  3. 单击您要打开的收藏夹的名称。

保存收藏夹

  1. 点击**收藏夹** > 另存为

  2. 输入您喜欢的**名称**和**描述**。 description字段支持RTF格式,有关更多详细信息,请参见解释部分。

  3. 点击**保存**。

重命名收藏夹

  1. 点击**收藏** > 重命名

  2. 输入您喜欢的新名称。

  3. 点击**更新**。

为最喜欢的人写一个诠释

解释是指向具有数据描述的资源的链接 在给定的时期。该信息在**仪表板**应用中可见。 要创建解释,您首先需要创建收藏夹。如果 您已经与其他人分享了自己的最爱, 写给那些人看。

  1. 点击**收藏夹** > 写入解释

  2. 在文本字段中,输入评论、问题或解释。你 也可以使用“@username”提及其他用户。首先输入“@” 加上用户名或真实姓名的第一个字母和提及 bar 将显示可用的用户。提及的用户将收到 带有解释或注释的内部 DHIS2 消息。你 可以在**仪表板**应用中查看解释。

    您可以使用**粗体**, 斜体*格式化文本 Markdown 样式标记 * 和 _ 分别用于 bold 和 *italic 。 也可以使用键盘快捷键:Ctrl/Cmd + B 和 Ctrl/Cmd + I。A 支持有限的一组表情符号,可以通过键入其中一个来使用 以下字符组合: :) :-) :( :-( :+1 :-1. URLs 自动检测并转换为可点击的链接。

  3. 搜索您想与之分享收藏夹的用户组, 然后单击 + 图标。

  4. 更改要修改的用户组的共享设置。

    • 可以编辑和查看 :每个人都可以查看和编辑对象。

    • 只能查看 :每个人都可以查看对象。

    • :公众将无法访问该对象。这 设置仅适用于**公共访问**。

  5. 点击**共享**。

订阅收藏

当您订阅收藏时,您会收到内部消息 每当另一个用户喜欢/创建/更新解释或 创建/更新此收藏夹的解释注释。

  1. 打开收藏夹。

  2. 单击工作区右上方的** > > > **。

  3. 单击右上角的响铃图标以订阅此收藏。

  1. 点击**收藏夹** > 获取链接

  2. 选择以下之一:

    • 在此应用程序中打开 :您将获得您最喜欢的 URL 可以通过电子邮件或聊天与其他用户共享。

    • 在 web api 中打开 :您将获得 API 资源的 URL。经过 默认这是一个 HTML 资源,但您可以更改文件 扩展到“.json”或“.csv”。

删除收藏夹

  1. 点击**收藏** > 删除

  2. 点击**确定**。

查看基于相对期间的解释

要查看相对时期的解释,例如一年前:

  1. 用解释打开收藏夹。

  2. 单击工作区右上方的** > > > **。

  3. 单击一个解释。您的图表显示数据和日期 基于解释的创建时间。查看其他 解释,点击它们。

将事件报告可视化为图表

制作事件报告后,可以将其作为图表打开:

单击**图表** > 以表形式打开此图表

使用事件可视化器应用

关于事件可视化器应用

使用 Event Visualizer 应用程序,您可以根据事件创建图表 数据。

创建图表

  1. Open the Event Visualizer app and select a chart type.

  2. 在左侧菜单中,选择要分析的元数据。

  3. Click Layout and arrange the dimensions.

    您可以根据需要保留默认选择。

  4. 点击**更新**。

选择图表类型

Event Visualizer 应用程序有八种不同的图表类型,每一种都有 不同的特性。要选择图表类型:

  1. In Chart type , click the chart type you need.

    Chart types
    Chart type Description
    Column chart Displays information as vertical rectangular columns with lengths proportional to the values they represent.

    Useful when you want to, for example, compare performance of different districts.
    Stacked column chart Displays information as vertical rectangular columns, where bars representing multiple categories are stacked on top of each other.

    Useful when you want to, for example, display trends or sums of related data elements.
    Bar chart Same as column chart, only with horizontal bars.
    Stacked bar chart Same as stacked column chart, only with horizontal bars.
    Line chart Displays information as a series of points connected by straight lines. Also referred to as time series.

    Useful when you want to, for example, visualize trends in indicator data over multiple time periods.
    Area chart Is based on line chart, with the space between the axis and the line filled with colors and the lines stacked on top of each other.

    Useful when you want to compare the trends of related indicators.
    Pie chart Circular chart divided into sectors (or slices).

    Useful when you want to, for example, visualize the proportion of data for individual data elements compared to the total sum of all data elements in the chart.
    Radar chart Displays data on axes starting from the same point. Also known as spider chart.
  2. 点击**更新**。

选择尺寸项目

事件图表始终基于程序,您可以进行分析 基于一系列维度。对于具有类别组合的程序, 您可以使用程序类别和类别选项组集作为 表格和图表的维度。每个维度项可以有一个 相应的过滤器。您从左侧选择维度项目 菜单。

  1. 选择数据元素:

    1. 点击**数据**。

    2. 选择一个程序和一个程序阶段。

      与所选节目相关的数据元素是 列在**可用**下。每个数据元素作为一个 尺寸。

    3. 通过双击它们来选择您需要的数据元素 名称。

      可以按类型过滤数据元素(数据元素、程序 属性、程序指标)并加上前缀使它们 容易识别。

      选择数据元素后,它在 Selected 下可见 数据项

    4. (可选)为每个数据元素指定一个过滤器 运算符,例如“大于”、“在”或“等于”以及 一个过滤值。

  2. 选择期间。

    1. 点击**期间**。

    2. 选择一个或多个期间。

      您有三个期间选项:相对期间、固定期间 和开始/结束日期。您可以结合固定时期和相对 同一图表中的时期。您不能将固定期间和 在同一图表中具有开始/结束日期的相对时间段。 重叠的时间段会被过滤,以便它们只出现一次。

      • 固定期间:在**选择期间类型**框中,选择一个 期间类型。您可以从中选择任意数量的固定期间 任何时期类型。例如,固定期间可以是“一月 2014 年”。

      • 相对期间:在**期间**的下部 部分,根据需要选择任意数量的相对时间段。这 名称相对于当前日期。这意味着如果 当前月份是三月,您选择**上个月**, 图表中包含二月。相对的 期间的优点是它将数据保存在 随着时间的推移报告最新。

      • 开始/结束日期:在 Periods 选项卡下的列表中, 选择**开始/结束日期**。此期间类型可让您 为报告中的时间跨度指定灵活的日期。

  3. 选择组织单位。

    1. Click Organisation units .

    2. 点击齿轮箱图标。

    3. Select a Selection mode and an organisation unit.

      共有三种不同的选择模式:

      Selection modes
      Selection mode Description
      Select organisation units Lets you select the organisation units you want to appear in the chart from the organization tree.

      Select User org unit to disable the organisation unit tree and only select the organisation unit that is related to your profile.

      Select User sub-units to disable the organisation unit tree and only select the sub-units of the organisation unit that is related to your profile.

      Select User sub-x2-units to disable the organisation unit tree and only select organisation units two levels down from the organisation unit that is related to your profile.

      This functionality is useful for administrators to create a meaningful "system" favorite. With this option checked all users find their respective organisation unit when they open the favorite.
      Select levels Lets you select all organisation units at one or more levels, for example national or district level.

      You can also select the parent organisation unit in the tree, which makes it easy to select for example, all facilities inside one or more districts.
      Select groups Lets you select all organisation units inside one or several groups and parent organisation units at the same time, for example hospitals or chiefdoms.
  4. 点击**更新**。

选择系列,类别和过滤器

您可以定义要显示为系列的数据维度, 类别和过滤器。每个数据元素都显示为单独的维度 并且可以放置在任何轴上。系列和类别面板可以 当时只有一维。

注意

连续值类型的数据元素(实数/十进制数) 只能用作过滤器,会自动定位为 布局对话框中的过滤器。这样做的原因是连续 数字不能分组到合理的范围内并用于列和 行。

  1. Click Layout .

  2. 将尺寸拖放到适当的空间。只有一个 维度可以在每个部分。

  3. 点击**更新**。

更改图表的显示

您可以自定义事件报告的显示。

  1. 点击**选项**。

  2. 根据需要设置选项。

    Chart options
    Option Description
    Data Show values Displays values as numbers on top of each series.
    Use 100% stacked values Displays 100 % stacked values in column charts.
    Use cumulative values Displays cumulative values in line charts.
    Hide n/a data Hides data tagged as N/A from the chart.
    Include only completed events Includes only completed events in the aggregation process. This is useful when you want for example to exclude partial events in indicator calculations.
    Hide empty categories Hides the category items with no data from the chart.

    None : doesn't hide any of the empty categories

    Before first : hides missing values only before the first value

    After last : hides missing values only after the last value

    Before first and after last : hides missing values only before the first value and after the last value

    All : hides all missing values

    This is useful for example when you create column and bar charts.
    Trend line Displays the trend line which visualizes how your data evolves over time. For example if performance is improving or deteriorating. Useful when periods are selected as category.
    Target line value/title Displays a horizontal line and title (optional) at the given domain value. Useful for example when you want to compare your performance to the current target.
    Base line value/title Displays a horizontal line and title (optional) at the given domain value. Useful for example when you want to visualize how your performance has evolved since the beginning of a process.
    Sort order Allows you to sort the values on your chart from either low to high or high to low.
    Output type Defines the output type. The output types are Event , Enrollment and**Tracked entity instance**.
    Program status Filters data based on the program status: All , Active , Completed or Cancelled .
    Event status Filters data based on the event status: All , Active , Completed , Scheduled , Overdue or Skipped .
    Axes Range axis min/max Defines the maximum and minimum value which will be visible on the range axis.
    Range axis tick steps Defines the number of ticks which will be visible on the range axis.
    Range axis decimals Defines the number of decimals which will be used for range axis values.
    Range axis title Type a title here to display a label next to the range axis (also referred to as the Y axis). Useful when you want to give context information to the chart, for example about the unit of measure.
    Domain axis title Type a title here to display a label below the domain axis (also referred to as the X axis). Useful when you want to give context information to the chart, for example about the period type.
    General Hide chart legend Hides the legend and leaves more room for the chart itself.
    Hide chart title Hides the title (default or custom) of your chart.
    Chart title Type a title here to display a custom title above the chart. If you don't enter a title, the default title is displayed.
    Hide chart subtitle Hides the subtitle of your chart.
    Chart subtitle Type a subtitle here to display a custom subtitle above the chart but below the title. If you don't enter a subtitle, no subtitle is displayed in the chart.
  3. 点击**更新**。

将图表下载为图像或PDF

创建图表后,您可以将其下载到本地 计算机作为图像或 PDF 文件。

  1. 点击**下载**。

  2. 在**图形**下,单击** PNG(.png) PDF(.pdf)**。

    该文件会自动下载到您的计算机。现在你可以 例如,将图像文件作为文本文件的一部分嵌入 报告。

下载图表数据源

您可以下载 HTML、JSON、XML 格式的图表背后的数据源, Microsoft Excel 或 CSV 格式。数据文档使用以下标识符 维度项并在新的浏览器窗口中打开以显示 URL 地址栏中对 Web API 的请求。这对 基于 DHIS2 Web API 的应用程序和其他客户端模块的开发人员 或者对于那些需要计划数据源的人,例如用于导入 进入统计包。

要下载纯数据源格式:

  1. 点击**下载**。

  2. 在**普通数据源**下,单击要下载的格式。

    Available formats
    Format Description
    HTML Creates HTML table based on selected meta data
    JSON Downloads data values in JSON format based on selected meta data
    XML Downloads data values in XML format based on selected meta data
    Microsoft Excel Downloads data values in Microsoft Excel format based on selected meta data
    CSV Downloads data values in CSV format based on selected meta data

管理收藏夹

将您的图表或数据透视表保存为收藏夹,便于查找 他们后来。您还可以选择与其他用户共享它们作为 解释或显示在仪表板上。

您可以在**数据透视表**, 数据可视化器 事件可视化器 ,**事件报告**应用程序中查看收藏夹的详细信息和解释。使用**收藏夹**菜单管理您的收藏夹。

打开收藏夹

  1. 点击**收藏夹** > 打开

  2. 在搜索字段中输入收藏的名称,或单击 Prev 和**下一步**显示收藏夹。

  3. 单击您要打开的收藏夹的名称。

保存收藏夹

  1. 点击**收藏夹** > 另存为

  2. 输入您喜欢的**名称**和**描述**。 description字段支持RTF格式,有关更多详细信息,请参见解释部分。

  3. 点击**保存**。

重命名收藏夹

  1. 点击**收藏** > 重命名

  2. 输入您喜欢的新名称。

  3. 点击**更新**。

为最喜欢的人写一个诠释

解释是指向具有数据描述的资源的链接 在给定的时期。该信息在**仪表板**应用中可见。 要创建解释,您首先需要创建收藏夹。如果 您已经与其他人分享了自己的最爱, 写给那些人看。

  1. 点击**收藏夹** > 写入解释

  2. 在文本字段中,输入评论、问题或解释。你 也可以使用“@username”提及其他用户。首先输入“@” 加上用户名或真实姓名的第一个字母和提及 bar 将显示可用的用户。提及的用户将收到 带有解释或注释的内部 DHIS2 消息。你 可以在**仪表板**应用中查看解释。

    您可以使用**粗体**, 斜体*格式化文本 Markdown 样式标记 * 和 _ 分别用于 bold 和 *italic 。 也可以使用键盘快捷键:Ctrl/Cmd + B 和 Ctrl/Cmd + I。A 支持有限的一组表情符号,可以通过键入其中一个来使用 以下字符组合: :) :-) :( :-( :+1 :-1. URLs 自动检测并转换为可点击的链接。

  3. 搜索您想与之分享收藏夹的用户组, 然后单击 + 图标。

  4. 更改要修改的用户组的共享设置。

    • 可以编辑和查看 :每个人都可以查看和编辑对象。

    • 只能查看 :每个人都可以查看对象。

    • :公众将无法访问该对象。这 设置仅适用于**公共访问**。

  5. 点击**共享**。

订阅收藏

当您订阅收藏时,您会收到内部消息 每当另一个用户喜欢/创建/更新解释或 创建/更新此收藏夹的解释注释。

  1. 打开收藏夹。

  2. 单击工作区右上方的** > > > **。

  3. 单击右上角的响铃图标以订阅此收藏。

  1. 点击**收藏夹** > 获取链接

  2. 选择以下之一:

    • 在此应用程序中打开 :您将获得您最喜欢的 URL 可以通过电子邮件或聊天与其他用户共享。

    • 在 web api 中打开 :您将获得 API 资源的 URL。经过 默认这是一个 HTML 资源,但您可以更改文件 扩展到“.json”或“.csv”。

删除收藏夹

  1. 点击**收藏** > 删除

  2. 点击**确定**。

查看基于相对期间的解释

要查看相对时期的解释,例如一年前:

  1. 用解释打开收藏夹。

  2. 单击工作区右上方的** > > > **。

  3. 单击一个解释。您的图表显示数据和日期 基于解释的创建时间。查看其他 解释,点击它们。

将图表可视化为数据透视表

制作图表后,可以将其作为数据透视表打开:

单击**图表** > 以表形式打开此图表

报告应用程序中的报告功能

该报告应用程序可用于罐装,标准报告,数据集报告,资源和组织单位分布报告。

使用标准报告

您可以通过导航到 Apps->Reports 来访问可用的报告。在里面 在左侧栏中的报告菜单中,单击标准报告。所有的清单 预定义的报告将出现在主窗口中。

您可以通过单击报告的三点图标来运行/查看报告,然后 从上下文菜单中选择“创建”。如果有任何 预定义的参数,您将看到一个报告参数窗口,您可以在其中 必须填写组织单位和/或报告月份所需的值, 取决于在基础报告表中定义的内容。 准备好后,单击“生成报告”。报告要么出现 直接在您的浏览器中或作为 PDF 文件下载, 取决于您处理 PDF 文件的浏览器设置。你可以保存 文件并将其保存在本地计算机上以备后用。

使用数据集报告

Dataset reports are printer friendly views of the data entry screen filled with either raw or aggregated data.

您可以从Apps-> Reports访问数据集报告。

将出现一个标准窗口,您可以在其中填写您的详细信息 报告:

**数据集:**您要显示的数据集。

报告期间: 您想要数据的实际期间。这可以是 聚合期和原始期。这意味着您可以要求 季度或年度报告,即使收集了数据集 每月。数据集的周期类型(收集频率)定义在 数据集维护。首先选择期间类型(Monthly、Quarterly、 每年等)在 Prev 和 Next 按钮旁边的下拉菜单中,然后 从下面的下拉列表中选择一个可用的时间段。用 Prev 和 Next 可向后或向前跳跃一年。

仅使用所选单位的数据: 如果您想要一个 报告有孩子的组织单位,但只想要数据 直接为本单位收集的数据,而不是其收集的数据 孩子们。如果您想要一个组织单位的典型汇总报告,您可以 不想勾选这个选项。

报告组织单位: 在这里选择你想要的组织单位 的报告。这可以在层次结构中的任何级别作为数据 将自动聚合到此级别(如果您不勾选 上面的选项)。

填写完报告标准后,单击 “产生”。该报告将以 HTML 格式以打印机友好的格式显示。 使用浏览器中的打印和另存为功能进行打印或保存(如 HTML) 报告。您还可以在 Excel 中导出数据集报告和 PDF 格式。

使用报告率摘要

从应用程序->报告菜单访问报告率摘要。 报告率摘要将显示有多少数据集(表格) 由组织单位和时间提交。

报告率是根据完整的数据集注册计算得出的。 完整的数据集注册是指用户将数据输入表单标记为 完成,通常通过单击数据输入屏幕中的完成按钮, 特此向系统表明她认为该表格是 完全的。这是一种主观的计算方法 完整性。

报告率摘要将为每一行显示一系列度量:

  • 实际报告:表示数据录入完成的次数 相关数据集的注册。

  • 预期报告:指示完成了多少数据输入 预计会有注册。这个数字是基于 相关数据集已分配到的组织单位 (启用数据输入)。

  • 报告率:注册为完成的报告的百分比基于 预期的数量。

  • 按时报告:与实际报告相同,仅报告注册为 在结束后的最大天数内完成 报告期。报告期后的天数可以是 在数据集管理中按数据集定义。

  • 按时报告率:与百分比相同,仅报告注册为 按时完成用作分子。

要运行报告,您可以按照以下步骤操作:

  • 从树中选择一个组织单位。

  • 选择一个数据集。

  • 从可用期间列表中选择期间类型和期间 对于那个时期类型。

  • 然后将呈现报告。更改上述任何参数 并再次点击“获取报告”查看相应的结果。

使用资源

资源工具允许您从本地上传这两个文件 计算机到 DHIS 服务器并添加到其他资源的链接 通过 URL 上网。如果您的系统配置了云存储, 资源将保存在那里。

要创建新资源:

  1. 打开**报告**应用,然后单击**资源**。

  2. 点击**添加新**。

  3. 输入一个**名称**。

  4. 选择**类型**: 上传文件**或**外部URL

  5. 点击**保存**。

使用组织单位分布报告

您可以从左侧菜单访问 Orgunit Distribution 报告 在应用程序->报告中。

组织单位分布报告是显示组织单位如何 分布在各种属性上,如类型和所有权,以及 地理区域。

结果可以显示在基于表的报告或图表中。

运行报告:

要运行报告,首先在左上角的组织单位中选择一个组织单位 树。该报告将基于位于所选 单位。选择要使用的组织单位组集, 通常这些是类型、所有权、农村/城市,但可以是任何 用户定义的组织单位组集。您可以单击获取报告 获取基于表格的演示或获取图表以获得相同的结果 在图表中。您还可以将基于表格的报告下载为 Excel 或 CSV。

讯息传递

关于消息和反馈消息

在 DHIS2 中,您可以向用户发送消息和反馈消息,用户 团体和组织单位。当您发送反馈消息时,它是 路由到称为反馈接收者组的特定用户组。 如果您是该用户组的成员,您可以访问反馈 处理工具。例如,您可以设置传入的状态 在您等待信息时向“待定”反馈。

除了用户对用户和反馈消息外,取决于您的 配置系统还会向您发送系统生成的消息。 这些消息可以由不同的事件触发,包括系统 或后台作业失败和验证分析结果。反馈 处理工具也可用于验证结果和 优先级将设置为违反验证规则的重要性。

要访问该应用程序,请单击标题栏中的**消息图标** 或找到 **消息**应用在应用搜索框中。

注意

消息和反馈消息不会发送到用户的电子邮件 地址,消息仅出现在 DHIS2 中。

在 2.30 中,我们引入了一个新的消息应用程序,它提供了更丰富的 消息体验。具体来说:

  • 通过单击中的图标在列表视图和紧凑视图之间切换 右上角。
  • 列表视图很简单,提供了一个很好的 所有消息的概述,特别适用于反馈和 验证消息。
  • 紧凑的视图是一种现代的视图方式 用户在一个视图中有更多信息的消息,因此 查看和回复多条消息更容易。

本节的第一个屏幕截图显示列表视图,而 **阅读消息**部分中的屏幕截图显示紧凑 查看。

  • 添加了一个新的搜索字段,使用户能够搜索 消息。搜索过滤不同消息的消息 属性;主题、文本和发件人。这意味着你是 能够通过输入一个来缩小消息对话列表的范围 搜索。

  • 添加了自动刷新功能,以便应用程序获取新的 以设定的时间间隔发送消息,每 5 分钟一次。这个功能是 默认禁用。

  • 对于每个消息对话,您都可以将参与者添加到 对话。如果您想对此进行输入,这将非常有用 特定对话或者是否有人也应该看到 信息。无法从会议中删除参与者 对话。

建立讯息

  1. 点击**撰写**。

  2. 定义您希望接收消息的人。你可以发消息 到组织单位、用户和用户组。

    • To 字段中,您可以搜索组织单位、用户 和用户组并选择所需的收件人。
  3. 键入一个主题和一条消息。

  4. 点击**发送**。

阅读讯息

  1. 在左侧选择适当的消息类型。

  2. 单击一条消息。

    如果消息是对话的一部分,您将看到所有消息 这次谈话。

创建反馈消息

  1. 按照创建消息的步骤操作,只需选择 **反馈消息**而不是输入收件人。

  2. 该消息将被创建为反馈消息并显示在 所有指定用户的 Ticket 文件夹。

附件

在 2.31 中,我们为消息引入了附件。创建时或 回复您可以添加的消息对话 附件。目前没有对类型或大小的限制 文件。

管理验证和反馈消息

注意

您将只看到反馈消息并有权访问扩展 处理工具,如果您是设置为的用户组的成员 处理反馈消息。

使用新的应用程序,您可以管理用于票证和验证的扩展工具 消息通过查看消息时出现的图标菜单或 检查对话列表中的消息。

选择所有消息

已选择所有消息

选择所有邮件并选择扩展选择器

选择了所有消息并选择了扩展选择器

您将收到反馈信息到您的 Ticket 文件夹和 验证消息到您的 Validation 文件夹。对于反馈和 除了验证消息之外,您还有以下选项 消息选项:

反馈处理工具
功能 说明

优先级

您可以标记具有不同优先级的反馈/验证消息:

设置优先级可以更轻松地跟踪您首先需要解决的反馈消息以及可以等待的反馈消息。

状态

所有反馈/验证消息的状态均为创建后 打开

要跟踪现有的反馈消息,可以将状态更改为 待处理 无效 已解决

您可以使用内部标题栏中的两个下拉菜单,根据反馈/验证消息的状态过滤反馈/验证消息。

分配给

您可以将反馈消息分配给设置为处理反馈消息的用户组的任何成员。

您可以将验证消息分配给系统中的任何用户。

- 表示您尚未将用户分配给反馈消息。

内部回复

在反馈处理小组中工作时,您可能需要先讨论反馈,然后再将答案发送给发件人。您可以将此讨论与反馈本身保持在同一消息对话中。

要在反馈处理用户组中发送答复,请单击 内部答复

配置反馈信息功能

要配置反馈消息功能,您必须:

  1. 创建一个用户组(例如“反馈消息收件人”) 包含所有应该接收反馈消息的用户。

  2. 打开**系统设置**应用程序,然后单击**常规** > **反馈 收件人**并选择您在之前创建的用户组 步。

设置用户帐户首选项

In Edit user profile , you can add personal information to your profile such as your email address, mobile phone number, date of birth, profile picture and more. When you send messages, the person receiving the message can see these profile details. You can also provide account names for various direct messaging services, which will be used by the system.

In Edit user settings , you can change the display language of DHIS2 and the language of the database. The database language is the translated content of the metadata, such as data elements and indicators. You can also choose a display style, and enable or disable SMS and email notifications. If you wish to, you can choose to display a short name, such as "Joe" in the analysis modules, rather than your full name.

In Edit account settings , you can reset your password and setup 2-Factor authentication. Setting up 2-Factor authentication will require you to download the Google Authenticator app on you mobile device.

在**查看完整个人资料** 部分,您可以找到个人资料详情的摘要。 此部分包含一些您无法自行编辑的字段, 例如用户角色和用户组织单位。

In Manage personal access tokens you can view the existing personal access tokens, revoke existing tokens and generate new ones. Personal access tokens are an alternative to using passwords for authentication and useful for providing (restricted) access to scripts and external applications. Note that the values of newly generated personal access tokens are only visible right after generating.

在**关于DHIS2**部分中,您找到有关DHIS2实例的详细信息列表。

配置元数据

关于维护应用

In the Maintenance app you configure all the metadata objects you need to collect and analyze data:

  • 分类目录

  • 资料元素

  • 数据集和数据输入表格

  • 指标

  • 组织单位

  • 程序元数据:跟踪的实体,跟踪的实体属性和 关系类型

  • 验证规则

  • 属性

  • 常数

  • 选项集

  • 传说

  • 预测变量

  • 推送报告

  • 外部地图图层

注意

您有权访问的功能取决于用户角色的访问权限 权限。

元数据对象以列表的形式显示,其中包含与每个对象相关的预定义列。 您可以自定义当前对象列表中显示的列。这些自定义是针对每个用户的,因此不会影响其他用户。请注意,这些更改不会编辑任何元数据,只会编辑列表的显示方式。

管理可见列

  1. Click the icon to the top right of the list of objects you want to configure.
  2. A dropdown-menu will appear, select Manage columns .
  3. 将出现一个对话框,并选择默认列。
  4. Click any column-name in the list of Available columns to add them to the list of selected columns.
  5. You may reorder the selected columns by drag-and-dropping the icon.
  6. 您也可以通过单击名称旁边的X图标,从视图中删除任何列。
  7. Click Save once you are satisified with your changes.

You may easily reset to the default values by clicking the Reset to default button.

下载元数据

您可以下载当前正在查看的对象的元数据。元数据下载将遵守您对该列表有效的所有过滤器。

  1. Click the icon to the top right of the list of objects you want to configure.
  2. 将会出现一个下拉菜单,选择**下载**。
  3. 将出现一个对话框,您可以在其中选择所需的格式和压缩率。
  4. 可以选择**具有共享**以包括元数据的共享数据。

管理类别

关于类别

类别通常是一个概念,例如“性别”,“年龄”或“ “疾病状态”。数据元素,例如“已确认病例数 疟疾”通常分为较小的组成部分,以便确定 例如,已确认的特定年龄组的疟疾病例数。

使用类别将数据元素分解为单个组件。 您还可以使用类别为所有数据分配元数据属性 记录在特定的数据集中,例如“实施伙伴”或 “资金代理机构。”

创建三个类别:“ 1岁以下”,“ 1-5”和“ 5岁以上”。将它们分配为 数据元素的类别。这将为创建三个单独的字段 此数据以数据输入形式:

  • 确诊的疟疾病例数(1岁以下)

  • 确诊的疟疾病例数(1-5)

  • 确诊的疟疾病例数(5例以上)

没有类别,您将不得不创建每个数据 上面单独列出的元素。

In the Maintenance app, you manage the following and category objects:

Category objects in the Maintenance app
Object type Available functions
类别选项 Create, edit, clone, share, delete, show details and translate
类别 Create, edit, clone, share, delete, show details and translate
Category combination Create, edit, clone, share, delete, show details and translate
Category option combination Edit and show details
Category option group Create, edit, clone, share, delete, show details and translate
Category option group set Create, edit, clone, share, delete, show details and translate

工作流程

  1. 创建所有类别选项。

  2. 创建由您拥有的多个类别选项组成的类别 创建。

  3. 创建由一个或多个组成的类别组合 类别。

  4. 创建数据元素并将其分配给类别组合。

创建或编辑类别选项

如果可能,请回收类别选项。例如,可能有 可能共享特定类别选项的两个类别(对于 例如 <1岁)。创建类别时,此类别 选项可以重复使用。如果特定类别选项很重要 (或类别选项组合)需要一起分析。

  1. Open the Maintenance app and click Category > Category 选项

  2. 点击添加按钮。

  3. 填写表格:

    1. 名称

    2. Start date (optional)

    3. End date (optional)

    4. Short name (optional)

    5. Code (optional)

    6. Form name (optional)
      Category options can have a form name. These will be displayed in the data entry app as a column header instead of the display name for the respective category option.

  4. 选择组织单位并分配它们。

    Tip

    You can automatically select all organisation units that belong to an organisation unit level or organisation unit group, for example "Chiefdom" or "Urban. To do this:

    Select an Organisation unit level or Organisation unit group and click Select .

  5. 点击**保存**。

创建或编辑类别

为特定类别创建所有类别选项后, 您可以创建该类别。

  1. Open the Maintenance app and click Category > Category .

  2. 点击添加按钮。

  3. 填写表格:

    1. 名称

    2. 数据维度类型

      类别可以是“分类”或“属性”类型。 要分解数据元素,请选择 分类 。数据维度类型“属性”允许 用于将类别组合分配给的类别 通过数据集记录的数据。

    3. 数据尺寸

      If you select Data dimension , the category will be available 除了其他方面, “期间”和“组织单位”的标准尺寸。

  4. 选择类别选项并分配它们。

  5. 点击**保存**。

创建或编辑类别组合

类别组合可让您将多个类别组合成一个 相关集。

您可以分解数据元素“新感染艾滋病毒的数量” 分为以下几类:

  • 艾滋病毒服务:“其他”,“ PMTCT”,“结核病”

  • 性别:“男”,“女”

在此示例中,有两个分解级别,包括 两个单独的数据元素类别。每个数据元素类别包括 几个数据元素类别选项。

在DHIS2中,根据 常见的一组类别。通过将这些不同的类别合并为一个 类别组合并将这些组合分配给数据元素, 您可以将适当的分类级别快速应用于大型 数据元素数。

  1. Open the Maintenance app and click Category > Category 组合

  2. 点击添加按钮。

  3. 填写表格:

    1. 名称

    2. 数据维度类型

    3. 报告中的跳过类别总计

  4. 选择类别并分配它们。

  5. 点击**保存**。

创建或编辑类别选项组

您可以使用类别选项对类别选项进行分组和分类 组。类别选项组集的主要目的是添加更多 您捕获的数据的维数,以便在例如 **数据透视表**或**数据可视化器**应用。

考虑一个由“项目”收集数据并为项目建模的系统 作为类别选项。系统必须能够基于 哪个捐助者支持该项目。在这种情况下,创建一个类别 选项组集称为“捐赠者”。每个捐赠者都可以创建为一个类别 选项组,其中每个类别选项/项目都放在 适当的组。在数据分析应用程序中,“捐赠者”组 集将显示为数据维度,而每个供体显示为 尺寸项目,准备包含在报告中。

要创建类别选项组:

  1. Open the Maintenance app and click Category > Category 选项组

  2. 点击添加按钮。

  3. 填写表格:

    1. 名称

    2. 短名称 :为数据元素定义一个短名称。

    3. 数据维度类型

  4. 选择**类别选项**并分配它们。

  5. 点击**保存**。

创建或编辑类别选项组集

您可以将类别选项组分组在类别选项组集中。的 类别选项组集的主要目的是添加更多 您捕获的数据的维数,以便在例如 **数据透视表**或**数据可视化器**应用。

  1. Open the Maintenance app and click Category > Category 选项组集

  2. 点击添加按钮。

  3. 填写表格:

    1. 名称

    2. 描述

    3. 数据尺寸

    4. 数据维度类型

  4. Select Category option groups and assign them.

  5. 点击**保存**。

对数据集使用类别组合

当类别和类别组合具有数据维类型时 “属性”,他们可以将一组通用属性应用于相关的一组 包含在数据集中的数据值。当类别组合为 用作属性,它们用作另一个维度(类似于 您可以在分析中使用的“期间”和“组织单位”。

假设非政府组织在给定的设施中提供ART服务。他们 需要每个月在“ ART每月摘要”中进行报告, 将包含许多数据元素。非政府组织和项目可以 可能会随着时间而改变。为了将数据归因于给定的NGO 和项目在任何时间点,您需要记录此信息 在输入数据时使用每个数据值。

  1. 使用数据维度类型“属性”创建两个类别: “实施伙伴”和“项目”。

  2. 创建具有数据维类型的类别组合 “属性”:“实施合作伙伴和项目”。

  3. 将您创建的类别分配给类别组合。

  4. 创建一个称为“ ART每月摘要”的数据集,然后选择 “实施合作伙伴和项目”类别组合。

When you enter data in the Data entry app, you can select an "Implementing partner" and a "Project". Each recorded data value, is assigned a specific combination of these categories as an attribute. These attributes (when specified as a dimension) can be used in the analysis applications similar to other dimensions, for example the period and organisation unit.

将代码分配给类别选项组合

您可以将代码分配给类别选项组合。这使得数据 DHIS2与外部系统之间的交换更加容易。系统创建 类别选项组合自动。

  1. Open the Maintenance app and click Category > Category 选项组合

  2. 在列表中,找到要修改的对象。

  3. 点击选项菜单,然后选择**编辑**。

  4. 输入验证码。

  5. 点击**保存**。

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

更改元数据对象的共享设置

您可以为元数据对象分配不同的共享设置,例如 示例组织单位和跟踪的实体属性。这些分享 设置可控制哪些用户和用户组可以查看或编辑 元数据对象。

一些元数据对象还允许您更改共享设置 对象的数据输入。这些附加设置控制谁可以 使用元数据查看或在表单字段中输入数据。

注意

默认设置是所有人( 公共访问权限 )都可以找到, 查看和编辑元数据对象。

  1. Open the Maintenance app and find the type of metadata object 您要修改。

  2. In the object list, click the context menu and select Sharing 设置

  3. (可选)添加用户或用户组:搜索一个或多个用户 分组并选择它。用户或用户组已添加到列表中。

  4. 更改要修改的访问组的共享设置。

    • 可以编辑和查看 :访问组可以查看和编辑 目的。

    • 只能查看 :访问组可以查看对象。

    • 禁止访问 (仅适用于**公共访问**):公众 将无法访问该对象。

  5. 更改您要访问的访问组的数据共享设置 修改。

    • 可以捕获数据 :访问组可以查看和捕获数据 为对象。

    • 可以查看数据 :访问组可以查看以下数据: 目的。

    • 无访问权限 :访问组将无法访问以下数据: 物体。

  6. 点击**关闭**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理数据元素

关于数据元素

数据元素是DHIS2的基础。数据元素定义什么 实际记录在系统中,例如免疫接种次数或 疟疾病例数。

诸如“确诊疟疾病例数”之类的数据元素通常 分解成较小的组成部分,例如确定 特定年龄段已确诊的疟疾病例数。

In the Maintenance app, you manage the following data elements objects:

Data element objects in the Maintenance app
Object type Available functions
数据元素 Create, edit, clone, share, delete, show details and translate
数据元素组 Create, edit, clone, share, delete, show details and translate
Data element group set Create, edit, clone, share, delete, show details and translate

工作流程

  1. 创建所有类别选项。

  2. 创建由您拥有的多个类别选项组成的类别 创建。

  3. 创建由一个或多个组成的类别组合 类别。

  4. 创建数据元素并将其分配给类别组合。

创建或编辑数据元素

  1. Open the Maintenance app and click Data elements > Data 元件

  2. 点击添加按钮。

  3. In the Name field, define the precise name of the data element.

    每个数据元素必须具有唯一的名称。

  4. In the Short name field, define a short name for the data 元件。

    通常,简称是完整数据的缩写 元素名称。此属性通常用于报表中以显示 数据元素的名称,其中空间有限。

  5. (可选)在 Code 字段中,分配一个代码。

    在许多国家/地区,为数据元素分配了代码。

  6. (Optional) In the Color field, assign a color which will be used 数据捕获应用程序中的此数据元素。

  7. (Optional) In the Icon field, assign an icon which will be used 数据捕获应用程序中的此数据元素。

  8. In the Description field, type a description of the data 元件。尽可能精确并包含完整的信息 关于如何测量数据元素以及其目的是什么。

  9. (Optional) In the Field mask field, you may type a template that's used to provide 提示数据元素的正确格式。

    NOTE

    So far this is only implemented in the DHIS2 Android Capture app; not in the Capture and Tracker Capture web apps.

以下是可在遮罩中使用的特殊字符。特殊字符与给定类型的一个字符完全匹配。

性格匹配
\ d 数字
\ x 小写字母
\ X 大写字母
\ w 任何字母数字字符

例如,该模式可用于在数据元素的输入字段中根据需要显示连字符。例如“ d d d- d d d- d d d, 每三位数显示一个连字符。

  1. In the Form name field, type an alternative name of the data 元件。此名称可以在部分或自动数据中使用 报名表。表单名称将自动应用。

  2. In the Domain type field, select whether the data element is an 数据元素的聚合或跟踪器类型。

  3. In the Value type field, select the type of data that the data 元素将记录。

    Value types
    Value type Description
    Age -
    Coordinate A point coordinate specified as longitude and latitude in decimal degrees. All coordinate should be specified in the format "-19.23 , 56.42" with a comma separating the longitude and latitude.
    Date Dates rendered as calendar widget in data entry.
    Date & time Is a combination of the DATE and TIME data elements.
    Email Email.
    File A file resource where you can store external files, for example documents and photos.
    Image A file resource where you can store photos.

    Unlike the FILE data element, the IMAGE data element can display the uploaded image directly in forms.
    Integer Any whole number (positive and negative), including zero.
    Letter A single letter.
    Long text Textual value. Renders as text area with no length constraint in forms.
    Negative integer Any whole number less than (but not including) zero.
    Number Any real numeric value with a single decimal point. Thousands separators and scientific notation is not supported.
    Percentage Whole numbers inclusive between 0 and 100.
    Phone number Phone number.
    Positive integer Any whole number greater than (but not including) zero.
    Positive or zero integer Any positive whole number, including zero.
    Organisation unit Organisation units rendered as a hierarchy tree widget.

    If the user has assigned "search organisation units", these will be displayed instead of the assigned organisation units.
    Unit interval Any real number greater than or equal to 0 and less than or equal to 1.
    Text Textual value. The maximum number of allowed characters per value is 50,000.
    Time Time is stored in HH:mm format.

    HH is a number between 0 and 23

    mm is a number between 00 and 59
    Tracker associate Tracked entity instance. Rendered as dialog with a list of tracked entity instances and a search field.
    Username DHIS2 user. Rendered as a dialog with a list of users and a search field. The user will need the "View User" authority to be able to utilise this data type
    Yes/No Boolean values, renders as drop-down lists in data entry.
    Yes only True values, renders as check-boxes in data entry.
  4. In the Aggregation type field, select the default aggregation 将在数据元素上使用的操作。

    大多数数据元素应具有** Sum **运算符。这包括 所有应加在一起的数据元素。其他资料 人员等级别的元素应设置为使用 ** Average **运算符,当沿时间维度的值应 不加在一起,而是取平均值。

    Aggregation operators
    Aggregation operator Description
    Average Average the values in both the period as and the organisation unit dimensions.
    Average (sum in organisation unit hierarchy) Average of data values in the period dimension, sum in the organisation unit dimensions.
    Count Count of data values.
    Min Minimum of data values.
    Max Maximum of data values.
    None No aggregation is performed in any dimension.
    Sum Sum of data values in the period and organisation unit dimension.
    Standard deviation Standard deviation (population-based) of data values.
    Variance Variance (population-based) of data values.
  5. 如果您出于特定原因要保存零,请选择**存储 零数据值**。默认情况下,DHIS2不存储输入的零 在数据输入模块中。

  6. In the URL field, enter a link to an in-depth description of the 数据元素。

    例如,指向元数据存储库或注册表的链接 包含有关定义的详细技术信息,以及 数据元素的测量。

  7. In the Category combination field, define which category 数据元素应具有的组合。这也称为 “分类”。

  8. Select an Option set .

    选项集是选项的预定义列表,可用于 数据输入。

  9. Select an Option set for comments .

    注释的选项集是预定义的选项列表,可以 用于指定数据中数据值的标准化注释 条目。

  10. 分配一个或多个**传奇**。

    图例用于** Maps **应用中,以显示某些 带有某些图标的数据元素。

  11. Set the Aggregation levels to allow the data element to be 汇总在一个或多个级别:

    1. 在左窗格中,选择要分配给 数据元素。

    2. 单击右箭头以指定聚合级别。

    默认情况下,聚合将从分配的最低点开始 组织单位。例如,如果您选择“ Chiefdom”,则表示 “酋长”,“地区”和“国家”聚合使用 作为数据的“首要”(可用的最高聚合级别) 源,PHU数据将不包括在内。 PHU数据仍将是 可用于PHU级别,但不包括在 以上级别。

    如果您同时选择“地区”和“首席”,则表示 “地区”和“国家”级别汇总使用地区数据作为 他们的来源是“酋长”将使用“酋长国”,“ PHU”将使用PHU。

  12. 如果适用,请输入自定义属性值,例如 分类**或**收集方法

    Note

    You create custom attributes in the Maintenance app: Other > Attributes .

  13. 如果适用,请选择强制性数据元素组集,用于 例如**主数据元素组**或**基于跟踪器的数据**。

    Note

    You'll only see data element group sets in this form if you've created them and set them to Compulsory .

    You create data element group sets in the Maintenance app: Data element > Date element group set .

  14. 点击**保存**。

创建或编辑数据元素组

数据元素组可让您将相关数据元素分类为 共同的主题。例如,两个数据元素“麻疹免疫”和 “ BCG免疫”可以分组为一个数据元素组 “儿童免疫”。

要创建数据元素组:

  1. Open the Maintenance app and click Data elements > Data 元素组

  2. 点击添加按钮。

  3. 填写表格:

    1. 名称

    2. 简称

  4. 选择数据元素并分配它们。

  5. 点击**保存**。

创建或编辑数据元素组集

数据元素组集可让您对多个数据元素进行分类 组成一组。系统在以下过程中使用数据元素组集 分析和报告,以将相似的数据元素组合并为一个 共同的主题。一个数据元素组可以是多个数据元素的一部分 组集。

  1. Open the Maintenance app and click Data elements > Data 元素组集

  2. 点击添加按钮。

  3. 填写表格:

    1. 名称
    2. 简称
    3. 描述
    4. 必修
    5. 数据尺寸
  4. 选择数据元素组并分配它们。

    可用的数据元素组显示在左侧面板中。数据 当前是数据元素组成员的元素组 设置显示在右侧面板中。

  5. 点击**保存**。

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

更改元数据对象的共享设置

您可以为元数据对象分配不同的共享设置,例如 示例组织单位和跟踪的实体属性。这些分享 设置可控制哪些用户和用户组可以查看或编辑 元数据对象。

一些元数据对象还允许您更改共享设置 对象的数据输入。这些附加设置控制谁可以 使用元数据查看或在表单字段中输入数据。

注意

默认设置是所有人( 公共访问权限 )都可以找到, 查看和编辑元数据对象。

  1. Open the Maintenance app and find the type of metadata object 您要修改。

  2. In the object list, click the context menu and select Sharing 设置

  3. (可选)添加用户或用户组:搜索一个或多个用户 分组并选择它。用户或用户组已添加到列表中。

  4. 更改要修改的访问组的共享设置。

    • 可以编辑和查看 :访问组可以查看和编辑 目的。

    • 只能查看 :访问组可以查看对象。

    • 禁止访问 (仅适用于**公共访问**):公众 将无法访问该对象。

  5. 更改您要访问的访问组的数据共享设置 修改。

    • 可以捕获数据 :访问组可以查看和捕获数据 为对象。

    • 可以查看数据 :访问组可以查看以下数据: 目的。

    • 无访问权限 :访问组将无法访问以下数据: 物体。

  6. 点击**关闭**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理数据集和数据输入表单

关于数据集和数据输入表格

All data entry in DHIS2 is organised in data sets. A data set is a collection of data elements grouped together for data entry and data export between instances of DHIS2. To use a data set to collect data for a specific organisation unit, you must assign the organisation unit to the data set. Once you have assigned the data set to an organisation unit, that data set is available in the Data entry app. Only the organisation units that you have assigned the data set to can use the data set for data entry.

类别组合可以链接到数据元素和数据集。如果 您将类别组合用于数据集,类别组合 适用于整个表格。这意味着您可以使用类别 捕获整个表格共有的信息,例如 项目或拨款的名称。当数据集链接到 类别组合,这些类别将显示为下拉列表 **数据输入**应用中的框。表格中捕获的数据将被 链接到从这些下拉框中选择的类别选项。对于 有关如何创建类别和类别组合的信息, 请参阅“管理数据元素和类别”一节。确保你 将类别和类别组合的类型设置为“属性”。

类别有用的一种情况是您需要捕获一个类别 实施伙伴组织和项目的数据输入表。 在这种情况下:

  1. 为所有合作伙伴组织创建类别选项和类别 和项目,并将它们链接到新的类别组合中。

  2. 将类别组合分配给要为其的数据集(窗体) 需要捕获此信息。

    在数据输入模块中打开此数据集时,伙伴 组织和项目类别将自动呈现 作为下拉框,允许您选择特定的实施 合作伙伴组织和项目,然后继续进行数据输入。

You create and edit data sets in the Maintenance app. Here you define, for example, which data elements you want to include in the data set and the data collection frequency.

You enter data in the Data entry app. The Data entry app uses data entry forms to display the data sets. There are three types of data entry forms:

Data entry form types
Data entry form type 描述
Default form Once you have assigned a data set to an organisation unit, a default form is created automatically. The default form is then available in the Data entry app for the organisation units you have assigned it to.

A default form consist of a list of the data elements belonging to the data set together with a column for inputting the values. If your data set contains data elements with a non-default category combination, for example age groups or gender, additional columns are automatically created in the default form based on the different categories.

If you use more than one category combination you get multiple columns in the default form with different column headings for the options.
Section form If the default form doesn't meet your needs, you can modify it to create a section form. Section forms give you more flexibility when it comes to using tabular forms.

In a section form you can, for example, create multiple tables with subheadings and disable (grey out) cells in a table.

When you have added a section form to a data set, the section form is available in the Data entry app.
Custom form If the form you want to design is too complicated for default or section forms, you can create a custom form. A custom form takes more time to create than a section form, but you have full control over the design.

You can, for example, mimic an existing paper aggregation form with a custom form. This makes data entry easier, and should reduce the number incorrectly entered data elements.

When you have added a custom form to a data set, the custom form is available in the Data entry app.

注意

如果数据集同时具有部分表单和自定义表单,则系统 在数据输入期间显示自定义表格。输入数据的用户不能 选择他们要使用的表格。在基于Web的数据输入中的顺序 显示首选项:

1.自定义表单(如果存在)

2.部分表格(如果存在)

3.默认格式

移动设备不支持自定义表格。在基于移动的数据输入中 显示首选项的顺序为:

1.部分表格(如果存在)

2.默认格式

In the Maintenance app, you manage the following data set objects:

Data set objects in the Maintenance app
Object type Available functions
资料集 创建、分配给组织单位、编辑、共享、删除、显示详细信息和翻译

编辑强制性数据元素

一次向组织单位添加和删除多个数据集
Section form Create, edit and manage grey fields
Section Change display order, delete and translate
Custom form Create, edit and script

工作流程

您需要具有数据元素和类别才能创建数据集和 数据输入表格。

  1. 创建一个数据集。

  2. 将数据集分配给组织单位。

    默认形式是自动创建的。

  3. 创建节形式或自定义形式。

    Now you can register data in the Data entry app.

创建或编辑数据集

  1. Open the Maintenance app and click Data set > Data set .

  2. 点击添加按钮。

  3. In the Name field, type the precise name of the data set.

  4. In the Short name field, define a short name for the data set.

    通常,简称是完整数据集的缩写 名称。此属性通常用于显示数据名称 设置空间有限的地方。

  5. (可选)在 Code 字段中,分配一个代码。

  6. In the Description field, type a description of the data set.

  7. Enter the number of Expiry days .

    到期天数控制应该持续多长时间 possible to enter data in the Data entry app for this data set. 到期天数指的是结束日期之后的天数 选定的数据输入期间,应打开数据输入表单 进入。天数到期后,数据集将 被锁定以进一步进入。

    您可以使用锁定异常为此设置手动异常 functionality in the Data Administration app.

    Note

    To allow data entry into all possible historical time periods, set the number of expiry days to zero.

  8. 如果希望将来可以输入数据,请键入 **开放将来的数据输入期间**中的期间数 领域。

    该值是可用于 数据输入。

    对于每月数据集,值2允许您输入2的数据 提前几个月。例如,这对于人口有用, 目标和计划数据。

  9. In the Days after period to qualify for timely submission field, 输入可以输入数据的天数 考虑及时报到。

    To verify the number of timely reports submitted, go to Reports > 报告率摘要

  10. Select a Period type .

    期间类型定义了报告的频率 特定的数据集。例如,频率可以是每天 每季度或每年。

  11. Select a Category combination to assign it to the data set.

    Tip

    Click Add new to create category combinations that you're missing. In the form that opens, create the category combinations you need. When you're done, click Refresh values .

  12. If you selected a category combination other than None , 您可以在**开放时间之后输入零或正数 类别选项的结束日期**。这使您可以在此数据中输入数据 为类别选项设置最多指定的周期数 该类别选项的结束日期之后。

  13. In the Complete notification recipients list, select a user 数据集标记为时应接收消息的组 complete in the Data Entry app.

    该消息是通过DHIS2消息传递系统传递的。

  14. 如果您希望输入数据的用户在以下情况下收到消息 the data set is marked as complete in the Data entry app, select 发送通知给完成用户

    该消息是通过DHIS2消息传递系统传递的。

  15. If applicable, select, a Data approval workflow .

  16. 如果您希望可以在Java中使用数据集 mobile DHIS2 application, select Enable for Java mobile client .

  17. 如果您要强制填写数据元素的所有值 在数据输入中,如果已填写一个或多个值,请选择**全部 必填数据元素的字段**。

    这意味着,如果您在 输入字段(用于类别选项组合),然后您 必须输入属于该数据元素的所有字段的数据(即 是所有类别选项组合)。

  18. 如果希望将数据输入表单标记为已完成 only if the validation of that form is successful, select Complete 仅当验证通过时才允许

    如果选择此选项,则无法将表单标记为已完成 验证失败。

  19. 如果您要强制要求所有缺失值都需要一个 评论以说明其缺席,请选择**缺少值要求 评论完成**。

  20. (可选)分配一个或多个**传奇**。

  21. If applicable, select Skip offline .

    此选项控制是否应将此数据输入表单 下载并保存在用户的网络浏览器中。通常你 shouldn't select Skip offline . This is the default setting. If 您有一些很少使用的大型表格,可以考虑选择 此选项可加快数据输入模块中的初始加载速度。

  22. If applicable, select Data element decoration

    如果选择此选项,则数据元素的描述将以 脱机模式下**数据中的已下载数据集中的标注 入门**应用。

  23. If applicable, select Render sections as tabs .

    此选项仅适用于部分表格。该选项允许 您可以将每个部分呈现为数据集水平上方的选项卡。 这对于较长的数据集很有用,因为它允许适当的部分 无需快速浏览整个表格即可快速选择。

  24. If applicable, select Render vertically .

    此选项仅适用于部分表格。

  25. 选择数据元素并分配它们。

    您可以覆盖每个选定数据集的类别组合 通过点击所选数据列表上方的齿轮图标 元素。这使您可以利用特定的类别组合 (分解)在当前数据集中而不是类别中 直接与数据元素本身关联的组合。

  26. 选择指标并分配它们。

  27. 在组织单位树中,选择您要使用的组织单位 想要将数据集分配给。

    Tip

    • Click Organisation unit level to select all organisation units that belong to a certain organisation level.

    • Click Organisation unit group to select all organisation units that belong to a certain organisation unit group.

  28. 点击**保存**。

You can now use the data set in the Data Entry app for the organisation units that you have assigned to and for periods according to the selected frequency (period type).

创建或编辑数据集通知

  1. Open the Maintenance app and click Data set > Data set 通知

  2. 点击添加按钮。

发送什么?

  1. In the Name field, type the precise name of the data set 通知。

  2. (可选)在 Code 字段中,分配一个代码。

  3. 输入**数据集**。

    这些数据集将与此通知关联。如果有的话 他们完成了一定时期和组织单位, 通知将由系统生成。

    Note

    Nothing will happen if no data set is selected

  4. In Message template section there are two parameters.

    • **主题模板**发送的通知主题 通知。它可以具有变量列表中的值 右侧可用。

    • **消息模板**通知中发送的实际消息。它可以 具有右侧可用变量列表中的值 侧。

    Note

    Subject is only relevant in case of Email and internal DHIS2 messages. It is ignored in case of SMS.

何时发送?

  1. **数据集通知触发器**字段确定何时发送 通知。

    • **数据集完成**将立即触发通知 数据集完成。

    • **计划天数**将根据天数安排通知时间 相对于预定日期。预定日期将由 与数据集关联的期间。

      • **发送通知为**提供两种不同类型的 通知

        • **汇总摘要**以摘要心情发送通知

        • **单一通知**单一发送通知 心情

    Note

    Send notification as option is only available in case of scheduled notification. This option is set to default which is Single notification in case of completion notification

寄给谁?

  1. **“通知收件人” **字段确定 通知。

    • **组织单位联系人**将向联系人发送通知 分配给已收集数据的组织单位 从。

    • ** UserGroup **将向所有会员发送通知 选择的用户组。

    Note

    An internal DHIS2 message will be sent in case if recipient is UserGroup. Moreover user will also receive SMS/EMAIL if phone number and email address exist for that user and SMS/EMAIL notifications are enabled in SystemSettings

覆盖数据集中的数据元素的类别组合

您可以覆盖要用于数据元素的类别组合 在数据集范围内。这意味着数据元素可以使用 不同数据集内的不同类别组合。这是 当您想重复使用数据元素时很有用,因为您不必 复制数据元素以允许多个类别组合。

如果组织单位层次结构中的不同区域使用 不同的分类,或者如果分类随时间变化, 您可以通过创建不同的数据集来表示 适当的类别组合。

  1. Open the Maintenance app and click Data set > Data set .

  2. 在列表中,找到要修改的数据集。

  3. 点击选项菜单,然后选择**编辑**。

  4. 转到数据元素部分,然后单击扳手图标。

  5. 选择新的类别组合,然后单击**关闭**。

  6. 点击**保存**。

编辑数据集中的强制数据元素

您可以添加或删除将被标记为强制性的数据元素 在数据输入期间。

  1. Open the Maintenance app and click Data set > Data set .

  2. 在列表中,找到要编辑的数据集。

  3. Click the options menu and select Edit compulsory data elements .

  4. 分配必填数据元素。

  5. 点击**保存**。

下载PDF格式的默认数据表格

您可以从PDF格式下载默认数据以获取离线数据 条目。

  1. Open the Maintenance app and click Data set > Data set .

  2. 在列表中,找到要下载的对象。

  3. Click the options menu and select Get PDF for data entry .

管理板块表格

创建部分表格

截面表单按数据元素类别自动分隔 组合,从而为每个表单生成电子表格,例如数据输入表单 部分。

  1. Open the Maintenance app and click Data set > Data set .

  2. 在列表中,找到要创建节形式的数据集 为了。

  3. Click the options menu and select Manage sections .

  4. 点击添加按钮。

  5. (Optional) In the Name field, type the name of the section.

  6. (Optional) In the Description field, type a description of the 部分。

  7. (可选)在以下期间显示节表中各行的总计 数据输入,选择**显示行总计**。

  8. (可选)在显示期间在部分表格中显示列的总计 数据输入,选择**显示列总计**。

  9. 将数据元素分配给该部分:

    1. (Optional) Select a Category combination filter .

      Note

      You can only use one category combination per section.

      Option Description
      None Displays all data elements that don't have a category combination.
      <No filter> Displays all data elements.
    2. Select data elements and assign them.

  10. (可选)使用向上键对部分中的数据元素进行排序 分配的数据元素字段左侧的向下箭头和向下箭头。

  11. 点击**保存**。

  12. 对您要包含的每个部分重复添加部分步骤 部分表格。

    In the Data Entry app you can now use the section form. The 当部分可用时,部分表格会自动出现 选定的数据集。具有部分表格的数据集将 自动显示剖面图。

注意如何将每个数据元素类别都分为一个单独的 部分,并且数据输入表已由 系统。将节形式与数据元素类别结合使用 可以大大减少创建所需的时间 数据集的数据输入表单。

编辑部分表格

  1. Open the Maintenance app and click Data set > Data set .

  2. 在列表中,找到要编辑节形式的数据集 为了。

  3. Click the options menu and select Manage sections .

  4. 在列表中,找到要编辑的部分。

  5. 点击选项菜单,然后选择**编辑**。

  6. Edit the section and click Save .

  7. 对要编辑的每个节重复编辑节的步骤。

管理分区表单中的灰色字段

您可以禁用数据输入的数据元素和类别选项。那 表示在数据处理期间将无法在这些字段中输入数据 条目。

  1. Open the Maintenance app and click Data set > Data set .

  2. 在列表中,找到要编辑节形式的数据集 为了。

  3. Click the options menu and select Manage sections .

  4. 在列表中,找到要编辑的部分。

  5. Click the options menu and select Manage grey fields .

  6. 选择要禁用的字段。

    Note

    If you've sections that contain data elements assigned to multiple category combinations, switch between the category combinations to view all fields.

  7. 点击**保存**。

在部分表格中更改部分显示顺序

您可以控制以节形式显示节的顺序。

  1. Open the Maintenance app and click Data set > Data set .

  2. 在列表中,找到要编辑节形式的数据集 为了。

  3. Click the options menu and select Manage sections .

  4. 在列表中,找到要移动的部分。

  5. 点击选项菜单,然后选择**上移**或**下移**。

    如果您要移动的部分是菜单中的第一部分或最后部分 列表中,您只会看到其中一个移动选项。

删除部分表格中的部分

  1. Open the Maintenance app and click Data set > Data set .

  2. 在列表中,找到要编辑节形式的数据集 为了。

  3. Click the options menu and select Manage sections .

  4. 在列表中,找到要删除的部分。

  5. Click the options menu and select Delete .

以节形式翻译节

  1. Open the Maintenance app and click Data set > Data set .

  2. 在列表中,找到要编辑节形式的数据集 为了。

  3. Click the options menu and select Translate .

  4. 选择一个语言环境。

  5. 输入所需的信息。

  6. 点击**关闭**。

管理自定义表单

创建一个自定义表格

您可以在内置的WYSIWYG HTML编辑器中设计自定义表单。如果选择 来源 ,您可以直接将HTML代码粘贴到编辑区域中。为一个 有关如何使用编辑器的完整指南,请参阅 http://docs.ckeditor.com/

创建自定义表单:

  1. Open the Maintenance app and click Data set .

  2. 在列表中,找到要添加自定义表单的数据集。

  3. Click the options menu and select Design data entry form .

  4. 在编辑区域中,创建自定义表单。

    • 双击左侧列表中的对象以将其插入 表格。

    • 如果您已经有了表单的HTML代码,请单击 **来源**并粘贴代码。

  5. Select a Form display style .

  6. 点击**保存**。

自定义形式的脚本

在自定义数据输入表单中,您可以使用JavaScript创建动态 行为和自定义。例如,您可以隐藏表单部分 根据数据元素的特定用户输入,或显示特定 表单加载时的信息。

大事记

DHIS2数据输入模块提供了一系列事件,您可以 注册并用于在特定时间执行操作。这些事件是 注册在document元素上。 jQuery事件对象和数据 集标识符始终是提供给 回调函数。下表概述了事件 以及何时触发它们。

Data entry events
描述 Arguments
dhis2.de.event.formLoaded Triggered after the data entry form is rendered, but before data values are set in entry fields. Event | Data set ID
dhis2.de.event.dataValuesLoaded Triggered after data values are set in entry fields. Event | Data set ID
dhis2.de.event.formReady Triggered when the data entry form is completely rendered and loaded with all elements. Event | Data set ID
dhis2.de.event.dataValueSaved Triggered when a data value is saved successfully. Event | Data set ID | Data value object
dhis2.de.event.completed Triggered when a data set is successfully marked as complete. Event | Data set ID | Complete registration object
dhis2.de.event.uncompleted Triggered when a data set is successfully marked as incomplete. Event | Data set ID
dhis2.de.event.validationSuccess Triggered when validation is done and there were no violations. Event | Data set ID
dhis2.de.event.validationError Triggered when validation is done and there were one or more violations. Event | Data set ID
dhis2.ou.event.orgUnitSelected Triggered when one or more organisation units are selected in the org unit web tree. Event | Org unit IDs | Org unit names | Sub org unit IDs

要注册活动:

 <script type="text/javascript">
dhis2.util.on('dhis2.de.event.formReady',function(event,ds){
  console.log('ID为'+ ds +'的表单已加载!');
dhis2.util.on('dhis2.de.event.dataValueSaved',function(event,ds,dv){
  console.log('数据值:'+ dv.value +'与数据元素:'+ dv.de一起保存);
dhis2.util.on('dhis2.de.event.completed',function(event,ds,cr){
  console.log('组织单位的表格已完成:'+ cr.ou);
 </script>

注意

请注意仅使用“命名空间”事件,例如 上面的示例,而不是一般的示例,例如dhis2.util.on中的“ click” 方法将首先注销事件。

如果您的功能仅适用于某些数据集,则可以使用 提供的数据集标识符和快捷方式,可避免不必要的功能 像这样的数据集 这个:

dhis2.de.on('dhis2.de.event.validationSuccess',function(event,ds){
  if($ .inArray(ds,['utXOiGbEj14','Re7qzHEThSC'])== -1){
    返回false;
  console.log('ID为:'+ ds +'的表单已成功验证!');

数据输入表单中输入字段的标识符位于 格式如下所述。此格式可用于选择输入 脚本中的字段并对其执行操作:

 <dataelementid>-<optioncomboid> -val

由于为所有事件提供了数据集标识符,因此可行 另一种方法是利用“文件” Web API资源并保留您的 回调函数在一个文件中,您可以在其中让JavaScript代码 根据当前加载的数据集采取措施。

职能

DHIS2数据输入模块包含JavaScript API函数,该函数可以 可从自定义数据输入表单访问。

** dhis2.de.api.getSelections **:此函数返回一个JavaScript 包含所有尺寸的属性以及相应属性的对象 所选选项的标识符的值。它包含 “ ds”(数据集),“ pe”(句号),“ ou”(组织单位)的属性 和所有数据集类别的标识符。

一个示例响应如下所示:

{
 + ds:“ lyLU2wR22tC”,
 + pe:“ 201605”,
 + ou:“ g8upMTyEZGZ”,
 + LFsZ8v5v7rq:“ CW81uF03hvV”,
 + yY2bQYqNt0o:“ yMj2MnmNI8L”

此功能的示例JavaScript用法:

var sel = dhis2.de.api.getSelections();
 + var orgUnit = sel [“ ou”];
 + var partner = sel [“ LFsZ8v5v7rq”];

更改元数据对象的共享设置

您可以为元数据对象分配不同的共享设置,例如 示例组织单位和跟踪的实体属性。这些分享 设置可控制哪些用户和用户组可以查看或编辑 元数据对象。

一些元数据对象还允许您更改共享设置 对象的数据输入。这些附加设置控制谁可以 使用元数据查看或在表单字段中输入数据。

注意

默认设置是所有人( 公共访问权限 )都可以找到, 查看和编辑元数据对象。

  1. Open the Maintenance app and find the type of metadata object 您要修改。

  2. In the object list, click the context menu and select Sharing 设置

  3. (可选)添加用户或用户组:搜索一个或多个用户 分组并选择它。用户或用户组已添加到列表中。

  4. 更改要修改的访问组的共享设置。

    • 可以编辑和查看 :访问组可以查看和编辑 目的。

    • 只能查看 :访问组可以查看对象。

    • 禁止访问 (仅适用于**公共访问**):公众 将无法访问该对象。

  5. 更改您要访问的访问组的数据共享设置 修改。

    • 可以捕获数据 :访问组可以查看和捕获数据 为对象。

    • 可以查看数据 :访问组可以查看以下数据: 目的。

    • 无访问权限 :访问组将无法访问以下数据: 物体。

  6. 点击**关闭**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理指标

关于指标

指标是一个可以包含多个数据元素的公式, 常数,组织单位组数和数学运算符。 指标通常由分子和分母组成。你用 用于计算覆盖率,发生率和其他值的指标 是已输入到数据元素值的结果 系统。计算得出的总数没有分母。

注意

您永远不会直接在DHIS2中输入指标值,而是进行计算。

指标公式可以包含数学运算符,例如 加号和减号;功能(见下文);和以下元素:

Indicator elements
Indicator element 类型 描述
不变 零件 Constants are numerical values which remain the same for all indicator calculations. This is useful in order to have a single place to change values that might change over time.

Constants are applied AFTER data element values have been aggregated.
资料元素 零件 Data elements are substituted by the data value captured for the data element.
Days Operator "Days" is special operator that always provides the number of days for a given indicator calculation.

For example: if you want to calculate the "Percentage of time vaccine refrigerator was non-functional", you could define the numerator as:

("Days-"Number of days vaccine refrigerator was available"")/"Days"

If the fridge was available 25 days in June, the indicator would be calculated as:

(30-25/25)*100 = 17 %

If you want to calculate the total for Quarter 1, the number of days ("Days") would be:

31+28+31 = 90

The "Days" parameter will always be the number of days in the period of interest.
Organisation unit counts 零件 You can use organisation unit groups in formulas. They will be replaced by the number of organisation units in the group. During aggregation, the organisation units in the group will be intersected with the part of the organisation unit hierarchy being requested.

This lets you use the number of public facilities in a specific district in indicators. This is useful for example when you create facility infrastructure surveys and reports.
程式 零件 Click Programs and select a program to view all data elements, attributes and indicators related to a specific program.

The program components you include in your formula will have a program tag assigned to them.

您可以在指标公式中使用以下功能:

Indicator functions
Indicator Function Arguments 描述
如果 (boolean-expr, true-expr, false-expr) Evaluates the boolean expression and if true returns the true expression value, if false returns the false expression value. The arguments must follow the rules for any indicator expression.
一片空白 (element) Returns true if the element value is missing (null), otherwise false.
isNotNull (element) Returns true if the element value is not missing (not null), otherwise false.
firstNonNull (element [, element ...]) Returns the value of the first element that is not missing (not null). Can be provided any number of arguments. Any argument may also be a numeric or string literal, which will be returned if all the previous objects have missing values.
最伟大的 (expression [, expression ...]) Returns the greatest (highest) value of the expressions given. Can be provided any number of arguments.
最小 (expression [, expression ...]) Returns the least (lowest) value of the expressions given. Can be provided any number of arguments.
log (expression [, base ]) Returns the natural logarithm (base e) of the numeric expression. If an integer is given as a second argument, returns the logarithm using that base.
log10 (expression) Returns the common logarithm (base 10) of the numeric expression.
null Returns no result. For example, if( #{FH8ab5Rog83}<0, null, 1 ) returns nothing if the data element value is less than 0, otherwise 1.
removeZeros (expression) Returns nothing if the expression value is 0, otherwise returns the expression value.
subExpression (expression) Evaluates part of an expression before aggregating. See Indicator SubExpressions below.
[periodInYear] The number of this period within the year (1, 2, 3, ...). For examples, see the Indicator Year-to-date section below.
[yearlyPeriodCount] The count of periods of this type within the year. For examples, see the Indicator Year-to-date section below.
.aggregationType (aggregation type) Overrides the default data element aggregation type for aggregate data (not for program data).
.maxDate (yyyy-mm-dd) For a data element (not program data), value from periods ending on or before a maximum date.
.minDate (yyyy-mm-dd) For a data element (not program data), value from periods starting on or after a minimum date.
.periodOffset (integer constant) Placed after a data value or expression, returns the value from a period offset relative to the reported period. It can be nested. See examples below.
.yearToDate() Summs the values of all periods from the start of the yaer through the current period. Note that any weekly period is considered to be part of the current year if it has four or more days in the year. For examples, see the Indicator Year-to-date section below.

Valid aggregation types:

聚集类型 描述
AVERAGE Average value in both period and organisation unit hierarchy
AVERAGE_SUM_ORG_UNIT Average value, sum in organisation unit hierarchy
COUNT Count of values
FIRST First value, sum in organisation unit hierarchy
FIRST_AVERAGE_ORG_UNIT First value, average in organisation unit hierarchy
LAST Last value, sum in organisation unit hierarchy
LAST_AVERAGE_ORG_UNIT Last value, average in organisation unit hierarchy
LAST_IN_PERIOD Last value in period, sum in organisation unit hierarchy
LAST_IN_PERIOD_AVERAGE_ORG_UNIT Last value in period, average in organisation unit hierarchy
MAX Maximum value
MIN Minimum value
NONE No aggregation is performed in any dimension
SUM Sum of values in both period and organisation unit hierarchy
STDEEV Standard deviation (population-based) of values
VARIANCE Variance (population-based) of values

Examples of .aggregationType, .maxDate, .minDate, and .periodOffset functions:

指标表达 手段
#{FH8ab5Rog83}.aggregationType(COUNT) count of values
#{FH8ab5Rog83}.aggregationType(LAST) - #{FH8ab5Rog83}.aggregationType(FIRST) the difference between first and last values
#{FH8ab5Rog83}.maxDate(2021-6-30) values until 30-Jun-2021
#{FH8ab5Rog83}.minDate(2021-1-1) values from 1-Jan-2021 onwards
#{FH8ab5Rog83}.minDate(2021-1-1)
.maxDate(2021-6-30)
values between 1-Jan-2021 and 30-Jun-2021
value from the period before
value from the period after
value from the period after
报告期间的数据元素FH8ab5Rog83减去前一时期的程序数据元素IpHINAT79UW.uf3svrmp8Oj的两倍
(#{FH8ab5Rog83}-
#{QOlfIKgNJ3D2}).periodOffset(-2)
前2个周期的数据元素FH8ab5Rog83减去前2个周期的数据元素QOlfIKgNJ3D2
前2个周期的数据元素FH8ab5Rog83加前1个周期的值
(#{FH8ab5Rog83} .periodOffset(-1)+
#{FH8ab5Rog83}).periodOffset(-1)
前2个周期的数据元素FH8ab5Rog83加上前1个周期的值(请注意,函数是嵌套的)

Indicator SubExpressions

When fetching data for a data element, indicators usually aggregate the data before evaluating it in the expression. For example, consider the indicator expression:

if( #{nYahlae7fe6} > 10, 1, 0 )

If the data element has aggregation type SUM, this will sum all the values of the data element nYahlae7fe6 for the relevant period and then test to see if the sum is greater than 10. It will return 1 if the sum of all the data element values is greater than 10, otherwise it will return 0.

Sometimes you may wish to evaluate a data value in an expression before aggregating it. For example, you may want to show at a district level how many facilities within the district have a data value greater than 10. This can be done by using the subExpression function as follows:

subExpression( if( #{nYahlae7fe6} > 10, 1, 0 ) )

This will test each data element value to see if it is greater than 10. If it is greater than 10, the if statement will return 1, otherwise 0. Then, assuming that data element nYahlae7fe6 has aggregation type SUM, it will sum the 1's and 0's, resulting in a count of how many data elements had a value greater than 10.

SubExpression notes:

  1. 仅当数据元素的聚合类型为 SUM 时,上述示例才会将 1 和 0 相加。如果数据元素具有不同的聚合类型,并且您希望将 1 和 0 相加,则可以使用 .aggregationType() 函数覆盖子表达式内的聚合类型,如下所示:

    subExpression( if( #{nYahlae7fe6} > 10, 1, 0 ) ).aggregationType(SUM)

  2. A SubExpression may reference only one data element, but it may reference it multiple times. For example:

    subExpression( if( #{nYahlae7fe6} > 10 && #{nYahlae7fe6} <= 20, 1, 0 ) )

  3. A SubExpression may reference a data element with a category option combination and/or an attribute option combination, but it must be exactly the same reference each time. For example:

    subExpression( if( #{nYahlae7fe6.beec4Dewah8} > 10 && #{nYahlae7fe6.beec4Dewah8} <= 20, 1, 0 ) )

  4. If you wish to evaluate an expression before aggregating that involves other types of data such as program data, or that involves more than one data element, category option combination or attribute option combination, you can use a Predictor to do so and store the result as a different data element. Then you can reference the predicted data element in an indicator or directly in analytics.

Indicator Year-to-date

Indicators can compute year-to-date values using the expression elements yearToDate() , [periodInYear] , and [yearlyPeriodCount] .

In the examples below, #{a} can be: #{dataElementUID}, or any valid indicator expression item that returns a data value such as #{dataElementUID.catOptionComboUid}, I{programIndicatorUID}, N{indicatorUID}, etc.

指标表达 手段
#{a} current period value
#{a}.yearToDate() sum of values year to date. For example, if the period is March gives the value for Jan+Feb+Mar
#{a}.yearToDate() / [periodInYear] average year-to-date value. For example, if the period is March gives the value for Jan+Feb+Mar / 3
#{a} - #{a}.yearToDate() / [periodInYear] difference between current period and average year to date
#{b} * [periodInYear] / [yearlyPeriodCount] If #{b} represents the annual target population (for example, the number of people who should be vaccinated during this year), then this can show the number of people who should be vaccinated by the current period. For example, in February this gives #{b} * 2 / 12.

Notes on [yearlyPeriodCount]

For monthly periods, [yearlyPeriodCount] is always 12, for quarters is always 4, etc. There are two advantages of using [yearlyPeriodCount] rather than hard-coding numbers like 12 or 4:

  1. For weekly periods [yearlyPeriodCount] will be 52 or 53 depending on the year. For biweekly periods it will be 26 or 27.

  2. If the user chooses a different period type in analytics, [periodInYear] and [yearlyPeriodCount] will adjust accordingly. For example if monthly data is collected, the user can choose to report monthly where [periodInYear] is 1: Jan, 2: Feb, ..., and [yearlyPeriodCount] is 12; or the user can report quarterly where [periodInYear] is 1: Q1, 2: Q2, ..., and [yearlyPeriodCount] is 4.

Notes on missing data

.yearToDate() returns a value if there is any data in the year before or during the period. For example, if the values of #{a} are:

Jan: (no data)
Feb: 1
Mar: 2
Apr: (no data)
May: 3
Jun: (no data)

then the values of #{a}.yearToDate() are:

Jan: (no data)
Feb: 1
Mar: 3
Apr: 3
May: 6
Jun: 6


In the Maintenance app, you manage the following indicator objects:

Indicator objects in the Maintenance app
Object type Available functions
指示符 Create, edit, clone, share, delete, show details and translate
Indicator type Create, edit, clone, delete, show details and translate
Indicator group Create, edit, clone, share, delete, show details and translate
Indicator group set Create, edit, clone, share, delete, show details and translate

工作流程

  1. 创建指标类型。

  2. 创建指标。

  3. 创建指标组。

  4. 创建指标组集。

创建或编辑指标类型

指标类型定义了在聚合期间应用的因素。 在数据集市导出或报告期间计算的指标值 表生成过程将显示正确的格式,并且 因此不需要额外的乘法器(例如, 百分比),以使值显示正确的格式。

注意

从DHIS2版本2.4开始,“计算数据元素”对象具有 已弃用。相反,您可以通过以下方式创建计算所得的数据元素: 创建因子类型为“ 1”的指标类型,并通过设置 “数字”选项为“是”。将“数字”选项设置为的效果 “是”将表示该指标实际上没有 分母。因此,您将只能定义一个分子, ,它将用作计算的数据元素的公式。

  1. 打开** Maintenance 应用程序,然后单击 Indicator ** > ** Indicator 类型**。

  2. 点击添加按钮。

  3. In the Name field, type the name of the indicator type, for 例如“百分比”,“每千”,“每万”。

  4. Type a Factor .

    该系数是数值系数,将乘以 指标计算过程中的指标公式。

  5. 点击**保存**。

创建或编辑指标

  1. 打开** Maintenance 应用程序,然后单击 Indicator ** > 指示符

  2. 点击添加按钮。

  3. In the Name field, type the full name of the indicator, for 例如:“每千人确诊的疟疾发病率”。

  4. In the Short name field, type an abbreviated name of the 指标,例如“每千次弹出记录的疟疾传播控制数”。

    简称必须少于或等于25个字符, 包括空格。

  5. (可选)在 Code 字段中,分配一个代码。

    在许多国家/地区,指标均分配有代码。

  6. (Optional) In the Color field, assign a color to reprersent the indicator.

  7. (Optional) In the Icon field, assign an icon to illustrate the meaning of the indicator.

  8. In the Description field, type a brief, informative description 指标及其计算方式。

  9. 如果要在计算过程中应用年化系数 of the indicator, select Annualized .

    通常,将年化指标的分子乘以 因数是12,而分母例如是每年 人口数字。这允许每月的覆盖值是 用年度人口数字计算。

  10. Select the number of Decimals in data output .

  11. 选择**指标类型**。

    该字段确定将自动应用的因子 在指标计算中。可能的选择是 由指标类型决定。例如,“百分比” 指标将自动乘以100, 导出到数据集市,以便将其显示为百分比。

  12. (可选)分配一个或多个**传奇**。

  13. In the URL field, enter a link, for example a link to an 指标注册表,其中完整的元数据描述 指示器可用。

  14. (可选)输入汇总数据的** Category选项组合 出口。**。

    您可以使用此设置将作为原始数据导出的聚合数据映射到 另一台服务器。通常,您会进行这种类型的数据交换映射 当您想根据患者数据创建匿名汇总数据时 记录在程序中(事件数据)。

  15. (可选)输入汇总的**属性选项组合 数据导出。**。

    您可以使用此设置将作为原始数据导出的聚合数据映射到 另一台服务器。通常,您会进行这种类型的数据交换映射 当您想根据患者数据创建匿名汇总数据时 记录在程序中(事件数据)。

  16. 如果适用,请输入自定义属性值,例如 分类**或**收集方法

    Note

    You create custom attributes in the Maintenance app: Other > Attributes .

  17. 点击**编辑分子**。

    1. 键入分子的清晰描述。

    2. 通过双击分子来定义分子 右侧字段。然后,这些组件将作为 左侧字段中的公式。通过添加数学运算符 双击左侧字段下方的图标。

      您的公式必须在数学上有效。这包括正确的 必要时使用括号。

    3. Click Done to save all changes to the numerator.

  18. Click Edit denominator .

    1. 键入分母的清晰描述。

    2. 通过双击组件中的组件来定义分母 右侧字段。然后,这些组件将作为 左侧字段中的公式。通过添加数学运算符 双击左侧字段下方的图标。

      您的公式必须在数学上有效。这包括正确的 必要时使用括号。

    3. Click Done to save all changes to the denominator.

  19. 如果适用,请选择强制性指标组集,例如 人力资源

    Note

    You'll only see indicator group sets in this form if you've created them and set them to Compulsory .

    You create indicator group sets in the Maintenance app: Indicator > Indicator group set .

  20. 点击**保存**。

创建或编辑指标组

  1. 打开** Maintenance 应用程序,然后单击 Indicator ** > ** Indicator 组**。

  2. 点击添加按钮。

  3. 输入名称。

  4. 选择指标并分配它们。

  5. 点击**保存**。

创建或编辑指标组集

指标组集创建相似指标的组合组。对于 例如,您可能有一组称为“疟疾”的指标, “利什曼病”。这两个组可以合并为一组 称为“媒介传播疾病”。指标组集用于 数据分析以结合指标的相似主题。

  1. 打开** Maintenance 应用程序,然后单击 Indicators ** > ** Indicator 组**。

  2. 点击添加按钮。

  3. 填写表格:

    1. 名称
    2. 简称
    3. 描述
    4. 必修
  4. 选择指标组并分配它们。

    可用的指示器组显示在左侧面板中。 当前是指标组成员的指标组 设置显示在右侧面板中。

  5. 点击**保存**。

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

更改元数据对象的共享设置

您可以为元数据对象分配不同的共享设置,例如 示例组织单位和跟踪的实体属性。这些分享 设置可控制哪些用户和用户组可以查看或编辑 元数据对象。

一些元数据对象还允许您更改共享设置 对象的数据输入。这些附加设置控制谁可以 使用元数据查看或在表单字段中输入数据。

注意

默认设置是所有人( 公共访问权限 )都可以找到, 查看和编辑元数据对象。

  1. Open the Maintenance app and find the type of metadata object 您要修改。

  2. In the object list, click the context menu and select Sharing 设置

  3. (可选)添加用户或用户组:搜索一个或多个用户 分组并选择它。用户或用户组已添加到列表中。

  4. 更改要修改的访问组的共享设置。

    • 可以编辑和查看 :访问组可以查看和编辑 目的。

    • 只能查看 :访问组可以查看对象。

    • 禁止访问 (仅适用于**公共访问**):公众 将无法访问该对象。

  5. 更改您要访问的访问组的数据共享设置 修改。

    • 可以捕获数据 :访问组可以查看和捕获数据 为对象。

    • 可以查看数据 :访问组可以查看以下数据: 目的。

    • 无访问权限 :访问组将无法访问以下数据: 物体。

  6. 点击**关闭**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理组织单位

在本节中,您将学习如何:

  • 创建一个新的组织单位并建立该组织单位 等级制

  • 创建组织单位组,组集并分配组织 他们的单位

  • 修改组织单位的层次结构

关于组织单位

The organisation unit hierarchy defines the organisation structure of DHIS2, for example how health facilities, administrative areas and other geographical areas are arranged with respect to each other. It is the where dimension of DHIS2, similar to how periods represent the when dimension.

组织单位层次结构是通过父子关系建立的。 在DHIS2中,每个节点都是一个组织单位。一个国家可能 例如有八个省,每个省可能有一个 地区的儿童。通常,最低级别包括 收集数据的设施。数据收集设施也可以 位于较高的级别,例如国家或省级 医院。因此,您可以在DHIS2中创建倾斜的组织树。

  • 您一次只能拥有一个组织层次结构。

  • 层次结构中可以有任意多个级别。

    通常,公共卫生中的国家组织层次结构具有 四到六个级别。

  • 您可以通过使用组织来创建其他分类 组和组织组集。

    例如,创建与 卫生保健部门。

  • 建议使用组织单位组来创建 非地理层次结构。

  • 组织单位只能是单个组织的成员 组织单位组集中的单位组。

  • 一个组织单位组可以是多个组织单位的一部分 组集。

  • 组织单位层次结构是数据的主要载体 地理维度上的汇总。

  • 当您关闭组织单位时,您无法注册或编辑 events to this organisation unit in the Event Capture and ** Tracker Capture **应用程序。

Important

You can change the organisation unit hierarchy after you've created it, even organisation units that collect data. However, DHIS2 always uses the latest hierarchy for data aggregation. So if you change the hierarchy, you loose the temporal representation of the hierarchy across time.

District A is sub-divided into District B and District C. Facilities which belonged to District A are reassigned to District B and C. Any historical data, which you entered before the split occurred, is still registered as belonging to District B and C, not to the obsolete District A.

In the Maintenance app, you manage the following organisation unit objects:

Organisation unit objects in the Maintenance app
Object type Available functions
组织单位 Create, edit, clone, delete, show details and translate
组织单位组 Create, edit, clone, share, delete, show details and translate
Organisation unit group set Create, edit, clone, share, delete, show details and translate
Organisation unit level Edit and translate
Hierarchy operations Move organisation units

工作流程

推荐的工作流程是:

  1. 创建组织单位。

  2. 创建组织单位组。

  3. 创建组织单位组集。

创建或编辑组织单位

您可以将组织单位一个或一个地添加到层次结构中 单位或作为所选组织单位的子级。你只能有 一个根单元。

  1. Open the Maintenance app and click Organisation unit > 组织单位

  2. 点击添加按钮。

  3. 选择您的新组织单位将使用的组织单位 属于:

    1. 点击**父组织单位**。

    2. 在组织单位树中,找到上级组织 单位并选择它。您的选择以黄色标记。

      Tip

      Click the arrows to expand the organisation unit tree.

    3. 点击**选择**。

  4. Enter a Name of the organisation unit.

    每个组织单位必须具有唯一的名称。

  5. Enter a Short name for the organisation unit.

    通常,简称是全称的缩写 组织单位名称。此属性通常用于报表中 显示单位单位的名称,该单位的空间有限。

  6. (可选)分配**代码**。

    在许多国家/地区,为组织单位分配了代码。

  7. (Optional) Upload a / remove the Organisation unit image

  8. (Optional) Type a Description of the organisation unit.

  9. Select an Opening date .

    开幕日期控制着一个组织中存在的组织单位 时间点,例如在分析历史数据时。

  10. If applicable, select a Closed date .

  11. In the Comment field, enter any additional information that you 要添加。

  12. (Optional) In the URL field, enter a link to an external web 具有有关组织单位的其他信息的站点。

  13. 输入联系信息:

    • 联系人

    • 地址

    • 电子邮件

    • 电话号码

  14. (Optional) Enter Latitude and Longitude .

    您必须具有经度和纬度值才能在地图中创建地图 地图**应用。然后,您的组织单位可以表示为 点在地图上,例如医疗机构。没有这个 information, the **Maps app will not work.

    以后批量导入坐标可能会更有效 job for all organisation units using the Import-Export app. You also use the Import-Export app to create polygons. A polygon is 代表行政边界的组织单位。

  15. If applicable, select Data sets and assign them.

    Note

    You control whether a user should be able to assign data sets to an organisation unit in the System Settings app:

    Open the System Settings app, click Access and select Allow assigning object to related objects during add or update .

  16. If applicable, select Programs and assign them.

    Note

    You control whether a user should be able to assign programs to an organisation unit in the System Settings app:

    Open the System Settings app, click Access and select Allow assigning object to related objects during add or update .

  17. 如果适用,输入自定义属性值,例如** HR 标识符**。

    Note

    You configure the custom attributes in the Maintenance app:

    Open the Maintenance app and click Other > Attribute .

  18. 点击**保存**。

创建或编辑组织单位组

Organisation unit groups allow you to classify related organisation units into a common theme. You can for example group all organisation units that are hospitals in an Hospital group.

  1. Open the Maintenance app and click Organisation unit > 单位部门

  2. 点击添加按钮。

  3. 填写表格:

    1. 名称 :为以下内容提供准确,唯一和描述性的名称: 组织单位组。

    2. 简称 :简称应小于25 字符。通常,简称是的缩写。 完整的单位部门名称。在某些情况下使用此属性 DHIS2中空间有限的地方。

    3. 符号 :选择将用于显示符号的符号 显示图层时的组织单位(仅点) **地图**应用。

  4. 在组织树中,单击您想要的组织单位 添加到组织单位组。

    您可以通过展开目录树来在树中找到组织单位 分支(单击箭头符号),或通过搜索 名称。

    所选组织单位显示为橙色。

  5. 点击**保存**。

创建或编辑组织单位组集

组织单位组集允许您创建其他 组织单位的分类。组集创建新 尺寸,以便您可以进行更详细的数据分析。你一个 轻松按组集中的组过滤,组织或汇总数据。

  • 您可以具有任意数量的组织单位组集。

  • 默认的组织单位组集是**类型**和 所有权

  • 组织单位只能是单个组织的成员 组织单位组集中的单位组。

  • 一个组织单位组可以是多个组织单位的一部分 组集。

  • 您可以定义组织单位组集是否是强制性的 是否会影响数据的完整性。必修 表示所有组织单位必须是该组中的成员 组集。

Note

In the Data integrity part of the Data administration app you can verify if you've accidentally assigned the same organisation unit to multiple groups within the same group set. In this app you also find information about organisation units that are not members of a compulsory organisation unit group set.

  1. Open the Maintenance app and click Organisation unit > 组织单位组集

  2. 点击添加按钮。

  3. 填写:

    1. 名称 :为组织单位组提供准确的名称 组。

    2. 说明 :说明组织单位组设置了什么 测量或捕获。

  4. 如果您希望所有组织单位成为该组中的成员 the group set, select Compulsory .

  5. (Optional) Select Data dimension .

  6. (Optional) Select Include subhierarchy in analytics .

    如果您选择此选项,则子单位部门将继承 最接近的“父级”的组织单位组属性 组织单位。子组织单位的任何财产将 覆盖继承值。

    如果单位部门没有关联的单位部门组, 组织单位可以继承其最接近的上级组织 单位组。如果上级组织单位组都没有 给定组织单位组集的组织单位组,结果 仍然是“空白”,但如果至少有一个父母有 组织单位组,子组织单位将继承它。

    在分析中包含子层次结构”已启用,这意味着组织 单位继承了最亲密的父母单位 为白色(没有与之关联的单位部门组)。

  7. 选择组织单位组并分配它们。

    在左侧列表中,找到可用的组织单位 组。使用箭头在两个组之间移动选定的组 列表。

    如果左侧列表中没有组织单位组, 点击**添加新**。在打开的表单中,创建组织 units group you need. When you're done, click Refresh values .

    Note

    An organisation unit can only be a member of a single organisation unit group within an organisation unit group set.

  8. 请点击 保存

You want to analyse data based on the ownership of the facilities. All facilities have an owner so you need to make sure that all organisation units get this classification. To do that you can use the Compulsory option:

  1. 为每种所有权类型创建一个组,例如“ MoH”,“私有” 和“基于信仰”。

  2. 将数据库中的所有设施分配给这些组之一。

  3. 创建一个名为“所有权”的组织单位组集,然后选择 必修

  4. 分配组织单位组“ MoH”,“私人”和 从“基于信仰”到“所有权”组织组 组。

通过两种方式对组织单位进行分组,并汇总这两种数据 并行层次结构

用于汇总数据(仅在分析应用程序中)

组织单位组设置的附加设置将创建一个 动态“成员资格”到组织单位组的集合。

您无需更改组织单位的层次结构

可扩展和动态

动态包含层次

动态附加分类

为组织单位级别分配名称

When you add children to an organisation unit, DHIS2 automatically creates a new organisation unit level if necessary. The system also assigns a generic name to this level, for example "Level 5". You can replace the generic name with a contextual name, for example "Country", "Province", "District" or "Health Facility". DHIS2 uses the contextual names anywhere levels are referred to, for example in the Maps app.

  1. Open the Maintenance app and click Organisation unit > 组织单位级别

    列表的加载时间取决于列表的深度 组织单位层次结构树。

  2. 对于要修改的组织单位级别,输入名称。

  3. 选择离线级别的数量。

    Note

    You configure the default value in the System Settings app:

    Open the System Settings app, click General and select a level in the Max offline organisation unit levels list.

  4. 点击**保存**。

在层次结构中移动组织单位

您可以通过以下方式在层次结构中移动组织单位: 所选组织单位的父级。

  1. Open the Maintenance app and click Organisation unit > 等级操作

  2. 在左侧的层次结构树中,选择您要使用的组织单位 想搬家。

    Note

    If the selected organisation unit is has sub-organisation units, all of them move to the new parent organisation unit.

  3. 在右侧的层次结构树中,选择您要使用的组织单位 想要将选定的组织单位移动到。

  4. Click Move x organisation units , where x stands for the number 您选择的组织单位数。

    您的更改将立即反映在左侧 层次树。

关闭组织单位

When you close an organisation unit, you can't register or edit events to this organisation unit in the Event Capture and Tracker Capture apps.

  1. Open the Maintenance app and click Organisation unit > 组织单位

  2. In the object list, click the options menu and select Edit .

  3. Select a Closed date .

  4. 点击**保存**。

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

更改元数据对象的共享设置

您可以为元数据对象分配不同的共享设置,例如 示例组织单位和跟踪的实体属性。这些分享 设置可控制哪些用户和用户组可以查看或编辑 元数据对象。

一些元数据对象还允许您更改共享设置 对象的数据输入。这些附加设置控制谁可以 使用元数据查看或在表单字段中输入数据。

注意

默认设置是所有人( 公共访问权限 )都可以找到, 查看和编辑元数据对象。

  1. Open the Maintenance app and find the type of metadata object 您要修改。

  2. In the object list, click the context menu and select Sharing 设置

  3. (可选)添加用户或用户组:搜索一个或多个用户 分组并选择它。用户或用户组已添加到列表中。

  4. 更改要修改的访问组的共享设置。

    • 可以编辑和查看 :访问组可以查看和编辑 目的。

    • 只能查看 :访问组可以查看对象。

    • 禁止访问 (仅适用于**公共访问**):公众 将无法访问该对象。

  5. 更改您要访问的访问组的数据共享设置 修改。

    • 可以捕获数据 :访问组可以查看和捕获数据 为对象。

    • 可以查看数据 :访问组可以查看以下数据: 目的。

    • 无访问权限 :访问组将无法访问以下数据: 物体。

  6. 点击**关闭**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

Manage validation rules

关于验证规则

验证规则基于表达式。该表达式定义了一个 数据元素值之间的关系。该表达式形成一个 条件符合某些逻辑条件。

该表达式包括:

  • 左侧

  • 右边

  • 操作员

验证规则断言所接种的疫苗总数 婴儿小于或等于婴儿总数。

左侧和右侧必须返回数字值。

In the Maintenance app, you manage the following validation rule objects:

Object type What you can do
Validation rule Create, edit, clone, delete, show details, and translate
Validation rule group Create, edit, clone, delete, share, show details, and translate
Validation notification Create, edit, clone, delete, show details, and translate

关于推拉窗

You can use sliding windows to group data across multiple periods as opposed to selecting data for a single period . Sliding windows have a size, that is to say, the number of days to cover, a starting point and an end point. The example below shows disease surveillance data:.

  • 橙色部分中的数据,根据当前数据选择数据 期。有一个阈值,每周计算一次 或期间,并显示在“结果”部分中。

  • 蓝色部分中的数据是滑动窗口。它选择数据 从过去7天开始。 “结果”显示了总数 确诊病例。

  • 验证规则可确保在总数达到 案例数超出了该时间段的阈值。

Different behaviour of validation rules
With sliding windows Without sliding windows
Used only for event data. Used for event data and aggregate data.
Data selection is based on a fixed number of days (periodType). Data selection is always based on a period.
The position of the sliding window is always relative to the period being compared. Data is always selected for the same period as the period being compared.

另请参阅:[创建或编辑广告时,如何使用滑动窗口 验证 规则]( https://docs.dhis2.org/master/en/user/html/manage_validation_rule.html#create_validation_rule )。

关于验证规则组

验证规则组使您可以对相关的验证规则进行分组。 当您运行* [验证规则 分析]( https://docs.dhis2.org/master/zh/user/html/validation_rule_analysis.html )*, 您可以选择运行系统中的所有验证规则,或者 只是一组验证规则。

关于验证通知

You can configure a validation rule analysis to automatically send notifications about validation errors to selected user groups. These messages are called validation notifications . They are sent via the internal DHIS2 messaging system.

您可以将验证规则通知作为单独的消息或作为 消息摘要。这很有用,例如,如果您要发送 有关高优先级疾病暴发的个别消息和摘要 用于低优先级常规数据验证错误。

About validation rule functions

You can use the following functions in a validation rule left side or right side:

Validation Rule functions
Validation Rule Function Arguments 描述
如果 (boolean-expr, true-expr, false-expr) Evaluates the boolean expression and if true returns the true expression value, if false returns the false expression value. The arguments must follow the rules for any indicator expression.
一片空白 (element) Returns true if the element value is missing (null), otherwise false.
isNotNull (element) Returns true if the element value is not missing (not null), otherwise false.
firstNonNull (element [, element ...]) Returns the value of the first element that is not missing (not null). Can be provided any number of arguments. Any argument may also be a numeric or string literal, which will be returned if all the previous objects have missing values.
最伟大的 (expression [, expression ...]) Returns the greatest (highest) value of the expressions given. Can be provided any number of arguments.
最小 (expression [, expression ...]) Returns the least (lowest) value of the expressions given. Can be provided any number of arguments.
log (expression [, base ]) Returns the natural logarithm (base e) of the numeric expression. If an integer is given as a second argument, returns the logarithm using that base.
log10 (expression) Returns the common logarithm (base 10) of the numeric expression.
null Returns no result. For example, if( #{FH8ab5Rog83}<0, null, 1 ) returns nothing if the data element value is less than 0, otherwise 1.
orgUnit.ancestor (orgUnitUid [, orgUnitUid ...]) Returns true if the organisation unit is a descendant of any of the (1 or more) organisation units, otherwise false.
orgUnit.dataSet (dataSetUid [, dataSetUid ...]) Returns true if the organisation unit is assigned to any of the (1 or more) data sets, otherwise false.
orgUnit.group (ouGroupUid [, ouGroupUid ...]) Returns true if the organisation unit is a member of any of the (1 or more) organisation unit groups, otherwise false.
orgUnit.program (programUid [, programUid ...]) Returns true if the organisation unit is assigned to any of the (1 or more) programs, otherwise false.
removeZeros (expression) Returns nothing if the expression value is 0, otherwise returns the expression value.

创建或编辑验证规则

  1. Open the Maintenance app and click Validation > 验证规则

  2. 点击添加按钮。

  3. Type a Name .

    在验证规则中,名称必须唯一。

  4. (可选)在 Code 字段中,分配一个代码。

  5. (可选)输入**说明**。

  6. 选择**重要性**: 中**或**低

  7. Select a Period type .

  8. 选择一个**操作员**: 必填项 等于 独家配对 大于 大于或等于 或**不等于**。

    **必填对**运算符允许要求该数据值 必须为表格的左侧和右侧输入表格 表情,还是双方都没有。这意味着您可以要求 如果填写表单中的一个字段,则一个或多个其他字段 还必须填写。

    **独占对**可以断言是否存在任何值 左侧,则右侧应没有值(或 反之亦然)。这意味着构成规则的数据元素 任何一方都应相互排斥,因为 给定的时间段/组织单位/属性选项组合。

  9. 创建表达式的左侧:

    1. Click Left side .

    2. Select Sliding window if you want to view data relative to 您比较的时期。另请参见[关于验证 规则]( https://docs.dhis2.org/master/zh/user/html/manage_validation_rule.html#about_validation_rule )。

    3. Select a Missing value strategy . This selection sets how the 如果数据丢失,系统将评估验证规则。

      Option Description
      Skip if any value is missing The validation rule will be skipped if any of the values which compose the expression are missing. This is the default option.

      Always select this option you use the Exclusive pair or Compulsory pair operator.
      Skip if all values are missing The validation rule will be skipped only if all of the operands which compose it are missing.
      Never skip The validation rule will never be skipped in case of missing data, and all missing operands will be treated effectively as a zero.
    4. Type a Description .

    5. Build an expression based on the available data elements, program objects, organisation units, counts and constants.

      In the right pane, double-click the data objects you want to include in the expression. Combine with the mathematical operators located below the left pane.

    6. Click Save .

  10. 创建表达式的右侧:

    1. Click Right side .

    2. Select a Missing value strategy . This selection sets how the 如果数据丢失,系统将评估验证规则。

      Option Description
      Skip if any value is missing The validation rule will be skipped if any of the values which compose the expression are missing. This is the default option.

      Always select this option you use the Exclusive pair or Compulsory pair operator.
      Skip if all values are missing The validation rule will be skipped only if all of the operands which compose it are missing.
      Never skip The validation rule will never be skipped in case of missing data, and all missing operands will be treated effectively as a zero.
    3. Select Sliding window if you want to view data relative to the period you are comparing. See also About validation rules .

    4. Type a Description .

    5. Build an expression based on the available data elements, program objects, organisation units, counts and constants.

      In the right pane, double-click the data objects you want to include in the expression. Combine with the mathematical operators located below the left pane.

    6. Click Save .

  11. (Optional) Choose which Organisation unit levels this rule 应该进行评估。将此留空将导致 要在所有级别上评估的验证规则。

  12. (Optional) Click Skip this rule during form validation to avoid 进行数据输入时触发此规则

  13. 点击**保存**。

创建或编辑验证规则组

  1. Open the Maintenance app and click Validation > 验证规则组

  2. 点击添加按钮。

  3. Type a Name .

  4. (可选)在 Code 字段中,分配一个代码。

  5. (可选)输入**说明**。

  6. Double-click the Validation rules you want to assign to the 组。

  7. 点击**保存**。

创建或编辑验证通知

  1. Open the Maintenance app and click Validation > 验证通知

  2. 点击添加按钮。

  3. Type a Name .

  4. (可选)在 Code 字段中,分配一个代码。

  5. Select Validation rules .

  6. Select Recipient user groups .

  7. (Optional) Select Notify users in hierarchy only .

    如果选择此选项,系统将过滤收件人 用户。 (系统从收件人那里获取收件人用户 用户组。)过滤器基于 收件人用户所属。链接到组织单位的用户 是违规组织单位的祖先 发生后将收到验证通知。系统将 忽略其他用户,这些用户将不会收到验证 通知。

  8. 创建消息模板:

    1. 创建**主题模板**。

      Double-click the parameters in the Template variables field 将它们添加到您的主题。

    2. 创建**消息模板**。

      Double-click the parameter names in the Template variables 字段以将其添加到您的消息中。

  9. 点击**保存**。

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

更改元数据对象的共享设置

您可以为元数据对象分配不同的共享设置,例如 示例组织单位和跟踪的实体属性。这些分享 设置可控制哪些用户和用户组可以查看或编辑 元数据对象。

一些元数据对象还允许您更改共享设置 对象的数据输入。这些附加设置控制谁可以 使用元数据查看或在表单字段中输入数据。

注意

默认设置是所有人( 公共访问权限 )都可以找到, 查看和编辑元数据对象。

  1. Open the Maintenance app and find the type of metadata object 您要修改。

  2. In the object list, click the context menu and select Sharing 设置

  3. (可选)添加用户或用户组:搜索一个或多个用户 分组并选择它。用户或用户组已添加到列表中。

  4. 更改要修改的访问组的共享设置。

    • 可以编辑和查看 :访问组可以查看和编辑 目的。

    • 只能查看 :访问组可以查看对象。

    • 禁止访问 (仅适用于**公共访问**):公众 将无法访问该对象。

  5. 更改您要访问的访问组的数据共享设置 修改。

    • 可以捕获数据 :访问组可以查看和捕获数据 为对象。

    • 可以查看数据 :访问组可以查看以下数据: 目的。

    • 无访问权限 :访问组将无法访问以下数据: 物体。

  6. 点击**关闭**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理属性

关于属性

您可以使用元数据属性将其他信息添加到 元数据对象。除了每个标准属性 这些对象可能有助于存储其他信息 属性,例如数据元素的收集方法。

In the Maintenance app, you manage the following attribute objects:

Attribute objects in the Maintenance app
Object type Available functions
属性 Create, edit, clone, delete, show details and translate

创建或编辑属性

  1. 打开**维护**应用程序并点击**属性**。

  2. 点击添加按钮。

  3. 名称 字段中,输入属性的名称。

    每个属性必须具有唯一的名称

  4. (可选)在 Code 字段中,分配一个代码。

  5. 选择**值类型**。

    如果为属性提供的值与该值不匹配 键入您将收到警告。

  6. Select an Option set .

  7. 选择所需的选项,例如:

    • Select Mandatory if you want an object to always have the 动态属性。

    • Select Unique if you want the system to enforce that values 对于特定的对象类型是唯一的。

  8. 点击**保存**。

    动态属性现在可用于您分配的对象 它来。

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理常数

关于常数

常量是可以供用户使用的静态值 在数据元素和指标中。一些指标,例如“夫妇年 保护率”取决于通常不会转换的常数 时间。

维护 应用程序中,您管理以下常量对象:

Constant objects in the Maintenance app
Object type Available functions
不变 Create, edit, clone, share, delete, show details and translate

创建或编辑常量

  1. Open the Maintenance app and click Other > Constant .

  2. 点击添加按钮。

  3. 名称 字段中,输入常量的名称。

  4. (Optional) In the Short name field, type an abbreviated name of 常数。

  5. (可选)在 Code 字段中,分配一个代码。

  6. In the Description field, type a brief, informative description 常数。

  7. 字段中,定义常量的值。

  8. 点击**保存**。

    现在可以使用该常数。

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

更改元数据对象的共享设置

您可以为元数据对象分配不同的共享设置,例如 示例组织单位和跟踪的实体属性。这些分享 设置可控制哪些用户和用户组可以查看或编辑 元数据对象。

一些元数据对象还允许您更改共享设置 对象的数据输入。这些附加设置控制谁可以 使用元数据查看或在表单字段中输入数据。

注意

默认设置是所有人( 公共访问权限 )都可以找到, 查看和编辑元数据对象。

  1. Open the Maintenance app and find the type of metadata object 您要修改。

  2. In the object list, click the context menu and select Sharing 设置

  3. (可选)添加用户或用户组:搜索一个或多个用户 分组并选择它。用户或用户组已添加到列表中。

  4. 更改要修改的访问组的共享设置。

    • 可以编辑和查看 :访问组可以查看和编辑 目的。

    • 只能查看 :访问组可以查看对象。

    • 禁止访问 (仅适用于**公共访问**):公众 将无法访问该对象。

  5. 更改您要访问的访问组的数据共享设置 修改。

    • 可以捕获数据 :访问组可以查看和捕获数据 为对象。

    • 可以查看数据 :访问组可以查看以下数据: 目的。

    • 无访问权限 :访问组将无法访问以下数据: 物体。

  6. 点击**关闭**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理选项集

关于选项集

选项集提供了一个预定义的下拉列表(枚举),用于 DHIS2。您可以定义任何类型的选项。

一个名为“投放类型”的选项集将具有以下选项:“普通”, “违反”,“剖腹产”和“协助”。

Option set objects in the Maintenance app
Object type Available functions
Option set Create, edit, clone, share, delete, show details and translate
选项组 Create, edit, clone, share, delete, show details and translate
Option group set Create, edit, clone, share, delete, show details and translate

创建或编辑选项集

重要

选项集必须具有代码和名称。您可以更改 名称,但是您无法更改代码。所有的名称和代码 选项即使在不同的选项集之间也必须是唯一的。

  1. Open the Maintenance app and click Other > Option set .

  2. 点击添加按钮。

  3. In the Primary details tab, define the option set:

    1. 名称 字段中,输入常量的名称。

    2. In the Code field, assign a code.

    3. 选择**值类型**。

    4. 点击**保存**。

  4. 对于您需要的每个选项,执行以下任务:

    1. Click the Options tab.

    2. 点击添加按钮。

    3. Type a Name and a Code . Optionally also select a **颜色**和**图标**将用于此选项 数据捕获应用程序。

    4. 按名称,代码/值或手动对选项进行排序。

    5. 点击**保存**。

创建或编辑选项组

You can group and classify options within an option set by using option groups . This way you can create a subset of options in an option set. The main purpose of this is to be able to filter huge option sets into smaller, related parts.

可以通过程序规则在跟踪器和事件捕获中将分组的选项隐藏或一起显示。

Note

You cannot change the Option set selected in an Option group once it has been created.

  1. Open the Maintenance app and click Other > Option group .

  2. 点击添加按钮。

  3. 填写表格:

    1. 名称
    2. 简称
    3. 选项集
  4. 选择**选项集**后,您可以分配要分组的**选项**。

  5. 点击**保存**。

创建或编辑选项组集

**选项组集**允许您将多个**选项组**归为一组。 选项组集的主要目的是为捕获的数据添加更多维度以进行分析。

Note

You cannot change the Option set selected in an Option group set once it has been created.

  1. 打开** Maintenance 应用程序,然后单击 Other ** > ** Option group set **。

  2. 点击添加按钮。

  3. 填写表格:

    1. 名称
    2. 描述
    3. 选项集
    4. 数据尺寸

      If you select Data dimension , the group set will be available to the analytics as another dimension, in addition to the standard dimensions of “Period” and “Organisation unit”.

  4. 选择选项组并分配它们。

可用选项组显示在左面板中。当前为选项组集成员的选项组显示在右侧面板中。

  1. 点击**保存**。

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

更改元数据对象的共享设置

您可以为元数据对象分配不同的共享设置,例如 示例组织单位和跟踪的实体属性。这些分享 设置可控制哪些用户和用户组可以查看或编辑 元数据对象。

一些元数据对象还允许您更改共享设置 对象的数据输入。这些附加设置控制谁可以 使用元数据查看或在表单字段中输入数据。

注意

默认设置是所有人( 公共访问权限 )都可以找到, 查看和编辑元数据对象。

  1. Open the Maintenance app and find the type of metadata object 您要修改。

  2. In the object list, click the context menu and select Sharing 设置

  3. (可选)添加用户或用户组:搜索一个或多个用户 分组并选择它。用户或用户组已添加到列表中。

  4. 更改要修改的访问组的共享设置。

    • 可以编辑和查看 :访问组可以查看和编辑 目的。

    • 只能查看 :访问组可以查看对象。

    • 禁止访问 (仅适用于**公共访问**):公众 将无法访问该对象。

  5. 更改您要访问的访问组的数据共享设置 修改。

    • 可以捕获数据 :访问组可以查看和捕获数据 为对象。

    • 可以查看数据 :访问组可以查看以下数据: 目的。

    • 无访问权限 :访问组将无法访问以下数据: 物体。

  6. 点击**关闭**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理图例

关于传说

您可以创建,编辑,克隆,删除,显示详细信息和翻译图例 使您为用户设置的地图有意义。您创建 **地图**应用中的地图。

注意

连续图例必须包含结束和开始的图例项 具有相同值,例如:0-50和50-80。不设置图例 像这样的项目:0-50和51-80。这将在您的图例中造成空白。

创建或编辑图例

注意

不允许在图例中留有空白。

不允许有重复的图例项。

  1. 打开** Maintenance 应用程序,然后单击 Other ** > ** Legend **。

  2. 点击添加按钮。

  3. In the Name field, type the legend name.

  4. (可选)在 Code 字段中,分配一个代码。

  5. 创建您想在图例中包含的图例项:

    1. 选择**起始值**和**结束值**。

    2. Select Number of legend items .

    3. 选择一种配色方案。

    4. 点击**创建图例项**。

    Tip

    Click the options menu to edit or delete a legend item.

  6. (可选)添加更多图例项:

    1. 点击添加按钮。

    2. 输入名称,然后选择一个开始值,一个结束值和一种颜色。

    3. 点击**确定**。

  7. (可选)更改色阶。

    1. 单击色阶以查看色阶选项列表, 并选择一个色标。

    2. 要自定义色标,请单击添加按钮。在**编辑 图例项**对话框,单击色阶按钮并手动选择 颜色,或输入您的颜色值。

  8. 点击**保存**。

图例项 Start value End value
Low bad 0 50
50 80
High good 80 100
Too high 100 1000

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

更改元数据对象的共享设置

您可以为元数据对象分配不同的共享设置,例如 示例组织单位和跟踪的实体属性。这些分享 设置可控制哪些用户和用户组可以查看或编辑 元数据对象。

一些元数据对象还允许您更改共享设置 对象的数据输入。这些附加设置控制谁可以 使用元数据查看或在表单字段中输入数据。

注意

默认设置是所有人( 公共访问权限 )都可以找到, 查看和编辑元数据对象。

  1. Open the Maintenance app and find the type of metadata object 您要修改。

  2. In the object list, click the context menu and select Sharing 设置

  3. (可选)添加用户或用户组:搜索一个或多个用户 分组并选择它。用户或用户组已添加到列表中。

  4. 更改要修改的访问组的共享设置。

    • 可以编辑和查看 :访问组可以查看和编辑 目的。

    • 只能查看 :访问组可以查看对象。

    • 禁止访问 (仅适用于**公共访问**):公众 将无法访问该对象。

  5. 更改您要访问的访问组的数据共享设置 修改。

    • 可以捕获数据 :访问组可以查看和捕获数据 为对象。

    • 可以查看数据 :访问组可以查看以下数据: 目的。

    • 无访问权限 :访问组将无法访问以下数据: 物体。

  6. 点击**关闭**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

将图例分配给指标或数据元素

You can assign a legend to an indicator or a data element in the Maintenance app, either when you create the object or edit it. When you then select the indicator or data element in the Maps app, the system automatically selects the assigned legend.

也可以看看

管理预测变量

关于预测变量

预测变量定义如何从表达式生成聚合数据值 包含汇总和/或事件数据。预测值可以基于:

  • 来自与预测值相同时期的数据,和/或

  • 来自预测值之前期间的数据

同期数据

预测器可以使用与预测值相同周期的数据。 例如,您可以计算具有 通过使用预测器表达式,例如:数据元素的非零值:

  if(#{ji7o0ILHuU2}!= 0,1,0) 

When you run this predictor at the organisation unit level where the data is collected, it will store 1 as the predicted value if the data element has a nonzero value for that organisation unit, otherwise 0. (If the data element that you predict into does not store zeros, then zeros will not be stored in the database, to save space.) You can then sum this predicted value in analytics at a higher organisation unit level, to count the number of organisation units with a nonzero value that are under each organisation unit in the report.

前期数据

当您指定汇总时,预测变量将使用以前期间的数据 函数,例如sum()或avg()。例如,以下生成器表达式 标识一个值,该值是平均值加上标准偏差的两倍 前期数据:

  avg(#{ji7o0ILHuU2})+ 2 * stddev(#{ji7o0ILHuU2}) 

上一时期的数据

预测变量表达式可以访问与 通过访问两个 汇总函数(针对先前期间),以及任何汇总函数之外 (同一时期)。例如,如下所示的表达式可以是 用来平衡上一时期(#{KOh02hHko7C}) 加上此期间的净变化(#{ji7o0ILHuU2}), 得出此期间的余额:

  sum(#{KOh02hHko7C})+#{ji7o0ILHuU2}  

第一个数据值在聚合表达式(总和)内,以指示 它正在采样前一时期的数据(即使只有一个前一时期), 而第二个数据值不在聚合函数中以表明它 正在引用同一时期的数据。

如果需要,可以在同一引用中引用预测变量的输出数据元素 预测变量的表达。例如,此示例中的表达式可以 用于预测一段时间内的余额,然后将该值与 下一个期间的变化以计算下一个期间的余额。 当预测变量跨多个期间运行时,将在以下期间处理这些期间 按时间顺序排列,可以使用较早时期的结果 作为以后的输入。

预测器组织单位级别

您需要为预测变量的输出选择一个或多个组织单位级别。 预测变量生成的所有值都存储在组织单位的 您选择的级别。预测变量表达式中的每个项目都是值的总和 为该组织单位存储的信息(如果有的话)以及组织中存储的所有值 低于该单位(如果有)的单位。

注意

在配置预测变量时,必须选择一个或多个组织单位级别 将输出预测数据。如果未选择任何级别,则不会预测 将生成值。

警告

如果您想在分析报告中使用预测值或 其他预测, 请勿选择多个组织单位级别 。 当您选择多个级别时,较高级别的预测将 还包括在较低级别的预测中使用的任何数据。如果预测 随后从多个级别将其用于分析或表达式中 其他预测变量,这可能会导致重复计算,因为 较高级别的值包括较低级别的预测值。

如果使用预测的组织单位级别,则可以选择多个组织单位级别 值仅在验证规则中。例如在疾病监测中,您 如果实际值高于 根据上一期间数据得出的该期间的期望值范围。 为此,您可以创建一个预测变量以计算平均值加上两倍的 前期数据的标准偏差。您可以使用验证 将该最高期望值与实际值进行比较的规则。 您可以在多个级别上运行预测变量和验证规则 以检测不同的爆发情况。在一种情况下,可能会有 一个设施的显着增加超出了预期范围,但是 包含该设施的地区可能不会超出其预期范围 因为地区价值与许多其他设施结合在一起。 但在另一种情况下, 设施不超出每个设施的预期范围(因为 每个设施的标准偏差可能很高),但确实超过了 该地区的预期范围(因为 整个地区的标准偏差可能会更低)。

如果要生成多个级别的预测,则还可以 在不同级别使用不同的预测变量。例如,您可能想要 如果某一级别的值超过平均值再加上标准的两倍,则会收到警报 偏差,但如果超出平均值加1.8倍,则会在另一个级别发出警报 标准偏差。如果需要,可以配置不同的预测变量 具有相同的输出数据元素。如果您使用相同的输出数据元素, 这仍然适用于不同组织单位级别的有效规则, 但您也必须注意不要在分析或其他结果中使用结果 预测器计算以避免重复计算。

In the Maintenance app, you manage the following predictor objects:

Predictor objects in the Maintenance app
Object type Available functions
预测变量 Create, edit, clone, delete, show details and translate

抽样前期

预测变量可以生成过去一段时间的数据值, 现在或将来。这些值基于预测期间的数据, 和/或来自预测时期之前的时期的采样数据。

如果您只需要进行预测的同一时期的数据, 那么您无需阅读本节。本节介绍如何 从预测周期之前的周期中采样数据。

顺序样本计数

A predictor's Sequential sample count gives the number of immediate previous periods to sample. For example, if a predictor's period type is Weekly and the Sequential sample count is 4, this means to sample four previous weeks immediately preceding the predicted value week. So the predicted value for week 9 would use samples from weeks 5, 6, 7, and 8:

如果预测变量的周期类型是* Monthly Sequential sample count *为4,这意味着立即采样前四个月 在预测值月份之前。所以五月的预测值 将使用一月,二月,三月和四月的样本:

The Sequential sample count can be greater than the number of periods in a year. For example, if you want to sample the 24 months immediately preceding the predicted value month, set the Sequential sample count to 24:

顺序跳过计数

A predictor's Sequential skip count tells how many periods should be skipped immediately previous to the predicted value period, within the Sequential sample count . This could be used, for instance, in outbreak detection to skip one or more immediately preceding samples that might in fact contain values from the beginning of an outbreak that you are trying to detect.

For example, if the Sequential sample count is 4, but the Sequential skip count is 2, then the two samples immediately preceding the predicted period will be skipped, resulting in only two periods being sampled:

年度样本数

A predictor's Annual sample count gives the number of previous years for which samples should be collected at the same time of year. This could be used, for instance, for disease surveillance in cases where the expected incidence of the disease varies during the year and can best be compared with the same relative period in previous years. For example, if the Annual sample count is 2 (and the Sequential sample count is zero), then samples would be collected from periods in the immediately preceding two years, at the same time of year.

顺序和年度样本计数一起

You can use the sequential and annual sample counts together to collect samples from a number of sequential periods over a number of past years. When you do this, samples will be collected in previous years during the period at the same time of year as the predicted value period, and also in previous years both before and after the same time of year, as determined by the Sequential sample count number.

For example, if the Sequential sample count is 4 and the Annual sample count is 2, samples will be collected from the 4 periods immediately preceding the predicted value period. In addition samples will be collected in the previous 2 years for the corresponding period, as well as 4 periods on either side:

顺序,年度和跳过样本计数一起

You can use the Sequential skip count together with the sequential and annual sample counts. When you do this, the Sequential skip count tells how many periods to skip in the same year as the predicted value period. For example, if the Sequential sample count is 4 and the Sequential skip count is 2, then the two periods immediately preceding the predicted value period period will be skipped, but the two periods before that will be sampled:

If the Sequential skip count is equal to or greater than the Sequential sample count , then no samples will be collected for the year containing the predicted value period; only periods from past years will be sampled:

样品跳过测试

您可以使用* Sample skip test *(样本跳过测试)来跳过某些时段的样本 根据测试结果, 在那些时期内表达。例如,可以在 疾病暴发检测,样本跳过测试可以识别 以前的疾病暴发,将那些样本从预测中排除 非爆发基准期望值。

  • Sample skip test *是一个应返回值的表达式 是或否,表示是否应跳过该时间段。 它可以是一个测试上一时期中任何数据值的表达式。 例如,它可以测试是否有明确输入的数据值 表示应跳过上一个期间。或者可以 将一段时间内的先前预测值与实际值进行比较 记录该时间段,以确定是否应跳过该时间段。

*样本跳过测试*为*真*的任何时期都不会 采样。例如:

创建或编辑预测变量

  1. 打开** Maintenance 应用程序,然后单击 Other ** > ** Predictor **。

  2. 点击添加按钮。

  3. In the Name field, type the predictor name.

  4. (可选)在 Code 字段中,分配一个代码。

  5. (可选)输入**说明**。

  6. Select an Output data element . Values generated by this 预测变量存储为与此数据关联的聚合数据 元素和预测周期。

    该值根据数据的值类型四舍五入 元素:如果值类型是整数类型,则预测值 舍入到最接近的整数。对于所有其他值类型, 数字四舍五入到四位有效数字。 (但是,如果有 小数点左边多于四位数,它们不是 替换为零。)

  7. (Optional) Select an Output category combo . This dropdown will only show 如果所选数据元素已附加categoryCombos。如果这是 在这种情况下,您可以选择要使用的类别组合。

  8. Select a Period type .

  9. Assign one or more organisation unit levels . The output value will be 分配给此级别(或这些级别)的组织单位。 For aggregate data, the input values depends on the selection below; organisation units providing data . For tracker based data, the input values will come from the organisation unit to which the 分配了输出,或从输出下方的任何较低级别进行分配 组织单位。

  10. Organisation units providing data controls where the input values comes from for aggregate data. If "at selected levels only", only organisation units at the selected levels are included. If "At selected levels and all levels below" is selected, organisation units at the selected level(s) and all organisation units below are also included.

  11. 创建一个**生成器**。生成器是用于计算预测值的表达式。

    1. Type a Description of the generator expression.

    2. Select a Missing value strategy . This selection sets how the system evaluates a validation rule if data is missing.

      选项 说明
      Skip if any value is missing The validation rule will be skipped if any of the values which compose the expression are missing. This is the default option.

      Always select this option you use the Exclusive pair or Compulsory pair operator.
      如果所有值均缺失,则跳过 仅当组成该值的所有值均缺失时,才跳过验证规则。
      永不跳过 如果缺少数据,将永远不会跳过验证规则,并且所有缺失值都将被有效地视为零。
    3. 输入生成器表达式。您可以通过选择聚合数据的数据元素或程序数据元素,属性或指标来构建表达式。尚不支持组织单位计数。

      要使用过去的采样数据,应将选择的所有项目包含在以下聚合函数之一中(请注意,这些函数名区分大小写):

      Aggregate function Means
      avg(x) Average (mean) value of x
      count(x) Count of the values of x
      max(x) Maximum value of x
      median(x) Median value of x
      min(x) Minimum value of x
      percentileCont(p, x) Continuous percentile of x, where p is the percentile as a floating point number between 0 and 1. For example, p = 0 will return the lowest value, p = 0.5 will return the median, p = 0.75 will return the 75 th percentile, p = 1 will return the highest value, etc. Continuous means that the value will be interpolated if necessary. For example, percentileCont( 0.5, #{FTRrcoaog83} ) will return 2.5 if the sampled values of data element FTRrcoaog83 are 1, 2, 3, and 4.
      stddev(x) Standard deviation of x. This function is eqivalent to stddevSamp. It's suggested that you use the function stddevSamp instead for greater clarity.
      stddevPop(x) Population standard deviation of x: sqrt( sum( (x - avg(x))^2 ) / n )
      stddevSamp(x) x 的样本标准差:sqrt( sum( (x - avg(x))^2 ) / ( n - 1 ) )。请注意,当只有一个样本时不会计算此值。
      sum(x) Sum of the values of x

      Note

      Any items inside an aggregate function will be evaluated for all sampled past periods, and then combined according to the formula inside the aggregate function. Any items outside an aggregate function will be evaluated for the period in which the prediction is being made.

      您可以通过单击(或 输入)表达式字段下方的任何元素: () * / +-天数。 可以通过键入常数来添加常数。那些日子 选项将 [days ]插入到解析为 数据来源期间的天数。

      您还可以在您的计算机中使用以下非聚合函数 表达式,在聚合函数内部或包含 聚合函数,或独立于聚合函数:

      Function Means
      if(test, valueIfTrue, valueIfFalse) Evaluates test which is an expression that evaluates to a boolean value -- see Boolean expression notes below. If the test is true , returns the valueIfTrue expression. If it is false , returns the valueIfFalse expression.
      isNull(item) Returns the boolean value true if the item is null (missing), otherwise returns false . The item can be any selected item from the right (data element, program data element, etc.).
      isNotNull(item) Returns true if the item value is not missing (not null), otherwise false .
      firstNonNull(item [, item ...]) Returns the value of the first item that is not missing (not null). Can be provided any number of arguments. Any argument may also be a numeric or string literal, which will be returned if all the previous items have missing values.
      greatest(expression [, expression ...]) Returns the greatest (highest) value of the expressions given. Can be provided any number of arguments.
      least(expression [, expression ...]) Returns the least (lowest) value of the expressions given. Can be provided any number of arguments.
      log(expression [, base ]) Returns the natural logarithm (base e) of the numeric expression. If an integer is given as a second argument, returns the logarithm using that base.
      log10(expression) Returns the common logarithm (base 10) of the numeric expression.
      null Returns no result. For example, if( #{FH8ab5Rog83}<0, null, 1 ) returns nothing if the data element value is less than 0, otherwise 1.
      orgUnit.ancestor(orgUnitUid [, orgUnitUid ...]) Returns true if the organisation unit is a descendant of any of the (1 or more) organisation units, otherwise false.
      orgUnit.dataSet(dataSetUid [, dataSetUid ...]) Returns true if the organisation unit is assigned to any of the (1 or more) data sets, otherwise false.
      orgUnit.group(ouGroupUid [, ouGroupUid ...]) Returns true if the organisation unit is a member of any of the (1 or more) organisation unit groups, otherwise false.
      orgUnit.program(programUid [, programUid ...]) Returns true if the organisation unit is assigned to any of the (1 or more) programs, otherwise false.
      removeZeros(expression) Returns nothing if the expression value is 0, otherwise returns the expression value.
      .maxDate(yyyy-mm-dd) For a data element (not program data), value from periods ending on or before a maximum date.
      .minDate(yyyy-mm-dd) For a data element (not program data), value from periods starting on or after a minimum date.

      Boolean expression notes: A boolean expression must evaluate to true or false . The following operators may be used to compare two values resulting in a boolean expression: \<, >, !=, ==, >=, and \<=. The following operators may be used to combine two boolean expressions: && (logical and), and || (logical or). The unary operator ! may be used to negate a boolean expression.

      Generator expression examples:

      Generator expression Means
      sum(#{FTRrcoaog83.tMwM3ZBd7BN}) Sum of the sampled values of data element FTRrcoaog83 and category option combination (disaggregation) tMwM3ZBd7BN
      avg(I{GSae40Fyppf}) + 2 * stddevSamp(I{GSae40Fyppf}) Average of the sampled values of of program indicator GSae40Fyppf plus twice its sample standard deviation
      sum(D{IpHINAT79UW.eMyVanycQSC}) / sum([days]) Sum of all sampled values of data element eMyVanycQSC from porgram IpHINAT79UW divided by the number of days in all sample periods (resulting in the overall average daily value)
      sum(#{FTRrcoaog83}) + #{T7OyqQpUpNd} Sum of all sampled values of data element FTRrcoaog83 plus the value of data element T7OyqQpUpNd in the period being predicted for (includes all disaggregations)
      1.2 * A{IpHINAT79UW.RKLKz1H20EE} 1.2 times the value of attribute RKLKz1H20EE of program IpHINAT79UW, in the period being predicted for
      if(isNull(#{T7OyqQpUpNd}), 0, 1) If the data element T7OyqQpUpNd is null in the period being predicted, then 0, otherwise 1.
      percentileCont(0.5, #{T7OyqQpUpNd}) Continuous 50 th percentile of the sampled values for data element T7OyqQpUpNd. Note that this is the same as median(#{T7OyqQpUpNd})
      if(count(#{T7OyqQpUpNd}) == 1, 0, stddevSamp(#{T7OyqQpUpNd})) If there is one sample value present for data element T7OyqQpUpNd, then 0, otherwise the sample standard deviation of these sample values. (Note that if no samples are present then the stddevSamp returns no value, so no value is predicted.)
      #{T7OyqQpUpNd}.minDate(2022-10-1) Value on or after 1-Oct-2022
      #{T7OyqQpUpNd}.maxDate(2022-12-31) Value on or before 31-Dec-2022
      #{T7OyqQpUpNd}.minDate(2022-10-1).maxDate(2022-12-31) Value bewteen 1-Oct-2022 and 31-Dec-2022
  12. (Optional) Create a Sample skip test . The sample skip test tells 从样本中排除哪个先前时段(如果有)。

    1. Type a Description of the skip test.

    2. 输入样本跳过测试表达式。您可以建立 通过选择用于聚合数据的数据元素来表达,或 程序数据元素,属性或指标。组织 尚不支持单位计数。与发电机一样 功能,您可以单击(或键入)以下任何元素 表达式字段:() * / +-天。

      The non-aggregating functions described above for generator expressions may also be used 在跳过测试中。

      该表达式的计算结果必须为布尔值** true 或 **false . See Boolean expression notes above.

      跳过测试表达式示例:

      Skip test expression Means
      #{FTRrcoaog83} > #{M62VHgYT2n0} The value of data element FTRrcoaog83 (sum of all disaggregations) is greater than the value of data element M62VHgYT2n0 (sum of all disaggregations)
      #{uF1DLnZNlWe} > 0 The value of data element uF1DLnZNlWe (sum of all disaggregations) is greater than the zero
      #{FTRrcoaog83} > #{M62VHgYT2n0} || #{uF1DLnZNlWe} > 0 The value of data element FTRrcoaog83 (sum of all disaggregations) is greater than the value of data element M62VHgYT2n0 (sum of all disaggregations) or the value of data element uF1DLnZNlWe (sum of all disaggregations) is greater than the zero
  13. Enter a Sequential sample count value.

    这是计算应该进行多少个连续周期 及时返回样本数据进行计算。

  14. Enter an Annual sample count value.

    这是计算应该追溯到多少年 用于计算的样本数据。

  15. (Optional) Enter a Sequential skip count value.

    这是紧接在 采样值之前,应跳过预测值周期。

  16. 点击**保存**。

创建或编辑预测变量组

  1. 打开** Maintenance 应用程序,然后单击 Other ** > ** Predictor 组**。

  2. 点击添加按钮。

  3. Type a Name . This field needs to be unique.

  4. (Optional) In the Code field, assign a code. This field needs to 独一无二。

  5. (可选)输入**说明**。

  6. Double-click the Predictors you want to assign to the group.

  7. 点击**保存**。

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理推送报告

关于推送报告

推送报告使您可以提高对数据分析的认识和使用 通过将带有图表,表格和地图的报告直接发送到用户电子邮件 地址。

  • 推送报告从现有仪表板获取其内容。

  • 推送报告以与 仪表板。

  • 推送报告只能包含带有图表,地图或 表。

  • You create the push report and its schedule in the Maintenance 应用程序。

  • 您在上设置的**标题**和**消息**参数 每个报告中都包含** Maintenance **应用程序。 **名字**你 给出报告不包括在报告中。取而代之的是 用于识别系统中的推送分析对象。这样一来 报告可以命名为一件事,报告的标题可以为 另一个。

  • 当您运行推送报告作业时,系统会编译以下列表: 您选择的用户组中的收件人。然后系统 为所选用户组的每个成员生成报告。每 仪表板项目中的一个是专门为每个用户生成的。 这意味着报告中包含的数据反映了该数据 用户有权访问。因此,所有用户都可以得到相同的 报告(如果所有数据均为“静态”)或自定义报告(如果所有 数据是“动态的”),或两者结合。

  • 推送报告通过电子邮件而不是通过电子邮件发送给收件人 内部DHIS2消息传递系统。如果用户没有有效的 电子邮件,或者如果作业失败,则不会发送电子邮件。在这种情况下, 问题记录在服务器上。

注意

推送报告中生成的数据是公开的,因此请确认您 不要包含任何敏感数据。

In the Maintenance app, you manage the following push reports objects:

Push reports objects in the Maintenance app
Object type Available functions
Push analysis Create, edit, clone, delete, show details, translate, preview and run

创建或编辑推送报告

  1. 打开** Maintenance 应用程序,然后单击 Other ** > ** Push 分析**。

  2. 点击添加按钮。

  3. 在**名称** 字段中,输入计划报告的名称。

    此名称不包括在报告电子邮件中。取而代之的是 用于识别系统中的推送分析对象。

  4. (可选)在 Code 字段中,分配一个代码。

  5. 添加报告**标题**。

    该标题包含在报告电子邮件中。

  6. (可选)添加**消息**。

    此消息包含在报告电子邮件中。

  7. 选择一个 仪表板 作为报告的基础。

  8. 选择并分配您要向其发送报告的用户组。

  9. Select a Scheduling frequency : Daily , Weekly or 每月

    Note

    If you schedule a push report to "Monthly" and "31", the scheduled report job will not run if the month has less than 31 days.

  10. (可选)选择**启用**以激活推送报告作业。

    作业只有激活后才能运行。

  11. 点击**保存**。

预览推送报告

  1. 打开** Maintenance 应用程序,然后单击 Other ** > ** Push 分析**。

  2. 在推送报告列表中,找到要预览的推送报告。

  3. 单击选项菜单并选择**预览**。

    推送报告的预览在新窗口中打开。

运行推送报告作业

  1. 打开** Maintenance 应用程序,然后单击 Other ** > ** Push 分析**。

  2. 在推送报告列表中,找到要运行的推送报告。

  3. 单击选项菜单并选择 立即运行

    推送报告作业立即运行。

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理外部地图图层

关于外部地图图层

You can customize GIS by including map layers from various sources and combine them with your own data in DHIS2. DHIS2 supports these common map service formats: Web Map Service (WMS), Tile Map Service (TMS), XYZ tiles and Vector tiles (Vector Style).

创建或编辑外部地图图层

注意

DHIS2仅支持Web Mercator投影 ([[EPSG:3857]( https://epsg.io/3857 )),因此请确保 服务支持此预测。

External map layer objects in the Maintenance app
Object type Available functions
External map layer Create, edit, clone, delete, show details and translate
  1. 打开** Maintenance 应用程序,然后单击 Other ** > 外部地图 层

  2. 点击添加按钮。

  3. In the Name field, type a name that describes the content of the 外部地图图层。

    这是您将在 Maps 应用程序中看到的名称。

  4. (可选)在 Code 字段中,分配一个代码。

  5. 选择 地图服务 格式。

    DHIS2 supports four common map service formats:

    • 网络地图服务(WMS)

      图片格式 :PNG格式允许图层透明, JPG格式可提供更好的压缩效果,并且通常更快 加载。

      图层 :WMS可以包含多个单独的图层,您可以 可以指定要包含的内容(以逗号分隔)。参考 WMS GetCapabilities文档以查看可用图层。

    • 平铺地图服务(TMS)

    • XYZ磁贴(也可用于WMTS)

    • Vector tiles (Vector Style)

    When Vector Style is chosen, you can then add a value for "Before layer id". It indicates the layer id in the Vector tile (layer) stack at which the user's layers (such as Thematic, Events) will be inserted. If this value isn't set, then the user's layers will be placed on top of the layers in the Vector Style. The map service URL should be to a JSON document that follows the Mapbox GL Style Spec .

  6. 输入地图服务的**URL**。

    Note

    XYZ and TMS URLs must contain placeholders {}, for example: http://{s}.tile.osm.org/{z}/{x}/{y}.png.

  7. (Optional) Enter Source of the map layers. The field can contain HTML标记(如果要链接到源)。

    使用外部地图服务时,突出显示 数据来自哪里。

  8. 选择一个**放置**:

    • 底部-底图 :对于“地图”应用,这将使外部地图图层 selectable as the basemap (i.e. as an alternative to the DHIS2 basemaps).

    • 顶部-重叠 :对于“地图”应用,这允许外部地图 从“添加图层”选择中添加并放置在上方的任何位置 the basemap.

    Note that Vector Style layers can only be added as a basemap.

  9. (可选)添加图例。

    您可以通过两种方式添加图例:

    • 选择预定义的**图例**以描述地图的颜色 层。

      Tip

      Click Add new to create legends that you're missing. In the form that opens, create the legends you need. When you're done, click Refresh values .

    • 在**传奇图像中输入指向外部图像图例的链接 网址**。

      这些通常是为WMS提供的。请参阅WMS中的LegendURL下 GetCapabilites文档。

  10. 点击**保存**。

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理SQL视图

DHIS2的SQL View功能将存储SQL视图定义 内部,然后在需要时实例化视图。

数据库管理员在创建数据库视图时必须小心 直接在DHIS2数据库中。例如,当资源表 生成,所有这些都将首先被删除然后重新创建。如果 任何SQL视图都依赖于这些表,完整性违规异常 将被抛出并且该过程将被中止。

SQL视图基于它们的反向字母顺序删除 DHIS2中的名称,并按常规字母顺序创建。这允许 您要在SQL视图之间具有依赖关系,因为视图仅取决于 其他按字母顺序排列的观点。对于 例如,“ ViewB”可以安全地依赖于“ ViewA”。否则,有意见 取决于其他视图会导致完整性违规错误。

创建一个新的SQL视图

要创建新的SQL视图,请点击** Apps ** > ** Maintenance ** > 其他 > ** SQL View ,然后单击添加 + **按钮。

The "Name" attribute of the SQL view will be used to determine the name of the table that DHIS2 will create when the view is materialized by the user. The "Description" attribute allows one to provide some descriptive text about what the SQL view actually does.

The "SQL type" attribute allows the creation of three kinds of views: - A "View" is stored in the database and regenerated when queried - A "Materialized View" is stored in the database and its results are cached in the database - A "Query" is not stored in the database

Finally, the "SQL query" should contain the SQL view definition.

Only SQL "SELECT" statements are allowed and certain sensitive tables (i.e., user information) are not accessible.

Press "Save" to store the SQL view definition. If you created a "View" or a "Materialized View", you must also "Execute query" to finish the creation of the SQL view.

Keep in mind that the the columns returned by the used SELECT statement become table columns, that means they must be of a valid table column type. When functions are used it might be necessary to explicitly cast the result to a type by adding ::{TYPE} after the function.

For example, instead of jsonb_each (which would return a record type that cannot be a column type) use jsonb_each_text and cast the result to text , like in the below sample:

select jsonb_each_text(eventdatavalues)::text from ...

SQL views that call other SQL views

If you wish to make a SQL view that can be called be other SQL views, then its SQL type must be either "View" or a "Materialized View" (not "Query"). It also must have Execute query run on it before being called.

For instance, if you created a view named Data element count with SQL type "View" and this SQL:

select count(*) as count from dataelement;

...then you could run Execute query from the context menu and create a second SQL view named More than 100 data elements with this SQL:

select case when count > 100 then 1 else 0 end as result from _view_data_element_count;

SQL视图管理

为了利用SQL视图,只需点击视图,然后从 在上下文菜单中,选择“执行查询”。该过程完成后,您将 系统将通知您已创建一个表。表格名称 将由“描述”属性提供 在SQL视图定义中提供。生成视图后, 您可以通过再次单击视图并选择“显示SQL 视图”。

提示

如果您有一个依赖于其他视图的视图,则应 注意视图的命名方式。当在 DHIS2服务器,必须删除所有视图,然后重新创建。什么时候 分析开始,按字母顺序删除视图,然后 然后以相反的字母顺序重新创建。因此,如果视图A取决于 在视图B上,它必须按字母顺序显示在视图B之前。如果它 会按字母顺序在视图B之后出现,分析可能会失败,因为 带有依存关系的视图将不会以正确的顺序删除。

管理语言环境

可以在DHIS2中创建自定义语言环境。除了 系统提供的语言环境,您可能需要添加自定义 系统的语言环境(例如“英语”和“赞比亚”)。这将允许 您可以将元数据对象翻译成本地语言,或解决 使用共同元数据的国家之间的细微差异 定义。

语言环境由语言和国家/地区组成。选择 所需的值,然后按“添加”。此自定义语言环境现已可用 作为系统中的翻译语言环境之一。

一次编辑多个对象组

**维护**应用程序中的**元数据组编辑器**可让您 同时编辑多个对象组。您可以编辑以下内容 对象类型:

Object types in the Metadata group editor
Object type Available functions
类别选项
Category option group
数据元素 Add one data element to multiple data element groups

Remove one data element from multiple data element groups
数据元素组 Add multiple data elements to one data element group

Remove multiple data elements from one data element group
指示符 Add one indicator to multiple indicator groups

Remove one indicator from multiple indicator groups
Indicator group Add multiple indicators to one indicator group

Remove multiple indicators from one indicator group

编辑对象组中的多个对象

  1. 打开 维护 应用程序并单击 元数据组编辑器

  2. 单击**管理组中的项目**。

  3. Select an object group type, for example Indicator groups .

  4. 选择一个对象组,例如** HIV **。

  5. 在左侧列表中,选择要添加到对象中的对象。 对象组,然后单击向右箭头。

  6. 在右侧列表中,选择要从中删除的对象 对象组,然后单击左箭头。

编辑多个对象组中的一个对象

  1. 打开 维护 应用程序并单击 元数据组编辑器

  2. 单击**管理组条目**。

  3. 选择一个对象类型,例如**指标**。

  4. 选择一个对象,例如 ANC LLITN 覆盖范围

  5. 在左侧列表中,选择要添加的对象组 对象,然后单击向右箭头。

  6. 在右侧列表中,选择您想要的对象组 从中删除对象,然后单击左箭头。

在维护应用中配置程序

关于程序

传统上,公共卫生信息系统一直在报告 整个健康计划中服务提供的汇总数据。这个 不允许您跟踪提供这些服务的人员。在 DHIS2,您可以分阶段定义自己的程序。这些程序是 “跟踪器”功能的重要部分,可让您跟踪 个人记录。您还可以跟踪其他“实体”,例如井或 保险。您可以创建两种类型的程序:

表:项目类型

Program type 描述 Examples of use
事件项目 Single event without registration program (anonymous program or SEWoR)

Anonymous, individual events are tracked through the health system. No person or entity is attached to these individual transactions.

Has only one program stage.
To record health cases without registering any information into the system.

To record survey data or surveillance line-listing.
追踪项目 Single event with registration program (SEWR)

An entity (person, commodity, etc.) is tracked through each individual transaction with the health system

Has only one program stage.

A tracked entity instance (TEI) can only enroll in the program once.
To record birth certificate and death certificate.
Multi events with registration program (MEWR)

An entity (person, commodity, etc.) is tracked through each individual transaction with the health system

Has multiple program stages.
Mother Health Program with stages as ANC Visit (2-4+), Delivery, PNC Visit.

要创建程序,必须首先配置几种类型的元数据 对象。您可以在**维护**应用中创建这些元数据对象。

Program metadata objects in the Maintenance app
Object type 描述 Available functions
事件项目 A program to record single event without registration Create, edit, share, delete, show details and translate
追踪项目 A program to record single or multiple events with registration Create, edit, share, delete, show details and translate
计划指标 An expression based on data elements and attributes of tracked entities which you use to calculate values based on a formula. Create, edit, clone, share, delete, show details and translate
Program rule Allows you to create and control dynamic behaviour of the user interface in the Tracker Capture and Event Capture apps. Create, edit, clone, delete, show details and translate
Program rule variable Variables you use to create program rule expressions. Create, edit, clone, delete, show details and translate
Relationship type Defines the relationship between tracked entity A and tracked entity B, for example mother and child. Create, edit, clone, share, delete, show details and translate
追踪实体类型 Types of entities which can be tracked through the system. Can be anything from persons to commodities, for example a medicine or a person.

A program must have one tracked entity. To enrol a tracked entity instance into a program, the tracked entity of an entity and tracked entity of a program must be the same.

Note

A program must be specified with only one tracked entity. Only tracked entity as same as the tracked entity of program can enroll into that program.
Create, edit, clone, share, delete, show details and translate
跟踪实体属性 Used to register extra information for a tracked entity.

Can be shared between programs.
Create, edit, clone, share, delete, show details and translate
程序 A program consist of program stages. Create, edit, share, delete, assign to organisation units, show details and translate
程序阶段 A program stage defines which actions should be taken at each stage. Create, edit, share, change sort order, delete, show details and translate
Program indicator group A group of program indicators Create, edit, clone, share, delete, show details and translate
Validation rule A validation rule is based on an expression which defines a relationship between data element values. Create, edit, clone, share, delete, show details and translate
Program notification Automated message reminder

Set reminders to be automatically sent to enrolled tracked entity instances before scheduled appointments and after missed visits.
Create, edit and delete
Program stage notification 自动消息提醒

设置提醒,当一个程序阶段完成时,或在到期日期之前或之后自动发送。
Create, edit and delete

在维护应用程序中配置事件程序

关于活动计划

*没有*注册程序的单个事件称为事件程序。 您可以在**维护**应用中对其进行配置。活动节目可以有 三种类型的数据输入形式:

Types of data entry forms for event programs
Form type 描述
Basic Lists all data elements which belong to the program. You can change the order of the data elements.
Section A section groups data elements. You can then arrange the order of the sections to create the desired layout of the data entry form.
Custom Defines the data entry form as HTML page.

注意

-如果自定义表单和部分表单都属于 现在。

-如果未定义自定义或部分表格,则基本表格为 使用。

-Android应用程序仅支持部分表格。

You can create program notifications for event programs. The notifications are sent either via the internal DHIS2 messaging system, via e-mail or via text messages (SMS). You can use program notifications to, for example, send an automatic reminder to a tracked entity 10 days before a scheduled appointment. You use the program’s tracked entity attributes (for example first name) and program parameters (for example enrollment date) to create a notification template. In the Parameters field, you'll find a list of available tracked entity attributes and program parameters.

工作流程:创建事件程序

  1. 输入事件程序详细信息。

  2. 分配数据元素。

  3. 创建数据输入表单: 基本 部分**或**自定义

  4. 将程序分配给组织单位。

  5. 创建程序通知。

创建或编辑事件程序

输入活动计划详细信息

  1. Open the Maintenance app and click Program > Program .

  2. 单击添加按钮,然后在弹出菜单中选择**事件程序**。

  3. 输入程序详细信息,然后单击下一步。

    Field Description
    Name The name of the program.
    Color Color used for this program in the data capture apps.
    Icon Icon used for this program in the data capture apps.
    Short name A short name of the program. The short name is used as the default chart or table title in the analytics apps.
    Description A detailed description of the program.
    Version The version of the program. This is used for example when people collect data offline in an Android implementation. When they go online and synchronize their metadata, they should get the latest version of the program.
    Category combination The category combination you want to use. The default setting is None .
    Open days after category option end date If you selected a category combination other than None, you may enter zero or a positive number. This lets you enter data for this program for a category option up to the specified number of days after that category option's end date.
    Data approval workflow The data approval workflow you want to use. The default setting is No value .
    Completed events expiry date Defines the number of days for which you can edit a completed event. This means that when an event is completed and the specified number of expiry days has passed, the event is locked.

    If you set "Completed events expiry days" to 10", an event is locked ten days after the completion date. After this date you can no longer edit the event.
    Expiry period type

    Expiry days
    The expiry days defines for how many days after the end of the previous period, an event can be edited. The period type is defined by the expiry period type. This means that when the specified number of expiry days has passed since the end date of the previous period, the events from that period are locked.

    If you set the expiry type to "Monthly" and the expiry days to "10" and the month is October, then you can't add or edit an event to October after the 10 th of November.
    Block entry form after completed Select checkbox to block the entry form after completion of the event of this program.

    This means that the data in the entry form can't be changed until you reset the status to incomplete.
    Feature type Sets whether the program is going to capture a geographical feature type or not.
    - None Nothing is captured.
    - Polygon An area is captured. For single event programs the area will be the area representing the event being captured. For tracker programs, the area will represent the area of the enrollment.
    - Point A point/coordinate is captured. For single event programs the point will be representing the event being captured. For tracker programs, the point will represent the enrollment.
    Validation strategy Sets the server and client side validation requirement.

    Data type validation is always performed regardless of the validation strategy. An integer field is never stored containing text, for example.
    - On complete This option will enforce required field and error messages to be fixed when completing the event, but the event can be saved to the server without passing these validation requirements. For legacy reasons, this is always the validation strategy for tracker programs, where each data value in the event is stored to the server while entering data.
    - On update and insert This option will enforce required field validation when saving the event to the server regardless of the completion status. When using this option no events can be stored without passing validations.
    Pre-generate event UID Select checkbox to pre-generate unique event id numbers.
    Description of report date Type a description of the report date.

    This description is displayed in the case entry form.
  4. 点击下一步。

分配数据元素

  1. 点击**分配数据元素**。

  2. 在可用项目列表中,双击要删除的数据元素。 想要分配给事件程序。

  3. (可选)为每个数据元素添加其他设置:

    Setting Description
    Compulsory The value of this data element must be filled into data entry form before you can complete the event.
    Allow provided elsewhere Specify if the value of this data element comes from other facility, not in the facility where this data is entered.
    Display in reports Displays the value of this data element into the single event without registration data entry function.
    Date in future Will allow user to select a date in future for date data elements.
    Mobile render type Can be used to select different render types for mobile devices. Available options vary depending on the data element's value type. For example, for a numerical value you may select "Default", "Value", "Slider", "Linear scale", and "Spinner".
    Desktop render type WARNING: NOT IMPLEMENTED YET.

    Can be used to select different render types for desktop (i.e. the web interface). Available options vary depending on the data element's value type. For example, for a numerical value you may select "Default", "Value", "Slider", "Linear scale", and "Spinner".
  4. 点击下一步。

创建数据输入表单

The data entry forms decide how the data elements will be displayed to the user in the Event Capture app.

  1. 点击**创建数据输入表单**。

  2. 点击**基本**, 部分**或**自定义

  3. 要创建**基本**数据输入表单:拖放数据 元素按您想要的顺序排列。

  4. 要创建**部分**数据输入表单,请执行以下操作:

    1. 点击添加按钮,然后输入部分的名称,说明和 桌面设备和移动设备的渲染类型。

    2. 单击该部分,使其以黑线突出显示。

    3. 通过单击数据旁边的加号来添加数据元素 元素的名称。

    4. 重复上述步骤,直到获得所需的所有部分。

    5. 更改部分顺序:单击选项菜单,然后拖动 部分到您想要的地方。

  5. 要创建** Custom 数据条目,请执行以下操作:使用WYSIWYG编辑器 创建一个完全定制的表单。如果您选择**来源 ,则您 可以直接将HTML代码粘贴到编辑区域中。你也可以 插入图像,例如标志或徽标。

  6. 点击下一步。

访问

访问选项决定谁可以捕获程序数据或查看/编辑数据 程序的元数据。程序可以与组织单位共享, 另外,主程序和任何程序阶段的访问选项 可以通过**共享对话框**进行配置。访问选项是 在**访问权限**标签中可用。

分配组织单位:

  1. 在组织树中,双击您的组织单位 想要添加到程序中。

    您可以通过展开目录树来在树中找到组织单位 分支(单击箭头符号),或通过搜索 名称。所选组织单位显示为橙色。

更改角色和访问权限:

  1. 向下滚动到**角色和访问权限**部分。

    第一行显示主程序的访问选项,每个 下一行显示一个程序阶段的选项。程序 带有警告图标(感叹号)的阶段包含访问选项 偏离主程序,这意味着它们可以通过 不同的用户组合。

  2. 单击任一行,将显示**共享对话框**。

  3. 相应地修改访问选项。请参阅有关 共享对话框以获取详细信息。

  4. 点击**应用**按钮。

  5. 对每个程序/程序阶段重复该过程。您也可以复制 从主程序到子程序的所有访问选项:

    1. 选择您想要具有类似访问权限的程序阶段 切换复选框,将其作为主程序 程序阶段的右侧。您也可以选择 **选择全部**程序阶段,**取消选择全部**程序阶段 或根据访问选项**选择类似**阶段,以 主程序。默认情况下会切换相似的阶段。

    2. 点击**应用于选定阶段**

创建程序通知

  1. 创建您要发送的消息:

    1. 点击**发送什么?**。

    2. 输入一个**名称**。

    3. 创建**主题模板**:双击中的参数 **模板变量**字段将其添加到您的主题。

      Note

      The subject is not included in text messages.

    4. 创建**消息模板**:双击参数 **模板变量**列表中的名称以将它们添加到您的 信息。

      亲爱的A {w75KJ2mc4zz}:您现在已注册V {program _name}。

  2. 定义*何时*要发送消息:

    1. 单击**什么时候发送?**。

    2. 选择一个**通知触发器**。

      Notification trigger Description
      Program stage completion The program stage notification is sent when the program stage is completed
      Days scheduled (due date) The program stage notification is sent XX number of days before or after the due date

      You need to enter the number of days before or after the scheduled date that the notification will be sent.
  3. 定义要将消息发送给的*谁*:

    1. Click Who to send it to? .

    2. 选择**通知**。

      Notification recipient Description
      Tracked entity instance Receives program notifications via e-mail or text message.

      To receive a program notification, the recipient must have an e-mail address or a phone number attribute.
      Organisation unit contact Receives program notifications via e-mail or text message.

      To receive a program notification, the receiving organisation unit must have a registered contact person with e-mail address and phone number.
      Users at organisation unit All users registered to the selected organisation unit receive program notifications via the internal DHIS2 messaging system.
      User group All members of the selected user group receive the program notifications via the internal DHIS2 messaging system
      Program TBA
    3. Click Save .

  4. 重复上述步骤,创建所需的所有程序通知。

  5. 点击**保存**。

注意

您可以在 Data 中配置何时发送程序通知 管理**应用程序 > **日程安排 > 程序通知 调度程序

  • 单击 立即运行 立即发送程序通知。

  • 选择一个时间并点击**开始**来安排节目 要在特定时间发送的通知 时间。

参考信息:程序通知参数

Program notification parameters to use in program notifications
Notification type Variable name Variable code
程序 Current date V{current_date}
Days since enrollment date V{days_since_enrollment_date}
Enrollment date V{enrollment_date}
Incident date V{incident_date}
Organisation unit name V{org_unit_name}
Program name V{program_name}
程序阶段 Current date V{current_date}
Days since due date V{days_since_due_date}
Days until due date V{days_until_due_date}
Due date V{due_date}
Organisation unit name V{org_unit_name}
Program name V{program_name}
Program stage name V{program_stage_name}
Event status V{event_status}

在维护应用程序中配置跟踪器程序

关于跟踪器程序

*具有*注册的单个或多个事件程序。程序必须指定一个被查明的实体。只有与程序被查到的身份相同的被查实体才能加入被查明的实体 程序。程序需要您在。**维护**应用程序中创建的各种类型的元数据。

工作流程:创建一个跟踪程序

  1. 输入跟踪器程序的详细信息。

  2. 输入注册详细信息。

  3. 分配属性并创建**部分**或**自定义**注册表格。

  4. 创建程序阶段。

  5. 配置访问权限,并分配给组织单位。

  6. 创建程序和程序阶段通知。

创建或编辑Tracker程序

  1. Open the Maintenance app and click Program > Program .

  2. 单击添加按钮并在弹出菜单中选择**随访项目**。

输入程序详细信息

领域 描述
名称 The name of the program.
颜色 Color used for this program in Tracker capture.
图标 Icon used for this program in Tracker capture
简称 A short name of the program. The short name is used as the default chart or table title in the analytics apps.
描述 A detailed description of the program.
Version The version of the program. This is used for example when people collect data offline in an Android implementation. When they go online and synchronize their metadata, they should get the latest version of the program.
Tracked Entity Type The tracked entity type you want to use. A program can only have one type of tracked entity.
Category combination The category combination you want to use. The default setting is None .
Open days after category option end date If you selected a category combination other than None, you may enter zero or a positive number. This lets you enter data for this program for a category option up to the specified number of days after that category option's end date.
Display front page list Select checkbox to display a list of Tracked Entity Instances in Tracker Capture. If not selected, the Search will be displayed.
First stage appears on registration page Select checkbox to display the first program stage together with the registration (enrollment).
Access level Choose the access level of the program.
Completed events expiry days Defines the number of days for which you can edit a completed event. This means that when an event is completed and the specified number of expiry days has passed, the event is locked.

If you set "Completed events expiry days" to 10", an event is locked ten days after the completion date. After this date you can no longer edit the event.
Expiry period type

Expiry days
The expiry days defines for how many days after the end of the previous period, an event can be edited. The period type is defined by the expiry period type. This means that when the specified number of expiry days has passed since the end date of the previous period, the events from that period are locked.

If you set the expiry type to "Monthly" and the expiry days to "10" and the month is October, then you can't add or edit an event to October after the 10 th of November.
Minimum number of attributes required to search Specify the number of tracked entity attributes that needs to be filled in to search for Tracked Entities in the Program.
Maximum number of tracked entity instances to return in search Specify the maximum number of tracked entity instances that should be returned in a search. Enter 0 for no limit.

Enter enrollment details

领域 描述
Allow future enrollment dates Select checkbox if you want to allow tracked entity instances to be enrolled in the program on a future date.
Allow future incident dates Select checkbox if you want to allow the incident date in the program to be on a future date.
Only enroll once (per tracked entity instance lifetime) Select checkbox if you want a tracked entity to be able to enroll only once in a program. This setting is useful for example in child vaccination or post-mortem examination programs where it wouldn’t make sense to enroll a tracked entity more than once.
Show incident date This setting allows you to show or hide the incident date field when a tracked entity enroll in the program.
Description of incident date Type a description of the incident date

For example:

In an immunization program for child under 1 year old, the incident date is the child's birthday.

In a maternal program, the incident date is the date of last menstrual period.
Type a description of the enrollment date The date when the tracked entity is enrolled into the program
Ignore overdue events When a tracked entity enrolls into the program, the events corresponding to the program stages are created. If you select this checkbox, the system will not generate overdue events.
Feature type Sets whether the program is going to capture a geographical feature type or not.
* None: Nothing is captured.
* Polygon: An area is captured. For single event programs the area will be the area representing the event being captured. For tracker programs, the area will represent the area of the enrollment.
* Point: A point/coordinate is captured. For single event programs the point will be representing the event being captured. For tracker programs, the point will represent the enrollment.
Related program Choose a Tracker program which is related to the program you are creating, for example an ANC and a Child program.

分配跟踪的实体属性。

  1. In the list of Available program tracked entity attributes , double-click the 您要分配给程序的属性。

  2. (可选)对于每个分配的属性,添加其他设置:

Setting 描述
Display in list Displays the value of this attribute in the list of tracked entity instances in Tracker capture.
Mandatory The value of this attribute must be filled into data entry form before you can complete the event.
Date in future Will allow user to select a date in future for date attributes.
Mobile render type Can be used to select different render types for mobile devices. Available options vary depending on the attribute's value type. For example, for a numerical value you may select "Default", "Value", "Slider", "Linear scale", and "Spinner".
Desktop render type WARNING: NOT IMPLEMENTED YET.

Can be used to select different render types for desktop (i.e. the web interface). Available options vary depending on the attribute's value type. For example, for a numerical value you may select "Default", "Value", "Slider", "Linear scale", and "Spinner".
  1. 创建注册表

注册表单定义了如何在使用中的应用(例如Android和Tracker Capture)中向用户显示属性。

1. 点击**创建注册表格**。
2. 点击**部分**或**自定义**。
3. 创建**部分**表格:
    1. 点击添加按钮,然后为台式机和移动设备输入版块的名称,说明和渲染类型。
    2. 单击该部分,使其以黑色边框突出显示。
    3. 通过单击要添加的数据元素名称旁边的加号来添加数据元素。
    4. 重复上述步骤,直到获得所需的所有部分。
        要更改节的顺序:单击选项菜单,然后将节拖动到所需的位置。
4. 创建** Custom **注册表:使用WYSIWYG编辑器创建一个完全定制的表单。如果选择“源”,则可以将HTML代码直接粘贴到编辑区域中。您还可以插入图像,例如标志或徽标。
5. 单击添加阶段。

创建程序阶段

一个程序由程序阶段组成。程序阶段定义哪个 每个阶段都应采取行动。

注意

在保存程序之前,不会保存对程序阶段的更改。

  1. 单击加号创建一个程序阶段。
  2. 输入程序阶段详细信息:
    1. 输入一个**名称**。
    2. (可选)选择将要使用的**颜色**和**图标** 由数据捕获应用确定此程序阶段。
    3. 输入**说明**。
    4. In the Scheduled days from start field, enter the minimum 等待启动程序阶段的天数。
  3. 输入可重复的程序阶段详细信息。
    1. Specify if the program stage is Repeatable or not.
    2. Select a Period type .
    3. Clear Display generate event box after completed if you 不想显示*创建新事件框*以创建新事件 for a repeatable stage after you click Complete for an event 以数据输入形式显示的阶段。该字段由 默认。
    4. Enter Standard interval days . The number of days to repeat the repeatable program stage.
    5. (Optional) Select a Default next scheduled date . This will show a list of assigned data elements of type date . If an element is selected, the Tracker client will use this as the default starting date. The data element can be used by program rules to dynamically schedule intervals between events.
  4. 输入表格详细信息
选项 行动
Auto-generate event Clear check box to prevent creating an event of this program stage automatically when a entity is enrolled in the program.
Open data entry form after enrollment Select check box to automatically open the event of this stage as soon as the entity has enrolled into the program.
Report date to use If you have selected the Open data entry form after enrollment check box, also select a Report date to use : Date of incident or Date of enrollment .
This is the date used as report date for an event that has been opened automatically.

If the Report date to use is selected as one of those two ('incident date'/'enrollment date'), in Dashboard, the 'Report date' of the event will be set as one of those two.
User assignment of events Select check box to enable user assignment of the program stage.

This means that in Tracker capture there will be a list of users to which the event can be assigned.
Block entry form after completed Select check box to block the entry form after completion of the event of this stage.

This means that the data in the entry form can't be changed until you reset the status to incomplete.
Ask user to complete program when stage is completed Select check box to trigger a pop-up which asks the user if he/she wants to create the event of next stage.
Ask user to create new event when stage is complete Select check box to trigger a pop-up which asks the users if he/she wants to create a new event of this stage when an event of this stage is completed.

This property is active only if you have selected Repeatable .
Generate events by enrollment date 选中它可以根据注册日期从该程序的程序阶段自动生成事件的到期日期。如果未选中,则基于事件日期生成截止日期。
Hide due dates Select checkbox to hide due dates for events.
Feature type Sets whether the program is going to capture a geographical feature type or not.
* None: Nothing is captured.
* Polygon: An area is captured. For single event programs the area will be the area representing the event being captured. For tracker programs, the area will represent the area of the enrollment.
* Point: A point/coordinate is captured. For single event programs the point will be representing the event being captured. For tracker programs, the point will represent the enrollment.
Pre-generate event UID Select check box to pre-generate unique event id numbers.
Description of report date Type a description of the report date.

This description is displayed in the data entry form.
Description of due date Type a description of the due date.
Referral* Flag to indicate if program stage is referral or not.
  1. 将数据元素分配给程序阶段:

    1. In the list of Available data elements , double-click the 您要分配给程序阶段的数据元素。

    2. 对于每个分配的数据元素,查看属性。您可以 选择:

选项 行动
必修 The value of this data element must be filled into data entry form before completing the event.
Allow provided elsewhere Specify if the value of this data element comes from other facility, not in the facility where this data is entered.
Display in reports Display the value of this data element into the single event without registration data entry function.
Date in future Allow to select a date in future for date data elements.
Skip synchronization Allow data element to be skipped when running data synchronization jobs.
Mobile render type Can be used to select different render types for mobile devices. Available options vary depending on the attribute's value type. For example, for a numerical value you may select "Default", "Value", "Slider", "Linear scale", and "Spinner".
Desktop render type WARNING: NOT IMPLEMENTED YET.

Can be used to select different render types for desktop (i.e. the web interface). Available options vary depending on the attribute's value type. For example, for a numerical value you may select "Default", "Value", "Slider", "Linear scale", and "Spinner".
  1. 创建程序阶段的数据输入表单

    数据输入表单决定如何将数据元素显示为 the user in the Tracker Capture app.

  2. 点击**创建数据输入表单**。

  3. 点击**基本**, 部分**或**自定义

  4. 要创建**基本**数据输入表单:拖放数据 元素按您想要的顺序排列。

  5. 要创建**部分**数据输入表单,请执行以下操作:

    1. 点击添加按钮,然后输入部分的名称,说明和 桌面设备和移动设备的渲染类型。

    2. 单击该部分,使其以黑色边框突出显示。

    3. 通过单击数据旁边的加号来添加数据元素 元素的名称。

    4. 重复上述步骤,直到获得所需的所有部分。

    5. 更改部分顺序:单击选项菜单,然后拖动 部分到您想要的地方。

  6. 要创建** Custom 数据条目,请执行以下操作:使用WYSIWYG编辑器 创建一个完全定制的表单。如果您选择**来源 ,则您 可以直接将HTML代码粘贴到编辑区域中。你也可以 插入图像,例如标志或徽标。

  7. 单击添加阶段。

访问

访问选项决定谁可以捕获程序数据或查看/编辑数据 程序的元数据。程序可以与组织单位共享, 另外,主程序和任何程序阶段的访问选项 可以通过**共享对话框**进行配置。访问选项是 在**访问权限**标签中可用。

分配组织单位:

  1. 在组织树中,双击您的组织单位 想要添加到程序中。

    您可以通过展开目录树来在树中找到组织单位 分支(单击箭头符号),或通过搜索 名称。所选组织单位显示为橙色。

更改角色和访问权限:

  1. 向下滚动到**角色和访问权限**部分。

    第一行显示主程序的访问选项,每个 下一行显示一个程序阶段的选项。程序 带有警告图标(感叹号)的阶段包含访问选项 偏离主程序,这意味着它们可以通过 不同的用户组合。

  2. 单击任一行,将显示**共享对话框**。

  3. 相应地修改访问选项。请参阅有关 共享对话框以获取详细信息。

  4. 点击**应用**按钮。

  5. 对每个程序/程序阶段重复该过程。您也可以复制 从主程序到子程序的所有访问选项:

    1. 选择您想要具有类似访问权限的程序阶段 切换复选框,将其作为主程序 程序阶段的右侧。您也可以选择 **选择全部**程序阶段,**取消选择全部**程序阶段 或根据访问选项**选择类似**阶段,以 主程序。默认情况下会切换相似的阶段。

    2. 点击**应用于选定阶段**

创建程序通知

您可以通过注册和创建程序的程序通知 他们的计划阶段。通知通过内部发送 DHIS2邮件系统,通过电子邮件或文本消息(SMS)。您可以 使用程序通知,例如,将自动提醒发送给 预定约会前10天跟踪的实体。您使用 程序的跟踪实体属性(例如名字)和程序 参数(例如注册日期)以创建通知 模板。

  1. Open the Maintenance app and click Program and then 通知

    所选程序的现有程序通知列表 打开。如果该程序没有任何程序通知,则 列表为空。

  2. Click on add button and select Program notification .

  3. 输入一个**名称**。

  4. 创建**主题模板**。

    Double-click the parameters in the Parameters field to add them 对你的主题。

    Note

    The subject is not included in text messages.

  5. 创建**消息模板**。

    Double-click the parameter names in the Parameters field to add 他们到您的消息。

    亲爱的A {w75KJ2mc4zz}:您现在已注册V {program _name}。

  6. In the When-to-send it field, select what should trigger the 通知。

    Trigger Description Note
    Program enrollment The program notification is sent when the TEI enrols in the program. -
    Program completion The program notification is sent when the program of TEI is completed -
    Days scheduled (incident date) The program notification is sent XX number of days before or after the incident date You need to enter the number of days before or after the scheduled date that the notification will be send.
    Days scheduled (enrollment date) The program notification is sent XX number of days before or after the enrollment date You need to enter the number of days before or after the scheduled date that the notification will be send.
    Program Rule Notification will be triggered as a result of program rule exeuction. Program rule with ProgramRuleActionType.SENDMESSAGE need to be in place to make this trigger successful.
  7. In the Who-to-send-it field, select who should receive the 程序通知。

    Recipient type Description Note
    Tracked entity instance Receives program notifications via e-mail or text message. To receive a program notification, the recipient must have an e-mail address or a phone number attribute.
    Organisation unit contact Receives program notifications via e-mail or text message. To receive a program notification, the receiving organisation unit must have a registered contact person with e-mail address and phone number.
    Users at organisation unit: All users registered to the selected organisation unit receive program notifications via the internal DHIS2 messaging system. -
    User group All members of the selected user group receive the program notifications via the internal DHIS2 messaging system -
    Limit To Hierarchy Send notification only to those users who belong to any of the organisation unit in the hierarchy. This option is only available when User Group is selected as recipient.
    Parent OrgUnit Only Send notification only to those users who belong to parent organisation unit. This option is only available when User Group is selected as recipient.
    Program Attribute TrackedEntityAttribute can also be selected as recipient. This parameter will only be effective if TrackedEntityAttribute value type is PHONE_NUMBER/EMAIL.
  8. 点击**保存**。

创建程序阶段通知

  1. Open the Maintenance app and click Program and then 通知

    所选项目的现有程序阶段通知的列表 程序阶段打开。如果程序阶段没有任何程序 阶段通知,列表为空。

  2. 点击添加按钮,然后选择**程序阶段通知**。

  3. 点击**添加新**。

  4. 输入一个**名称**。

  5. 创建**主题模板**。

    Double-click the parameter names in the Parameters field to add 他们对你的主题。

    Note

    The subject is not included in text messages.

  6. 创建**消息模板**。

    Double-click the parameter names in the Parameters field to add 他们到您的消息。

    亲爱的A {w75KJ2mc4zz},欢迎前来预约 V {due _date}。

  7. In the When-to-send-it field, select what should trigger the 通知。

    Trigger Description Note
    Program stage completion The program stage notification is sent when the program stage is completed -
    Days scheduled (due date) The program stage notification is sent XX number of days before or after the due date You need to enter the number of days before or after the scheduled date that the notification will be send.
    Program Rule Notification will be triggered as a result of program rule execution. Program rule with ProgramRuleActionType.SENDMESSAGE need to be in place to make this trigger successful.
    1. Allow notification to be sent multiple times

      This flag can be used if notification is required to be sent multiple times. For example in case of repeatable program stage, same notification will be sent as many times as the stage is repeated.

  8. In the Recipients field, select who should receive the program 阶段通知。您可以选择:

    Recipient type Description Note
    Tracked entity instance Receives program notifications via e-mail or text message. To receive a program stage notification, the recipient must have an e-mail address or a phone number attribute.
    Organisation unit contact Receives program notifications via e-mail or text message. To receive a program stage notification, the receiving organisation unit must have a registered contact person with e-mail address and phone number.

    The system selects the same organisation unit as where the event took place.
    Users at organisation unit: All users registered to the selected organisation unit receive program notifications via the internal DHIS2 messaging system. -
    User group All members of the selected user group receive the program notifications via the internal DHIS2 messaging system -
    Limit To Hierarchy Send notification only to those users who belong to any of the organisation unit in the hierarchy. -
    Parent OrgUnit Only Send notification only to those users who belong to parent organisation unit. -
    Data Element Data Element associated with ProgramStage can be selected as recipient. Data Element will only be effective if DataElement has value type PHONE_NUMBER/EMAIL.
    Tracked Entity Attribute Tracked Entity Attribute associated with ProgramInstance/Enrollment can be selected as recipient. Attribute will only be effective if it has value type PHONE_NUMBER/EMAIL.
  9. 点击**保存**。

参考信息:程序通知参数

Program notification parameters to use in program notifications
Notification type Variable name Variable code
程序 Current date V{current_date}
Days since enrollment date V{days_since_enrollment_date}
Enrollment date V{enrollment_date}
Incident date V{incident_date}
Organisation unit name V{org_unit_name}
Program name V{program_name}
程序阶段 Current date V{current_date}
Days since due date V{days_since_due_date}
Days until due date V{days_until_due_date}
Due date V{due_date}
Organisation unit name V{org_unit_name}
Program name V{program_name}
Program stage name V{program_stage_name}
Event organisation unit V{event_org_unit_id}
Enrollment organisation unit V{enrollment_org_unit_id}
Program stage id V{program_stage_id}
Program id V{program_id}
Program instance id/Enrollment id V{enrollment_id}
Tracked entity id V{tracked_entity_id}
Event/Execution date V{event_date}

配置程序指示器

关于计划指标

程序指示符是基于数据元素和属性的表达式 跟踪实体的数量,可用于基于 式。计划指标包括汇总类型,分析 类型,表达式和过滤器。

根据分配的汇总类型评估计划指标, 表达式和过滤器。评估顺序为:

    • filter *将过滤成为 评估/汇总例程。
    • expression *将针对每个事件进行评估。
  1. 所有评估的表达式值将根据以下条件进行*统计* 程序指示器的聚合类型。

Program indicator components
Program rule component 描述
聚集类型 The aggregation type determines how the program indicator will be aggregated. The following aggregation types are available:
* Average
* Average (number)
* Average (number, disaggregation)
* Average (sum in organisation unit hierarchy)
* Average (sum of numbers)
* Average (sum of numbers, disaggregation)
* Average (Yes/No)
* Count
* Custom
The "custom" aggregation type allows you to specify the aggregation type in-line in the expression. All other aggregation types are applied to the entire expression.
Using the "custom" aggregation type might lead to an exception of the order of evaluation described above where individual parts of the expression can be evaluated and aggregated, as opposed to the entire expression being evaluated prior to aggregation.
* Default
* Max
* Min
* None
* Standard deviation
* Sum
* Variance
Analytics type The available analytics types are event and enrollment .

The analytics type defines whether the program indicator is calculated based on events or program enrollments. This has an impact on what type of calculations can be made.
* Events implies a data source where each event exists as an independent row. This is suitable for performing aggregations such as counts and sums.
* Enrollments implies a data source where all events for a single enrollment is combined on the same row. This allows for calculations which can compare event data from various program stages within a program enrollment.
Analytics period boundaries Defines the boundaries for the program indicator calculation. The boundaries determine which events or enrollments gets included in aggregations, always relative to the aggregate reporting period start and end. When creating the program indicator, the default boundaries will get preselected based on analytics type.
* For analytics type event , the default boundaries will be configured to encapsulate any events with an event date after the reporting period starts and before the reporting period ends.
* For analytics type enrollment , the default boundaries will encapsulate all enrollments with an enrollment date after the reporting date starts and before the reporting period ends. In addition, the default enrollment program indicator evaluates the newest event for all program stages regardless of date.

It is possible to change the upper and lower boundaries to include a longer or shorter period relative to the reporting period, or delete one of the boundaries - in effect returning all data before or after a certain period. It is also possible to add more constraints, for example to make an enrollment program indicator only include event data up to a given point in time.
* Boundary target: Can be incident date , event date , enrollment date or custom . Designates what is being constrained by the boundary.

custom is used make boundary that target either a date data element, tracked entity attribute or the presence of an event in a program stage. This is done with a custom expression on the form:
- Data element of type date: #{programStageUid.dataElementUid}.
#{A03MvHHogjR.a3kGcGDCuk6}
- Tracked entity attribute of type date: #{attributeUid}.
A{GPkGfbmArby}
- Presence of one event in a specific program stage: PS_EVENTDATE:programStageUid.
PS_EVENTDATE:A03MvHHogjR
Note This boundary target is only applicable to Analytics type Enrollment
* Analytics period boundary type: Defines whether the boundary is an end boundary - starting with "before...", or a start boundary - "after...". Also defines whether the boundary relates to the end of the aggregate reporting period or the start of the aggregate reporting period.
* Offset period by amount: In some cases, for example cohort analytics, the boundary should be offset relative to the aggregate reporting period when running pivots and reports. The offset period by amount is used to move the current boundary either back(negative) or forward(positive) in time. The amount and period type together will determine how big the offset will be. An example can be when making a simple enrollment cohort program indicator for a 1 year cohort, it might be enough to offset each boundary of the program indicator with "-1" and "Years"
* Period type: See above. Can be any period, e.g. Weekly or Quarterly .
Expression The expression defines how the indicator is being calculated. The expression can contain references to various entities which will be substituted with a related values when the indicator is calculated:
* Data elements: Will be substituted with the value of the data element for the time period and organisation unit for which the calculation is done. Refers to both program stage and data element.
* Attributes: Will be substituted with the value of the attribute for the person / tracked entity for which the calculation is done.
* Variables: Will be substituted with special values linked to the program, including incident date and date of enrollment for the person, current date and count of values in the expression for the time period and organisation unit for which the calculation is done.
* Constants: Will be substituted with the value of the constant.

The expression is a mathematical expression and can also contain operators.

For single event programs and tracker programs with analytics type event , the expression will be evaluated per event , then aggregated according to its aggregation type.

For tracker programs with analytics type enrollment , the expression will be evaluated per enrollment , then aggregated according to its aggregation type.
过滤 The filter is applied to events and filters the data source used for the calculation of the indicator. I.e. the filter is applied to the set of events before the indicator expression is being evaluated. The filter must evaluate to either true or false. It filter is applied to each individual event. If the filter evaluates to true then the event is included later in the expression evaluation, if not it is ignored. The filter can, in a similar way as expressions, contain references to data elements, attributes and constants.

The program indicator filter can in addition use logical operators. These operators can be used to form logical expressions which ultimately evaluate to either true or false. For example you can assert that multiple data elements must be a specific value, or that specific attributes must have numerical values less or greater than a constant.

In the Maintenance app, you manage the following program indicator objects:

Object type Available functions
计划指标 Create, edit, clone, share, delete, show details and translate
Program indicator group Create, edit, clone, share, delete, show details and translate

创建或编辑程序指示器

注意

程序指示器完全属于一个程序。

  1. 打开** Maintenance 应用程序,然后单击 Indicator ** > ** Program 指示符**。

  2. 点击添加按钮。

  3. Select a Program and enter:

    • 名称

    • 简称

    • 颜色

    • 图标

    • 描述

    • Select number of Decimals in data output .
  4. Select an Aggregation type .

  5. 如果要**以表格显示**,请选择一个。

  6. Assign one or multiple **Legend**s.

  7. (可选)输入汇总数据的** Category选项组合 出口**。

  8. (可选)输入汇总的**属性选项组合 数据导出**。

  9. 创建表达式。

    1. 点击**编辑表达式**。

    2. 根据数学运算符和 属性,变量和常量在右侧列出。

  10. 创建过滤器。

    1. 点击**编辑过滤器**。

    2. 根据数学运算符和 属性,变量和常量在右侧列出。

  11. 点击**保存**。

创建或编辑程序指示器组

  1. 打开** Maintenance 应用程序,然后单击 Indicator ** > ** Program 指标组**。

  2. 点击添加按钮。

  3. Enter Name and Code .

  4. 在可用程序指示符列表中,双击 您要分配给组的程序指示器。

  5. 点击**保存**。

参考信息:每种值类型的表达式和过滤器示例

下表显示了如何编写表达式和过滤器的示例 对于不同的数据元素和属性值类型:

Expression and filter examples per value type
Value types Example syntax
Integer

Negative integer

Positive or zero integer

Positive integer

Number

Percentage
Numeric fields, can be used for aggregation as an expression, or in filters:
#{mCXR7u4kNBW.K0A4BauXJDl} >= 3
Yes/No

Yes only
Boolean fields. Yes is translated to numeric 1, No to numeric 0. Can be used for aggregation as an expression, or in filters:
#{mCXR7u4kNBW.Popa3BauXJss} == 1
Text

Long text

Phone number

Email
Text fields. Can be checked for equality in filters:
#{mCXR7u4kNBW.L8K4BauIKsl} == 'LiteralValue'
Date

Age
日期字段。与 d2:daysBetween 函数结合使用时最有用,该函数可生成可聚合为表达式或在过滤器中使用的数字:
d2:daysBetween(#{mCXR7u4kNBW.JKJKBausssl},V{enrollment_date}) >100
也可以直接检查过滤器中的相等性:
#{mCXR7u4kNBW.JKJKBausssl} == '2011-10-28'

参考信息:在程序指示器表达式和过滤器中使用的函数,变量和运算符

包含属性,数据元素和常量的表达式 看起来像这样:

(A {GPkGfbmArby} +#{mCXR7u4kNBW.NFkjsNiQ9PH})* C {bCqvfPR02Im}

使用自定义聚合类型的表达式,因此可以使用 内联聚合类型看起来像 这个:

(sum(#{mCXR7u4kNBW.K0A4BauXJDl} *#{mCXR7u4kNBW.NFkjsNiQ9PH})/ sum(#{mCXR7u4kNBW.NFkjsNiQ9PH})))* 100

注意在表达式内部如何使用“ sum”聚合运算符 本身。

程序指示符表达式或过滤器中使用的函数

程序指示符表达式和过滤器支持以下范围 职能。这些函数可以应用于数据元素和属性:

Functions to use in a program indicator expression or filter
功能 Arguments 描述
d2:hasValue (object) Returns true if the data element/attribute has a value. Can be used in filters to distinguish between the number 0 and no value, and to distinguish between explicit "No" and no selection for a Yes/No field.
d2:minutesBetween (datetime, datetime) Produces the number of minutes between two data elements/attributes of type "date and time". When the first argument datetime comes before the second argument datetime, the number will be positive - in the opposite case, the number will be negative. The static datetime format is 'yyyy-MM-dd hh:mm'. Any of the arguments can be replaced with PS_EVENTDATE:(programStageUid) to compare the latest event date from a given program stage.
d2:daysBetween (date, date) Produces the number of days between two data elements/attributes of type date. When the first argument date comes before the second argument date, the number will be positive - in the opposite case, the number will be negative. The static date format is 'yyyy-MM-dd'. Any of the arguments can be replaced with PS_EVENTDATE:(programStageUid) to compare the latest event date from a given program stage.
d2:星期之间 (date, date) Produces the number of full weeks between two data elements/attributes of type date. When the first argument date comes before the second argument date, the number will be positive - in the opposite case, the number will be negative. The static date format is 'yyyy-MM-dd'. Any of the arguments can be replaced with PS_EVENTDATE:(programStageUid) to compare the latest event date from a given program stage.
d2:monthsBetween (date, date) Produces the number of full months between two data elements/attributes of type date. When the first argument date comes before the second argument date, the number will be positive - in the opposite case, the number will be negative. The static date format is 'yyyy-MM-dd'. Any of the arguments can be replaced with PS_EVENTDATE:(programStageUid) to compare the latest event date from a given program stage.
d2:年之间 (date, date) Produces the number of full years between two data elements/attributes of type date. When the first argument date comes before the second argument date, the number will be positive - in the opposite case, the number will be negative. The static date format is 'yyyy-MM-dd'. Any of the arguments can be replaced with PS_EVENTDATE:(programStageUid) to compare the latest event date from a given program stage.
d2:condition (boolean-expr, true-expr, false-expr) Evaluates the boolean expression and if true returns the true expression value, if false returns the false expression value. The conditional expression must be quoted. The true-expr and false-expr arguments must follow the rules of any program indicator expression (including functions).
d2:zing (expression) Returns zero if the expression is negative, otherwise returns the expression value. The expression must follow the rules of any program indicator expression (including functions).
d2:oizp (expression) Returns one if the expression is zero or positive, otherwise returns zero. The expression must follow the rules of any program indicator expression (including functions).
d2:zpvc (object, [,object ...]) 返回给定对象参数中数字零和正值的数量。可以提供任意数量的参数。
d2:relationshipCount ([relationshipTypeUid]) Produces the number of relationships of the given type that is connected to the enrollment or event. When no type is given, all types are counted.
d2:计数 (dataElement) Useful only for enrollment program indicators. Counts the number of data values that has been collected for the given program stage and data element in the course of the enrollment. The argument data element is supplied with the #{programStage.dataElement} syntax.
d2:countIfValue (dataElement, value) Useful only for enrollment program indicators. Counts the number of data values that matches the given literal value for the given program stage and data element in the course of the enrollment. The argument data element is supplied with the #{programStage.dataElement} syntax. The value can be a hard coded text or number, for example 'No_anemia' if only the values containing this text should be counted.
d2:countIfCondition (dataElement, condition) Useful only for enrollment program indicators. Counts the number of data values that matches the given condition criteria for the given program stage and data element in the course of the enrollment. The argument data element is supplied with the #{programStage.dataElement} syntax. The condition is supplied as a expression in single quotes, for example '<10' if only the values less than 10 should be counted.
如果 (boolean-expr, true-expr, false-expr) Evaluates the boolean expression and if true returns the true expression value, if false returns the false expression value. This is identical to the d2:condition function except that the boolean-expr is not quoted.
一片空白 (object) Returns true if the object value is missing (null), otherwise false.
isNotNull (object) Returns true if the object value is not missing (not null), otherwise false.
firstNonNull (object [, object ...]) Returns the value of the first object that is not missing (not null). Can be provided any number of arguments. Any argument may also be a numeric or string literal, which will be returned if all the previous objects have missing values.
最伟大的 (expression [, expression ...]) Returns the greatest (highest) value of the expressions given. Can be provided any number of arguments. Each expression must follow the rules of any program indicator expression (including functions).
最小 (expression [, expression ...]) Returns the least (lowest) value of the expressions given. Can be provided any number of arguments. Each expression must follow the rules of any program indicator expression (including functions).
log (expression [, base ]) Returns the natural logarithm (base e) of the numeric expression. If an integer is given as a second argument, returns the logarithm using that base.
log10 (expression) Returns the common logarithm (base 10) of the numeric expression.

使用“ hasValue”函数的过滤器如下所示:

d2:hasValue(#{mCXR7u4kNBW.NFkjsNiQ9PH})

使用“ relationshipCount(relationshipTypeUid)”函数的过滤器如下所示:

d2:relationshipCount('KLkjshoQ90U')

使用“ zing”和“ oizp”函数的表达式如下所示:

d2:zing(A {GPkGfbmArby})+ d2:oizp(#{mCXR7u4kNBW.NFkjsNiQ9PH}))

使用“ daysBetween”函数的表达式如下所示:

d2:daysBetween(#{mCXR7u4kNBW.k8ja2Aif1Ae},'2015-06-01')

使用“ yearBetween”函数将程序阶段“ mCXR7u4kNBW”的最新事件与注册日期进行比较的表达式如下所示:

d2:daysBetween(V {enrollment_date},PS_EVENTDATE:mCXR7u4kNBW)

使用“条件”函数的表达式如下所示:

d2:condition('#{mCXR7u4kNBW.NFkjsNiQ9PH}> 100',150,50)

使用“ countIfValue”函数的表达式仅计算收集值10的次数,如下所示:

d2:countIfValue(#{mCXR7u4kNBW.NFkjsNiQ9PH}),10)

使用“ zpvc”函数的表达式如下所示:

d2:zpvc(A {GPkGfbmArby}),#{mCXR7u4kNBW.NFkjsNiQ9PH}),4,-1)

使用“ if”和“ isnull”函数的表达式如下所示:

if(isNull(A {GPkGfbmArby}),10,20)

使用“ firstNonNull”函数的表达式如下所示:

firstNonNull(A {GPkGfbmArby}),#{mCXR7u4kNBW.NFkjsNiQ9PH},44)

使用“最大”函数的表达式如下所示:

最好的(#{mCXR7u4kNBW.k8ja2Aif1Ae},#{mCXR7u4kNBW.NFkjsNiQ9PH},1)

程序指示符表达式或过滤器中使用的变量

程序指示符表达式和过滤器支持以下范围 变量:

Variables to use in a program indicator expression or filter
变量 描述
event_date The date of when the event or the last event in the enrollment took place.
creation_date 在系统中创建事件或注册的日期。
due_date 事件到期的日期。
sync_date 事件或注册最后一次与Android应用程序同步的日期。
incident_date 事件发生的日期。
enrollment_date 跟踪的实体实例在程序中注册的日期。
enrollment_status Can be used to include or exclude enrollments in certain statuses.

When calculating the haemoglobin improvement/deterioration throughout a pregnancy, it might make sense to only consider completed enrollments. If non-completed enrollments is not filtered out, these will represent half-finished ANC followups, where the final improvement/deterioration is not yet established.
current_date 当前日期。
value_count 事件的表达式部分中非空值的数量。
zero_pos_value_count 事件的表达式部分中的正数值。
event_count 事件计数(与过滤器结合使用)。
enrollment_count The count of enrollments (useful in combination with filters). Aggregation type for the program indicator must be COUNT.
tei_count The count of tracked entity instances (useful in combination with filters). Aggregation type for the program indicator must be COUNT.
org_unit_count The count of organisation units (useful in combination with filters). Aggregation type for the program indicator must be COUNT.
program_stage_name Can be used in filters for including only certain program stages in a filter for tracker programs. Uses the name of the program stage:
V{program_stage_name} == 'ANC first visit'
program_stage_id Can be used in filters for including only certain program stages in a filter for tracker programs. Uses the unique identifier of the program stage:
V{program_stage_id} == 'YPSSfbmAtt1'
analytics_period_start Can be used in filters or expressions for comparing any date to the first date in each reporting period.
d2:daysBetween(#{WZbXY0S00lP.w4ky6EkVahL}, V{analytics_period_start})
analytics_period_end 可以在过滤器或表达式中使用,以将任何日期与每个报告期间的最后一个包含日期进行比较。
event_status Can be used in filters or expressions for comparing event status.
V{event_status} == 'COMPLETED'

使用“ Analytics(分析)期末”变量的过滤器仅包含 拥有LMP的女性 三个月:

d2:daysBetween(#{WZbXY0S00lP.w4ky6EkVahL},V {analytics_period_end})<= 84

使用“值计数”变量的表达式看起来像 这个:

(#{A03MvHHogjR.a3kGcGDCukuk6} +#{A03MvHHogjR.wQLfBvPrXqq})/ V {value_count}

使用“ event _date”和“ incident _date”变量的表达式 看起来像这样:

d2:daysBetween(V {incident_date},V {event_date})

操作员要在程序指示器过滤器中使用

Operators to use in a program indicator filter
Operator 描述
and Logical AND
or Logical OR
== Equal to
!= Not equal to
< Less than
<= Less than or equal to
> Greater than
>= Greater than or equal to

这些运算符可用于形成逻辑表达式,最终 评估为真或假。例如,您可以断言 多个数据元素必须是一个特定的值,或者那个特定的 属性的数值必须小于或大于常数。

同时使用属性和数据元素的过滤器如下所示:

A {cejWyOfXge6} =='Female'和#{A03MvHHogjR.a3kGcGDCuk6} <= 2

提示

DHIS2正在使用JEXL库来评估表达式 支持超出此范围的其他语法 文档。请参阅[项目首页中的参考 页面]( http://commons.apache.org/proper/commons-jexl/reference/syntax.html ) 了解如何创建更复杂的表达式

配置程序规则

关于计划规则

Program rules allows you to create and control dynamic behaviour of the user interface in the Tracker Capture and Event Capture apps. During data entry, the program rules expressions are evaluated each time the user interface is displayed, and each time a data element is changed. Most types of actions will take effect immediately when the user enters values in the Tracker Capture and Event Capture apps.

Program rule components
Program rule component 描述
Program rule action Each program rule contains one or multiple actions. These are the behaviours that are triggered in the user interface when the expression is true. Actions will be applied at once if the expression is true, and will be reverted if the expression is no longer true. There are several types of actions and you can have several actions in one program rule.
Program rule expression Each program rule has a single expression that determines whether the program rule actions should be triggered, if the expression evaluates to true. If the expression is true the program rule is in effect and the actions will be executed. If the expression is false, the program rule is no longer in effect and the actions will no longer be applied.

You create the expression with standard mathematical operators, custom functions, user-defined static values and program rule variables. The program rule variables represent attribute and data element values which will be evaluated as part of the expression.
Program rule variable Program rule variables lets you include data values and attribute values in program rule expressions. Typically, you'll have to create one or several program rule variables before creating a program rule. This is because program rules expressions usually contain at least one data element or attribute value to be meaningful.

The program rule variables are shared between all rules in your program. When you create multiple program rules for the same program, these rules will share the same library of program rule variables.

In the Maintenance app, you manage the following program rule objects:

Object type Available functions
Program rule Create, edit, clone, delete, show details and translate
Program rule variable Create, edit, clone, share, delete, show details and translate

工作流程

  1. 在** Maintenance **应用程序中,如果需要,请创建程序规则变量 需要。

  2. In the Maintenance app, create the program rule:

    1. 输入程序规则详细信息。

    2. 创建程序规则表达式。

    3. 定义程序规则操作。

  3. In the Tracker Capture or Event Capture apps, verify that 程序规则的行为符合预期。

创建或编辑程序规则变量

  1. Open the Maintenance app and click Program > Program rule 变量

  2. 点击添加按钮。

  3. Select a Program and enter a Name .

  4. Select if you want to Use code for option set .

    仅当数据元素或已跟踪时,此选项才有效 实体属性连接到选项集。如果不选择 此选项时,程序规则变量将填充 选项集的名称。如果选择该选项,则程序规则 变量将使用选项集的代码填充。

  5. 选择**来源类型**,然后输入所需信息。

    根据来源类型,您必须选择例如 程序阶段****数据元素**或**跟踪实体属性

    源类型确定程序规则变量的方式 填充一个值。

    Source type Description
    Data element from the newest event for a program stage This source type works the same way as Data element from the newest event in the current program , except that it only evaluates values from one program stage.

    This source type can be useful in program rules where the same data element is used in several program stages, and a rule needs to evaluate the newest data value from within one specific stage.
    Data element from the newest event in the current program This source type is used when a program rule variable needs to reflect the newest known value of a data element, regardless of what event the user currently has open.

    This source type is populated slightly differently in Tracker Capture and Event Capture apps:

    Tracker Capture : the program rule variable will be populated with the newest data value collected for the given data element within the enrollment.

    Event Capture : the program rule variable will be populated with the current events data.
    NB Future dates are "newer" than current or past dates.
    Data element in current event Program rule variables with this source type will contain the data value from the same event that the user currently has open.

    This is the most commonly used source type, especially for skip logic (hide actions) and warning/error rules.
    Data element from previous event Program rule variables with this source type will contain the value from a specified data element from a previous event. Only older events is evaluated, not including the event that the user currently has open.

    This source type is commonly used when a data element only should be collected once during an enrollment, and should be hidden in subsequent events.

    Another use case is making rules for validating input where there is an expected progression from one event to the next - a rule can evaluate whether the previous value is higher/lower and give a warning if an unexpected value is entered.
    Calculated value Program rule variable with this source type is not connected directly to any form data - but will be populated as a result of some other program rules ASSIGN action.

    This variable will be used for making preliminary calculations, having a ASSIGN program rule action and assigning a value, this value can be used by other program rules - potentially making the expressions simpler and more maintanable.

    These variables will not be persisted and will stay in memory only during the exectution of the set of program rules. Any program rule that assigns a data value to a preliminary calculated value would normally also have a priority assigned - to make sure that the preliminary caculation is done before the rule that consumes the calculated value.
    Tracked entity attribute Populates the program rule variable with a specified tracked entity attribute for the current enrollment.

    Use this is the source type to create program rules that evaluate data values entered during registration.

    This source type is also useful when you create program rules that compare data in events to data entered during registration.

    This source type is only used for tracker programs (programs with registration).
  6. 点击**保存**。

创建或编辑程序规则

注意

程序规则完全属于一个程序。

  1. 打开** Maintenance 应用程序,然后单击 Program ** > ** Program 规则**。

  2. 点击添加按钮。

  3. 输入程序规则详细信息。这些字段未显示给 最终用户,它们仅适用于程序管理员。

    • 程序

    • 仅适用于计划阶段的触发规则

      如果选择了程序阶段,则该程序规则将仅对所选程序阶段运行, 而不是针对程序中的每个程序阶段运行。

    • 名称

    • 描述

    • 优先

      假设您的程序中有16条程序规则。您 使用以下优先级配置程序规则 设置:

      • 程序规则A的优先级1

      • 计划规则B-K的优先级2

      • 程序规则L-P没有优先级

      结果:系统运行以下程序规则 订购:

      1. 计划规则A

      2. 程序规则B-K(您无法在其中找到或配置 系统运行这些程序规则的顺序)

      3. 程序规则L-P。

  4. Click Enter program rule expression and create the program rule 借助变量,函数和运算符进行表达。

  5. Click Define program rule actions and create the actions 当表达式为真时执行。

    1. Click the add button, select an Action and enter the 需要的信息。

      根据操作类型,您必须执行不同的操作 设置类型。对于某些操作类型,还必须输入 自由文本或创建表达式。

      Action type Required settings Description
      Assign value Data element to assign value to

      Program rule variable to assign value to

      Expression to evaluate and assign
      Used to help the user calculate and fill out fields in the data entry form. The idea is that the user shouldn’t have to fill in values that the system can calculate, for example BMI.

      When a field is assigned a value, the user sees the value but the user can't edit it.

      Example from Immunization stock card i Zambia: The data element for vaccine stock outgoing balance is calculated based on the data element for incoming stock balance minus the data elements for consumption and wastage.

      Advanced use: configure an 'assign value' to do a part of a calculation and then assign the result of the calculation to a program rule variable. This is the purpose with the "Calculated value" program rule variable.
      Display text Display widget

      Static text

      Expression to evaluate and display after static text
      Used to display information that is not an error or a warning, for example feedback to the user. You can also use this action to display important information, for example the patient's allergies, to the user.
      Display key/value pair Display widget

      Key label

      Expression to evaluate and display as value
      Used to display information that is not an error or a warning.

      Example: calculate number of weeks and days in a pregnancy and display it in the format the clinician is used to see it in. The calculation is based on previous recorded data.
      Error on complete Data element to display error next to

      Tracked entity attribute to display error next to

      Static text

      Expression to evaluate and display after static text
      Used whenever you've cross-consistencies in the form that must be strictly adhered to. This action prevents the user from continuing until the error is resolved.

      This action differs from the regular Show error since the error is not shown until the user tries to actually complete the form.

      If you don't select a data element or a tracked entity attribute to display the error next to, make sure you write a comprehensive error message that helps the user to fix the error.
      Hide field Data element to hide

      Tracked entity attribute to hide

      Custom message for blanked field
      Used when you want to hide a field from the user.

      Custom message for blanked field allows you to define a custom message displayed to the user in case the program rule hides and blanks out the field after the user typed in or selected a value.

      If a hide field action hides a field that contains a value, the field will always removed. If no message is defined, a standard message will be displayed to alert the user.
      Hide section Program stage section to hide Used when you want to hide a section in a program stage from the user.
      Prevent adding new events to stage Program stage where users will not be able to add new events Used when you do not want users to add any more events to a program stage. Existing events will not be hidden.
      Make field mandatory Data element to make mandatory

      Tracked entity attribute to make mandatory
      Used when you want to make a data element or tracked entity attribute mandatory so they have to be filled out before the form can be saved.
      Show error Data element to display error next to

      Tracked entity attribute to display error next to

      Static text

      Expression to evaluate and display after static text
      Used whenever there are rules which must strictly be adhered to. The show error action prevents the user from continuing until the error is resolved.

      Such a strict validation should only be used when it's certain that the evaluated expression is never true unless the user has made a mistake in data entry.

      It's mandatory to define a message that is shown to the user when the expression is true and the action is triggered.

      You can select which data element or tracked entity attribute to link the error to. This will help the user to fix the error.

      In case several data elements or attributes are involved, select the one that is most likely that the user would need to change.
      Show warning Data element to display warning next to

      Tracked entity attribute to display warning next to

      Static text

      Expression to evaluate and display after static text
      Used to give the user a warning about the entered data, but at the same time to allow the user to save and continue.

      You can use warnings to help the user avoid errors in the entered data, while at the same time allow the user to consciously disregard the warnings and save a value that is outside preset expectations.

      Static text defines the message shown to the user when the expression is true and the action is triggered.

      You can select which data element or tracked entity attribute to link the error to. This will help the user to fix the error.

      In case several data elements or attributes are involved, select the one that is most likely that the user would need to change.
      Warning on complete Data element to display warning next to

      Tracked entity attribute to display warning next to

      Static text

      Expression to evaluate and display after static text
      Used to give the user a warning if he/she tries to complete inconsistent data, but at the same time to allow the user to continue. The warning is shown in a dialog when the user completes the form.

      Static text defines the message shown to the user when the expression is true and the action is triggered. This field is mandatory.

      You can select which data element or tracked entity attribute to link the error to. This will help the user to fix the error.

      If you don't select a data element or a tracked entity attribute to display the error next to, make sure you write a comprehensive error message that helps the user to fix the error.
      Send Message Message template to send Send Message triggers a notification based on provided message template. This action will be taken immediately. The message template will be parsed and variables will be substituted with actual values.
      Schedule Message Message template to send

      Data field which contains expression to evaluate the date which notification should be sent at. If this expression results in any value other than Date, then resultant will be discarded and notification will not get scheduled.
      Schedule Message will schedule notification at date provided by Expression in the data field. Sample expression is given below
      d2:addDays( '2018-04-20', '2' )
      Message template will be parsed and variables will be substituted with actual values.
      Hide option Data element to hide option for

      Tracked entity attribute to hide option for

      Option that should be hidden
      Used to selectively hide a single option for an option set in a given data element/tracked entity attribute.

      When combined with show option group the hide option takes presedence.
      Hide option group Data element to hide option group for

      Tracked entity attribute to hide option group for

      Option group that should be hidden
      Used to hide all options in a given option group and data element/tracked entity attribute.

      When combined with show option group the hide option group takes precedence.
      Show option group Data element to show option group for

      Tracked entity attribute to show option group for

      Option group that should be shown
      Used to show only options from a given option group in a given data element/tracked entity attribute. To show an option group implicitly hides all options that is not part of the group(s) that is shown.
    2. Click Save .

    3. (Optional) Repeat above steps to add more actions.

  6. 点击**保存**。

示例:程序规则

注意

您可以在演示服务器上查看所有示例: https://play.dhis2.org/dev/dhis-web-maintenance/#/list/programSection/programRule

本示例说明如何配置程序规则 怀孕的周数和天数,并将结果显示在 临床医生用来查看的格式。计算基于 先前记录 数据。

  1. ** Data **字段中的完整表达式:

    d2:concatenate(d2:weeksBetween(#{lmp},V {current_date}),'+',
    d2:modulus(d2:daysBetween(#{lmp},V {current_date}),7))
    

This example shows how to configure a program rule to display text in the Feedback widget in the Tracker Capture app.

This example shows how to configure a program rule to always display certain data in the Feedback widget in the Tracker Capture app. This is useful when you want to make sure that vital data, for example medicine allergies, is always visible.

通过使用“分配值”类型的程序规则,您可以计算 “访问时的胎龄”值并将其填写在数据输入表单中。您 配置程序规则以基于以下条件计算“访问时的胎龄” 在“ LMP日期”或“超声估计到期 日期”。

参考信息:程序规则表达式中使用的运算符和函数

提示

您可以相互嵌套函数,并使用子表达式来嵌套 形成更复杂的条件。一个产生妊娠的例子 周龄,根据最近的月经日期:

d2:floor(d2:daysBetween(#{lastMenstrualDate},V {event_date})/ 7)

提示

源类型将确定d2:函数调用的方式 评估(源域)参数。

示例:其中\#{hemoglobinCurrent}设置为源类型** Data 当前事件中的元素**。以下函数调用带有评估 是否在当前事件中输入了血红蛋白。

d2:hasValue('hemoglobinCurrent')

示例:其中\#{hemoglobin}设置为源类型**数据元素 来自当前程序中的最新事件**。以下功能 致电以评估是否存在血红蛋白值 注册中的任何事件。

d2:hasValue('hemoglobin')

示例:其中\#{hemoglobinPrevious}设置为源类型** Data 先前事件中的元素**。下面的函数调用 评估是否存在血红蛋白值 当前事件之前的事件。

d2:hasValue('hemoglobinPrevious')

Possible operators to use in a program rule expression
Operator 描述
+ Add numbers together
-- Subtract numbers from each other
* Multiply two numbers
/ Divide two numbers
% The modulus of two numbers
&& Logical AND. True only when the expression on the left and right side is true. The left and right side can be yes/no, yes only or a sub-expression in parenthesis.
|| Logical OR. True when either the expression on the left or the expression on the right side is true. The left and right side can be yes/no, yes only or a sub-expression in parenthesis.
> Left number greater than right number
>= Left number greater than or equal to right number
< Left number less than right number
<= Left number less than or equal to right number.
== Left side equal to right side. Supports numbers, text, yes/no and yes only.
!= Left side not equal to right side. Supports numbers, text, yes/no and yes only.
! Negates the following value. Can be used for yes/no, yes only or a sub-expression in parenthesis.
() Parenthesis is used to group sub-expressions.
Custom functions to use in a program rule expression
功能 Arguments 描述
d2:ceil (number) 将输入参数**向上舍入**到最接近的整数。
示例:
d2:ceil(#{hemoglobinValue})
d2:楼层 (number) Rounds the input argument down to the nearest whole number.
An example producing the number of weeks the woman is pregnant. Notice that the sub-expression #{gestationalAgeDays}/7 is evaluated before the floor function is executed:
d2:floor(#{gestationalAgeDays}/7)
d2:圆 (number [, decimals]) Rounds the input argument to the nearest integer. An optional second argument can be provided to specify a number of decimal places to which the number is to be rounded.
Example: d2:round(1.25, 1) = 1.3
d2:模数 (number,number) Produces the modulus when dividing the first with the second argument.
An example producing the number of days the woman is into her current pregnancy week:
d2:modulus(#{gestationalAgeDays},7)
d2:zing (number) 如果值是负数,则将数字类型的参数评估为零,否则为值本身。
d2:oizp (number) 如果值为零或正数,则将类型为number的参数评估为1,否则为零。
d2:串联 (object, [,object, object,...]) Produces a string concatenated string from the input parameters. Supports any number of parameters. Will mainly be in use in future action types, for example to display gestational age with d2:concatenate('weeks','+','gestationalageDays').
d2:daysBetween (date, date) Produces the number of days between the first and second argument. When the first argument date comes before the second argument date, the number will be positive - in the opposite case, the number will be negative. The static date format is 'yyyy-MM-dd'.
Example, calculating the gestational age(in days) of a woman, based on the last menstrual period and the current event date:
d2:daysBetween(#{lastMenstrualDate},V{event_date})
d2:星期之间 (date, date) Produces the number of full weeks between the first and second argument. When the first argument date comes before the second argument date, the number will be positive - in the opposite case, the number will be negative. The static date format is 'yyyy-MM-dd'.
d2:monthsBetween (date, date) Produces the number of full months between the first and second argument. When the first argument date comes before the second argument date, the number will be positive - in the opposite case, the number will be negative. The static date format is 'yyyy-MM-dd'.
d2:年之间 (date, date) Produces the number of years between the first and second argument. When the first argument date comes before the second argument date, the number will be positive - in the opposite case, the number will be negative. The static date format is 'yyyy-MM-dd'.
d2:addDays (date, number) Produces a date based on the first argument date, adding the second argument number of days.
An example calculating the pregnancy due date based on the last menstrual period:
d2:addDays(#{lastMenstrualDate},'283')
d2:计数 (sourcefield) Counts the number of values that is entered for the source field in the argument. The source field parameter is the name of one of the defined source fields in the program - see example
Example usage where #{previousPregnancyOutcome} is one of the source fields in a repeatable program stage "previous pregnancy":
d2:count('previousPregnancyOutcome')
d2:countIfValue (sourcefield,text) Counts the number of matching values that is entered for the source field in the first argument. Only occurrences that matches the second argument is counted. The source field parameter is the name of one of the defined source fields in the program - see example.
Example usage where #{previousPregnancyOutcome} is one of the source fields in a repeatable program stage "previous pregnancy". The following function will produce the number of previous pregnancies that ended with abortion:
d2:countIfValue('previousPregnancyOutcome','Abortion')
d2:countIfZeroPos (sourcefield) Counts the number of values that is zero or positive entered for the source field in the argument. The source field parameter is the name of one of the defined source fields in the program - see example.
Example usage where #{fundalHeightDiscrepancy} is one of the source fields in program, and it can be either positive or negative. The following function will produce the number of positive occurrences:
d2:countIfZeroPos('fundalHeightDiscrepancy')
d2:hasValue (sourcefield) Evaluates to true of the argument source field contains a value, false if no value is entered.
Example usage, to find if the source field #{currentPregnancyOutcome} is yet filled in:
d2:hasValue('currentPregnancyOutcome')
d2:zpvc (object, [,object, object,...]) 返回给定对象参数中数字零和正值的数量。可以提供任意数量的参数。
d2:validatePattern (text, regex-pattern) 如果输入文本与提供的正则表达式模式完全匹配,则评估为 true。正则表达式需要转义。
示例表达式,如果数字不在模式 9999/99/9 上则触发操作,
!d2:validatePattern(A{nrc},'\\d{6}\/\\d{2}\/\\d')
示例表达式,如果地址不包含字母或空格,则触发操作,然后是空格,然后是数字:
!d2:validatePattern(A{registrationAddress},'[\\w ]+ \\d+')
示例,如果名称包含任何数字则触发操作:
!d2:validatePattern(A{name},'[^\\d]*')
示例表达式,如果手机号码包含非法号码序列 555:
d2:validatePattern(A{mobile} ,'.*555.*')
d2:左 (text, num-chars) Evaluates to the left part of a text, num-chars from the first character.
The text can be quoted or evaluated from a variable:
d2:left(#{variableWithText}, 3)
d2:对 (text, num-chars) Evaluates to the right part of a text, num-chars from the last character.
The text can be quoted or evaluated from a variable:
d2:right(#{variableWithText}, 2)
d2:子字符串 (text, start-char-num, end-char-num) Evaluates to the part of a string specified by the start and end character number.
Example expression:
d2:substring(#{variableWithText}, 1, 3) If the #{variableWithText} in the above example was 'ABCD', then the result of the evaluation would be 'BC'
d2:分割 (text, delimiter, element-num) Split the text by delimiter, and keep the nth element(0 is the first).
The text can be quoted or evaluated from a variable, the delimiter must be quoted:
d2:split(#{variableWithText}, '-', 1)
Note: comma delimiter(,) is not supported.
d2:长度 (text) Find the length of a string.
Example:
d2:length(#{variableWithText})
d2:inOrgUnitGroup (text) Evaluates whether the current organisation unit is in the argument group. The argument can be defined with either ID or organisation unit group code. The current organisation unit will be the event organisation unit when the rules is triggered in the context of an event, and the enrolling organisation unit when the rules is triggered in the event of a TEI registration form.
Example expression:
d2:inOrgUnitGroup('HIGH_RISK_FACILITY')
d2:hasUserRole (user role) 如果当前用户具有此角色,则返回 true,否则返回 false
Example expression:
d2:hasUserRole('UYXOT4A3ASA')
d2:zScoreWFA Z-Score weight for age indicator 根据 WHO 年龄别体重指标提供的数据计算 z 分数。 e 根据重量值在 -3.5 到 3.5 之间变化。
表达式示例:
d2:zScoreWFA( 年龄、体重、性别 )
性别 > 默认情况下,性别被视为女性。以下任何代码都可用于>表示男性: 'Male', 'MALE', 'male', 'ma', 'm', 'M', 0, false
d2:zScoreHFA Z-Score height for age indicator Calculates z-score based on data provided by WHO height-for-age indicator. Its value varies between -3.5 to 3.5 depending upon the value of height.
Example expression:
d2:zScoreHFA( ageInMonths, height, gender )
d2:zScoreWFH Z-Score weight for height indicator Calculates z-score based on data derived from the WHO weight-for-length and weight-for-height indicators. The data used for girls can be found here and for boys here . Its value varies between -3.5 to 3.5 depending upon the value of the weight.
Example expression:
d2:zScoreWFH( height, weight, gender )
d2:minValue Get minimum value for provided item Function gets minimum value of provided data element across entire enrollment.
Example expression:
d2:minValue( 'blood-pressure' )
d2:maxValue Get maximum value for provided item Function gets maximum value of provided data element across entire enrollment.
Example expression:
d2:maxValue( 'blood-pressure' )
d2:extractDataMatrixValue Get GS1 value based on application identifier 给定一个使用 gs1 数据矩阵标准格式化的字段值和一个来自 GS1 应用程序标识符的字符串键。该函数查找并返回链接到提供的键的值。
示例表达式:
d2:extractDataMatrixValue( 'gtin', A{GS1 Value} )
Data matrix codes
AI Data Title 描述 Fixed Length
00 SSCC SSCC (Serial Shipping Container Code) 20
01 GTIN Global Trade Item Number 16
02 CONTENT GTIN of Trade Items Contained in a logistic unit 16
10 LOT_NUMBER Batch or lot number 变量
11 PROD_DATE Production date (YYMMDD) 8
12 DUE_DATE Due date (YYMMDD) 8
13 PACK_DATE Packaging date (YYMMDD) 8
15 BEST_BEFORE_DATE Best before date (YYMMDD) 8
16 SELL_BY Sell by date (YYMMDD) 8
17 EXP_DATE Expiration date (YYMMDD) 8
20 VARIANT Internal Product variant 4
21 SERIAL_NUMBER Serial number 变量
22 CPV Consumer product variant 变量
235 TPX Third Party Controlled, Serialised Extension of Global Trade Item Number (GTIN) (TPX) 变量
240 ADDITIONAL_ID Additional product identification assigned by the manufacturer 变量
241 CUSTOMER_PART_NUMBER Customer part number 变量
242 MTO_VARIANT_NUMBER Made-to-Order Variation Number 变量
243 PCN Packaging component number 变量
250 SECONDARY_SERIAL Secondary serial number 变量
251 REF_TO_SOURCE Reference to source entity 变量
253 GDTI Global Document Type Identifier 变量
254 GLN_EXTENSION_COMPONENT GLN Extension component 变量
255 GCN Global Coupon Number (GCN) 变量
30 VAR_COUNT Variable count 变量
310* NET_WEIGHT_KG Net weight, kilograms (variable measure trade item 变量
311* LENGTH_M Length or first dimension, metres (variable measure trade item) 变量
312* WIDTH_M Width, diameter, or second dimension, metres (variable measure trade item) 变量
313* HEIGHT_M Depth, thickness, height, or third dimension, metres (variable measure trade item) 变量
314* AREA_M2 Area, square metres (variable measure trade item) 变量
315* NET_VOLUME_L Net volume, litres (variable measure trade item) 变量
316* NET_VOLUME_M3 Net volume, cubic metres (variable measure trade item) 变量
320* NET_WEIGHT_LB Net weight, pounds (variable measure trade item) 变量
321* LENGTH_I Length or first dimension, inches (variable measure trade item) 变量
322* LENGTH_F Length or first dimension, feet (variable measure trade item) 变量
323* LENGTH_Y Length or first dimension, yards (variable measure trade item) 变量
324* WIDTH_I Width, diameter, or second dimension, inches (variable measure trade item) 变量
325* WIDTH_F Width, diameter, or second dimension, feet (variable measure trade item) 变量
326* WIDTH_Y Width, diameter, or second dimension, yards(variable measure trade item) 变量
327* HEIGHT_I Depth, thickness, height, or third dimension, inches (variable measure trade item) 变量
328* HEIGHT_F Depth, thickness, height, or third dimension, feet (variable measure trade item) 变量
329* HEIGHT_Y Depth, thickness, height, or third dimension, yards (variable measure trade item) 变量
330* GROSS_WEIGHT_GF Logistic weight, kilograms 变量
331* LENGTH_M_LOG Length or first dimension, metres 变量
332* WIDTH_M_LOG Width, diameter, or second dimension, metres 变量
333* HEIGHT_M_LOG Depth, thickness, height, or third dimension, metres 变量
334* AREA_M2_LOG Area, square metres 变量
335* VOLUME_L_LOG Logistic volume, litres 变量
336* VOLUME_M3_LOG Logistic volume, cubic metres 变量
337* KG_PER_M2 Kilograms per square metre 变量
340* GROSS_WHEIGHT_LB Logistic weight, pounds 变量
341* LENGTH_I_LOG Length or first dimension, inches 变量
342* LENGTH_F_LOG Length or first dimension, feet 变量
343* LENGTH_Y_LOG Length or first dimension, yards 变量
344* WIDTH_I_LOG Width, diameter, or second dimension, inches 变量
345* WIDTH_F_LOG Width, diameter, or second dimension, feet 变量
346* WIDTH_Y_LOG Width, diameter, or second dimension, yards 变量
347* HEIGHT_I_LOG Depth, thickness, height, or third dimension, inches 变量
348* HEIGHT_F_LOG Depth, thickness, height, or third dimension, feet 变量
349* HEIGHT_Y_LOG Depth, thickness, height, or third dimension, yards 变量
350* AREA_I2 Area, square inches (variable measure trade item) 变量
351* AREA_F2 Area, square feet (variable measure trade item) 变量
352* AREA_Y2 Area, square yards (variable measure trade item) 变量
353* AREA_I2_LOG Area, square inches 变量
354* AREA_F2_LOG Area, square feet 变量
355* AREA_Y2_LOG Area, square yards 变量
356* NET_WEIGHT_T Net weight, troy ounces (variable measure trade item) 变量
357* NET_VOLUME_OZ Net weight (or volume), ounces (variable measure trade item) 变量
360* NET_VOLUME_Q Net volume, quarts (variable measure trade item) 变量
361* NET_VOLUME_G Net volume, gallons U.S. (variable measure trade item) 变量
362* VOLUME_Q_LOG Logistic volume, quarts 变量
363* VOLUME_G_LOG Logistic volume, gallons U.S. 变量
364* VOLUME_I3 Net volume, cubic inches (variable measure trade item) 变量
365* VOLUME_F3 Net volume, cubic feet (variable measure trade item) 变量
366* VOLUME_Y3 Net volume, cubic yards (variable measure trade item) 变量
367* VOLUME_I3_LOG Logistic volume, cubic inches 变量
368* VOLUME_F3_LOG Logistic volume, cubic feet 变量
369* VOLUME_Y3_LOG Logistic volume, cubic yards 变量
37 COUNT Count of trade items or trade item pieces contained in a logistic unit 变量
390* AMOUNT Applicable amount payable or Coupon value, local currency 变量
391* AMOUNT_ISO Applicable amount payable with ISO currency code 变量
392* PRICE Applicable amount payable, single monetary area (variable measure trade item) 变量
393* PRICE_ISO Applicable amount payable with ISO currency code (variable measure trade item) 变量
394* PRCNT_OFF Percentage discount of a coupon 变量
395* PRICE_UOM Amount Payable per unit of measure single monetary area (variable measure trade item) N4+N6
400 ORDER_NUMBER Customers purchase order number 变量
401 GINC Global Identification Number for Consignment (GINC) 变量
403 ROUTE Routing code 变量
410 SHIP_TO_GLOB_LOC Ship to / Deliver to Global Location Number (GLN) 变量
411 BILL_TO_LOC Bill to / Invoice to Global Location Number (GLN) 变量
412 PURCHASED_FROM Purchased from Global Location Number (GLN) 变量
413 SHIP_FOR_LOG Ship for / Deliver for - Forward to Global Location Number (GLN) 变量
414 LOC_NUMBER Identification of a physical location - Global Location Number (GLN) 变量
415 PAY_TO 发票方的全球位置编号 (GLN) 变量
416 PROD_SERV_LOC Global Location Number (GLN) of the production or service location 变量
417 PARTY Party Global Location Number (GLN) 变量
420 SHIP_TO_POST Ship to / Deliver to postal code within a single postal authority 变量
421 SHIP_TO_POST_ISO Ship to / Deliver to postal code with ISO country code 变量
422 ORIGIN Country of origin of a trade item 变量
423 COUNTRY_INITIAL_PROCESS Country of initial processing 变量
424 COUNTRY_PROCESS Country of processing 变量
425 COUNTRY_DISASSEMBLY Country of disassembly 变量
426 COUNTRY_FULL_PROCESS Country covering full process chain 变量
427 ORIGIN_SUBDIVISION Country subdivision Of origin 变量
4300 SHIP_TO_COMP Ship-to / Deliver-to company name 变量
4301 SHIP_TO_NAME Ship-to / Deliver-to contact 变量
4302 SHIP_TO_ADD1 Ship-to / Deliver-to address line 1 变量
4303 SHIP_TO_ADD2 Ship-to / Deliver-to address line 2 变量
4304 SHIP_TO_SUB Ship-to / Deliver-to suburb 变量
4305 SHIP_TO_LOCALITY Ship-to / Deliver-to locality 变量
4306 SHIP_TO_REG Ship-to / Deliver-to region 变量
4307 SHIP_TO_COUNTRY Ship-to / Deliver-to country code 变量
4308 SHIP_TO_PHONE Ship-to / Deliver-to telephone number 变量
4310 RTN_TO_COMP Return-to company name 变量
4311 RTN_TO_NAME Return-to contact 变量
4312 RTN_TO_ADD1 Return-to address line 1 变量
4313 RTN_TO_ADD2 Return-to address line 2 变量
4314 RTN_TO_SUB Return-to suburb 变量
4315 RTN_TO_LOCALITY Return-to locality 变量
4316 RTN_TO_REG Return-to region 变量
4317 RTN_TO_COUNTRY Return-to country code 变量
4318 RTN_TO_POST Return-to postal code 变量
4319 RTN_TO_PHONE Return-to telephone number 变量
4320 SRV_DESCRIPTION Service code description 变量
4321 DANGEROUS_GOODS Dangerous goods flag 变量
4322 AUTH_LEAV Authority to leave 变量
4323 SIG_REQUIRED Signature required flag 变量
4324 NBEF_DEL_DT Not before delivery date time 变量
4325 NAFT_DEL_DT Not after delivery date time 变量
4326 REL_DATE Release date 变量
7001 NSN NATO Stock Number (NSN) 变量
7002 MEAT_CUT UN/ECE meat carcasses and cuts classification 变量
7003 EXP_TIME Expiration date and time 变量
7004 ACTIVE_POTENCY Active potency 变量
7005 CATCH_AREA Catch area 变量
7006 FIRST_FREEZE_DATE First freeze date 变量
7007 HARVEST_DATE Harvest date 变量
7008 AQUATIC_SPECIES Species for fishery purposes 变量
7009 FISHING_GEAR_TYPE Fishing gear type 变量
7010 PROD_METHID Production method 变量
7020 REFURB_LOT Refurbishment lot ID 变量
7021 FUNC_STAT Functional status 变量
7022 REV_STAT Revision status 变量
7023 GIAI_ASSEMBLY Global Individual Asset Identifier (GIAI) of an assembly 变量
703* PROCESSOR_NUMBER Number of processor with ISO Country Code 变量
7040 UIC_EXT GS1 UIC with Extension 1 and Importer index 变量
710 NHRN_PZN National Healthcare Reimbursement Number (NHRN) - Germany PZN 变量
711 NHRN_CIP National Healthcare Reimbursement Number (NHRN) - France CIP 变量
712 NHRN_CN National Healthcare Reimbursement Number (NHRN) - Spain CN 变量
713 NHRN_DRN National Healthcare Reimbursement Number (NHRN) - Brasil DRN 变量
714 NHRN_AIM National Healthcare Reimbursement Number (NHRN) - Portugal AIM 变量
723* CERT_NUMBER Certification reference 变量
7240 PROTOCOL Protocol ID 变量
8001 DIMENSIONS Roll products (width, length, core diameter, direction, splices) 变量
8002 CMT_NUMBER Cellular mobile telephone identifier 变量
8003 GRAI Global Returnable Asset Identifier (GRAI) 变量
8004 GIAI Global Individual Asset Identifier (GIAI) 变量
8005 PRICE_PER_UNIT Price per unit of measure 变量
8006 ITIP Identification of an individual trade item piece (ITIP) 变量
8007 IBAN International Bank Account Number (IBAN) 变量
8008 PROD_TIME Date and time of production 变量
8009 OPTSEN Optically Readable Sensor Indicator 变量
8010 CPID Component/Part Identifier (CPID) 变量
8011 CPID_SERIAL Component/Part Identifier serial number (CPID SERIAL) 变量
8012 VERSION Software version 变量
8013 GMN Global Model Number (GMN) 变量
8017 GSRN_PROVIDER Global Service Relation Number (GSRN) to identify the relationship between an organisation offering services and the provider of services 变量
8018 GSRN_RECIPIENT Global Service Relation Number (GSRN) to identify the relationship between an organisation offering services and the recipient of services 变量
8019 SRIN Service Relation Instance Number (SRIN) 变量
8020 REF_NUMBER Payment slip reference number 变量
8026 ITIP_CONTENT Identification of pieces of a trade item (ITIP) contained in a logistic unit 变量
8110 COUPON_USA Coupon code identification for use in North America 变量
8111 POINTS Loyalty points of a coupon 变量
8121 POSITIVE_OFFER_COUPON_USA Paperless coupon code identification for use in North America 变量
8200 PRODUCT_URL Extended Packaging URL 变量
90 AGREEMENT_INTERNAL Information mutually agreed between trading partners 变量
91 COMPANY_INTERNAL_1 Company internal information 变量
92 COMPANY_INTERNAL_2 Company internal information 变量
93 COMPANY_INTERNAL_3 Company internal information 变量
94 COMPANY_INTERNAL_4 Company internal information 变量
95 COMPANY_INTERNAL_5 Company internal information 变量
96 COMPANY_INTERNAL_6 Company internal information 变量
97 COMPANY_INTERNAL_7 Company internal information 变量
98 COMPANY_INTERNAL_8 Company internal information 变量
99 COMPANY_INTERNAL_9 Company internal information 变量
Standard variables to use in program rule expressions
变量 类型 描述
V {current_date} (date) Contains the current date whenever the rule is executed.
Example expression:
d2:daysBetween(#{symptomDate},V{current_date}) < 0
V {event_date} (date) 包含当前事件执行的事件日期。规则作为注册表格的一部分执行时将没有值。
V {event_status} (string) Contains status of the current event or enrollment.
Example expression to check status is:
V{event_status} == 'COMPLETED'
V{due_date} (date) 执行规则时,此变量将包含当前日期。注意:这意味着该规则可能会在不同时间产生不同的结果,即使没有其他改变。
V {event_count} (number) 包含注册中的事件总数。
V{enrollment_date} (date) 包含当前注册的注册日期。对于单个事件程序将没有值。
V{incident_date} (date) 包含当前注册的事件日期。对于单个事件程序将没有值。
V{enrollment_id} (string) Universial identifier string(UID) of the current enrollment. Will not have a value for single event programs.
V {event_id} (string) Universial identifier string(UID) of the current event context. Will not have a value at the moment the rule is executed as part of the registration form.
V {orgunit_code} (string) Contains the code of the orgunit that is linked to the current enrollment. For single event programs the code from the current event orgunit will be used instead.
Example expression to check whether orgunit code starts with WB_:
d2:left(V{orgunit_code},3) == 'WB_'
V {environment} (string) 包含代表规则的当前运行时环境的代码。可能的值为“ WebClient”,“ AndroidClient”和“ Server”。当程序规则仅应在一种或多种客户端类型中运行时可以使用。
V {program_stage_id} (string) 包含触发规则的当前程序阶段的ID。这可用于在特定程序阶段运行规则,或避免在某些阶段执行。在TEI注册表单中执行规则时,变量将为空。
V {program_stage_name} (string) 包含触发规则的当前程序阶段的名称。这可用于在特定程序阶段运行规则,或避免在某些阶段执行。在TEI注册表单中执行规则时,变量将为空。
V{completed_date} (string) 此变量包含触发此规则的事件的完成日期。如果事件尚未完成,则"completed_date"不包含任何内容。

配置关系类型

关于关系类型

关系表示跟踪器模型中两个实体之间的链接。关系被视为DHIS2中的数据,并且基于关系类型,类似于被跟踪实体实例基于被跟踪实体类型的方式。

关系始终包括两个实体,并且这些实体可以包括“跟踪的实体实例”,“注册”和“事件”,以及这些的任意组合。请注意,当前应用程序中并非所有这些组合都可用。

另外,关系可以定义为单向或双向。当前唯一的功能差异是这些功能需要不同级别的创建权限。单向关系要求用户对“从”实体具有数据写访问权限,而对“至”实体具有数据读访问权限,而双向关系则要求双方都具有数据写访问权限。

For more information about configuration and the meaning of 'From constraint' and 'To constraint', see Relationship model .

创建或编辑关系类型

  1. 打开** Maintenance 应用程序,然后单击 Program ** > ** Relationship 类型**。

  2. 点击添加按钮。

  3. Type a Name of the relationship type.

  4. (可选)分配**代码**。

  5. (Optional) Provide a Description of the relationship.

  6. (可选)选择关系是否应为双向

  7. Provide Relationship name seen from inititating entity . This is the name of the relationship that will be shown in the Data Entry app at the 'left' side of the relationship. E.g. in a Mother-child relationship this could be 'Mother of'.

  8. (可选)提供**从接收实体看到的关系名称**。这是关系的名称,将显示在“数据输入”应用程序中关系的“右侧”。例如。在母子关系中,这可能是“母亲”。

  9. Select a 'From constraint'. This limits what kind of entities can be included in the relationship. Relationship model . After selecting a 'From constraint', you have the option to choose which attributes or data elements should be shown in the relationship widget in Tracker Capture and Capture for the "From constraint". The list will vary based on the constraint:

    • When selecting “Tracked Entity Instance”, then a Tracked Entity Type only, choose between the configured Tracked Entity Type Attributes
    • When selecting “Tracked Entity Instance”, then a Tracked Entity Type and a Program, choose between the the attributes that have been configured for both the Tracked Entity Type and for the Program
    • When selecting “Enrollment in program”, choose between the attributes that have been configured for the Program
    • When selecting “Event in program or program stage”, choose between the data elements that have been configured for that Event program or Program stage
  10. Select a 'To constraint'. This limits what kind of entities that can be included in the relationship. Relationship model . Repeat the selection of attributes or data elements that should be shown in the relationship widget for the "To constraint".

  11. 点击**保存**。

配置跟踪的实体类型

关于跟踪的实体类型

跟踪的实体是可以通过 系统。它可以是从人到商品的任何东西,例如 药还是一个人。

一个程序必须有一个跟踪的实体。注册被跟踪实体 实例到程序中,被跟踪的实体类型和被跟踪的 程序的实体类型必须相同。

跟踪的实体属性用于为 跟踪的实体。跟踪的实体属性可以在之间共享 程式。

创建或编辑跟踪的实体属性

  1. Open the Maintenance app and click Program > Tracked 实体属性

  2. 点击添加按钮。

  3. In the Name field, type the tracked entity attribute name.

  4. (Optional) Type a Short name .

  5. (Optional) Type a Form name .

  6. (可选)在 Code 字段中,分配一个代码。

  7. (可选)输入**说明**。

  8. (Optional) In the Field mask field, you may type a template that's used to provide hints for correct formatting of the attribute. NOTE: So far only implemented in the DHIS2 Android Capture app, not in the Capture and Tracker Capture web apps. 以下是可在遮罩中使用的特殊字符。特殊字符与给定类型的一个字符完全匹配。

性格匹配
\ d 数字
\ x 小写字母
\ X 大写字母
\ w 任何字母数字字符

例如,该模式可用于在数据元素的输入字段中根据需要显示连字符。例如“ d d d- d d d- d d d, 每三位数显示一个连字符。

  1. Select an Option set .

  2. In the Value type field, select the type of data that the 跟踪的实体属性将记录。

    Value types
    Value type Description
    Age -
    Coordinate A point coordinate specified as longitude and latitude in decimal degrees. All coordinate should be specified in the format "-19.23 , 56.42" with a comma separating the longitude and latitude.
    Date Dates render as calendar widget in data entry.
    Date & time -
    E-mail -
    File A file resource where you can store external files, for example documents and photos.
    Image Similar to File, but restricted to images.
    Integer Any whole number (positive and negative), including zero.
    Letter -
    Long text Textual value. Renders as text area in forms.
    Negative integer Any whole number less than (but not including) zero.
    Number Any real numeric value with a single decimal point. Thousands separators and scientific notation is not supported.
    Percentage Whole numbers inclusive between 0 and 100.
    Phone number
    Positive integer Any whole number greater than (but not including) zero.
    Positive of zero integer Any positive whole number, including zero.
    Organisation unit -
    Unit interval Any real number greater than or equal to 0 and less than or equal to 1.
    Text Textual value. The maximum number of allowed characters per value is 50,000.
    Time Time is stored in HH:mm format.

    HH is a number between 0 and 23

    mm is a number between 00 and 59
    Tracker associate -
    Username Rendered as a dialog with a list of users and a search field. The user will need the "View User" authority to be able to utilise this data type
    Yes/No Boolean values, renders as drop-down lists in data entry.
    Yes only True values, renders as check-boxes in data entry.
  3. Select an Aggregation type .

    Aggregation operators
    Aggregation operator Description
    Average Average the values in both the period as and the organisation unit dimensions.
    Average (sum in organisation unit hierarchy) Average of data values in the period dimension, sum in the organisation unit dimensions.
    Count Count of data values.
    Min Minimum of data values.
    Max Maximum of data values.
    None No aggregation is performed in any dimension.
    Sum Sum of data values in the period and organisation unit dimension.
    Standard deviation Standard deviation (population-based) of data values.
    Variance Variance (population-based) of data values.
  4. Select Unique to specify that the values of the tracked entity 属性是唯一的。

    唯一设置有两个选项:

    • 整个系统 :被跟踪实体属性的值 可以重复使用属于其他跟踪实体的值 属性。但是此跟踪实体属性中的值必须 不重复。

      Select Automatically generated to allow automatic generation 跟踪实体的属性值。当生成设置 被选中时,用于指定图案的可选字段也被选中 显示。此字段应包含基于 TextPattern语法。当值自动生成时, 对于整个系统,此属性将是唯一的。看到 TextPattern部分以获取有关其工作原理的更多信息。

    • 组织单位 :被跟踪实体的值 属性不得在同一单位部门中重复。

  5. Select Inherit to registry a new entity for relationship with an 可用实体,所有继承实体的实体属性值 将预先填写在注册表中。

  6. (Optional) Select Confidential .

    仅当您配置了以下功能的加密时,此选项才可用 系统。

  7. (Optional) Select Display in list without program .

  8. (可选)分配一个或多个**传奇**。

  9. 点击**保存**。

创建或编辑跟踪的实体类型

  1. Open the Maintenance app and click Program > Tracked 实体类型

  2. 点击添加按钮或一个已经存在的**已跟踪实体 类型**。

  3. Type a Name of the tracked entity.

  4. (Optional) select a Color and an Icon that will be used by 数据捕获应用程序以识别此跟踪的实体类型。

  5. (Optional) Enter a Description of the tracked entity.

  6. (可选)输入**所需的最少数量的属性 搜索**。这指定了需要设置的属性数量 填写以便能够搜索此**跟踪的实体 type** in a global search . See [Configure 搜索](../ search / search.xml#configure_search)了解更多信息。

  7. (可选)输入**要跟踪的实体实例的最大数量 返回搜索**。这指定了被跟踪实体的数量 实例将在*全局搜索*中返回。请参阅[配置 搜索](../ search / search.xml#configure_search)了解更多信息。

  8. (Optional) Add Tracked entity type attributes . This is used to 配置搜索,请参阅[配置 搜索](configure_search)了解更多信息。

  9. (Optional) Enter an Alternative name of the tracked entity.

  10. 点击**保存**。

可以为用户提供搜索组织单位,从而可以 在数据捕获之外搜索跟踪的实体实例 组织单位。

搜索可以在程序的上下文中进行,也可以在 跟踪实体类型的上下文。为用户提供以下选择 在程序上下文中搜索,有必要进行配置 可以搜索哪个程序跟踪的实体属性。为了给 用户可以选择在跟踪的实体类型的上下文中进行搜索, 您将必须配置哪个跟踪实体类型属性 是可搜索的。

配置搜索跟踪器程序

为了能够使用程序进行搜索,您必须制作一些 程序属性可搜索。唯一的程序属性将始终是 可搜索的。

  1. Open Maintenance app and click Program

  2. Open or create a Tracker program

  3. Go to Attributes

  4. 如果没有属性,请添加一个

  5. 将属性设置为可搜索

可搜索的程序属性将分配给搜索组。

  • 唯一组。每个唯一程序属性一组。独特 属性不能与程序中的其他程序属性组合 搜索。搜索结果只能是0或1个跟踪实体 实例。

  • 非唯一组。该组包含所有非唯一程序 属性,并可以在一个属性中组合多个属性 搜索。

There are two limits that can be set for a program search, as part of the Program details configuration.

  • 搜索所需的最少属性数量:此属性 定义必须输入多少个非唯一属性 才能执行搜索。
  • 返回的跟踪实体实例的最大数量:此属性通过限制允许用户获取其搜索条件的匹配跟踪实体实例的数量来定义搜索的具体程度。如果匹配的记录数大于此最大值,则不会返回它们。在返回匹配记录之前,用户必须提供更具体的搜索条件,以减少匹配记录的数量。

    NOTE

    This maximum is only applied to search results outside the users capture org unit. Within the capture scope, the user can see any number of results.

配置搜索以跟踪实体类型

注意

TET =跟踪的实体类型

为了能够在没有程序的情况下进行搜索,您必须做一些 TET属性可搜索。唯一的TET属性将始终是 可搜索的。

  1. Open Tracked entity type app

  2. 打开一个跟踪实体类型

  3. 如果TET没有属性,请添加一个

  4. 将属性设置为可搜索

可搜索的TET属性将分配给搜索组。

  • 唯一组。每个唯一的TET属性一组。独特属性 不能与搜索中的其他TET属性结合使用。结果 来自搜索的只能是0或1个跟踪的实体实例。

  • 非唯一组。该组包含所有非唯一的TET属性 并可以在搜索中组合多个属性。

可以为TET搜索设置两个限制

  • 搜索所需的最少属性数量:此属性 定义必须输入多少个非唯一属性 才能执行搜索。
  • 返回的跟踪实体类型的最大数量:此属性通过限制允许用户为其搜索条件获取的匹配跟踪实体类型的数量,定义搜索的特定程度。如果匹配的记录数大于此最大值,则不会返回它们。在返回匹配记录之前,用户必须提供更具体的搜索条件,以减少匹配记录的数量。

    NOTE

    This maximum is only applied to search results outside the users capture org unit. Within the capture scope, the user can see any number of results.

为用户配置搜索组织单位

能够搜索用户数据以外的其他组织单位 捕获组织单位,则必须为用户分配搜索 组织单位。给用户一个搜索组织单位也将 授予其在该组织单位所有子级中进行搜索的权限。

  1. 开启**使用者应用程式**

  2. 点击一个用户

  3. 打开**分配搜索组织单位**

  4. 选择组织单位

  5. 点击**保存**

克隆元数据对象

克隆数据元素或其他对象可以在创建时节省时间 许多相似的对象。

  1. Open the Maintenance app and find the type of metadata object 你想克隆。

  2. 在对象列表中,单击选项菜单并选择**克隆**。

  3. 修改所需的选项。

  4. 点击**保存**。

删除元数据对象

注意

您只能在以下情况下删除数据元素和其他数据元素对象: 没有数据与数据元素本身关联。

警告

从系统删除的所有数据集都将不可避免地丢失。所有 数据输入表格,以及可能已经制定的部分表格 也将被删除。确保您已经备份了您的 数据库,然后删除任何数据集,以防您需要还原它 在某个时间点。

  1. Open the Maintenance app and find the type of metadata object 您要删除。

  2. 在对象列表中,单击选项菜单并选择**删除**。

  3. 点击**确认**。

更改元数据对象的共享设置

您可以为元数据对象分配不同的共享设置,例如 示例组织单位和跟踪的实体属性。这些分享 设置可控制哪些用户和用户组可以查看或编辑 元数据对象。

一些元数据对象还允许您更改共享设置 对象的数据输入。这些附加设置控制谁可以 使用元数据查看或在表单字段中输入数据。

注意

默认设置是所有人( 公共访问权限 )都可以找到, 查看和编辑元数据对象。

  1. Open the Maintenance app and find the type of metadata object 您要修改。

  2. In the object list, click the context menu and select Sharing 设置

  3. (可选)添加用户或用户组:搜索一个或多个用户 分组并选择它。用户或用户组已添加到列表中。

  4. 更改要修改的访问组的共享设置。

    • 可以编辑和查看 :访问组可以查看和编辑 目的。

    • 只能查看 :访问组可以查看对象。

    • 禁止访问 (仅适用于**公共访问**):公众 将无法访问该对象。

  5. 更改您要访问的访问组的数据共享设置 修改。

    • 可以捕获数据 :访问组可以查看和捕获数据 为对象。

    • 可以查看数据 :访问组可以查看以下数据: 目的。

    • 无访问权限 :访问组将无法访问以下数据: 物体。

  6. 点击**关闭**。

显示元数据对象的详细信息

  1. Open the Maintenance app and find the type of metadata object 您想查看。

  2. In the object list, click the options menu and select Show 细节

翻译元数据对象

DHIS2提供了用于翻译数据库内容的功能, 示例数据元素,数据元素组,指标,指标组 或组织单位。您可以将这些元素转换为任意数量的 语言环境。地区代表特定的地理,政治或 文化区。

Tip

To activate a translation, open the System Settings app, click > Appearance and select a language.

  1. Open the Maintenance app and find the type of metadata object 您要翻译。

  2. 在对象列表中,单击选项菜单并选择**翻译**。

    Tip

    If you want to translate an organisation unit level, click directly on the Translate icon next to each list item.

  3. 选择一个语言环境。

  4. 输入**名称**、 简称**和**说明

  5. 点击**保存**。

管理用户,用户角色和用户组

关于用户管理

多个用户可以同时访问DHIS2,每个用户可以拥有 不同的当局。您可以微调这些权限,以便 某些用户只能输入数据,而其他用户只能生成数据 报告。

  • 您可以创建尽可能多的用户,用户角色和用户组 需要。

  • 您可以为用户组或个人分配特定权限 通过用户角色的用户。

  • 您可以创建多个用户角色,每个用户角色都有自己的权限。

  • 您可以将用户角色分配给用户,以向用户授予 相应的当局。

  • 您可以将每个用户分配到组织单位。然后用户可以 输入分配的组织单位的数据。

  • You can set an expiration date to individual users

User management terms and definitions
Term Definition
权威 A permission to perform one or several specific tasks Create a new data element

Update an organisation unit

View a report
用户 A person's DHIS2 user account admin

traore

guest
User role A group of authorities Data entry clerk

System administrator

Antenatal care program access
User group A group of users Kenya staff

Feedback message recipients

HIV program coordinators

您可以在**用户**应用中管理用户,用户角色和用户组。

Objects in the Users app
Object type Available functions
用户 Create, edit, invite, clone, disable, display by organisation unit, delete, show details and reset password
User role Create, edit, share, delete and show details
User group Create, edit, join, leave, share, delete and show details

关于用户

DHIS2中的每个用户都必须具有一个用户帐户,该帐户由 用户名。您应该为每个用户注册一个名字和姓氏 以及联系信息,例如电子邮件地址和电话 数。

注册正确的联系信息很重要。 DHIS2 使用此信息直接联系用户,例如发送 通过电子邮件通知重要事件。您也可以使用 联系人信息以共享,例如仪表板和数据透视表。

DHIS2中的用户与组织单位相关联。你应该 分配用户所在的组织单位。

为地区记录员创建用户帐户时,应 将他/她工作的地区指定为组织单位。

分配的组织单位会影响用户如何使用DHIS2:

  • 在**数据输入**应用中,用户只能输入 与她关联的组织单位和组织单位 低于层次结构中的例如,一个区记录 该官员将能够为其所在地区和 仅在该地区以下的设施。

  • 在**用户**应用中,用户只能为以下用户创建新用户: 与她相关联的组织单位 层次结构下的组织单位。

  • 在**报告**应用中,用户只能查看她的报告 组织单位及以下组织单位。 (这是我们考虑的 打开以提供比较报告。)

用户管理的重要部分是控制哪些用户是 允许创建具有权限的新用户。在DHIS2中,您可以 控制允许哪些用户执行此任务。关键原则 是用户只能授予权限并访问那些 用户本身有权访问。国家,省的用户数 和地区级别通常相对较少,可以创建和 由系统管理员管理。如果很大一部分 设施正在将数据直接输入到系统中, 用户可能会变得笨拙。建议委派和 将这项任务下放给地区官员,它将使 处理效率更高,并为设施用户提供更好的支持。

关于用户角色

DHIS2中的用户角色是一组权限。权威是指 执行一项或多项特定任务的权限。

用户角色可以包含创建新数据元素,进行更新的权限 组织单位或查看报告。

一个用户可以具有多个用户角色。如果是这样,用户的权限将 是用户角色中所有权限和数据集的总和。这个 意味着您可以出于特殊目的混合和匹配用户角色 仅创建新的。

用户角色与数据集的集合相关联。这影响 **数据输入**应用:用户只能输入数据集的数据 为他/她的用户角色注册。例如,当 您想允许卫生计划人员仅输入以下数据 他们相关的数据输入表格。

建议:

  • 为组织内的每个职位创建一个用户角色。

  • 与定义哪个用户正在并行创建用户角色 系统中的哪些任务。

  • 只给用户角色他们需要执行的确切权限 他们的工作,而不是更多。只有那些应该执行任务的人 应该有执行它的权限。

关于用户组

A user group is a group of users. You use user groups when you set up sharing of metadata objects or notifications for example for reports or programs.

也可以看看:

Sharing

[管理程序 通知]( https://docs.dhis2.org/master/zh/user/html/configure_tracker_program_in_Maintenance_app.html#create-a-program-stage-notification

Manage push reports

工作流程

  1. 定义项目所需的职位并确定哪个职位 不同职位将执行的任务。

  2. 为每个职位创建大约一个用户角色。

  3. 创建用户。

  4. 将用户角色分配给用户。

  5. 将用户分配给组织单位。

  6. (可选)将用户分组到用户组中。

  7. 通过中的“共享”对话框与用户或用户组共享数据集 维护应用程序的数据集管理部分

提示

为了使用户能够输入数据,您必须将其添加到 组织单位级别并与他们共享数据集。

管理使用者

创建一个用户

  1. 打开** Users 应用程序,然后单击 Users 卡中的 + **。

  2. 选择是否要填写所有个人用户 信息,或通过电子邮件邀请用户完成其余的 用户信息:

  3. 使用用户详细信息创建帐户 如果您想输入的所有登录详细信息,请选择此选项。 新用户,例如用户名,密码等。在这种情况下,用户名,密码,姓氏, 名称和角色是必填项。

    创建用户后,即可使用该帐户 以及您提供的用户名和密码。

    Username requirements

    The following rules apply when you create a new username. The username must:

    • Contain at least 4 characters.

    • Not contain more than 255 characters.

    • Contain lowercase and UPPERCASE latin characters and numbers ( a-z , A-Z , 0-9 ).

    • These characters are also allowed . _ @ and # , but these may only be used as a separator, and not as a leading or trailing character, and should not be repeated (i.e. user@@name is not allowed).

  4. 通过电子邮件邀请创建帐户 如果您想通过电子邮件将邀请发送到 用户。然后,他/他必须返回DHIS2并完成设置他们的用户 帐户。用户完成设置的帐户将受到限制 根据您如何配置帐户。

注意

为了使用此功能,系统应具有有效的电子邮件 系统设置中的配置->电子邮件

Enter the email address to which the invitation should be sent. If you want to, you may also enter the user name that the account will have. If you leave the user name empty, then the user may choose their own user name when they respond to the invitation (as long as it is not taken already for another user.)

After you've created the user, the system sends an email to the address you provided. It contains a unique web link by which the user can return to the system and activate their account by entering the rest of their user information. The user must finish setting up the account within 4 days, after that the invitation becomes invalid.

  1. (可选)为以下字段提供值:**OIDC映射声明,LDAP标识符,移动电话号码,WhatsApp,Facebook Messenger,Skype,Telegram和Twitter **。

  2. 选择一种**接口语言**。
    您可以选择将DHIS2用户界面的固定元素翻译成的语言。

  3. 选择一种**数据库语言**。
    您可以选择实现提供的语言 项目已在数据库中翻译,例如数据元素 名称或组织单位级别的名称。

  4. 在**可用角色**部分中,双击要分配给用户的用户角色。

  5. 选择**数据捕获和维护组织单位**。

    The data capture and maintenance organisation units control for which organisation units the user can do data entry. You must assign at least one data capture and maintenance organisation unit to each user.

    Users will have access to all sub-organisation units of the assigned organisation units. For example, if you've assigned a user to a district which has several facilities contained in the district, the user would have access to the district's data, as well as all of the facilities contained within the district.

  6. (可选)选择**数据输出和分析组织单位**。

    数据输出和分析组织单位控制 用户可以在哪些组织单位中查看汇总数据 分析应用程序,例如**数据透视表**和**GIS**应用程序。你 可以将任意数量的数据输出和分析组织单位分配给 用户。

    用户将有权访问广告联盟的所有子单位部门 分配的组织单位。您不应该选择 您已经选择的组织单位。例如,如果 您已将用户分配到一个地区,则不应选择 该地区内的设施。

注意

分配数据输出和分析组织单位组织单位是可选的。如果不指定 任何组织单位,用户将有权访问全部 用于查看汇总数据的组织单位层次结构。与 数据捕获组织单位, 您不应选择后代 您已选择的单位的组织单位

您可以在Analytics(分析)应用的多个位置中选择“用户组织 unit”作为组织单位维度。此机制将首先 尝试使用与当前链接的数据视图组织单位 用户。如果找不到,它将使用数据捕获和维护 组织单位。如果用户已分配给多个 组织单位,使用“用户组织单位”可能会导致 不可预测的行为。

  1. 点击**显示更多选项**和其他 将显示三个字段。 (可选)

  2. 在**搜索组织单位**中 选择您希望用户可以搜索的组织单位。

  3. (可选)在**可用用户组**部分中,双击 您要分配给用户的用户组。

  4. (可选)在**数据分析的可用维度限制**部分中, 双击要分配给用户的尺寸。

    您可以通过选择以下内容来限制用户在数据分析应用中看到的值: 尺寸将限制用户的视图。

示例

假设您已将*实施合作伙伴*定义为类别选项组集,并且您仅与该用户共享一个或多个特定的实施合作伙伴(类别选项组)。如果您要确保用户在分析中看不到包含其他组值的总计,请向该用户分配*实施合作伙伴*。

这样可以确保对通过分析应用程序对用户可见的所有数据进行过滤,以仅选择对用户可见的“实施合作伙伴”类别选项组。

  1. 点击**保存**。

Edit user

  1. Open the Users app and find the user you want to edit.

  2. In the user list, directly click the relevant user, or click the 菜单图标,然后选择**编辑**。

  3. 修改所需的选项。

  4. 点击**保存**。

Set account expiration date

In case a user account should expire on a specific date, you can set an account expiration date for a user

  1. 打开**用户**应用,然后单击**用户**。

  2. Select the user whose account should have an expiration date

  3. Use the "Account expiration date" input to define the date

  4. Save the updates by submitting the form

Disable user

您可以禁用用户。这意味着该用户的帐户不是 已删除,但用户无法登录或使用DHIS2。

  1. 打开**用户**应用,然后单击**用户**。

  2. 在列表中,单击相关用户记录的菜单图标,然后选择 停用

  3. 单击**确定**以确认。

Warning

If you are using the Android Capture App disabling a user (in DHIS2 versions previous to 2.30 and after 2.38) will cause the Android application to delete the local data stored on the phone next time the user attemps an on-line login. Please make sure that when you use the disable user function all the data has been synced with the server. Or that you are using this funcionality to ensure data deletion in case of a device being lost.

Display user profile

  1. 打开**用户**应用,然后单击**用户**。

  2. 在列表中,单击相关用户的菜单图标,然后选择 个人资料

按组织单位过滤用户

您可以查看已分配给特定用户的所有用户 组织单位。

  1. 打开**用户**应用,然后单击**用户**。

  2. 在用户列表上方,点击**组织单位**过滤器 输入。

  3. 将出现一个弹出窗口,您可以在其中选择组织单位 您想过滤。

用户列表将被过滤为仅包括已 分配给选定的组织单位。

Clone user

  1. 打开**用户**应用,然后单击**用户**。

  2. In the user list, click the menu icon of the relevant user and 选择**复制**。

  3. 输入克隆的用户帐户的新用户名和密码。

  4. 点击**复制**。

  5. In the user list, click the user you just created and click 编辑

  6. 修改所需的选项。

  7. 点击**保存**。

修改用户密码

要更改用户密码:

  1. 打开**用户**应用,然后单击**用户**。

  2. In the user list, click the menu icon of the relevant user and 选择**编辑**。

  3. 输入新密码并重新输入。

  4. 点击**保存**。

密码要求

创建新密码时,以下规则适用。密码必须:

  • Contain at least 8 characters. Note that this number is configurable through the system setting "Minimum characters in password", which can be up to 14 characters.

  • Not contain more than 34 characters.

  • 包含至少一个特殊字符(非字母数字字符)。

  • Contain at least one UPPERCASE character.

  • Contain at least one lowercase character.

  • 至少包含一位数字(数字)。

Reset user password by email

To reset the password of a user by email:

  1. 打开**用户**应用,然后单击**用户**。
  2. In the user list, click the menu icon of the relevant user and select "Reset password".
  3. 点击**确认**。

The person owning the user account will receive an email with instructions for how to reset the password. The email is sent to the address specified for the user account.

Delete user

  1. Open the Users app and find the type of user you want to 删除。

  2. In the user list, click the menu icon of the relevant user and 选择**删除**。

  3. 点击**确认**。

Display details of user

  1. Open the Users app and find user you want to view.

  2. In the user list, click the menu icon of the relevant user and 选择**显示详细信息**。

Disable Two Factor Authentication for a user

如果用户启用了“双重身份验证”,然后无法访问 他/她的身份验证设备(例如智能手机丢失或损坏), 该用户将无法再登录系统。为了解决这个问题 问题,用户管理员可以为 受影响的用户,以便该用户能够使用再次访问系统 只是一个密码。

  1. 打开**用户**应用,然后单击**用户**。

  2. In the user list, click the menu icon of the relevant user and 选择**禁用两因素身份验证**。

  3. 点击**确定**以确认

注意

禁用双因素身份验证的选项将仅可用 对于已通过 用户个人资料应用。

管理用户角色

创建用户角色

  1. 打开**用户**应用,然后单击**用户角色**。

  2. 点击**添加新**。

  3. 输入一个**名称**,例如"超级用户"或"管理员用户"。

  4. 输入**说明**。

  5. 在**权限**部分中,选择您想要的权 赋予用户角色。您也可以使用上方的过滤器输入 授权部分以搜索特定的授权。

  6. 点击**添加**。

Edit user role

  1. Open the Users app and find the type of user role you want to 编辑。

  2. In the user list, directly click the relevant user role, or click the 菜单图标,然后选择**编辑**。

  3. 修改所需的选项。

  4. 点击**保存**。

Delete user role

  1. Open the Users app and find the user role you want to delete.

  2. In the user role list, click the menu icon of the relevant user and 选择**删除**。

  3. 点击**确认**。

Display details of user role

  1. Open the Users app and find the user role you want to view.

  2. In the user list, click the menu icon of the relevant user role and 选择**显示详细信息**。

Change sharing settings for user role

  1. Open the Users app and find the user role you want to modify.

  2. In the user list, click the relevant user role and select Sharing 设置

  3. (可选)搜索用户组并选择它,然后单击 加号图标。用户组已添加到列表中。

  4. (可选)选择**外部访问(不登录)**。

    Note that this only gives access when no user is logged in. To give access also to logged in users, you must also allow Public access .

  5. 更改要修改的用户组的设置。

  6. 没有
  7. 可以查看 :用户组中的每个人都可以查看对象
  8. 可以编辑和查看 :用户组中的每个人都可以查看和编辑对象

  9. 点击**保存**。

管理用户组

创建一个用户组

  1. 打开**用户**应用,然后单击**用户组**。

  2. 点击**添加新**。

  3. 在**名称**字段中,键入用户组的名称。

  4. 在**可用用户**部分中,双击所需的用户 添加到用户组。

  5. 在**可用用户组**部分中,双击用户 您要添加到用户组的组。

  6. 点击**添加**。

加入用户组

  1. 打开**用户**应用,然后单击**用户组**。

  2. 在列表中,单击相关的用户组,然后选择**加入 组**。

离开使用者群组

  1. 打开**用户**应用,然后单击**用户组**。

  2. 在列表中,单击相关的用户组,然后选择**离开 组**。

Edit user group

  1. Open the Users app and find the type of user group you want to 编辑。

  2. In the user group list, directly click the relevant user group, or click the 菜单图标,然后选择**编辑**。

  3. 修改所需的选项。

  4. 点击**保存**。

Delete user group

  1. Open the Users app and find the type of user group you want to 删除。

  2. In the user group list, click the menu icon of the relevant user group and 选择**删除**。

  3. 单击**确定**以确认。

Display details of user group

  1. Open the Users app and find the user group you want to view.

  2. In the object list, click the menu icon of the relevant user group and 选择**显示详细信息**。

Change sharing settings for user group

  1. Open the Users app and find user you want to modify.

  2. In the user group list, click the relevant user group and select Sharing 设置

  3. (可选)搜索用户组并选择它,然后单击 加号图标。用户组已添加到列表中。

  4. (可选)选择**外部访问(不登录)**。

    Note that this only gives access when no user is logged in. To give access also to logged in users, you must also allow Public access .

  5. 更改要修改的用户组的设置。

  6. 没有
  7. 可以查看 :用户组中的每个人都可以查看对象
  8. 可以编辑和查看 :用户组中的每个人都可以查看和编辑对象

  9. 点击**保存**。

分散用户管理

DHIS2支持称为* managed的用户管理概念。 用户*允许明确定义应允许哪些用户 管理或修改哪些用户。 “管理用户”意味着您可以 查看和修改该用户。用户管理的基本概念是 您可以查看和修改已被授予所有 当局;换句话说,您可以修改具有以下内容的用户 您自己的权威。托管用户的概念为您带来更多 控制这个。

受管用户概念使您可以定义应将哪些用户 能够管理哪些用户。这是通过用户组和 这些组中的成员身份。可以将用户组配置为 允许通过标准添加和更新来管理其他用户组 用户界面。结果是特定用户可以管理所有用户 是用户组的成员,可以由用户组管理 用户所属的成员。换句话说,用户可以由所有人管理 管理用户组的用户组成员 的。

要启用此概念,您应该授予用户以下权限: “在托管组中添加/更新用户”,并且*不*授予访问权限 标准的“添加/更新用户”权限。受管理的含义 用户概念是,使用“添加/更新用户”创建用户时, 仅在受管组中”,则必须使用户至少成为 当前用户可以管理的一个用户组。如果不是,则当前 用户将失去对立即创建的用户的访问权限。这是 由系统验证。

授予“在托管组中添加/更新用户”权限后, 系统允许用户向其拥有的用户组添加成员 只读访问。这样做的目的是为了分散 用户管理。您可以定义一系列用户组,其中其他用户 可以添加或删除成员,但不能删除或更改成员的名称 组。

示例:卫生系统中的用户管理

在卫生系统中,将用户按照任务进行逻辑分组 他们的表现和所占据的位置。

  1. 定义哪些用户应具有系统管理员角色。 它们通常是国家HIS部门的一部分,应具有 系统中的全部权限。

  2. 为每个职位创建大约一个用户角色。

常见职位的示例有:

Position Typical tasks Recommended authorities 评论
System administrators Set up the basic structure (metadata) of the system. Add, update and delete the core elements of the system, for example data elements, indicators and data sets. Only system administrators should modify metadata.
If you allow users outside the system administrators team to modify the metadata, it might lead to problems with coordination.

Updates to the system should only be performed by the administrators of the system.
National health managers

Province health managers
Monitor and analyse data Access to the reports module, the GIS , Data Quality apps and the dashboard. Don't need access to enter data, modify data elements or data sets.
National health information system division officers (HISO)

District health records and information officers (DHRIO)

Facility health records and information officers (HRIO)
Enter data that comes from facilities which are not able to do so directly

Monitor, evaluate and analyse data
Access to all the analysis and validation apps

Access to the Data Entry app.
--
Data entry clerks -- -- --

用户权限

Accept data at lower levels F_ACCEPT_DATA_LOWER_LEVELS
Access my data mart F_MYDATAMART_VIEW
Add Facility F_FRED_CREATE
Add Locale F_LOCALE_ADD
Add Option Set F_OPTIONSET_ADD
Add Organisation Unit Group Set F_ORGUNITGROUPSET_ADD
Add Program Rule F_PROGRAM_RULE_ADD
Add Public Map F_MAP_PUBLIC_ADD
Add Relationship Type F_RELATIONSHIPTYPE_ADD
Add/Remove Members In Read-Only User Groups F_USER_GROUPS_READ_ONLY_ADD_MEMBERS
Add SQL View F_SQLVIEW_ADD
Add Tracked Entities F_TRACKED_ENTITY_ADD
Add Tracked Entity Attribute Value F_TRACKED_ENTITY_ATTRIBUTEVALUE_ADD
Add Tracked Entity Form F_TRACKED_ENTITY_FORM_ADD
Add Tracked Entity Instance Comment F_TRACKED_ENTITY_COMMENT_ADD
Add Tracked Entity Relationship F_RELATIONSHIP_ADD
Add/Update Attribute F_ATTRIBUTE_ADD
Add/Update Chart F_CHART_ADD
Add/Update Concept F_CONCEPT_ADD
Add/Update Constant F_CONSTANT_ADD
Add/Update Data Value F_DATAVALUE_ADD
Add/Update Indicator Type F_INDICATORTYPE_ADD
Add/Update Min/max rule F_DATAELEMENT_MINMAX_ADD
Add/Update Organisation Unit F_ORGANISATIONUNIT_ADD
Add/Update Private Category Option Group F_CATEGORY_OPTION_GROUP_PRIVATE_ADD
Add/Update Private Category Option Group Set F_CATEGORY_OPTION_GROUP_SET_PRIVATE_ADD
Add/Update Private Data Element F_DATAELEMENT_PRIVATE_ADD
Add/Update Private Data Element Category F_CATEGORY_PRIVATE_ADD
Add/Update Private Data Element Category Combo F_CATEGORY_COMBO_PRIVATE_ADD
Add/Update Private Data Element Category Option F_CATEGORY_OPTION_PRIVATE_ADD
Add/Update Private Data Element Category Option Combo F_CATEGORY_OPTION_COMBO_PRIVATE_ADD
Add/Update Private Data Element Groups F_DATAELEMENTGROUP_PRIVATE_ADD
Add/Update Private Data Element Group Sets F_DATAELEMENTGROUPSET_PRIVATE_ADD
Add/Update Private Data Set F_DATASET_PRIVATE_ADD
Add/Update Private Document F_DOCUMENT_PRIVATE_ADD
Add/Update Private Indicator F_INDICATOR_PRIVATE_ADD
Add/Update Private Indicator Group F_INDICATORGROUP_PRIVATE_ADD
Add/Update Private Indicator Group Sets F_INDICATORGROUPSET_PRIVATE_ADD
Add/Update Private Option Set F_OPTIONSET_PRIVATE_ADD
Add/Update Private Organisation Unit Group F_ORGUNITGROUP_PRIVATE_ADD
Add/Update Private Organisation Unit Group Set F_ORGUNITGROUPSET_PRIVATE_ADD
Add/Update Private Program F_PROGRAM_PRIVATE_ADD
Add/Update Private Report F_REPORT_PRIVATE_ADD
Add/Update Private SQL View F_SQLVIEW_PRIVATE_ADD
Add/Update Private Tracked Entity Attribute F_TRACKED_ENTITY_ATTRIBUTE_PRIVATE_ADD
Add/Update Private User Group F_USERGROUP_PRIVATE_ADD
Add/Update Private User Role F_USERROLE_PRIVATE_ADD
Add/Update Private Validation Rule Group F_VALIDATIONRULEGROUP_PRIVATE_ADD
Add/Update Program Attribute F_PROGRAM_ATTRIBUTE_ADD
Add/Update Program Indicator F_ADD_PROGRAM_INDICATOR
Add/Update Program Stage F_PROGRAMSTAGE_ADD
Add/Update Program Stage Section F_PROGRAMSTAGE_SECTION_ADD
Add/Update Public Category Option Group F_CATEGORY_OPTION_GROUP_PUBLIC_ADD
Add/Update Public Category Option Group Set F_CATEGORY_OPTION_GROUP_SET_PUBLIC_ADD
Add/Update Public Chart F_CHART_PUBLIC_ADD
Add/Update Public Dashboard F_DASHBOARD_PUBLIC_ADD
Add/Update Public Data Element F_DATAELEMENT_PUBLIC_ADD
Add/Update Public Data Element Category F_CATEGORY_PUBLIC_ADD
Add/Update Public Data Element Category Combo F_CATEGORY_COMBO_PUBLIC_ADD
Add/Update Public Data Element Category Option F_CATEGORY_OPTION_PUBLIC_ADD
Add/Update Public Data Element Category Option F_CATEGORY_OPTION_DELETE
Add/Update Public Data Element Category Option Combo F_CATEGORY_OPTION_COMBO_PUBLIC_ADD
Add/Update Public Data Element Groups F_DATAELEMENTGROUP_PUBLIC_ADD
Add/Update Public Data Element Group Sets F_DATAELEMENTGROUPSET_PUBLIC_ADD
Add/Update Public Data Set F_DATASET_PUBLIC_ADD
Add/Update Public Document F_DOCUMENT_PUBLIC_ADD
Add/Update Public Indicator F_INDICATOR_PUBLIC_ADD
Add/Update Public Indicator Group F_INDICATORGROUP_PUBLIC_ADD
Add/Update Public Indicator Group Sets F_INDICATORGROUPSET_PUBLIC_ADD
Add/Update Public Option Set F_OPTIONSET_PUBLIC_ADD
Add/Update Public Organisation Unit Group F_ORGUNITGROUP_PUBLIC_ADD
Add/Update Public Organisation Unit Group Set F_ORGUNITGROUPSET_PUBLIC_ADD
Add/Update Public Program F_PROGRAM_PUBLIC_ADD
Add/Update Public Report F_REPORT_PUBLIC_ADD
Add/Update Public Report Table F_REPORTTABLE_PUBLIC_ADD
Add/Update Public SQL View F_SQLVIEW_PUBLIC_ADD
Add/Update Public Tracked Entity Attribute F_TRACKED_ENTITY_ATTRIBUTE_PUBLIC_ADD
Add/Update Public User Group F_USERGROUP_PUBLIC_ADD
Add/Update Public User Role F_USERROLE_PUBLIC_ADD
Add/Update Public Validation Rule Group F_VALIDATIONRULEGROUP_PUBLIC_ADD
Add/Update Section F_SECTION_ADD
Add/Update Tracked Entity F_TRACKED_ENTITY_ADD
Add/Update Tracked Entity Attributes F_ALLOW_EDIT_TRACKED_ENTITY_ATTRIBUTES
Add/Update Tracked Entity Data Value F_TRACKED_ENTITY_DATAVALUE_ADD
Add/Update Tracked Entity Instance F_TRACKED_ENTITY_INSTANCE_ADD
Add/Update User F_USER_ADD
Add/Update User Group Managing Relationships F_USERGROUP_MANAGING_RELATIONSHIPS_ADD
Add/Update User Within Managed Group F_USER_ADD_WITHIN_MANAGED_GROUP
Add/Update Validation Criteria F_VALIDATIONCRITERIA_ADD
Add/Update Validation Rule F_VALIDATIONRULE_ADD
Add Validation Rule Groups F_VALIDATIONRULEGROUP_ADD
Administrate data mart F_DATAMART_ADMIN
Administrate data mart F_DATA_MART_ADMIN
Administrate data visualizer F_DV_ADMIN
Administrate GIS F_GIS_ADMIN
批准数据 F_APPROVE_DATA
Approve data at lower levels F_APPROVE_DATA_LOWER_LEVELS
Archive data F_ARCHIVE_DATA
Change GIS Configuration F_GIS_CONFIGURATION_UPDATE
Change Location of Tracked Entity Instance F_TRACKED_ENTITY_INSTANCE_CHANGE_LOCATION
Change order in Data Set F_DATASET_ORDER_CHANGE
Change system settings F_SYSTEM_SETTING
Change Tracked Entity Instance Location F_TRACKED_ENTITY_CHANGE_LOCATION
Chart External Access F_CHART_EXTERNAL
Concept Management F_CONCEPT_MANAGEMENT
Constant Management F_CONSTANT_MANAGEMENT
Copy Excel Item F_COPY_EXCEL_ITEM_ADMINISTRATION
Create and download backup F_DASHBOARD_DOWNLOAD_BACKUP
Data Admin Locking F_DATAADMIN_LOCK
Data Admin Unlocking F_DATAADMIN_UNLOCK
Delete Attribute F_ATTRIBUTE_DELETE
Delete Category Option Group F_CATEGORY_OPTION_GROUP_DELETE
Delete Category Option Group Set F_CATEGORY_OPTION_GROUP_SET_DELETE
Delete Chart F_CHART_DELETE
Delete Concept F_CONCEPT_DELETE
Delete Constant F_CONSTANT_DELETE
Delete Data Element F_DATAELEMENT_DELETE
Delete Data Element Category F_CATEGORY_DELETE
Delete Data Element Category Combo F_CATEGORY_COMBO_DELETE
Delete Data Element Groups F_DATAELEMENTGROUP_DELETE
Delete Data Element Group Sets F_DATAELEMENTGROUPSET_DELETE
Delete Data Set F_DATASET_DELETE
Delete Data Value F_DATAVALUE_DELETE
Delete Document F_DOCUMENT_DELETE
Delete Excel Template F_EXCEL_TEMPLATE_MANAGEMENT_DELETE
Delete Facility F_FRED_DELETE
Delete Indicator F_INDICATOR_DELETE
Delete Indicator Group F_INDICATORGROUP_DELETE
Delete Indicator Group Sets F_INDICATORGROUPSET_DELETE
Delete Indicator Type F_INDICATORTYPE_DELETE
Delete Locale F_LOCALE_DELETE
Delete Min/max rule F_DATAELEMENT_MINMAX_DELETE
Delete Option Set F_OPTIONSET_DELETE
Delete Organisation Unit F_ORGANISATIONUNIT_DELETE
Delete Organisation Unit Group F_ORGUNITGROUP_DELETE
Delete Organisation Unit Group Set F_ORGUNITGROUPSET_DELETE
Delete Program F_PROGRAM_DELETE
Delete Program Attribute F_PROGRAM_ATTRIBUTE_DELETE
Delete Program Enrollment F_PROGRAM_INSTANCE_DELETE
Delete Program Stage F_PROGRAMSTAGE_DELETE
Delete Program Stage Section F_PROGRAMSTAGE_SECTION_DELETE
Delete Relationship Type F_RELATIONSHIPTYPE_DELETE
Delete Report F_REPORT_DELETE
Delete Report Table F_REPORTTABLE_DELETE
Delete Section F_SECTION_DELETE
Delete SMS F_MOBILE_DELETE_SMS
Delete SQL View F_SQLVIEW_DELETE
Delete Tracked Entity F_TRACKED_ENTITY_DELETE
Delete Tracked Entity Attribute F_TRACKED_ENTITY_ATTRIBUTE_DELETE
Delete Tracked Entity Attribute Value F_TRACKED_ENTITY_ATTRIBUTEVALUE_DELETE
Delete Tracked Entity Data Value F_TRACKED_ENTITY_DATAVALUE_DELETE
Delete Tracked Entity Form F_TRACKED_ENTITY_FORM_DELETE
Delete Tracked Entity Instance F_TRACKED_ENTITY_INSTANCE_DELETE
Delete Tracked Entity Instance Comment F_TRACKED_ENTITY_COMMENT_DELETE
Delete Tracked Entity Instance Visit F_PROGRAM_STAGE_INSTANCE_DELETE
Delete Tracked Entity Relationship F_RELATIONSHIP_DELETE
Delete User F_USER_DELETE
Delete User Group F_USERGROUP_DELETE
Delete User Role F_USERROLE_DELETE
Delete User Within Managed Group F_USER_DELETE_WITHIN_MANAGED_GROUP
Delete Validation Criteria F_VALIDATIONCRITERIA_DELETE
Delete Validation Rule F_VALIDATIONRULE_DELETE
Delete Validation Rule Group F_VALIDATIONRULEGROUP_DELETE
Eliminate duplicate data elements F_ELIMINATE_DUPLICATE_DATA_ELEMENTS
Excel Reporting Administration F_EXCEL_REPORT_ADMINISTRATION
Execute SQL View F_SQLVIEW_EXECUTE
Export Activity Plan to XLS file F_ACTIVITY_PLAN_EXPORT
Export data F_EXPORT_DATA
Export events F_EXPORT_EVENTS
Export meta-Data F_METADATA_EXPORT
Generate Activity Plans F_GENERATE_ACTIVITY_PLANS
Generate min-max values F_GENERATE_MIN_MAX_VALUES
Generate Program Statistics Report F_GENERATE_STATISTICAL_PROGRAM_REPORT
Generate Program Summary Report F_GENERATE_PROGRAM_SUMMARY_REPORT
Generate Tracked Entity Tabular report F_GENERATE_BENEFICIARY_TABULAR_REPORT
Import data F_IMPORT_DATA
Import events F_IMPORT_EVENTS
Import from other systems F_IMPORT_OTHER_SYSTEMS
Import GML F_IMPORT_GML
Import meta-Data F_METADATA_IMPORT
Insert custom Java script and CSS F_INSERT_CUSTOM_JS_CSS
List Excel Template F_EXCEL_TEMPLATE_MANAGEMENT_LIST
List Tracked Entity Instance F_TRACKED_ENTITY_INSTANCE_LIST
List User Groups F_USERGROUP_LIST
List User Roles F_USERROLE_LIST
Load event reminder messages F_PROGRAM_STAGE_INSTANCE_REMINDER
Load Tracked Entity Instance History F_TRACKED_ENTITY_INSTANCE_HISTORY
Lock Data Set F_DATASET_LOCK
Manage integration routes F_MANAGE_INTEGRATION_ROUTES
Manage Program Indicators F_PROGRAM_INDICATOR_MANAGEMENT
Manage Program Rule F_PROGRAM_RULE_MANAGEMENT
Manage Tracked Entities F_TRACKED_ENTITY_MANAGEMENT
Manage Tracked Entity Instance Reminders F_TRACKED_ENTITY_INSTANCE_REMINDER_MANAGEMENT
Map External Access F_MAP_EXTERNAL
Merge organisation units F_MERGE_ORGANISATION_UNITS
Move Organisation Unit F_ORGANISATIONUNIT_MOVE
Multiple Individual Data Entry F_NAME_BASED_DATA_ENTRY
Option Set Management F_OPTIONSET_MANAGEMENT
Organisation Unit Registration F_ORGANISATION_REGISTRATION
Perform maintenance tasks F_PERFORM_MAINTENANCE
Program Enrollment F_PROGRAM_ENROLLMENT
Program Event Management F_PROGRAM_INSTANCE_MANAGEMENT
Program Stage Section Management F_PROGRAMSTAGE_SECTION_MANAGEMENT
Program Tracking Management F_PROGRAM_TRACKING_MANAGEMENT
Program Un-enrollment F_PROGRAM_UNENROLLMENT
Prune organisation units F_PRUNE_ORGANISATION_UNITS
Remove Empty Tracked Entity Events F_TRACKED_ENTITY_REMOVE_EMPTY_EVENTS
Rename Excel Template file F_EXCEL_TEMPLATE_MANAGEMENT_RENAME
Report Table External Access F_REPORTTABLE_EXTERNAL
Run validation F_RUN_VALIDATION
Scheduling Administration F_SCHEDULING_ADMIN
Scheduling case aggregate query builder F_SCHEDULING_CASE_AGGREGATE_QUERY_BUILDER
Scheduling send messages F_SCHEDULING_SEND_MESSAGE
Search Activity Plan F_ACTIVITY_PLAN
Search events without registration F_PROGRAM_STAGE_INSTANCE_SEARCH
Search events with registration F_PROGRAM_TRACKING_SEARCH
Search Tracked Entity Instance F_TRACKED_ENTITY_INSTANCE_SEARCH
Search Tracked Entity Instance in All Org Units F_TRACKED_ENTITY_INSTANCE_SEARCH_IN_ALL_ORGUNITS
See API Module M_dhis-web-api
See Apps Maintenance module M_dhis-web-maintenance-appmanager
See Browser Cache Cleaner module M_dhis-web-cache-cleaner
See Dashboard integration module M_dhis-web-dashboard-integration
See Dashboard module M_dhis-web-dashboard
See Data Administration module M_dhis-web-maintenance-dataadmin
See Data Elements and Indicators Maintenance module M_dhis-web-maintenance-datadictionary
See Data Entry module M_dhis-web-dataentry
See Data Mart module M_dhis-web-datamart
See Data Set Maintenance module M_dhis-web-maintenance-dataset
See Data Visualizer module M_dhis-web-visualizer
See Event Capture module M_dhis-web-event-capture
See Event Reports module M_dhis-web-event-reports
See Event Visualizer module M_dhis-web-event-visualizer
See Excel Report module M_dhis-web-excel-reporting
See Export Data Mart Module M_dhis-web-exportdatamart
See FRED API Module M_dhis-web-api-fred
See GIS module M_dhis-web-gis
See GIS module M_dhis-web-mapping
See Import-Export module M_dhis-web-importexport
See Individual Records M_dhis-web-caseentry
See Light module M_dhis-web-light
See Line-listing DataEntry module M_dhis-web-dataentry-national
See Mobile Maintenance module M_dhis-web-maintenance-mobile
See NRHM Reports module M_dhis-web-reports
See Organisation Unit Maintenance module M_dhis-web-maintenance-organisationunit
See Pivot Table module M_dhis-web-pivot
See Report module M_dhis-web-reporting
See Settings Maintenance module M_dhis-web-maintenance-settings
See Smartphone module M_dhis-web-mobile
See SMS module M_dhis-web-sms
See Tracked Entity And Programs module M_dhis-web-maintenance-program
See Tracker Capture module M_dhis-web-tracker-capture
See User Maintenance module M_dhis-web-maintenance-user
See Validation Analysis module M_dhis-web-validationrule-local-in
See Validation Rule module M_dhis-web-validationrule
Send message F_SEND_MESSAGE
Send SMS F_MOBILE_SENDSMS
Set mobile settings F_MOBILE_SETTINGS
Single Event Without Registration Data Entry F_ANONYMOUS_DATA_ENTRY
Single Event With Registration Data Entry F_SINGLE_EVENT_DATA_ENTRY
Sql View External Access F_SQLVIEW_EXTERNAL
Sql View Management F_SQLVIEW_MANAGEMENT
Tracked Entity Aggregation F_TRACKED_ENTITY_AGGREGATION
Tracked Entity Form Management F_TRACKED_ENTITY_FORM_MANAGEMENT
Tracked Entity Instance Dashboard F_TRACKED_ENTITY_INSTANCE_DASHBOARD
Tracked Entity Instance Management F_TRACKED_ENTITY_INSTANCE_MANAGEMENT
Tracked Entity Relationship Management F_RELATIONSHIP_MANAGEMENT
Update Facility F_FRED_UPDATE
Update Organisation Unit Level F_ORGANISATIONUNITLEVEL_UPDATE
Update Program Rule F_PROGRAM_RULE_UPDATE
Update Relationship Type F_RELATIONSHIPTYPE_UPDATE
Update Tracked Entities F_TRACKED_ENTITY_UPDATE
Update Tracked Entity Attribute F_TRACKED_ENTITY_ATTRIBUTE_EDIT
Upload Excel Template F_EXCEL_TEMPLATE_MAMAGEMENT_UPLOAD
View and Search Tracked Entity Attributes and Identifiers F_ACCESS_TRACKED_ENTITY_ATTRIBUTES
View data browser F_VIEW_DATABROWSER
View Program Stage Completeness Report F_PROGRAM_STAGE_COMPLETENESS
View program tracking F_PROGRAM_TRACKING_LIST
View Report F_REPORT_VIEW
View Tracked Entity Attribute F_TRACKED_ENTITY_ATTRIBUTE_VIEW
View unapproved data F_VIEW_UNAPPROVED_DATA
View User F_USER_VIEW
View User Group Managing Relationships F_USERGROUP_MANAGING_RELATIONSHIPS_VIEW
View User Within Managed Group F_USER_VIEW_WITHIN_MANAGED_GROUP
Delete tracked entity instance and associated enrollments and events F_TEI_CASCADE_DELETE
Delete enrollment and associated events F_ENROLLMENT_CASCADE_DELETE
Edit expired data F_EDIT_EXPIRED

关于对象共享

本章讨论DHIS2中的实体共享功能。

共享对象

DHIS2中的许多对象(例如报告,图表,地图和指标)都可以 共享。 DHIS2支持元数据共享或数据共享。分享 元数据意味着使对象(例如报告)可供阅读或 修改为一组用户或每个人。数据共享方式 将捕获的实际数据提供给其他人,并控制谁 可以捕获此类数据。例如报告,共享 单击旁边的“共享设置”按钮可以打开对话框 列表中的每个报告。实施者可以使用此功能来允许 仅某些用户组可以访问某些对象。用户可以使用 决定他们想要共享对象的功能(例如数据透视) 表格,图表,仪表板等)。

如果特定类的对象支持共享,则将出现一个对话框 称为“共享设置”,通常可以通过单击 对象的名称或在分析工具中,通过图标(共享 和其他人)。访问共享设置后, 您想要共享的对象,将出现一个类似于以下对话框。 如图所示。

You can share your report with everyone or with a number of user groups. "External access" can be enabled to allow this resource to be shared with everyone, including users which cannot logon to DHIS2. This is useful for sharing public resources with external systems. Note, that if objects are shared externally, then they are visible to anyone who has access to the URL which provides the resource without any login credentials. Also note that "External access" does not give access to logged in users—to give them access, you must also allow "Public access".

在“公共访问”旁边,您可以在下面选择公共访问选项 “ METADATA”:“无权访问”,“只能查看”或“可以编辑和查看”,以及 在“数据”下:“无访问权限”,“可以查看数据”,“可以捕获数据”。上市 访问是指登录到系统的用户。也编辑 意味着删除报告。

要与群组共享,只需开始输入群组名称和 “搜索用户组”输入字段,然后选择所需的组。 单击输入字段旁边的“ +”图标以与该组共享。 您可以为每个组设置一个访问选项,类似于公共访问。

与用户组共享意味着该组中的所有用户都将获得 访问共享对象。要创建用户组,您可以转到 仪表板模块,然后单击“组”。这将带您进入清单 您可以在其中单击右上角的“添加新”。 仪表板模块中的每个人都可以创建用户组。

元数据共享和访问控制

支持元数据共享的对象是指标,指标 组,指标组集,数据字典,数据集,程序,标准 报告,资源,报告表,图表,地图和用户组。在那些之中 对象,报告表,图表,地图和用户组向所有人开放 私下创建。私有意味着对象仅可用 您自己或潜在地针对多个用户组(如果您选择 共享对象。这些对象称为“打开”对象,并且 可以由所有用户创建。其余对象要求您 用户帐户有权创建它们。这些对象是 称为“非打开”对象。

可以授予用户创建可公开访问的权限 对象或可私有访问的对象。为了公开创建 用户的可访问对象(任何人均可查看或编辑) 帐户必须有权这样做。例如,创建一个 公开图表,您的用户必须具有“创建公开图表” 授权。创建私有对象的权限仅适用 非开放对象。例如,允许用户创建指标 仅该用户而非所有人(该用户)可以访问 可以被授予“创建私有指标”权限。

与其他人共享一个未打开的对象,然后让她编辑 对象要求该人的用户帐户具有以下权限: 更新授予的那种对象。例如,如果您想让 另一个人编辑您的指标,该人的用户帐户必须具有 授予“更新指示器”权限。这不适用于公开 对象。

创建新对象时,该对象将自动变为 所有人(如果您的用户帐户有权创建公共帐户) 对象。举例来说,如果您创建一个标准报告,并且拥有 授予“创建公共标准报告”的权限,该报告将 对所有人可见。如果您没有授予该权限 该报告仅对您自己可见。创建完一个 对象,您可以导航到“共享设置”对话框并设置您的 所需的访问控制级别。

如果您需要一个可以查看绝对所有对象的用户帐户 您可以使用“ ALL”权限创建用户角色,并将用户分配给 那个角色。如果需要在对象的“完整”视图之间切换 和对象的“个人”视图,建议创建两个用户 帐户,其中一个帐户分配了“ ALL”权限,另一个帐户则没有。

应用了元数据共享

元数据共享功能在几种情况下很有用。一 用例正在为具有以下条件的全球组织设置DHIS2实例: 在多个国家/地区开展业务。通常,组织有一套 适用于所有国家的全球数据集,指标和报告 国家,而所有国家/地区都需要针对特定国家/地区 数据集,指标和报告。在这种情况下以下 方法可能有效:

  • 为全球人员设置一个用户组。

  • 为每个国家/地区的人员设置用户组。

  • 创建全局数据集和报告,使其对所有人可见 并且仅可用于全局用户组。

  • 创建特定国家/地区的数据集和报告,使其可见 并可以针对国家/地区用户组和全球用户组进行编辑 只要。

这样,可以查看和分析全球指标和报告 由每个人,但仅由全局用户组维护。的 可以查看特定国家的数据集,指标和报告,并 由国家和全球人员维护,而看不见或 对组织中其他国家的系统产生影响。

类似的方法可能适用于有多个捐赠者的情况 用户所在国家/地区的供资机构和实施伙伴 可以为每个实体设置组。这样每个 实施合作伙伴可以在他们的内部创建并共享他们的报告 组织,而不影响或允许他人访问。报告书 也可以在结束时与主管和资助机构共享 报告期。

另一个用例是具有多个健康状况的国家卫生部门 程式。通常,需要有常规报告和 为部门制定图表,同时允许制定健康计划 供内部使用的特定报告和图表。这可以通过 为每个健康程序创建用户组。后来,在开发时 报告和图表,可以使这些视图和图表对 仅程序用户组。这样,报告将不可见 其他程序和用户。这是有益的,因为报告是 保留在程序内部,并且因为可见的报告列表 其他用户则更短,更相关。

数据共享和访问控制

支持数据共享的对象是数据集,跟踪实体 类型,程序和程序阶段。数据共享的目的是 控制哪些用户可以捕获数据,哪些用户可以查看数据 被抓

基于事件的程序的数据共享

适用于被跟踪实体类型,程序和程序的对象类型 阶段。在事件捕获中使用单个事件程序时,用户 必须具有“ DATA:可以查看数据”共享级别才能看到 程序及其数据。没有此共享级别,该程序及其 用户将看不到数据。使用跟踪器程序时 在跟踪器捕获中,用户需要具有“数据:可以查看数据”才能 跟踪的实体类型和程序。如果是跟踪程序, 在每个程序阶段,用户还将需要“ DATA:可以查看数据” 以便能够查看程序中的数据。捕获 数据用户需要“数据:可以捕获数据”共享级别。

注意

要查看和捕获程序的数据,数据捕获用户还需要 向该程序所在的组织单位报告 已分配。

Data sharing for tracker programs
Object type Can view data Can capture data 评论
Tracked entity type * Search for tracked entities with this tracked entity type.
* See tracked entity type attribute values for this tracked entity type.
* Edit visible tracked entity attributes for tracked entity instances of this type.
* Register/create new tracked entity instances of this type.
* Delete tracked entity instances of this type.
* Deactivate/reactivate tracked entity instances of this type.
程序 * Search for tracked entities within this program.
* See tracked entity attributes specific to this program.
* See enrollment details for the program.
* See notes for the enrollment.
* Enroll into the program.
* Edit enrollment details for the program.
* Complete/reopen enrollments into the program.
* Add notes for the program.
* Edit relationships for the program.
* Send message to tracked entity instance.
* Delete enrollments in the program.
Both "Can view data" and "Can capture data" also requires the user to have "Can view data" for the tracked entity type.
Program stage * See the program stage and its events and data within an enrollment.
* See the program stage notes.
* Add/schedule/refer a new event within the program stage.
* Complete/reopen the events within the program stage.
* Edit tracked entity data values within events in the program stage.
* Add notes for events in the program stage.
* Delete events in the program stage.
Both "Can view data" and "Can capture data" also requires the user to have "Can view data" for the program and the tracked entity type.
Data sharing for single event programs
Object type Can view data Can capture data 评论
程序 * See list of events within the program.
* See tracked entity data values for events in the program.
* Add new events into the program.
* Edit data for events in the program.
* Delete events in the program.

数据集的数据共享

适用于数据集和类别选项的对象类型。什么时候 在数据输入应用程序中工作,用户需要具有“数据:可以捕获 数据”以查看和捕获数据集中的数据。 用户需要在“数据集”中输入字段:

  1. 授权:F _DATAVALUE _ADD(可以添加数据值)

  2. 数据集与“数据:可以捕获数据”共享

  3. 数据元素与“元数据:可以查看”共享

  4. 所选数据集使用的所有类别选项均与 “数据:可以捕获数据”

注意

要查看和捕获数据集的数据,数据捕获用户还需要 向组织单位报告数据集所在的位置 已分配。

Data sharing for data sets
Object type Can view data Can capture data 评论
Data set * View Data Set's data in Analytics * Can see DataSet in Data Entry app
* Can save data for Data Set using API
For saving data value in Data Entry app, users also need "Can capture data" for Category Options within selected Data Set.
CategoryOption * Can view data values belong to shared Category Option in analytics * Can save data value for input fields in Data Entry app which belongs to shared Category Options. For CategoryOptionCombo and AttributeOptionCombo to be writeable, all belongs CategoryOptions must be shared with "Can capture data".

Configure DHIS2 Maps

语境

Setting up DHIS2 Maps simply means storing coordinates for the organisation units you want to show on the map in the database. Coordinates are often distributed in proprietary formats and will need to be converted to a format which DHIS2 understands. ESRI shapefile is a common geospatial vector data format for desktop applications. You might find shapefiles for your country here or in many other geospatial data repositories on the web. Some amount of work needs to be done in order to use these coordinates in DHIS2 Maps, namely transforming the data into a suitable format and ensuring the name which are contained in the geospatial data match exactly with the names of the organization units which they should be matched to.

Only organisation units with POINT geometry types can be edited through the Maintenance app at this time. To modify POLYGON geometries, please us the Org unit geometry import in the Import/Export app.

To edit the POINT coordinates of an organisation unit, open the Maintenance App and navigate to the Organisation Unit section. Click on the Organisation Unit you would like to view or edit, you can search or filter the list from on the left-hand side of the screen. Once an organisation unit is selected, you can edit the Latitude and Longitude values to update the POINT coordinates. If the Organisation Unit has a POLYGON geometry, the coordinates cannot be edited.

If you are going to add or update coordinates for a large number of units, or if you need to update polygon geometries, you should use the automatic Org unit geometry import explained in the following section.

Important

The only coordinate reference system (CRS) supported by DHIS2 is EPSG:4326, also known as geographic longitude/latitude. Coordinates must be stored with the longitude (east/west position) proceeding the latitude (north/south position). If your vector data is in a different CRS than EPSG 4326, you will need to reproject the data first before importing into DHIS2.

Importing coordinates in GeoJSON format

Step 1 - Convert geospatial data to GeoJSON format

Skip this step if your data is already in GeoJSON format using geographic longitude/latitude.

The recommended tool for geographical format conversions is called "ogr2ogr". This should be available for most Linux distributions sudo apt-get install gdal-bin . For Windows, go to http://fwtools.maptools.org/ and download "FWTools", install it and open up the FWTools command shell. During the format conversion we also want to ensure that the output has the correct coordinate projection (called EPSG:4326 with geographic longitude and latitude). For a more detailed reference of geographic coordinates, please refer to this site . If you have already reprojected the geographic data to the geographic latitude/longitude (EPSG:4326) system, there is no need to explicitly define the output coordinate system, assuming that ogr2ogr can determine the input spatial reference system. Note that most GeoJSON files use the EPSG:4326 system. You can determine the spatial reference system by executing the following command.

ogrinfo -al -so filename.shp

This command assumes your geospatial data is in ESRI Shapefile (.shp) format, but several other formats are supported .

Assuming that the projection is reported to be EPSG:27700 by ogrinfo , we can transform it to EPSG:4326 by executing the following command.

ogr2ogr -s_srs EPSG:27700 -t_srs EPSG:4326 -f GeoJSON filename.geojson filename.shp

If the geographic data is already in EPSG:4326, you can simply transform the shapefile to GeoJSON by executing the following command.

ogr2ogr -f GeoJSON filename.geojson filename.shp

You will find the created GeoJSON file in the same folder as the shapefile.

Step 2 - Simplify/generalize your geographical data

The boundaries in geographical data files are usually very accurate, too much so for the needs of a web-based GIS. This usually does not affect the performance when using GIS files on a local system, but it is usually necessary to optimize the geographical data for the web-based GIS system of DHIS2. All geographical data needs to be downloaded from the server and rendered in a browser, so if the data is overly complex, the performance of the DHIS2 Maps will be negatively impacted. This optimization process can be described as follows:

For polygons, we can make the boundary lines less detailed by removing some of the line points. This generalization will lead to degradation of the polygon. However, after a bit of experimentation, an optimal level of generalization can be found, where the accuracy of the polygon is visually acceptable, and the performance is optimal. Make a backup of your files before you start. One possible method is the use of MapShaper which is an online tool which can be used to generalize geographical data. To use MapShaper, simply upload your files to the site. Then, click on Simplify in the top menu and select a simplification method. A slider will show at the top of the screen that starts at 100%. It is usually acceptable to drag it up to about 30%. When you are happy with the result, click "Export" in the top right corner. Select the "GeoJSON" file format and click the Export button to download the file. Move on to the next step with your new simplified GeoJSON file.

Step 3 - Prepare the GeoJSON file

Unfortunately, the GeoJSON file is not ready for importation yet. Open it in a robust text editor like Geany (Linux) or Notepad++ (Windows). GeoJSON is a JSON based format. In the GeoJSON file an organisation unit is represented as a Feature. Every feature should have a geometry, properties (attributes) and they can have an id.

In order to import geospatial data from a GeoJSON file, DHIS2 must match each of them with an organisation unit in its database. Each GeoJSON feature must, in other words, contain a reference to its corresponding organisation unit. The reference itself must be one of three possible DHIS2 identifiers: uid , code or name .

By default we will try to match the organisation unit uid with the GeoJSON feature id. You can add or change the id field so it matches the uid for the organisasjon unit. You can also match by a property from the GeoJSON feature properties. The property can be matched with organisation uid , code or name .

Please note that the identifier used must uniquely identify an organisation unit (e.g. if there are two organisation units in the database of the same name or code, these cannot be matched properly on either). As uid is the only guaranteed-to-be-unique identifier it is the most robust choice. However, as matching on name is usually easier (given that the name is already part of your data).

简要查看标识符,并将其与 数据库中的相应值。如果它们看起来相当不错, 现在是时候在import-export模块中进行预览了。

Go to the Import/Export app and click Org Unit geometry import . Select the GeoJSON file and how you want to match the GeoJSON features to the organisation units. Click Start dry run and look at the summary. Look for new/updated organisation units. Our intention is to add coordinates to already existing organisation units in the database, so we want as many updates as possible and 0 new. Those listed as new will be created as root units and mess up the organisation unit trees in DHIS2. If any listed as new, click the number and the organisation units in question will appear in the list below. If there are any slight misspellings compared to the organisation unit names in the database - fix them and start dry run again. Otherwise, click the "discard all" button below the list and then the Start import button.

If the import process completes successfully, you should now be able to utilize the geographical data in the DHIS2 Maps. If not, check the log for hints and look for common errors such as:

- Name duplicates in the GeoJSON file. The name column in the database is unique and does not accept two organisation units with the same name.

-数据库中organizationalunit表中的“ shortname”列 varchar定义太小。将其增加到100。

- Special name characters in the GeoJSON file.

- Wrongly formatted input GeoJSON, use GeoJSONLint to test the content.

Importing coordinates in GML format

第1步-简化/概括您的地理数据

The boundaries in geographical data files are usually very accurate, too much so for the needs of a web-based GIS. This usually does not affect the performance when using GIS files on a local system, but it is usually necessary to optimize the geographical data for the web-based GIS system of DHIS2. All geographical data needs to be downloaded from the server and rendered in a browser, so if the data is overly complex, the performance of the DHIS2 Maps will be negatively impacted. This optimization process can be described as follows:

For polygons, we can make the boundary lines less detailed by removing some of the line points. This generalization will lead to degradation of the polygon. However, after a bit of experimentation, an optimal level of generalization can be found, where the accuracy of the polygon is visually acceptable, and the performance is optimal. Make a backup of your shapefiles before you start. One possible method is the use of MapShaper which is an online tool which can be used to generalize geographical data. To use MapShaper, simply upload your files to the site. Then, click on Simplify in the top menu and select a simplification method. A slider will show at the top of the screen that starts at 100%. It is usually acceptable to drag it up to about 30%. When you are happy with the result, click "Export" in the top right corner. Select GeoJSON file format and click the Export button to download the file to your computer.

Step 2 - Convert to GML

The recommended tool for geographical format conversions is called "ogr2ogr". This should be available for most Linux distributions sudo apt-get install gdal-bin . For Windows, go to http://fwtools.maptools.org/ and download "FWTools", install it and open up the FWTools command shell. During the format conversion we also want to ensure that the output has the correct coordinate projection (called EPSG:4326 with geographic longitude and latitude). For a more detailed reference of geographic coordinates, please refer to this site . If you have already reprojected the geographic data to the geographic latitude/longitude (EPSG:4326) system, there is no need to explicitly define the output coordinate system, assuming that ogr2ogr can determine the input spatial reference system. Note that most shapefiles are using the EPSG:4326 system. You can determine the spatial reference system by executing the following command.

ogrinfo -al -so filename.json

Assuming that the projection is reported to be EPSG:27700 by ogrinfo , we can transform it to EPSG:4326 by executing the following command.

ogr2ogr -s_srs EPSG:27700 -t_srs EPSG:4326 -f GML filename.gml filename.json

如果地理数据已经在EPSG:4326中,则只需进行转换 通过执行以下命令将shapefile转换为GML。

ogr2ogr -f GML filename.gml filename.json

您将在shapefile所在的文件夹中找到创建的GML文件。

第3步-准备GML文件

不幸的是,GML文件尚未准备好导入。在其中打开 强大的文本编辑器,例如Geany(Linux)或Notepad ++(Windows)。 GML是 基于XML的格式,这意味着您将识别常规XML 标签层次结构。在GML文件中,组织单位表示为 <gml:featureMember>。在功能成员内部,我们通常会发现很多 属性,但是我们只是要导入它们的坐标。

In order to import geospatial data from the feature members of the GML input, DHIS2 must match each of them with an organisation unit in its database. The feature member element must, in other words, contain a reference to its corresponding organisation unit. The reference itself must be one of three possible DHIS2 identifiers: uid , code or name . The identifier of choice must be provided as a property for each feature member element. The importer will look for a property with the local name of either Uid , Code or Name , e.g. "ogr:Name" or "anyPrefix:Code".

如果您的功能成员已经包含标识符的属性,则您 希望使用(例如区域名称)可以使用搜索和替换 在文本编辑器中将这些元素重命名为DHIS2将识别的名称 (请参见下表)。这通常是适用的工作流程 使用名称作为标识符时(源shapefile甚至GML 通常会包含其定义的每个区域的名称)。

Organisation unit identifiers supported for GML import
Matching priority 识别码 Valid spellings Guaranteed unique
1 Uid uid, Uid, UID 是的
2 code, Code, CODE
3 名称 name, Name, NAME

In the case of renaming properties one would usually find a tag named something like "ogr:DISTRICT*NAME", "ogr:NAME_1" and rename it to "ogr:Name". If using the _code* or uid identifiers on the other hand, looking up the correct values in the DHIS2 database and going through the GML file, adding the properties for each corresponding feature member might be necessary. In any of the cases it is important to realize that the identifier used must uniquely identify an organisation unit (e.g. if there are two organisation units in the database of the same name or code, these cannot be matched properly on either). As uid is the only guaranteed-to-be-unique identifier it is the most robust choice. However, as matching on name is usually easier (given that the name is already part of your data), a viable approach to solving uniqueness conflicts can be to match any non-uniquely named organisation units on a different identifier (uid, preferably) and the rest on their names.

如上表所示,有一个匹配的优先级,即 为同一功能成员提供了两个或多个标识符, 匹配将在最高优先级的标识符上执行。另请注意 GML中可以使用的有效属性。命名空间前缀 不重要,因为仅使用本地名称。

A common pitfall of performing preparation of the GML files is syntax- or element naming errors. Therefore please make sure that all properties of the GML file are started and terminated with correctly corresponding tags. Also make sure the properties follow either of the given valid spellings of the property name. The identifying properties are supposed to look like e.g. \<ogr:Name>Moyamba District\</ogr:Name>, \<somePrefix:uid>x7uuia898nJ\</somePrefix:uid> or \<CODE>OU*12345\</CODE>. Another common error is not making sure the identifier matches exactly, especially when using the _name* property. All matches are performed on exact values, meaning that "Moyamba" in a source GML file would not be matched against "Moyamba District" in the database.

简要查看标识符,并将其与 数据库中的相应值。如果它们看起来相当不错, 现在是时候在import-export模块中进行预览了。

Go to the Import/Export app , click Org Unit geometry import and select the GML format. Select the GML file and click Start dry run and look at the summary. Look for new/updated organisation units. Our intention is to add coordinates to already existing organisation units in the database, so we want as many updates as possible and 0 new. Those listed as new will be created as root units and mess up the organisation unit trees in DHIS2. If any listed as new, click the number and the organisation units in question will appear in the list below. If there are any slight misspellings compared to the organisation unit names in the database - fix them and do the preview again. Otherwise, click the "discard all" button below the list and then the "Import all" button above the list.

如果导入过程成功完成,您现在应该可以 利用DHIS2 GIS中的地理数据。如果没有,请检查日志 寻找提示并查找常见错误,例如:

-名称在GML文件中重复。数据库中的名称列为 唯一,并且不接受两个具有相同名称的组织单位。

-数据库中organizationalunit表中的“ shortname”列 varchar定义太小。将其增加到100。

-GML文件中的特殊名称字符。确保将它们转换为 适当的XML等效项或转义序列。

-输入GML格式错误,标签不匹配

配置报告功能

报告数据源

数据类型和汇总

在HIS术语的整体图中,DHIS2中的所有数据通常都是 称为汇总,因为它们是以下各项的汇总(例如每月汇总) 医护人员报告的医疗记录或某种服务记录 卫生设施。但是,DHIS2内部的聚合是主题 这里是关于如何在DHIS2中捕获原始数据(通过数据 输入或导入)随着时间的推移进一步汇总(例如,从每月到 季度值)或组织层次结构(例如来自工厂) 到地区值)。

术语

  • *原始数据*是指注册到DHIS2中的数据 通过数据输入或数据导入,并且没有被操作 DHIS2聚合过程。所有这些数据都存储在 表(或Java对象,如果需要)称为DataValue。

  • *汇总数据*是指由 DHIS2,意味着它不再是原始数据,而是某种汇总 原始数据。

  • *指标值*也可以理解为汇总数据,但是 这些是基于用户计算方式的特殊方式 定义的公式(因子 *分子/分母)。指标值 因此是处理后的数据而不是原始数据,并且位于 聚合值值表/对象。指标计算 在组织层次结构的任何级别以及这些计算 然后基于每个节点可用的汇总数据值 水平。聚合数据值表中的级别属性指的是 价值所在的组织单位的组织级别 计算。

    • Period and Period type *用于指定时间的维度 原始值或汇总值,并且数据可以从一个汇总 句号类型,例如从每月一次到季度一次,或者每天一次 每月。每个数据值有一个周期,而那个周期有一个周期 期间类型。例如。一月,二月和三月的数据值 2009年,所有月度类型可以汇总到 2009年第一季度和期间类型的汇总数据值 季刊。

汇总的基本规则

什么加在一起

数据(原始)可以在任何组织级别(例如,在 2级国家医院,5级卫生机构或 级别4的PHC更大。这因国家/地区而异,但是DHIS2是 灵活地允许在任何地方进行数据输入或数据导入 水平。这意味着自己生子的性行为可以 注册数据,有时与其子单元使用相同的数据元素。 DHIS2中聚合的基本规则是*所有原始数据都是 汇总在一起*,表示在第5级设施上注册的数据 被添加到第4级为PHC注册的数据中。

用户/系统管理员/设计者应确保没有 正在进行重复的数据输入,例如在处输入的数据 级别4与报告的服务/访问次数不同 5级组织儿童。

注意

在某些情况下,您想拥有 在系统中复制数据,但以受控方式进行。例如。什么时候 您有两个不同的人口估计数据来源 5级流域人口数据和另一个人口数据源 基于人口普查数据的第4级(因为第5级流域的总和不是 始终与4级人口普查数据相同)。然后您可以指定使用 系统应使用的高级聚合设置(请参阅下一节) 例如不将5级人口数据添加到4级人口数据中,并且 3,2,1级人口数据汇总仅基于4级 数据,不包括5级数据。

数据如何加在一起

数据如何聚合取决于聚合的维度(请参阅 再向下)。

沿着组织单位级别,维度总会被汇总;即简单地添加 一起。请注意,原始数据永远不会是百分比,因此可以是 总结在一起。指标值可以是百分比 不同(在每个级别上重新计算,从不总结)。

沿着时间维度,存在几种可能性,其中两种可能性最大 汇总的常用方法是求和与求平均值。用户可以指定 每个数据元素通过设置聚合使用哪种方法 运算符(请参阅下一节)。通常汇总每月服务数据 随着时间的流逝,例如一年中接种的疫苗数量是 该年每个月接种的疫苗总和。对于人口 设备,人员和其他通常称为半永久性的东西 数据,平均方法通常是一种使用的方法,例如'的数量 护士在某机构工作一年,将不会是两者之和 六个月的人员配置报告中报告的数字,但 两个数字的平均值。 “聚合”下的更多详细信息 运营商的。

集合维度

组织单位和级别

组织单位用于表示“何处”维度 与数据值相关联。在DHIS2中,安排了组织单位 在层次结构中,通常对应于层次结构性质 组织或国家/地区的名称。组织单位级别对应于 层次结构中的不同级别。例如,一个国家可能是 组织成省,然后是地区,然后是设施,然后 次中心。该组织层次结构将具有五个级别。 在每个级别内,将存在许多组织单位。中 聚合过程中,数据从下层开始聚合 组织单位级别更高。取决于 聚合运算符,数据可以在给定范围内“求和”或“平均” 组织单位级别,以得出所有 较高级别中包含的组织单位 组织单位级别。例如,如果有十个区 给定数据包含在一个省和聚合运算符中 元素已定义为“ SUM”,即该省的总计 将被计算为单个十个值的总和 该省包含的地区。

句点用于表示与数据关联的“何时”维度 价值观。数周至数月,数月不等的数据可以轻松汇总 到季度,从季度到年份。 DHIS2使用已知的规则 这些不同的间隔包含在其他间隔中 实例2010年第一季度已知包含2010年1月,2010年2月 (2010年3月),以便汇总较小时间间隔的数据, 例如个星期,例如更长的时间间隔几个月。

数据元素和类别

数据元素维度指定“正在”记录的内容 特定数据值。数据元素类别实际上是退化的 数据元素维度的维度,用于分解 将数据元素维度划分为更精细的类别。数据元素 类别(例如“年龄”和“性别”)用于记录特定 数据元素,通常用于不同的人群。这些 然后可以使用类别来计算 类别和所有类别的总计。

聚合运算符,聚合方法

“ sum”运算符仅计算所有 包含在特定的汇总矩阵中。例如,如果数据 在地区级别每月进行记录并汇总 到省的季度总数,所有地区包含的所有数据 给定的省份以及给定季度的所有星期都将被添加 一起获得总计。

平均

选择平均聚合运算符时,未加权 给定聚合矩阵内所有数据值的平均值为 计算。

重要的是要了解DHIS2如何处理 一般操作员的上下文。对于某些人来说这很普遍 组织单位不提交某些数据元素的数据。在 在平均运算符的上下文中,平均结果取自数字 数据元素中实际存在的数据元素(因此不是NULL) 给定的聚合矩阵。给定范围内是否有12个区 省,但其中只有10个提交了数据,平均 总计将由实际存在的这十个值得出 数据库,并且不会考虑缺少的值。

高级聚合设置(聚合级别)

聚合水平

系统的正常规则是将所有原始数据汇总在一起 向上移动组织层次结构,系统假设数据 通过输入提供给以下用户的相同服务,该条目不会重复 在两个设施级别都具有相同的客户, 更高级别的“汇总”(所有设施的总和)数量。这是 当相同的服务是 提供给不同设施的客户/集水区 5级和PHC(相同设施的父级)在4级。 这样,第5层的设施和第4层的PHC可以共享同一设施 数据元素,然后简单地将其数字相加即可得出总数 地理区域中提供的服务。

有时不希望这样的聚合,仅仅是因为它会 表示重复有关同一人群的数据。这是当 您有两个不同组织单位级别的两个不同数据源。 例如。设施的集水人口可以来自不同的地方 来源比地区人口多,因此设施的总和 流域人口与以下地区提供的地区人口不符 例如人口普查数据。如果是这种情况,我们实际上希望复制 系统中的数据,以便每个级别可以具有与 可能,但是我们不想汇总这些数据源 一起。

在“数据元素”部分,您可以编辑数据元素,对于每个 它们指定每个级别的汇总方式。在这种情况下 如上所述,我们需要告诉系统不要包含设施数据 高于该级别(即该级别)的任何聚合中的人口 以上,在这种情况下,各区已登记了他们的人口 直接作为原始数据。然后应使用地区人口数据 在以上(包括区级)的所有级别上,而设施 级别应使用自己的数据。

如何编辑数据元素聚合

这是通过称为聚合级别和在 编辑数据元素屏幕的末尾有一个复选框 聚合级别。如果您勾选那个,您将看到一个清单 聚合级别,可用和已选择。默认是没有 定义了聚合级别,那么层次结构中的所有原始数据将是 加在一起。为了指定上述规则,并给出了 国家,省,地区,设施等级:选择设施和 区为您的聚合级别。基本上你选择你在哪里 数据。选择设施意味着设施将使用来自 设施(因为这是最低级别)。选择地区 表示在汇总时将使用区域级别的原始数据 区域级别的数据(因此该日期不会进行汇总 级别),而设施数据将不属于汇总数据 地区值。在省级区域汇总数据时 将使用最高级别的原始数据,因为这是最高的可用数据 已选择聚合级别。同样针对国家/地区级别 将使用地区原始数据。只是重复一下,如果我们没有指定 该区级别是一个聚合级别,然后是设施数据和 地区数据将被加在一起并导致重复 (双)地区和以上所有级别的人口数据。

资源表

资源表提供有关以下方面的其他信息: 数据格式非常适合外部工具组合 与数据值表。通过将数据值表与这些 资源表可以轻松地沿着数据元素类别进行汇总 维度或数据元素/指标/组织单位组的维度。 例如。通过使用类别选项male或标记所有数据值 女性,并在另一列“性别”中提供该信息 根据收集的数据值得出的男性和女性小计 类别选项组合,例如(male, <5) and (male,> 5)。见 “数据透视表”部分提供了有关如何使用它们的更多示例。 orgunitstructure是数据库中另一个重要的表,有助于 提供orgunits的层次结构以及数据。通过加入 带有数据值表的orgunitstructure表可以获取行 具有完整层次结构的数据值,例如格式:OU1,OU2,OU3, OU4,DataElement,时间段,值(塞拉利昂,博,巴迪贾,Ngelehun CHC, BCG <1,2010年1月1日,32)这种格式可以使例如枢 表或其他OLAP工具将数据汇总到层次结构中。

报告表

报告表是定义的,交叉列表的报告,可以用作 进一步报告的基础,例如Excel数据透视表或简单地 下载为Excel工作表。报告表旨在提供 所需数据的特定视图,例如“每月国家ANC 指标”。此报告表可能会提供 国家/地区,按月汇总整个国家/地区。该数据可以 当然可以从主要的数据集市中检索,但通常是报表表 执行速度更快,并向用户呈现定义明确的数据视图。

如何创建报告表

要创建新的报告表,请转到 报告模块(报告->报告表)。以上标准清单 报告,请使用“添加报告表”或“添加数据元素维表” 纽扣。常规报告表可用于保存数据 元素,指标或数据集完整性,而数据元素 维度表用于在报表中包括数据元素类别 表。创建表的方法相同,但是,唯一的方法是 选择数据时例外。

要创建报告表,首先要为 表格,其中最重要的是交叉表维度。然后, 您选择哪些数据元素,指标,数据集或数据元素 您要包含的尺寸。最后,您选择哪个组织 报表中要使用的单位和时间段。每个步骤 详细说明如下。

常规选项

跨标签尺寸

您可以交叉标记以下一个或多个维度:数据 元素/指标,组织单位和期间,这意味着列将是 根据所选尺寸的值创建的如果指标 选择后,您将在表中获得反映名称的列名称 所选指标中。

例如,如果您跨指标和周期进行制表,则该列 标头将显示“ <indicator title> <period>”。组织 单位将列为行。参见屏幕截图以进行澄清:

如果您交叉链接指标和组织单位,则该列 该表的标题将显示“ <indicator title> <组织 unit >“。现在句点将列为行。有关的信息,请参见屏幕截图 澄清:

请注意,此处有关交叉表尺寸的选项可能具有 使用报告表时可用选项的后果 以后用作数据源,例如用于标准报告。

排序

影响表中最右边的列,允许您选择排序 从低到高或从高到低。

最高限额

上限允许您设置要包括的最大行数 在报告表中。

包括回归

这将添加具有可包含的回归值的其他列 在报表设计中,例如折线图中。

选择数据

指标/数据元素

在这里,选择要包含的数据元素/指标 那个报告。使用群组过滤器可以更轻松地找到自己 寻找并双击要包含或使用的项目 用于添加/删除元素的按钮。您可以同时拥有数据元素和 同一报告中的指标。

数据集

在这里,选择要包括在报告中的数据集。 包含数据集将为您提供有关数据完整性的数据 给定集合,而不是其数据元素上的数据。双击您要的项目 想要包含或使用按钮。

选择报告参数

有两种方法可以选择要包含在其中的组织单位 报告以及应包含哪些时间段:相对时间段还是固定时间段。 固定的组织单位和/或期间表示您选择 创建报告时要包含在报告表中的单位/期间 表。使用相对期间,您可以选择时间和/或单位为 报表表填充时的参数,例如运行时 标准报告或创建图表。也可以组合使用 例如在报告中永久添加一些组织单位 同时让用户选择其他。报表参数为 在下面讨论。通常,使用固定的组织单位和/或时间 期限是不必要的限制。

固定的组织单位

要添加固定组织单位,请点击“切换固定组织 单位”。将出现一个面板,您可以在其中选择始终使用的枪支 包括在报告中。如果您将其保留为空白,则用户选择orgunits 通过使用报告参数运行报告时。使用 下拉菜单可按级别过滤组织单位,双击或 使用按钮添加/删除。

固定时期

要添加固定期间,请单击“切换固定组织单位”。面板 将出现在您可以选择始终包含在 报告。如果您将其保留为空白,则用户在运行 通过使用报告参数进行报告。使用下拉菜单 选择期间类型(周,月等),然后按“上一个”和“下一个”按钮 选择年份,然后双击或使用按钮添加/删除。

相对期间

与其使用固定/静态时段(例如“ 2010年1月”或“ 2010年第一季度”),不如说是 通用期间可用于创建可重复使用的报告表,例如对于 每月报告期间,“报告月份”只需选择 用户在运行报告时选择的当前报告月份。 请注意,所有相对期间都是相对于“报告月份”的。的 报告月份是由用户选择的,否则是当前的 使用月份。这是可能的相对期间的描述:

  • 报告月份:

    将此用于每月报告。报告中选择的月份 报告中将使用month参数。

  • 今年的月份/季度

    这将在一年中每月或每季度提供一个值。这个 非常适合标准的月度或季度报告,其中所有 需要列出月份/季度。仍无数据的期间 将为空,但将始终保持相同的列名。

  • 今年:

    这是一年中到目前为止的累计值,汇总了各个期间 从年初开始直到选定的 报告月份。

  • 去年的月份/季度

    相对于去年的每月或每季度,这将提供一个价值 到报告月份。这非常适合标准的每月或 需要列出所有月份/季度的季度报告。 仍然没有数据的期间将为空,但将始终保留 相同的列名。

  • 去年:

    这是相对于报告月份的去年累计, 汇总去年以来的所有期间。

范例-相对期间

假设我们选择了三个指标:A,B和C,我们还选择了 选择使用相对期间“报告月份”和“今年” 当我们创建报告表时。如果是报告月份(已选择 自动或由用户)是例如2010年5月 将为2010年5月计算三个选定指标的值 (=“报告月份”)和三个月的累计值 在2010年到目前为止选择的指标(=到目前为止为“今年”)。

因此,我们最终将为每个组织单位使用六个值: “指标A,2010年5月”,“指标B,2010年5月”,“指标C,2010年5月”, “ 2010年迄今的指标A”,“ 2010年迄今的指标B”和 “指标C到2010年为止”。

报告参数

报告参数使报告随着时间的推移更加通用和可重用 和不同的组织单位。这些参数将在以下情况时弹出 生成报告表或基于报告运行报告 表。用户将选择他们想要在报告中看到的内容。那里 有四个可能的报告参数,您可以选择无,全部或 任何组合。

  • 报告月份:

    这决定了系统选择时使用哪个月份 相对时期。如果未选中该框,则用户不会 在生成报告时被要求提供报告月份- 然后将使用当前月份。

  • 上级组织单位:

    选择所有组织单位孩子和祖父母的祖父母 您要在报告中列出的孩子。例如。所选区域将 触发该区域本身,所有区域以及所有区域的使用 他们的街道。

  • 家长组织单位:

    选择要在列表中列出的所有组织单位子项的父项 报告。例如。选定的区域将触发使用 地区本身及其所有子地区。

  • 组织单位:

    这将触发在报表中使用此组织单位。没有孩子 列出。

示例-报告参数

继续上面相对时间的示例,假设 除了“报告月份”之外,我们还选择了“家长 创建报告时将“组织单位”作为报告参数 表。运行报告表时,将要求我们选择 组织单位。现在,假设我们选择“ Region R”作为 组织单位。 “区域R”的子级为“区X”,并且 “区Y”。

运行报告时,系统将汇总两个报告的数据 “区X”和“区Y”。数据将从 收集它们的最低级别。的值 地区将进一步汇总,以得出 “区域R”。

因此,报告表将生成在 前面的示例,用于“区X”,“区Y”和“区域R”。

数据元素维度表

这些表允许在报告表中使用数据元素类别。 与常规报告表有两个区别。首先是 您无法选择交叉表尺寸,因为列将 始终是类别组合的分类。另一个 是数据的实际选择。只能添加一个类别组合 每个报表,则只能将同一类别组合中的数据元素设为 已选择。

小计和总计也将包含在表格中,例如一种 性别(男性,女性)+ EPI年龄( <1, > 1)类别组合可得出 以下几列:男性+ <1, male+> 1,女性+ <1, female+> 1,男性, 女性, <1, > 1,总计。

选择数据

使用下拉菜单选择类别组合。数据 将列出使用此类别组合的元素。双击以 添加到报告中,或使用按钮。

报表-最佳做法

为了使报告表能够随着时间的推移以及在各个分支之间可重复使用 可以有参数。允许使用四种类型的参数。组织单元 父组织单位(用于在一个区域列出枪支),祖父母 组织单位和报告月份。附带一提,我们可以提到 正在考虑将其扩展到包括季度和年度报告, 或者使该周期参数在周期类型方面更为通用 不知何故。使用期间作为参数的功能使报表成为可能 随着时间的推移可重复使用,因此非常适合报表需求,例如 月度,季度或年度报告。当用户运行报告时 在DHIS2中,用户必须为以下报告表指定值: 链接到报告。首先重新生成报告表 (删除并使用更新的数据重新创建),然后运行报告 (在后台,在Jasper报表引擎中)。

报告表可以包含与数据元素,指标相关的值 或数据完整性,与报告的完整性有关 在给定的月份内跨越orgunits。完整性报告将涵盖在内 在单独的部分中。

报告表中有三个维度可以识别数据。 指标或数据元素,枪支和时期。对于这些 用户可以选择维度以选择要包含在 报告。用户必须选择一个或多个数据元素或指标来 出现在报告中。可以将组织单位选择替换为 参数,一个特定的组织单位或父组织单位( 本身及其所有子项都出现在报告中)。如果一个或多个 选择了orgunits并且未使用orgunit参数,则报告 关于要包含哪些侦探,在大多数情况下是静态的 是对报告的不必要限制。

使用相对期间

除了特定的时间段外,还可以选择更高级的时间段 像2007年1月9日,2007年1月8日这样的时期也包含相对 期。由于报告通常会定期运行特定时间段 像Jan-09在报告中不是很有用。相反,如果您想 设计一个月度报告,您应该使用称为 报告月份。然后,您还必须将“报告月份”作为以下内容之一 您的报告参数,以使系统知道确切的 报告生成时间的报告月份。还有很多 可用的相对期间,它们都与报告参数有关 报告月份。例如。今年到目前为止的相对时间是指 包括当年的累计值报告月份。如果你 想要一个具有多个期间而不是一个汇总的趋势报告 期间,您可以选择“今年的月份” 一年中到目前为止每个月的值。您可以做类似的报告 与宿舍。这个想法是支持尽可能多的通用报告类型 可以使用相对期间,因此,如果您还有其他报告需求, 请在邮件列表中建议新的相对时期,它们可能会 添加到报告表选项中。

交叉尺寸

交叉制表是报表设计中非常强大的功能,因为 典型的DHIS2数据表,其参考了期间,数据 element / indicator和orgunit使更高级的报表设计变得非常 困难,因为你不能放具体指标,时期或 特定列上的orgunits。例如。通过交叉指标 指标报告表中的维度,您将获得指标名称 在报表的列标题上,除了列之外 参考组织单位,以及另一列参考期。有了这样的 您可以将指标名称拖放到特定列的表格设计 或iReport软件中的图表位置。同样,您可以交叉标签 在orgunits或句号上将其名称专门提供给 报告设计。例如。通过交叉标记期间并选择两个 相关期间“报告月份”和“今年”,您可以设计 包含上个月和累计年度价值的报告 给定的月份,因为它们将在您的报告中用作列标题 表。也可以在交叉表中合并两个维度, 例如周期和指标,例如看三个 为两个特定的相对时期选择指标。例如 使使用BCG,DPT3制作基于表格或图表的报告成为可能 和麻疹覆盖率,包括上个月和累计 一年中到目前为止的报道。

总而言之,通过结合交叉制表功能,相对 期间和报告表参数,您应该具有支持的工具 大多数报告场景。如果没有,我们将很高兴收到 有关进一步改进报表的建议。就像已经 提到,我们已经开始研究更多的细粒度参数 期间维度为“报告月份”不足,或者 至少在诸如季刊 报告。

报告表结果

运行报告表时,系统将计算以下值: 指定的指标/数据元素/数据集,枪支和时期。的 数据将以表格形式显示在DHIS2中。列标题 将与您选择的交叉表尺寸相对应。一个例子 显示的报告表显示了冈比亚某地区的ANC覆盖范围 下面。指标和期间在此处交叉列出,可以 从列标题中看到。

桌子上方有六个按钮。五个下载按钮和一个 返回键。单击“后退”按钮将使您直接回到 前一个屏幕。五个下载按钮的功能分别是 在屏幕截图下方显示:

五个下载按钮

  • 以Excel格式下载:

    下载可以在Excel中打开的生成的Excel文件。

  • 下载为CSV:

    下载生成的.csv文件。 CSV代表** C ** omma ** S 分开的 V ** alue。这是一个文本文件,文件结尾 .csv。文件中的每一行对应表中的一行,而 列之间用半冒号(;)分隔。该文件可以是 在文本编辑器以及电子表格程序(例如 作为Excel)。

  • 下载为PDF:

    下载生成的PDF文件。数据将以 与您已经在其中查看的生成表的布局相似 DHIS2。

  • 下载为报告:

    下载“样式化” PDF文件。除了在 表格布局,此文件还显示一个图表,显示 来自所有选定期间和父期间的汇总数据 为报告表选择的组织单位。该报告是 使用Jasper报表引擎生成的。

  • 下载为JRXML:

    下载生成的报告中的设计文件,如 上一个项目符号。设计文件(文件结尾为.jrxml)可以 在Jasper iReport Designer软件中打开。如果您打算 设计标准报告,这是起点。

标准报告

什么是标准报告?

标准报告是一种手动设计的报告,它以 手动指定的布局。标准报告可以基于 报告表或SQL查询。两种方法均在 以下各节。使用报告表的主要优点是 简单-不需要特殊的开发技能。在这种情况下 您有特殊要求或需要利用 DHIS2数据库,您可能想使用基于SQL的标准报告。在任何 您将能够利用报告参数来创建 动态报告。以下指南将使用报告表方法, 而SQL方法将在最后介绍。

在iReport中设计标准报告

Jasper iReport Designer是用于创建可以使用的报告的工具 作为DHIS2中的标准报告。该工具允许创建 可以轻松地从DHIS2导出标准报告模板 迄今为止的数据。创建报告的过程涉及四个主要步骤:

  1. 必须在DHIS2中使用指标/数据创建报告表 报告中要使用的元素/数据集。

  2. 您必须运行报告表并下载设计文件(点击 “下载为JRXML”按钮)。

  3. 使用免费软件Jasper打开下载的.jrxml文件 iReport Designer可以编辑报告的布局。

  4. 然后,可以将编辑后的报告上载到DHIS2,以用作 标准报告。

如果要在iReport的设计过程中预览报告,则可以 实际上必须将文件上传到DHIS2才能看到它的外观。

这四个步骤将在接下来的部分中详细介绍。在 一般而言,在制作标准报告时,您应该清楚 甚至在制作报表之前,应该如何看待它的外观 报告表的设计对报告的生成方式有影响 在iReport中格式化。例如,选择了哪些交叉表尺寸 报告表中的内容会影响可用的交叉表 对于标准报告,它会对哪种类型的报告产生影响 您可以制作的图表。

下载并打开设计文件

注意

如果尚未创建报告表,则必须这样做。 请参见“如何创建报告表”部分。*

找到所需的报告表并通过单击绿色圆圈运行它 里面的白色箭头。显示报告后,点击“下载 as JRXML”按钮下载设计文件。然后在 Jasper iReport Designer软件。

编辑报告

现在您可以编辑报告的布局了。主要的iReport 窗口由左侧的“报告检查器”组成,报告文档 在中间,右上角有一个“ Palette”区域, 右下角的“属性”区域。 “报告检查器” 用于选择和检查各种特性 报告,并在检查器中选择一个项目时,“属性” 面板更改为显示与选择有关的属性。的 “调色板”用于添加各种元素,例如文字框,图像 和图表到 文件。

注意

如果看不到“组件面板”或“属性”侧栏,则可以 从菜单栏上名为“窗口”的菜单项启用它们。

iReport文档分为七个主要区域,按布局划分 分隔符(蓝线)。这些行用于确定每个行有多大 哪些区域应该在报告中。

这些区域都有不同的用途:

  • 标题-报告标题区域

  • 页面标题-页面标题的区域

  • 列标题-列标题的区域(用于表)

  • 详细信息1-将放置实际报告数据的区域

  • 列页脚-成为表格页脚的区域

  • 页面页脚-页面页脚的区域

  • 摘要-此区域中的元素将放置在 报告

默认情况下,您会看到只有标题,列标题和 细节1波段具有数据。对于大多数报告,这是可以的。标题乐队是 适用于标题,例如图表。数据字段输入到 细节1区域将被迭代以创建表。例如,如果 名为“ dataelementname”的字段放置在“ Detail 1”区域中,所有数据 报告表中的元素将在此处列出。我们将回到 数据字段管理仅在下面进行一些说明。

报告中未使用的区域已收缩,以为您增加更多空间 报告数据。但是,您可以在增加或减少波段高度时 喜欢。有两种方法可以做到这一点。第一种方法就是简单地拖动 蓝色带状线,如下所示。

调整乐队高度的另一种方法是在 “报表检查器”,然后在 右下角的“详细信息1-属性”区域。

由于该字段已经存在于报告中,您可能不希望 除了固定布局并拖动字段外,还可以执行其他任何操作。您可以 还可以通过拖动边线,顶线或底线来调整字段的大小。如果你 要更改列标题中的文本,只需双击 字段并更改文本。

要将字段添加到表中,我们只需将其拖到“明细1”区域 来自“报告检查器”。列标题将被添加 自动。

通过双击该框,可以编辑文本。的格式 文本,例如大小,字体和对齐方式,可以使用工具进行调整 文件上方。

注意

以“ $ F”开头的字段的当前值为 每次运行报告时从数据库中检索。价值 此处会有所不同,因此除非您需要静态字段,否则不要更改这些字段 在这里值!

文本

iReport中有两种文本类型:“文本标签”和“文本字段” (数据字段)。它们以不同的方式工作,应用于 不同的目的。要点是,文本字段只是 占位符,将使用报告中的正确文本填充 运行报表时使用表格,而文本标签将保持原样 运行报表的时间。

静态文字

静态文本是可以正常编辑的纯文本文本标签。 有两种编辑文本标签的方法:

  • 通过双击文本框

  • 通过使用属性中的静态文本属性 面板

文字栏位

文本字段是在以下情况下将从报告表中填充的公式 报告运行。与静态文字不同,这些文字无法在 正常方式。但是,可以通过多种方式对它们进行操作以确保 将产生所需的输出。共有三种编辑方式 文本字段:

  • 通过右键单击文本框并选择“编辑表达式”

  • 双击文本字段(不建议这样做,因为这不会 调出表达式编辑器)

  • 通过使用属性中的文本字段属性 面板

文本字段可以代表数字或文本,因此它们可以是 用于显示例如地区名称或数字 价值观。因此,在Text中看到的Expression类非常重要 字段属性与“文本”字段表达式匹配。对于默认文字 从DHIS2下载的.jrxml文件中的字段,这不是问题, 但是在创建新的文本字段时很重要。最重要的两个 表达式类是用于数字的java.lang.Double和java.lang.String 用于文本。

例如,假设您有一个季度报告, 添加具有年度总数的新列。因此,您添加了一个新的 列标题带的静态文本字段,以及列标题带的文本字段 详细信息带入。默认情况下,新的Text字段设置为java.lang.String (文本)。但是,“年度总计”列将填充数字。我们 因此必须将新文本字段的Expression类更改为 java.lang.Double:

当我们编辑文本字段表达式时,我们会看到表达式编辑器 报表中包含所有可用列的窗口。我们可以看到 在这里,每个标记都标有它们的类型-文本或 数。因此,我们需要确保的是 我们为文本字段选择的类与实际匹配 表达。

过滤表行

从DHIS2导出的默认表中,有一些行 离开桌子可能会更好,而有些则可能 最好在最后。例如,当基于 带有“上级组织单位”参数的报告表, 默认表中可能有一行,其中国家/地区级别位于 在所有区域之间。在iReport中,可以更改此设置,以便 «父组织单位»出现在表格的底部。这个 涉及两个步骤,下面将进行解释。请注意,这不会 在只有一个组织单位的地方工作,因此 在使用“上级组织单位”或“祖父母”时最有用 报告表格中的“组织单位»”参数。

隐藏表格中的“参数组织单位”

通过使用以下命令从表中排除“参数组织单位” “详细信息”区域中的“属性,当表达式打印时”属性。设置一个 表达式时打印,从选择报告中的明细带开始 检查器,然后在属性中编辑“当表达式时打印” 面板。

现在将出现“表达式编辑器”窗口。我们必须做的是 创建一个表达式,检查生成的行是否为该行 以单位部门为参数。报告表 包含我们可以用于此的列 Organization _unit _is _parent。用参数排除行 组织单位,双击“组织 _unit _is _parent” 列表以将其复制到表达式区域,然后在. equals(“ No”) 结束,因此代码是:

$ F {organisation_unit_is_parent} .equals(“否”)

这告诉报表引擎仅打印表格行,其中 组织单位不是上级组织 单元。

在表格底部放置“参数组织单位”

而不是从表中删除“参数组织单位” 完全可以将其放在广告素材的底部(或顶部) 表。这可以通过使用 下一节,然后选择首先排序 “ organization _unit _is _parent”。其他排序选项可以添加到 除此之外,例如列出参数 组织单位在表格的底部,其他 上面按字母顺序列出的组织单位。

隐藏其他行

使用表达式编辑器,还可以排除其他行 从表中,除了原组织单位 以上说明。例如,在加纳,所有地区都有 地区»,是方括号中的区域名称。这个可以 也可以使用 以上介绍。为此,请按照上面的说明进行操作 表达式编辑器窗口。然后,我们使用Java表达式进行测试 该行是否应该隐藏。

示例-删除具有以 [开头的组织单位的行

示例-删除具有以 [开头的组织单位的行

($ F {organisationunitname} .charAt(0)!='[')

这样一来,报告将跳过所有行的第一个字符 组织单位名称为 [。

也可以组合这些表达式中的几个。去做这个 我们用两个字符&&将表达式放在括号中 之间。例如,要创建一个同时保留两个组织的表 名称以 [和上级组织单位开头的单位,我们可以 使用以下表达式:

($ F {organisationunitname} .charAt(0)!='[')&& $ F {organisation_unit_is_parent} .equals(“否”)

排序

通常您会在第一列是组织的地方进行报告 单位名称。但是,组织列表可能是一个问题 单位不是按字母顺序排序的。可以在iReport中修复 通过几个简单的步骤。

在报告检查器中,右键单击报告名称(通过 默认为dpt),然后选择“编辑” 查询。

将会出现“报告查询”窗口。单击排序选项 按钮。

出现如下所示的排序窗口。在这里,我们可以添加排序 选项。单击添加字段按钮。将会出现另一个小窗口, 在下拉菜单中,您可以选择“按单位排序” 使表格按字母顺序排序 名称。

单击确定-关闭-确定以关闭三个窗口。该表现在应该 被排序。

更改指标/数据元素名称

默认情况下,DHIS2的报告使用短名称作为指标 以及报表和图表中的数据元素。在某些情况下,这些不是 对于第三方总是非常有意义的,但是通过一些工作,他们可以 通过iReport提供自定义名称。例如,如果您 正在以指标为行,句号为列的报告,或者 用于具有 指标。

要更改指标或数据元素的名称,我们必须对其进行编辑 «表达式»或公式,例如通过右键单击文本框并 选择编辑表达式以调出表达式 编辑。

接下来,我们必须插入一些Java代码。在以下示例中,我们 将用其适当的名称代替三个指标的简称 名称。该代码搜索短名称,然后将其替换为 正确的名称。

($ F {indicatorname} .equals(“ Bed Util All”))吗? “床利用率-所有病房”
($ F {indicatorname} .equals(“ Bed Util Mat”))吗? “床的利用率-产假”
($ F {indicatorname} .equals(“ Bed Util Ped”))吗? “床的利用率-儿科”
$ F {indicatorname}

由此,我们可以看到可用于更一般情况的模式。

  • 对于每个指标或数据元素,我们要更改其名称, 我们需要一行

  • 每行之间用冒号分隔:

  • 我们用“常规”行结束表达式

每行具有相同的格式,其中红色文本是简称, 蓝色文本是我们要插入的内容 代替。

例如,当具有指标名称时,可以使用相同的表达式 沿图表的类别轴。

添加水平总计

通过使用表达式编辑器,可以将列添加到 每行总计的表格。在下面的示例中,我们将 三个月的表格以及总计的表格 三个月。

我们首先将文本标签拖动到表格标题中,然后更改其标题 将文本添加到“总计”,然后将文本字段拖到详细信息行中。

如“文本字段”部分中所述,我们必须更改 新文本字段的属性,以便它可以显示数字。去做 为此,将属性面板中的“表达式类”更改为 “ java.lang.Double”。

右键单击文本字段,然后选择“编辑表达式”。这将带来 打开“表达式编辑器”。作为表达式,我们要总结所有 列。在这种情况下,我们要求和三个值表达式 上:“ 9月”,“ 2010年10月”,“ 2010年11月”。这些的名字 字段会因您在其中选择的交叉表维度而异 报告表。在我们的例子中,我们做的表达是

$ f {September} + $ f {2010年10月} + $ f {2010年11月}
表格的每一行在右侧都有一个总计栏。

表组

在某些情况下,将多个表合在一起可能会很有用 报告。可以使用“报告”组来完成。使用此功能, 例如,您可以为每个指标创建一个报告表,或者一个 每个组织单位的表格。在下文中,我们将经历 包含三个指标的报告所需的步骤 在一张表中表示。重要的是报告表不要 当我们想基于 指标。

在我们的示例中,默认情况下将从DHIS2下载的.jrxml文件 对于组织单位和指标都有一列(假设我们 已选择期间作为唯一的交叉表维度)。我们从 删除指标列,因为在我们的例子中不需要这样做,并且 重新调整其他字段以适合 报告。

接下来,我们创建报告组。转到报告检查器,右 点击报告名称(默认为dpt),然后选择添加报告 组。

随即出现一个带有报告组向导的窗口。选择名称 组,在这种情况下,我们选择“指标”。在下拉菜单中,我们可以 选择我们希望组基于的报告表中的哪些列 上。因此,如果我们要为每个组织单位使用一张桌子, 选择组织单位名称作为要分组的报告对象 至。但是,由于在此示例中我们按指标分组,因此我们 选择指标名称。然后点击 下一个。

下一步是选择是否要一个单独的组 每个报告组的页眉和组页脚区域。在这种情况下,我们 选择同时包含两者。单击完成,然后会出现乐队 在里面 报告。

如果您上载并运行报告,它现在将为每个报告创建一个表 指示符。但是,看起来不会很好,因为不会有 每个表格的标题行-每页顶部仅一个标题。 同样,也没有指示哪个表显示了哪个 指示符。接下来,我们将解决此问题。

除了将标题行放在列标题中,我们还可以 将其移动到组标题。这将使标题显示在上方 每个单独的表。此外,我们可以为每个表添加标题 与指标名称。

将列标题从“列标题”区域移至“指示器” 组头 带。

接下来,将文本字段添加到“指标”组标题栏中,然后进行编辑 它是显示指标的表达式 名称。

该报告现在应具有三个表,每个指标一个。每 表格的标题将带有指标名称,并且还有一个 表头 行。

排序和分组

使用分组时,必须注意以下事项: 排序。值得注意的是,添加排序参数时,无论参数是 用作分组依据的必须首先。因此,如果您要分组 按指标报告,并希望对组织单位进行排序 按字母顺序,您必须先选择按指标排序,然后再按 组织单位名称如下所示。有关如何添加的说明 排序,请参阅排序部分 以上。

图表

默认情况下,.jrxml文件中包含3D条形图, 从DHIS 2下载。此设置是为了仅从 «参数组织单位»(通常是父母或祖父母)是 用过的。通常,这是一个很好的解决方案。由于这是默认设置,因此我们将 首先看条形图,再看折线 图表。

条形图

条形图是DHIS2中的默认图表类型。在本节中,我们将 看一下如何制作上面的条形图,比较其值 几个地区的一项指标。在中编辑默认图表 iReport,右键单击它并选择图表 数据。

将出现一个窗口。默认情况下,Filter表达式被填充为 仅显示上级组织单位的数据。如果 由于某些原因您不希望这样做,只需删除文本中的文本 框。在这种情况下,我们不需要过滤器,因为我们正在制作图表 显示跨地区的比较。要继续,请单击详细信息 标签。

在详细信息下,您将看到该图表的系列列表。默认情况下,一个 每个交叉表列创建系列。在这种情况下,我们正在研究 一些地区的2010年全年指标数据。 指标位于交叉表中 尺寸。

要更改系列,请选择它,然后单击“修改”。另一个窗口 将出现在可以编辑四个区域的位置。三个第一 是必需的,但是在其中之一中添加空引号(«»)就足够了 首先 二。

第一个框是一个文本字段,其中的系列名称可以是 插入或编辑。这是将用于填充文本的字段 在图例框中(显示为 下面)。

但是,如果您想沿x轴的每个条都有名称 图表而不是使用图例,这可以通过添加 您想在“类别表达式”字段中显示的任何文本,或者 通过插入一个表达式使其在 报告运行。在这种情况下,我们希望每个都有一个条 组织单位。因此,我们通过点击 在按钮上 对。

作为表达式,我们选择organisationunitname,如下所示 下面。

完成后,系列编辑器应如下所示。请点击 单击确定,然后单击关闭以关闭图表详细信息 窗口。

如果您在“类别”表达区域中添加了良好的描述,则可以 省略图例框。这是在“报告”属性面板中完成的 iReport,您还可以在其中编辑 图表。

我们还可以为图表添加标题,例如 指示符。这也可以在“图表属性”面板的“标题”下完成。 表达。

将出现“表达式编辑器”窗口,您可以在其中输入标题。 请注意,标题必须用引号引起来,如下所示 下面。

图表现已准备就绪。

折线图

折线图在许多情况下都非常有用。但是,要使线 图表报表数据(报表)必须适合它。因此,如果你 要制作折线图,报告表必须要做 交叉表维度中没有句点。这是示例 如果您要为单个组织单位制作报告, 一个或多个指标,或者如果您使用一个指标进行报告 和一个或多个组织单位。

下面,我们将详细介绍制作带一行报告的步骤 图表显示一年中三个指标的发展情况 组织单位。我们首先制作一个带有选择项的报告表 显示 下面:

当我们在iReport中打开生成的.jrxml文件时,默认行 包括图表。由于我们要制作折线图,因此我们将其删除 图表并将新的图表元素从面板中拖到报告中 面板。

只要将Chart元素拖入报告中,就会出现一个窗口 出现。我们选择折线图,如下所示 下面。

将出现一个图表向导。在第一步中单击“下一步”,然后在“完成”中 接下来-我们将添加数据 后来。

接下来,调整报表中图表的大小和位置。然后我们 将为我们的三个指标中的每个指标添加一个数据系列。右键点击 在图表上,然后选择图表数据。如果您要制作一张带有 指标和几个组织单位,您可能希望创建一个 过滤表达式,以便仅来自参数/父项的数据 图表中使用了组织单位。为此,请将此行添加到 过滤器表达区域:

$ F {organisation_unit_is_parent} .equals(“是”)

在我们的示例中,我们只有组织单位,所以这不是 必要。接下来,单击详细信息选项卡以查看其中的系列列表 图表。目前,此列表为空,但我们将为 我们三个指标中的每个指标。要添加系列,请单击添加 按钮。

在出现的窗口中,输入第一个 系列表达式窗口中的指示符。记住把名字放在 引号。在类别表达式中(沿x轴),我们希望 月,因此我们使用字段旁边的按钮打开表达式 编辑器并添加 期间名称。

在值表达式中,我们添加第一个的实际数据值 指示符。再次使用表达式编辑器执行此操作。当我们 完成后,窗口应该看起来像下面的窗口,只有不同的窗口 根据的名称 指示符。

然后,您可以单击确定关闭窗口。按照相同的步骤添加 另一个系列 指标。

关闭窗口,折线图的数据应已准备就绪。 但是,可能需要进行一些其他调整-其中大多数可以 在折线图属性面板中找到。例如,当制作一个 如我们的示例所示,逐月图表通常不够用 沿类别轴的月份名称的空间。这可以通过解决 通过使用属性将标签旋转例如-40度 类别轴刻度线标签 回转。

许多其他选项可用于为图表提供所需的 看。

将报告添加到DHIS2

现在,我们可以切换到DHIS2并导入我们的报告。转到报告 DHIS2中的模块,然后选择“标准报告”。在“标准报告”中 屏幕上,单击“添加新的”,或编辑现有的。

在以下屏幕中,我们需要执行几个操作。 首先,输入新的“标准报告”的名称。其次,为了设计 单击“选择文件”,然后在iReport中找到已编辑的.jrxml文件。 然后,选择我们用作报告基础的报告表 在iReport中。点击添加,它将移至“选定的报告 表格”区域。最后,单击 保存。

该报告现在可以作为DHIS2中的“标准报告”使用:

最终指南

  • 使用相同版本的iReport和DHIS2的Jasper版本 报告。有关所使用的Jasper版本,请参见DHIS2中的“关于”页面。

  • 使用具有交叉表尺寸的报表表作为您的数据源 您的报告设计。这将使设计更加容易 报告您需要放置特定指标,期间或 列上的orgunits。

  • 向他人学习,Jasper上有许多DHIS2报告设计 启动板,请参见 http://bazaar.launchpad.net/~DHIS2-devs-core/DHIS2/trunk/files/head:/resources/

设计基于SQL的标准报告

标准报告可能基于SQL查询。当您 需要访问DHIS2数据库中的多个表并进行自定义 选择并加入。

-此步骤为可选步骤,但在需要调试报告时非常方便 当您可以直接访问要使用的数据库时。请点击 在“报告数据源”按钮,“新建”,“数据库JDBC连接”上 然后点击“下一步”。在此窗口中,您可以给您一个连接名称和 选择JDBC驱动程序。 PostgreSQL和MySQL应该包含在其中 您的iReport。然后输入JDBC连接URL,用户名和密码。 最后三个是指您的数据库,可以从您的数据库中检索 DHIS2配置文件(hibernate.properties)。点击“保存”。你有 现在将iReport连接到您的数据库。

-转到标准报告,然后单击“添加新”,然后“获取报告 模板”。在iReport中打开此模板。此模板包含一个 一系列报表参数,可用于创建动态SQL 陈述。这些参数将根据报告替换 我们稍后将选择并包含在标准中的参数 报告。参数为:

  • 句号-相对值的逗号分隔标识符字符串 期间

  • period _name-报告期间的名称

  • Organisationunits-所选组织单位的标识符

  • Organisationunit _name-报告组织单位的名称

  • Organisationunit _level-报告组织单位的级别

  • Organisationunit _level _column-相应列的名称 在 _orgunitstructure资源表中

这些参数可以使用 $ P \!{periods} 语法,其中“句点”代表参数。

-要在iReport中创建SQL查询,请单击“报告查询”按钮。 将查询写入或粘贴到文本区域。使用示例SQL查询 参数,这些参数将创建一个报告,在报告中显示原始数据值 组织单位层次结构中的第四层是:

    选择district.name作为区,Chiefdom.name作为Chiefdom,ou.name作为设施,
    bcg.value为bcg,yellowfever.value为yellowfever,麻疹.value为麻疹
    来自组织单位ou
    左外部联接_orgunitstructure ous
      于(ou.organisationunitid = ous.organisationunitid)
    左外加入组织单位区
      在(ous.idlevel2 = district.organisationunitid)上
    左外加入组织单位首领
      在(ous.idlevel3 = chiefdom.organisationunitid)上
    左外连接(
      选择sourceid,sum(cast(值是double precision))作为值
      其中dataelementid = 359706
      和periodid = $ P!{periods}
      按sourceid分组)作为bcg在bcg.sourceid = ou.organisationunitid上
    左外连接(
      选择sourceid,sum(cast(值是double precision))作为值
      其中dataelementid = 35
      和periodid = $ P!{periods}
      按sourceid分组)为yellowfever.sourceid = ou.organisationunitid上的yellowfever
    其中ous.level = 4
    并且ous。$ P!{organisationunit_level_column} = $ P!{organisationunits}
    按区名,酋长名,ou.name排序;
注意如何在查询中使用所有参数,以及SQL连接 DHIS2数据库中的资源表。

-最后,回到“添加新报告”屏幕,我们单击“使用JDBC” 数据源”。这使您可以选择任何相对期间和报告 报告的参数。相对时期是相对于今天的 日期。报告参数将在创建报告和 可以动态选择组织单位和期间 在运行时用于您的报告。对于上面的示例,我们必须 在相关期间下选择“报告月份”,然后选择“报告” 报告参数下的“月份”和“组织单位”。点击保存。 会将您重定向到报告列表,您可以在此处单击绿色 报告旁边的“创建”图标以进行呈现。

设计基于HTML的标准报告

可以使用纯HTML和JavaScript设计标准报告。这个 需要一点提到的开发经验 科目。基于HTML的标准报告的好处是它允许 以获得最大的灵活性。使用HTML,您可以准确地设计报告 您要根据以下内容在页面上放置表格,徽标和值 您的设计需求。您可以在以下位置编写和保存标准报告设计 常规文本文件。要将基于HTML的标准报告上载到DHIS2 请执行下列操作:

  • 导航到标准报告,然后单击“添加新”。

  • 给报告起一个名字。

  • 选择“ HTML报告”作为类型。

  • 如果您愿意,可以通过单击下载报告模板 “获取HTML报告模板”。

  • 选择所需的相对时间-这些将在 报告中的JavaScript。

  • 选择报告参数-这些参数将在JavaScript中提供 您的报告。

报告模板,您可以在选择报告类型后下载该模板, 是开发基于HTML的标准报告的有用起点。 它为您提供了基本结构并建议了如何使用JavaScript 和报告中的CSS。 JavaScript和CSS可以很容易地包含在内 标准脚本和样式标签。

如果在创建标准报告时选择了相对期间, 可以像这样在JavaScript中访问它们:

var period = dhis2.report.periods; //具有句点标识符的数组
var period = period [0];

如果在创建广告订单时选择了组织单位报告参数 标准报告,您可以在其中访问所选的组织单位 像这样的JavaScript:

var orgUnit = dhis2.report.organisationUnit; // 一个东西
var id = orgUnit.id;
var name = orgUnit.name;
var code = orgUnit.code;

设计这些报告时,您可以利用Analytics Web API 资源以在JavaScript中检索汇总数据。看一看 请参阅本指南的Web API章节中的详细说明。作为一个 完整的最小示例,您可以在 报告已加载,并使用该数据来设置报表的内部文本 这样的HTML元素:

 <script type="text/javascript">
$(document).ready(function(){
    $ .get(“ ../api/analytics?dimension=dx:FnYCr2EAzWS;eTDtyyaSA7f&dimension=pe:THIS_YEAR&filter=ou:ImspTQPwCqd”,function(json){
        $(“ #bcg”).html(json.rows [0] [2]);
        $(“ #fic”).html(json.rows [1] [2]);
 </script>
 <div> BGG覆盖率:<span id="bcg"> </span> </div>
 <div> FIC覆盖范围:<span id="fic"> </span> </div>

其他一些技巧:要包含图形,可以将图像转换为SVG 并将SVG内容直接嵌入到报告中-DHIS2基于 HTML 5,其中SVG标签是有效的标记。要在其中包含图表和地图 您的报告可以使用Web API中的图表和地图资源。 您可以在自己的JavaScript中使用Web API的全部功能 报告-仔细阅读Web API章节以获取 所有可用资源的概述。

系统设置

常规设置

General settings
Setting 描述
Cache strategy Decides for how long reports analytics responses should be cached.

If you use the scheduled, nightly analytics update, you may want to select Cache until 6 AM tomorrow . This is because data in reports change at that time, and you can safely cache data up to the moment when the analytics tables are updated.

If you are loading data continuously into the analytics tables, select No cache .

For other cases select the amount of time you want the data to be cached.
Infrastructural indicators Defines an indicator group where the member indicators should describe data about the organisation units' infrastructure.

You can view the infrastructural data in the GIS app: right-click a facility and click Show information .
Infrastructural data elements Defines a data element group where the member data elements should describe data about the organisation units' infrastructure.

Infrastructural data elements can be population, doctors, beds, Internet connectivity and climate.

You can view the infrastructural data in the GIS app: right-click a facility and click Show information .
Infrastructural period type Sets the frequency for which the data elements in the infrastructural data elements group are captured.

This will typically be yearly. When viewing the infrastructural data you will be able to select the time period of the data source.

You can view the infrastructural data in the GIS app: right-click a facility and click Show information .
Default relative period for analysis Setting this value will determine which relative period is selected as the default in the analytics apps.
Feedback recipients Defines a user group where the members will receive all messages sent via the feedback function in the Dashboard app.

This will typically be members of the super user team who are able to support and answer questions coming from end-users.
System update notification recipients Defines a user group where the members will receive messages about new system updates available for download, the recipients will only receive the message once for each new patch version of the DHIS2 installation. If no such user group is defined, the system defaults to sending it to all users that have the ALL authority.
Max offline organisation unit levels Defines how many levels in the organisation unit hierarchy will be available offline in the organisation unit tree widget.

Under normal circumstances you can leave this on the lowest level, which is default is the default setting.

It can be useful to set it to a higher level to reduce initial load time in cases where you have a large number of organisation units, typically more than 30 000.
Data analysis std dev factor Sets the number of standard deviations used in the outlier analysis performed on the captured data in the Data Entry app.

The default value is 2. A high value will catch less outlier values than a low value.
Phone number area code The area code for the area in which your deployment is located.

Used for sending and receiving SMS. Typically, this is a country code.

+260 (country code for Zambia)
Enable multi-organisation unit forms Enables support to enter data forms for multiple organisation units at the same time in the Data Entry app.

If you've enabled this setting, you can in the Data Entry app, click on the parent organisation unit for the children that you want to enter data for, and the data set list will include data sets that are assigned to the children of that parent.
Acceptance required before approval When this setting is selected, acceptance of data will be required first before submission to the next approval level is possible.
Gather analytical object statistics in dashboard views Gather usage analytics data when analytical objects (e.g., maps, charts, etc.) are viewed within a dashboard. Without this setting, analytics data on the objects is gathered only when the objects are viewed outside of a dashboard.
Include passive dashboard views in usage analytics statistics Gather usage analytics data on the first dashboard shown when the Dashboard app is launched (otherwise only explicit dashboard selections are counted).

分析设置

Analytics settings
Setting 描述
Default relative period for analysis Defines the relative period to use by default in analytics app: Data Visualizer , Event Reports , Event Visualizer , GIS and Pivot Table apps. The relative period will be automatically selected when you open these apps.

Recommended setting: the most commonly used relative period among your users.
Property to display in analysis modules Sets whether you want to display the metadata objects' names or short names in the analytics apps: Data Visualizer , Event Reports , Event Visualizer , GIS and Pivot Table apps.

The user can override this setting in the Settings app: User settings > Property to display in analysis modules .
Default digit group separator to display in analysis modules Sets the default digit group separator in the analytics apps: Data Visualizer , Event Reports , Event Visualizer , GIS and Pivot Table apps.
Hide daily periods Hide daily periods in the analysis tools
Hide weekly periods Hide weekly periods in the analysis tools
Hide monthly periods Hide monthly periods in the analysis tools
Hide bimonthly periods Hide bimonthly periods in the analysis tools
Financial year relative start month Defines which month (April, July or October) the the relative financial year in the analytics apps should begin on.
Cacheability Sets whether analytics data responses should be served with public or private visibility.

Private : Any node or server between the DHIS2 server and the end user which has the ability to cache can NOT cache the web page. This is useful if the page served can or do contain sensitive information. This means that each time you want a web page, either you get a new page from the DHIS2 server, or the DHIS2 server caches the page. No other server than the DHIS2 server are allowed to cache the page.

Public : Any node or server between the DHIS2 server and the end user which has the ability to cache can cache the web page. This relives the traffic to the DHIS2 server and potentially speeds up the subsequent page loading speed.
Analytics cache mode Support two different modes:

Progressive : this relates to the new progressive caching feature for analytics. When enabled, it OVERRIDES the global caching strategy for analytics requests. This mode will trigger HTTP and data layer caching for all analytics requests. When enabling this mode, the caching factor is MANDATORY.

Fixed : the requests will be cached based on the period of time defined in cache strategy.
Caching factor Select a value for the caching factor. This field is only available when the analytics cache mode has been set to progressive .

It shows a list of integers where each integer represents an absolute caching factor. This integer will be used internally to calculate the final expiration time for each analytics request. Higher the caching factor, for longer the request will be cached.
Max number of years to hide unapproved data in analytics Sets whether and for how long back in time analytics should respect the approval level of the data. Typically, data which is several years old would be considered to be approved by default. In order to speed up analytics requests, you can choose to ignore the actual approval level of historical data.

Never check approval : no data will be hidden, irrespective of its data approval status.

Check approval for all data : approval status will always be checked.

Other options, for example Last 3 years : approval status will be checked for data which is newer than 3 years old; older data will not be checked.
Threshold for analytics data caching Sets whether to enable caching data older than the specified number of years only.

This allows for returning the most recent data directly with no caching, while serving cached version of older data for performance concerns.
Respect category option start and end date in analytics table export This setting controls whether analytics should filter data which is associated with a category option with a start and end date, but which is not associated with a period within the category options interval of validity.
Put analytics in maintenance mode Places the analytics and web API of DHIS2 in maintenance mode. This means that "503 Service Unavailable" will be returned for all requests.
This is useful when you need to perform maintenance on the server, for example rebuilding indexes while the server is running in production, in order to reduce load and more efficiently carry out the maintenance.
Allow users to switch dashboard favorite view type Allows users to switch dashboard favorites' view between charts, pivot tables and maps, using the dashboard item menu.
Allow users to open dashboard favorite in relevant app Allows users to open dashboard items in the app for that type of item, using the dashboard item menu.
Allow users to show dashboard favorite interpretations and details Allows users to see dashboard favorites' interpretations and details, using the dashboard item menu.
Allow users to view dashboard favorite in fullscreen Allows users to view dashboard favorites in fullscreen, using the dashboard item menu.
Default basemap Select which basemap will be selected by default in the Maps app. If no value is selected, then OSM Light will be used.

服务器设定

Server settings
Setting 描述
Number of database server CPUs Sets the number of CPU cores of your database server.

This allows the system to perform optimally when the database is hosted on a different server than the application server, since analytics in DHIS2 scales linearly with the number of available cores.
System notifications email address Defines the email address which will receive system notifications.

Notifications about failures in processes such as analytics table generation will be sent here. This is useful for application monitoring.
Google Analytics (Universal Analytics) key Sets the Google UA key to provide usage analytics for your DHIS2 instance through the Google Analytics platform. It should be noted that currently, not all apps in DHIS2 support Google Analytics, so certain activity of your users may not appear in this platform.

You can read more about Google Analytics at google.com/analytics .
Google Maps API key Defines the API key for the Google Maps API. This is used to display maps within DHIS2.
Bing Maps API key Defines the API key for the Bing Maps API. This is used to display maps within DHIS2.
Limit settings
Setting 描述
Maximum number of analytics records Increase this number to provide more records from the analytics.

The default value is 50,000.

Warning

Use the setting Unlimited carefully, it might result in a very high load on your server.
Maximum number of SQL view records Set the maximum number of records in a SQL view.

The default value is Unlimited.
Maximum number of Tracked Entity Instance that can be fetched from database Sets the limit on maximum tracked entity instance records that can be fetched from database. If user does not provide any value then default value which is 50,000 will be used.
Setting this to 0 or any negative integer will disable this setting.
Warning
Disabling this setting may result in high load on the server.

外观设置

Appearance settings
Setting 描述
Select language Sets the language for which you can then enter translations of the following settings:
* Application introduction
* Application title
* Application notification
* Application left-side footer
* Application right-side footer
Note
Before each of these settings can accept a translated value, they first need to have a default/fallback value. This value can be set by selecting System default (fallback) in this dropdown.
Application title Sets the application title on the top menu.
Application introduction Sets an introduction of the system which will be visible on the top-left part of the login page.
Application notification Sets a notification which will be visible on the front page under the login area.
Application left-side footer Sets a text in the left-side footer area of the login page.
Application right-side footer Sets a text in the right-side footer area of the login page.
Style Sets the style (look-and-feel) of the system.

The user can override this setting in the Settings app: User settings > Style .

Note

Due to technical reasons, it's not possible to change the color of the newest version of the header bar. The apps with the newest header bar will retain the blue header bar.
Start page Sets the page or app which the user will be redirected to after log in.

Recommended setting: the Dashboard app.
Enable light-weight start page Instructs apps to render a light-weight and fast landing page. Recommended in low-bandwidth environments.
Help page link Defines the URL which users will see when they click Profile > Help .
Flag Sets the flag which is displayed in the left menu of the Dashboard app.
Interface language Sets the language used in the user interface.

The user can override this setting in the Settings app: User settings > Interface language .
Database language Sets the language used in the database.

The user can override this setting in the Settings app: User settings > Database language .
Require authority to add to view object lists If you select this option, you'll hide menu and index page items and links to lists of objects if the current user doesn't have the authority to create the type of objects (privately or publicly).
Custom login page logo Select this option and upload an image to add your logo to the login page.
Custom top menu logo Select this option and upload an image to add your logo to the left in the top menu.

电子邮件设定

Email settings
Setting 描述
Host name Sets the host name of the SMTP server.

When you use Google SMTP services, the host name should be smtp.gmail.com .
Port Sets the port to connect to the SMTP server.
User name The user name of the user account with the SMTP server.

[email protected]
Password The password of the user account with the SMTP server.
TLS Select this option if the SMPT server requires TLS for connections.
Email sender The email address to use as sender when sending out emails.
Send me a test email Sends a test email to the current user logged into DHIS2.

访问设置

Access settings
Setting 描述
Self registration account user role Defines which user role should be given to self-registered user accounts.

To enable self-registration of users: select any user role from the list. A link to the self-registration form will be displayed on the login page.

Note

To enable self-registration, you must also select a Self registration account organisation unit .

To disable self-registration of users: select Disable self registration .
Self registration account organisation unit Defines which organisation unit should be associated with self-registered users.

Note

To enable self-registration, you must also select a Self registration account user role .
Do not require reCAPTCHA for self registration Defines whether you want to use reCAPTCHA for user self-registration. This is enabled by default.
Enable user account recovery Defines whether users can restore their own passwords.

When this setting is enabled, a link to the account recovery form will be displayed on the front page.

Note

User account recovery requires that you have configured email settings (SMTP).
Lock user account temporarily after multiple failed login attempts Defines whether the system should lock user accounts after five successive failed login attempts over a timespan of 15 minutes.

The account will be locked for 15 minutes, then the user can attempt to log in again.
Allow users to grant own user roles Defines whether users can grant user roles which they have themselves to others when creating new users.
Allow assigning object to related objects during add or update Defines whether users should be allowed to assign an object to a related object when they create or edit metadata objects.

You can allow users to assign an organisation unit to data sets and organisation unit group sets when creating or editing the organisation unit.
Require user account password change Defines whether users should be forced to change their passwords every 3, 6 or 12 months.

If you don't want to force users to change password, select Never .
Enable password expiry alerts When set, users will receive a notification when their password is about to expire.
Minimum characters in password Defines the minimum number of characters users must have in their passwords.

You can select 8 (default), 10, 12 or 14.
CORS whitelist Whitelists a set of URLs which can access the DHIS2 API from another domain. Each URL should be entered on separate lines. Cross-origin resource sharing (CORS) is a mechanism that allows restricted resources (e.g. javascript files) on a web page to be requested from another domain outside the domain from which the first resource was served.

日历设定

Calendar settings
Setting 描述
Calendar Defines which calendar the system will use.

The system supports the following calendars: Coptic, Ethiopian, Gregorian, Islamic (Lunar Hijri), ISO 8601, Julian, Nepali, Persian (Solar Hijri) and Thai.

This is a system wide setting. It is not possible to have multiple calendars within a single DHIS2 instance.

Refer here for more information about the difference between Gregorian and ISO 8601.
Date format Defines which date format the system will use.

资料汇入设定

数据导入设置适用于可以启用的其他控件 验证通过Web API导入的汇总数据。他们 对应视为冲突的事项提供可选约束 在导入期间。将约束应用于每个单独的数据值 在导入中。

Data import settings
Setting 描述
Require periods to match period type of data set Require period of data value to be of the same period type as the data sets for which the data element of data value is assigned to.
Require category option combos to match category combo of data element Require category option combination of data value to be part of the category combination of the data element of the data value.
Require organisation units to match assignment of data set Require organisation unit of data value to be assigned to one or more of the data sets which the data element of data value is assigned to.
Require attribute option combos to match category combo of data set Require attribute option combination of data value to be part of the category combination of the data set which the data element of data value is assigned to.
Require category option combo to be specified Require category option combination of data value to be specified.

By default it will fall back to default category option combination if not specified.
Require attribute option combo to be specified Require attribute option combination of data value to be specified.

By default it will fall back to default attribute option combination if not specified.

同步设定

以下设置用于数据和元数据 同步。

注意

有关如何配置元数据同步的更多信息, 请参阅[配置元数据 同步]( https://docs.dhis2.org/master/zh/user/html/metadata_sync.html

Synchronization settings
Setting 描述
**远程服务器URL ** Defines the URL of the remote server running DHIS2 to upload data values to.

It is recommended to use of SSL/HTTPS since user name and password are sent with the request (using basic authentication).

The system will attempt to synchronize data once every minute.

The system will use this setting for metadata synchronization too.

Note

To enable data and metadata synchronization, you must also enable jobs for Data synchronization and Metadata synchronization in the Scheduler app.
远程服务器用户名 The user name of the DHIS2 user account on the remote server to use for data synchronization.

Note

If you've enabled metadata versioning, you must make sure that the configured user has the authority "F_METADATA_MANAGE".
远程服务器密码 The password of the DHIS2 user account on the remote server. The password will be stored encrypted.
Enable versioning for metadata sync Defines whether to create versions of metadata when you synchronize metadata between central and local instances.
Don't sync metadata if DHIS versions differ The metadata schema changes between versions of DHIS2 which could make different metadata versions incompatible.

When enabled, this option will not allow metadata synchronization to occur if the central and local instance(s) have different DHIS2 versions. This apply to metadata synchronization done both via the user interface and the API.

The only time it might be valuable to disable this option is when synchronizing basic entities, for example data elements, that have not changed across DHIS2 versions.
Best effort A type of metadata version which decides how the importer on local instance(s) will handle the metadata version.

Best effort means that if the metadata import encounters missing references (for example missing data elements on a data element group import) it ignores the errors and continues the import.
Atomic A type of metadata version which decides how the importer on local instance(s) will handle the metadata version.

Atomic means all or nothing - the metadata import will fail if any of the references do not exist.

OAuth2客户端

您可以在 **系统设置 **中创建,编辑和删除OAuth2客户端 应用程序。

  1. 打开 **系统设置 **应用,然后单击 **OAuth2客户端 **。

  2. 点击添加按钮。

  3. 输入 **名称 **, **客户ID **和 **客户密码 **。

  4. 选择 **授权类型 **。

    Grant type Description
    Password TBA
    Refresh token TBA
    Authorization code TBA
  5. 输入**重定向URI **。如果您有多个URI,请使用 一条线。

System update notification

The system will default send a notification in the mail inbox under the "system" category when there is a new patch version available for download. This notification will be sent to the users who have the "ALL" authority, unless the "System update notification recipients" user group is defined, under the "General settings".

It is also possible to disable this feature altogether by setting the "system.update_notifications_enabled" configuration variable to "off", in the "dhis.conf" file.

Under the hood, it works by calling (GET, with no parameters) on a REST API endpoint on a central server every day around 2:00 AM.

This is the URL: https://releases.dhis2.org/v1/versions/stable.json

资料管理

数据管理模块提供了一系列功能来确保 DHIS2数据库中存储的数据是完整的,并且 数据库性能得到优化。这些功能应在 由数据管理员定期检查以确保 存储的数据是最佳的。

Data integrity

DHIS2可以对数据执行各种数据完整性检查 包含在数据库中。识别和纠正数据完整性 问题对于确保用于 分析目的是否有效。每个数据完整性检查 将描述系统执行的操作以及一般步骤 可以解决这些问题。

没有数据集的数据元素

每个数据元素必须分配给一个数据集。数据值 如果有数据,将无法将元素输入系统 元素未分配给数据集。选择 在主菜单中选择维护->数据库集->编辑,然后添加 将“孤立的”数据元素添加到适当的数据集。

没有组的数据元素

一些数据元素已经分配给几个数据元素组。 目前不允许这样做,因为这会导致重复 分析记录集中的链接数据记录提供了汇总 数据。转到维护->数据元素组以查看每个数据 确定元素并删除不正确的组分配。

违反排他组的数据元素

Some data elements have been allocated to several data element groups that are members of the same data element group set. All group sets in DHIS2 are defined as exclusive, which means that a data element can only be allocated to one data element group within that group set. Go to Maintenance -> Data elements and indicators -> Data element groups to review each data element identified in the integrity check. Either remove the data element from all groups except the one that it should be allocated to, or see if one of the groups should be placed in a different group set.

数据集中的数据元素,但不在表单或节中

数据元素已分配给数据集,但尚未分配 分配给数据集表格的任何部分。使用的所有数据集 部分表格,通常应在数据集中包含所有数据元素 恰好分配给数据集的一部分。

分配给具有不同期间类型的数据集的数据元素

数据元素不应分配给两个单独的数据集 期间类型不同。建议的方法是创建两个 单独的数据元素(例如,每月和每年的数据元素) 并将它们分配给各自的数据集。

数据集未分配给组织单位

所有数据集应分配给至少一个组织单位。

类别组合无效的部分

使用节表的数据集应仅具有一个类别 每个部分中的组合。违反可能是由于 将数据元素分配给节,然后更改类别 此数据元素在以后的某个时间点的组合。

具有相同公式的指标

尽管此规则不会影响数据质量,但通常不会 具有两个定义完全相同的指标是有意义的。评论 确定的指标及其公式,并删除或修改任何 指示器似乎是重复的。

没有分组的指标

All data elements and indicators must be assigned to at least one group, so these Indicators need to be allocated to their correct Data Element and Indicator Group. From the main menu, go to Data elements/Indicators -> Indicator Groups, and allocate each of the `Orphaned` indicators to its correct group.

无效的指标分子

违反此规则的原因可能是错误地引用了 删除或修改的数据元素。查看指标并进行 分子定义的更正。

无效的指标分母

违反此规则的原因可能是错误地引用了 删除或修改的数据元素。查看指标并进行 分母定义的更正。

违反排他性组的指标

Some indicators have been allocated to several indicator groups that are members of the same indicator group set. All group sets in DHIS2 are defined as exclusive, which means that an indicator can only be allocated to one indicator group within that group set. Go to Maintenance -> Data elements and indicators -> Indicator groups to review each indicator identified in the integrity check. Either remove the indicator from all groups except the one that it should be allocated to, or see if one of the groups should be placed in a different group set.

重复期间

如果已从外部应用程序导入了期间,则可能是 某些时期可能会重复。如果您有任何时期 在这里似乎重复的,您将需要解决这些问题 直接在DHIS2数据库中。所有已分配给 重复的期间,应移至正确的期间,并且 重复期间应删除。

具有循环引用的组织单位

组织单位不能同时是父级和子级, 直接或间接。如果发生这种情况,您将需要 直接在DHIS2数据库中解析循环引用 通过重新分配“组织单位”表中的“上级”字段 组织单位。

孤立的组织单位

All organisation units must exist within the organisation unit hierarchy. Go to Organisation units -> Hierarchy Operations and move the offending organisation unit into the proper position in the hierarchy.

没有团体的组织单位

All organisation units must be allocated to at least one group. The problem might either be that you have not defined any compulsory OrgUnit Group Set at all, or that there are violations of the compulsory rule for some OrgUnits . NOTE: If you have defined no compulsory OrgUnit Group Sets, then you must first define them by going to Organisation units->Organisation unit group sets and define at least one compulsory Group Set (the group set 'Type' are nearly universally relevant). If you have the relevant group sets, go to Maintenance -> OrgUnit Groups to review each OrgUnit identified and add the relevant Group allocation.

组织单位违反必修课

These organisation units have not been assigned to the any organisation unit group within one of the compulsory organisation unit group sets. When a group set is defined as compulsory, it means that an organisation unit must be allocated to at least one organisation unit group within that group set. For instance, all organisation units must belong to one of the groups in the 'Type' group set. It might belong to the `Hospital` or the `Clinic` or any other 'type' group - but it must belong to exactly one of them. Go to Organisation units->Organisation unit groups to review each organisation unit identified in the integrity check. Allocate all organisation units to exactly one compulsory group.

违反专属组的组织单位

一些组织单元已分配给同一组织单元组集的多个组织单元组。所有组集都被定义为互斥的,意味着一个组织单元*只能*属于该组集中的*一个*组织单元组。请转到组织单元->组织单元组以查看完整性检查中识别出的每个组织单元。从除了应分配给它的组织单元之外的所有组中移除该组织单元。

没有组集的组织单位组

此处列出的组织单位组尚未分配给 组集。转到维护->组织单位->组织单位 组设置并将组织单位组分配给适当的 组集。

无组验证规则

All validation rules must be assigned to a group. Go to Maintenance app > Validation rule group and assign the offending validation rule to a group.

无效的验证规则左侧表达式

An error exists in the left-side validation rule definition. Go to Maintenance app -> Validation rule and click Edit on the offending rule. Click Left side and make the required corrections.

无效的验证规则右侧表达式

An error exists in the right-side validation rule definition. Go to Maintenance app -> Validation rule and click Edit on the offending rule. Click Right side and make the required corrections.

无条件的程序规则

Report will highlight all the Program rules not configured with Condition . Evaluation for rules not having condition are always evaluated as false.

没有优先权的ProgramRules

Report will highlight all the Program rules not configured with Priority . This is optional but its existence is very important when ProgramRuleActionType is ASSIGN . Rules with ASSIGN action type should have higher priority then the rest of the action types.

不采取行动的ProgramRules

Report will highlight all the Program rules not configured with any ProgramRuleAction .

没有dataElements的ProgramRuleVariables

Report will highlight all the Program rule variables not configured with DataElement . Report will be based on source type configuration. DataElement should be provided when the source type of ProgramRuleVariable is DataElement .

没有属性的ProgramRuleVariables

Report will highlight all the Program rule variables not configured with TrackedEntityAttribute . Report will be based on source type configuration. TrackedEntityAttribute should be provided when the source type of ProgramRuleVariable is Attribute .

没有数据对象的ProgramRuleActions。

Report will highlight all the Program rule actions not configured with any Data object. Data object can be either DataElement of TrackedEntityAttribute . There are certain ProgramRuleActions which are responsible for assigning values to either dataElement or trackedEntityAttribute.

没有通知的ProgramRuleActions

Report will highlight all the Program rule actions which have ProgramRuleActionType set to SENDMESSAGE/SCHEDULEMESSAGE where the configuration does not provide any link to notification.

没有部分ID的ProgramRuleActions

Report will highlight all the Program rule actions which have ProgramRuleActionType set to HIDESECTION but configuration does not provide any section id.

没有程序阶段ID的ProgramRuleActions

Report will highlight all the Program rule actions which have ProgramRuleActionType set to HIDEPROGRAMSTAGE but configuration does not provide any program stage id.

无效的程序指示符表达式

报告由无效** DataElement 或无效 TrackedEntityAttribute **引起的程序指示器表达式中的所有冲突。

无效的程序指示器过滤器表达式

报告由无效** DataElement 或无效 TrackedEntityAttribute **引起的程序指示器过滤器表达式中的所有冲突。

保养

Data maintenance functions in the Data Administration app
功能 描述
Clear analytics tables Completely empties the analytics tables. These tables are used to generate aggregate data for the pivot tables, GIS and reports.
Remove zero data values Removes zero data values from the database. Values registered for data elements with aggregation operator average is not removed, as such values will be significant when aggregating the data, contrary to values registered for data elements with aggregation operator sum.

Reducing the number of data values will improve system performance.
Permanently remove soft deleted data values When a data value is deleted in DHIS2, the system will mark the corresponding database row as deleted, and not actually delete the row.

Running this maintenance function will physically remove these data value rows from the database.
Prune periods Removes all periods which have no registered data values. Reducing the number of periods will improve system performance.
Remove expired invitations Will delete users which represent user account invitations that now have gone past their expiry date.
Drop SQL views DHIS2 lets you set up and manage SQL views as system objects with corresponding database SQL views.

Running this maintenance function will drop underlying SQL views for all system views. Use the Create SQL views function to recreate these SQL views.
Create SQL views Recreates all SQL views in the database.
Update category option combinations Rebuilds the category option combinations. This may be required after altering the category options which belong to a given category.
Update organisation unit paths The organisation unit table in the DHIS2 database has a column "path" which contains a concatenated string of all ancestors in the hierarchy for each organisation unit.

Running this maintenance function will update and ensure that these values are in sync with the current organisation unit hierarchy. This column is managed by DHIS2, but a manual update might be useful when doing data loading directly in the database.
Clear application cache Clears the system cache.
重新加载应用 Manually reloads and detects installed DHIS2 apps.

The installed apps are also detected when the system starts and when installing or uninstall apps.

Resource tables

资源表是在分析过程中使用的支持表 数据。通常,将这些表的内容与 从第三方应用程序(例如, Microsoft Excel。分析模块也广泛使用它们 DHIS2。资源表的重新生成只能执行一次 解决了所有数据完整性问题。资源表也 每次运行分析过程时, 系统。

  • 组织单位结构( _orgunitstructure)

    只要有任何情况,都应重新生成该表 对组织单位层次结构所做的更改。这个桌子 提供有关组织单位层次结构的信息。它有 每个组织单位一行,每个组织一行 单位级别以及以下所有父级的组织单位标识符 作为价值的血统。

  • 数据元素组集结构( _dataelementgroupsetstructure)

    该表提供有关哪些数据元素是 数据元素组集的成员。该表有一行 每个数据元素,每个数据元素组集合的一列,以及 数据元素组的名称作为值。

  • 指标组集结构( _indicatorgroupsetstructure)

    下表提供有关哪些指标是成员的信息 哪个指标组设置。该表各有一行 指标,每个指标组集的一列,以及 指标组作为值。

  • 组织单位组集结构 ( _organisationunitgroupsetset结构)

    下表提供有关哪些组织单位是 组织单位组的成员。桌子有一排 对于每个组织单位,每个组织单位一列 组集和组织单位组的名称作为值。

  • 类别结构( _categorystructure)

    该表提供有关哪些数据元素是 成员属于哪个类别。该表的每个数据都有一行 元素,每个类别一列,并且类别名称 选项作为值。

  • 数据元素类别选项组合名称( _categoryoptioncomboname)

    只要有更改,就应该重新生成该表 进行类别组合名称。它包含可读的名称 用于类别的各种组合。

  • 数据元素结构( _dataelementstructure)

    该表提供有关所有数据元素以及哪些数据的信息 捕获数据的周期类型(频率)。期间类型为 通过数据集成员身份确定,因此依赖于数据 要成为具有类似周期类型的数据集的成员的元素 明确的行为。

  • 期间结构( _dataperiodstructure)

    该表提供有关所有期间以及哪个期间的信息 与它们关联的类型。对于每个较低的期间类型 频率比其本身,它包含有关其周期的信息 将落入。

  • 数据元素类别选项组合 ( _dataelementcategoryoptioncombo)

    该表提供了数据元素与所有可能元素之间的映射 类别选项组合。

Analytics tables management

DHIS2 generates database tables which the system then uses as basis for various analytics functions. These tables are also valuable if you write advanced SQL reports. In the Data Administration app, you can execute the tables generation immediately. If you want to schedule them to be executed at regular intervals, this can be done in the Scheduler app. This means that you can refresh recent analytics on demand and see updated pivot tables without waiting for all of the past years data to re-process.

Note

You can also generate the tables through the web API. This task is typically performed by a system administrator.

  1. Open the Data Administration app and click Analytics Tables .

  2. 选择要跳过的分析过程部分:

    • 跳过资源表的生成

    • 跳过汇总数据和完整性数据的生成

    • 跳过事件数据的生成

    • 跳过注册数据的生成

    • Skip generation of organisation unit ownership data

  3. Select Number of last years of data to include .

  4. 点击**开始导出**。

Data statistics

数据统计模块提供了对象数量的概述 存储在DHIS2数据库中。

每种类型的对象的总数以一系列 表,其中包含每个对象的摘要统计信息。

Lock exceptions

Lock exceptions provide fine-grained control over exemption from a locked data set. After the expiry of the data set, data entry will be denied by default, unless an exception has been granted through the Lock exception interface.

Adding a lock exception

By granting a lock exception, data entry will be enabled even after the expiry period of the data set has passed.

  1. Open the Data Administration app and click Lock Exception .
  2. Click Add lock exception at the top of the page
  3. Select the desired data set, organisation units and time period (see screenshot below)
  4. Click Add lock exception

In the example above, a data lock exception would be created for "Bo" for the "ART monthly summary" dataset for "February 2014".

Min-Max Value Generation

此管理功能可用于生成最小值-最大值, 作为数据质量和验证过程的一部分, 特定的组织单位和数据集。只需选择数据集 从左手框架,然后选择所需的组织 单位以从组织单位生成最小-最大值 右侧的选择器。按“生成”按钮生成或 重新生成所有最小-最大值。按“删除”删除所有最小-最大 当前存储在数据库中的值。

Cache Statistics

此选项仅供系统管理员使用。缓存 统计信息显示应用程序级别缓存的状态。的 应用程序级缓存是指对象和查询结果 应用程序正在缓存以提高性能。如果数据库 已直接修改,需要清除应用程序缓存 它才能生效。

可视化使用情况统计

关于使用情况分析应用

The Usage Analytics app lets you visualize statistics on how users are working with the Dashboard , GIS , Event Visualizer , Data Visualizer and Event Reports apps within DHIS2. With this statistics you can answers questions such as:

  • How many times people have loaded visualizations and dashboards?

  • 用户创建了多少个收藏夹?

  • 登录的用户数与用户总数之比?

  • 什么是最受欢迎的收藏夹?

创建使用情况分析图

  1. Open the Usage Analytics app.

  2. 选择**开始日期**和**结束日期**。

  3. Select an Interval : day, week month or year.

  4. Select a Category .

    有五种分析类别:

    • 收藏夹视图 :提供各种类型的次数 of favorites have been viewed, such as visualizations and 仪表板,随着时间的推移。通过此分析,您可以在所有 收藏夹的类型,所有类型的总数和平均值 观看次数。

    • 收藏夹 :提供已被收藏的收藏夹数量 随着时间的推移创建并存储在系统中。

    • 用户 :提供有效数量以及总数 随着时间的流逝。

    • 热门收藏夹 :显示系统中查看最多的收藏夹 按类型。

    • 数据值 :提供存储在其中的数据值的数量 随着时间的流逝。

  5. 点击**更新**。

数据存储管理器

数据存储管理器适用于高级DHIS2用户。之前 使用数据存储管理器,您可以阅读有关数据存储的更多信息 此处:[DHIS2数据 商店]( https://docs.dhis2.org/master/zh/developer/html/webapi_data_store.html )。

使用数据存储管理器

数据存储管理器可让您管理Web API数据的内容 商店。这在管理应用程序和外部脚本时很有用。

向数据存储管理器添加新的名称空间和密钥

注意:必须先创建名称空间,然后才能向其中添加键。

  1. 点击**新建**。

  2. 输入要创建的名称空间的名称。

  3. 输入密钥名称,然后选择**创建**。显示新的名称空间 在左窗格中。

向数据存储管理器中的现有名称空间添加密钥

要将新密钥添加到数据存储管理器中的现有名称空间,

  1. 选择要向其添加键的名称空间。

  2. Click the options menu, and click New key .

  3. 在“新建密钥”对话框中输入密钥名称。

  4. 点击**创建**。新密钥将添加到您的命名空间中 已选择。

从数据存储管理器中删除名称空间或键

若要删除名称空间或键,请单击“选项”菜单,然后单击“确定”。 删除 ,然后再次**删除**。请注意,如果您删除唯一 键入名称空间,您还将删除它所属的名称空间。

搜索名称空间或键

使用左上角的搜索工具搜索名称空间和 关键如下:

  • 输入名称空间名称,后跟** \#**和要搜索的键名 命名空间中的特定键。

  • 输入** \#**,然后输入密钥名称以搜索密钥 只要。

搜索您的JSON库

使用工作区工具栏中的搜索工具搜索JSON 图书馆。

在数据存储管理器中编辑名称空间或键

Use the Search tool to find namespaces or keys in your datastore. When you edit your content, you can toggle between the Tree view and the Code view. Use the Tree view to get an overview of the contents of the Datastore. Use the Code view to edit your code directly in the code editor. Remember to save your work by clicking the Save button.

在代码视图中,您可以编辑代码。当您编辑一行代码时, 它以黄色突出显示。

任何错误均由编辑器标记。如果将鼠标悬停在错误图标上, 您可以查看错误的简短说明。

排程

计划程序是用于管理DHIS2中的后台作业的应用程序。 后台作业可以执行许多任务,例如运行分析, 同步数据和元数据,或发送推送分析报告。的 应用程序提供了创建,修改和删除此类作业的功能。

调度程序与DHIS2捆绑在一起,可以通过应用程序进行访问 菜单。

The start page of the Scheduler app

The start page of the Scheduler app shows an overview of existing jobs. By default, pre-defined system jobs are hidden. To view these, click Include system jobs in list in the top right corner.

When you create or modify a job, it will be scheduled according to the selected schedule. To run a job on demand, go to the job list, click the "Actions" button of the job you want to run and click "Run manually". This action is only available for enabled jobs.

创造工作

  1. Open the Scheduler app and click the "New job" button in the top 右上角。

  2. Choose a suitable Name for the new job.

  3. Select the Job type you want to schedule using the 下拉式菜单。

  4. Select a schedule for the job. Each job type has its own scheduling type, either Cron scheduling or Delay scheduling.

    1. For Cron scheduled job types you can set a schedule using the Spring scheduling syntax. You can also select a predefined Cron expression by clicking "Choose from preset times". This schedule will only start a new job run if the previous job run has finished, to prevent the system from spawning too many jobs.

    2. For Delay scheduled jobs you can set a delay in seconds. Unlike the Cron scheduled jobs, these jobs aren't executed according to a set schedule, but with a specific delay in between job runs. The delay timer starts when a job ends, starting a new job run when the delay timer reaches zero. This will continue as long as the job is enabled.

  5. If the job type is customizable, a Parameters section will appear below the scheduling settings. These additional options specify the details of the scheduled job, and will vary depending on the job type.

  6. Press the Save button to confirm the job creation. On successful job creation you will be redirected to the job overview, where the newly created job will now be listed.

Creating a new scheduler job

Newly created jobs are enabled by default.

Editing a job

With the proper permissions, you can modify the details of user-created jobs. To quickly enable or disable a user created job from running, use the switches in the On/off column on the landing page of the Scheduler app. Note that system jobs are always enabled and cannot be disabled.

Further editing of user jobs:

  1. Click the "Actions" button of the job you want to edit and click "Edit" (only user jobs can be edited).

  2. When done editing, press the Save button to persist the changes.

删除工作

  1. Click the "Actions" button of the job you want to delete and click "Delete" (only user jobs can be deleted).

  2. 在弹出窗口中再次按** Delete **进行确认。

User jobs can also be deleted from the editing screen.

Deleting a scheduler job

工作类型

以下部分描述了各种作业类型。

Disable Inactive Users

Users that have not been active - not logged in - for a number of months can automatically be disabled. Select the number of inactive months as the job parameter. All users that have not logged in for that number of months or longer will be disabled by the job. Disabled users will no longer be able to log into the system.

The Reminder days before parameter can be set to send a reminder email to those users the specified number of days before their account is due to expire. If users do not log in further reminder emails are sent each halving the previous number of days. For example if the number of days is set to 7 the first email is sent 7 days in advance, the second 3 days and the third and last 1 day in advance. If the value is not set (blank) no reminder is sent.

资源表

资源表作业负责生成和更新资源数据库表。这些表由DHIS 2中的各个组件使用,旨在简化针对数据库的查询。

请注意,当指定任何分析表作业时,资源表可以是该过程的一部分,并且也不必指定资源表作业。

分析表

分析表作业负责生成和更新分析表。分析表用作DHIS2中数据分析查询的基础。仪表板,可视化工具和地图等应用程序通过DHIS2分析API从这些表中检索数据,并且必须对其进行更新才能使分析数据可用。您可以安排此过程通过分析表作业类型定期运行。

默认情况下,分析表作业将填充所有年份和数据元素的数据。可以使用以下参数:

  • **过去几年:**为其填充分析表的最后几年的数量。例如,如果您指定2年,则该过程将更新最近两年的数据,而不更新较旧的数据。此参数对减少过程完成所需的时间很有用,并且如果旧数据没有更改,并且需要更新最新数据,则该参数非常适用。
  • **跳过资源表:**在分析表更新过程中跳过资源表。这减少了过程完成所需的时间,但导致元数据的更改未反映在分析数据中。
  • **跳过表类型:**跳过一种或多种分析表类型。这减少了过程完成所需的时间,但导致这些数据类型未在分析数据中更新。

连续分析表

分析表作业负责生成和更新分析表。分析表用作DHIS2中数据分析查询的基础。仪表板,可视化工具和地图等应用程序通过DHIS2分析API从这些表中检索数据,并且必须对其进行更新才能使分析数据可用。您可以安排此过程通过分析表作业类型定期运行。

连续分析表作业基于两个阶段:

  • _最新更新:_最新数据的更新,其中最新是指自上次更新最新数据或完整数据以来已添加,更新或删除的数据。此过程将经常发生。
  • _完整更新:_多年来所有数据的更新。此过程每天进行一次。

连续分析表作业将经常更新最新数据。最新数据处理使用特殊的数据库分区,该分区仅用于保存最新数据。由于数据量相对较少,因此可以快速刷新此分区。分区的大小将增加,直到执行完全更新。每天一次,将更新所有年份的所有数据。这将清除最新的分区。

默认情况下,分析表作业将填充所有年份和数据元素的数据。可以使用以下参数:

  • **一天中的完整更新时间:**一天中的完整更新将在这一小时完成。例如,如果您指定1,则将在凌晨1点执行完整更新。
  • **过去几年:**为其填充分析表的最后几年的数量。例如,如果您指定2年,则该过程将更新最近两年的数据,而不更新较旧的数据。此参数对减少过程完成所需的时间很有用,并且如果旧数据没有更改,并且需要更新最新数据,则该参数非常适用。
  • **跳过资源表:**在分析表更新过程中跳过资源表。这减少了过程完成所需的时间,但导致元数据的更改未反映在分析数据中。

Tracker search optimization

The tracker search optimization job is responsible for generating and updating the trigram indexes for relevant tracked entity attributes. Trigram indexes improve the performance of searching tracked entity instances based on specific tracked entity attribute values. The usefulness of trigram indexes depends on whether the tracked entity attribute is configured as unique or if they are configured as searchable (when connected to program/tracked entity type). You can configure the job to choose which tracked entity attributes should be trigram indexed. The job also takes care of deleting any obsolete indexes that have been created earlier but are no more required due to change in metadata configuration.

The following parameters are available:

  • Attributes: The list of attributes that needs a trigram index created. For each attribute, a partial trigram index will be created. As an example, if you specify "firstname" and "lastname" attribute, the process will create two separate trigram indexes for the corresponding attributes "firstname" and "lastname". Note that, if the attribute provided in this parameter is not indexable (either because they are not unique or not searchable), such attributes are simply ignored by the process and no trigram index will be created for them.
  • Skip index deletion: Skip obsolete index deletion during the trigram index process. If set to true, indexes that are deemed obsolete will not be deleted.

数据同步

DHIS2 provides synchronisation of data between remotely distributed instances and a central instance of DHIS2. This can be useful e.g. when you have deployed multiple stand-alone instances of DHIS2 which are required to submit data values to a central DHIS2 instance. Both tracker data and aggregate data synchronization is supported.

这些是启用数据同步的步骤:

  • 转到“同步设置”,输入远程服务器URL, 用户名和密码。按TAB按钮自动保存 新密码。刷新页面并检查填充值 仍然存在。请注意,密码字段将在之后为空 刷新,因为此值是加密的,所以您可以考虑使用它 已保存。

  • 使用Scheduler应用程序,使用“事件程序 数据同步”和/或“跟踪器程序数据同步”作业类型。请确保 完成后启用。 (注意:如果“程序数据同步” 以前版本中可用的作业是在Scheduler应用中设置的, 它被两个新的作业“事件程序数据同步”自动替换 和“ Tracker Programs Data Sync”具有相同的设置。 )

数据同步功能的某些方面需要注意:

  • 本地DHIS2实例将存储用户帐户的密码 在本地数据库中加密的远程实例上。遥控器 帐户在传输数据时用于身份验证。对于 security purposes make sure you set the encryption.password configuration parameter in hibernate.properties to a strong 密码。

  • 强烈建议在SSL / HTTPS上部署远程服务器,因为 用户名和密码使用基本格式以明文形式发送 身份验证,并且可能被攻击者拦截。

  • 数据同步使用数据元素的UID属性, 类别选项组合和组织单位以匹配 元数据。因此,同步取决于这三个 在本地和远程实例上协调元数据对象 为了工作正常。

  • DHIS2首次运行同步作业时,它将包括 任何可用数据。随后的同步作业将仅 包括自上次成功工作以来添加和更改的数据。一种 仅当所有数据都被认为是成功的同步作业 已成功保存在远程服务器上(任何数据成功 无论作业是否同步,同步后的邮件都会保留在接收实例上 最终失败)。这项工作是否成功可以 由中央服务器返回的导入摘要决定。

  • 初始同步作业可能需要花费大量时间 时间,可能会使实例变慢,具体取决于多少 数据正在同步。最好配置 在线用户很少时运行作业,然后稍后更改 to your own preference. If you do not want or need to synchronize all 数据,则有可能 跳过 一些数据正在同步

When DHIS2 synchronizes tracker data, it determines the set of data to synchronize based on the last time it was synchronized. Each of 跟踪的实体实例和事件具有自己的记录 when they where last successfully synchronized.

  • 系统将根据规则集启动同步作业 在作业的配置中。如果同步作业开始 没有与远程服务器的连接时,它将重试 至中止之前的三倍。作业将在 计划的时间。

  • 服务器分别处理每组程序,这意味着一个 一组程序可以成功同步,而另一组 失败。一个人的失败或成功不会影响另一个人,因为 最后的成功同步时间将单独跟踪 如前所述,每个项目。

  • TrackedEntityInstances的属性(TrackedEntityAttribute) 和ProgramStages的数据元素(ProgramStageDataElement) 启用了“跳过同步”选项的用户将不会 已同步。此功能使您可以决定不同步 一些敏感或不相关的数据,并将其仅保留在本地。

  • The authority Ignore validation of required fields in Tracker and Event Capture ( F\_IGNORE\_TRACKER\_REQUIRED\_VALUE\_VALIDATION ) should be used when 要求某些强制属性/数据元素 同时具有“跳过同步”属性。 这样的设置将导致中央服务器上的验证失败 因为给定的属性/数据元素将不会出现在 有效载荷。

具有此权限的用户验证不会失败。的 应该在中央服务器上将权限分配给用户, 将用于同步作业。

  • In specific cases, the initial synchronization of all the data can be undesirable ; 例如,当本地实例上的数据库是 数据库存在于中央实例上,或者在不推荐的情况下 synchronize old data in favor of initial synchronization taking less 时间。

  • syncSkipSyncForDataChangedBefore * SettingKey可用于跳过 所有数据(数据值,事件和跟踪器)的同步 程序数据,完整的数据集注册) 最后 changed before the specified date . The SettingKey is used in the synchronization job all the time. Therefore, if you need to synchronize the old data, you should change the SettingKey .

  • Both Tracker Programs and Event Programs synchronization job supports 分页是为了避免超时并处理不稳定的网络。 “事件程序数据同步”作业的默认页面大小设置为60。 “跟踪程序数据同步”作业的默认页面大小设置为20。

如果默认值不符合您的目的,则可以指定自己的页面大小 通过参数,特别是Scheduler应用中的同步作业。

元数据同步调度

DHIS2提供了用于同步远程元数据的功能 实例到DHIS2的本地实例。当您有 部署了DHIS2的多个独立实例,您需要创建 所有本地实例中的元数据都类似于中央DHIS2 实例。

这些是启用元数据同步的步骤:

  • 转到设置>同步,输入远程服务器URL, 用户名和密码,然后单击保存。

  • 转到元数据管理>计划。在元数据下 将同步设置策略设置为“已启用”,然后选择时间段和 单击开始。

元数据同步功能的某些方面需要注意:

  • 本地DHIS2实例将存储用户帐户的密码 远程实例在其数据库中的位置。远程用户帐户是 用于传输/下载数据时的身份验证。对于 security purposes make sure you set the encryption.password configuration parameter in hibernate.properties to a strong 密码。

  • 强烈建议在SSL / HTTPS上部署远程服务器,因为 用户名和密码使用基本格式以明文形式发送 身份验证,并且可能被攻击者拦截。

  • 另外,请确保远程用户没有ALL权限, 相反,只需创建具有F _METADATA _MANAGE权限的用户,即可 即使这些细节被黑客拦截, 完全控制远程系统。

  • 元数据同步依赖于基础导入层。 每个元数据版本都是两个给定之间的元数据导出 时间戳记。每次同步元数据版本都是尝试导入 该元数据快照到本地实例中。的同步 版本是增量的。本地实例将尝试下载 来自中央实例的元数据版本一个接一个。 无法同步特定的元数据版本将无法同步 进行进一步的版本。发生故障时,适当 必须对中央的元数据进行更改,以确保 错误得到解决。元数据配置至关重要, user should be careful while rolling out the updates to the 生产。始终建议在 确保元数据版本及其完整性的地方 此后的影响。本地实例将同步来自 第一版,以便保持和谐以及本地和中央 实例将正常工作。

  • 系统将在计划的时间尝试同步。如果 本地或远程服务器没有可用的Internet 当时的连接,同步将被中止,并且 按照尝试次数中所述的重试次数重新尝试 dhis.conf file.

  • 您可以看到上一次与远程服务器成功同步的时间 调度屏幕中“最后成功”标签旁边的服务器。

Predictor

This runs selected predictors and/or predictor groups.

The relative start and end parameters determine the periods in which data will be predicted, corresponding to the date on which the predictor job is run:

  • Relative start counts the days from the job date to the earliest date on which a predicted period may start. It can be positive or negative. For example, a value of 3 means predict into periods that start at least 3 days after the predictor run. A value of -3 means predict into periods that start at least 3 days before the predictor run.

  • Relative end counts the days from the job date to the latest date on which a predicted period may end. It can be positive or negative. For example, a value of 9 means predict into periods that end at least 9 days after the predictor run. A value of -9 means predict into periods that end at least 9 days before the predictor run.

Setting these values can give you very flexible control over when predictions will be made, especially if your predictor job is set to run daily or more frequently. Before you set these values, you should think carefully about when you want predictions for a period to start being made, and when you want them to stop being made. Then you need to compute the appropriate relative start and end dates.

例子:

  1. Requirement : A predictor uses data from the same week as the predicted value. (No past sampled data are used.) After the week ends on Sunday, you expect the data to be entered in the following two days (Monday and Tuesday). You don't want to start predicting data until Wednesday after the week ends because you don't want partial results to be shown. However, data may still be adjusted on Wednesday, so you want to update the predictions also on Thursday. After that, the data are frozen and you don't want to predict for that period anymore.

    Solution: For a job running daily or more frequently, define the relative start as -10 and the relative end as -2 (for periods within 10 to 2 days before the job runs).

    • Before Wednesday of the following week, the period end is greater than 2 days before, so no predictions are made.

    • On Wednesday of the following week, the period started 9 days before and ended 2 days before. Predictions are made because -9 to -2 are within the range -10 to -2.

    • On Thursday of the following week, the period started 10 days before and ended 3 days before. Predictions are made because -10 to -3 are within the range -10 to -2.

    • After Thursday, the previous week started more than 10 days before, so no predictions are made.

    • Predictions are made only on Wednesday and Thursday. On Friday through Tuesday, no predictions are made (and the job finishes very quickly).

  2. Requirement : A predictor is used to forecast a limit (average plus twice the standard deviation) for expected non-seasonally varying disease cases based on data from the previous five weeks. Weeks are Monday through Sunday. Predictions should start being made from the previous Tuesday, using available data at that time, and continue being made through Tuesday of the week that the predictions are being made for (by which time it is assumed that the previous week's data are final).

    Solution: For a job running daily or more frequently, define the relative start as -1 and the relative end as 12.

    • Before Tuesday, predictions will not be made for the following week because it ends more than 12 days later.

    • On Tuesday, predictions will be made for the following week which starts in 6 days and ends in 12 days.

    • On Wednesday through the following Tuesday, predictions will be made for the week whose start-to-end dates are Wed: 5 to 11, Thu: 4 to 10, Fri: 3 to 9, Sat: 2 to 8, Sun: 1 to 7, Mon: 0 to 6, and Tue: -1 to 5.

    • Note that on Tuesday, predictions are made for the current week with start-to-end dates -1 to 5, and also for the following week with start-to-end dates 6 to 12. On all other days of the week predictions are made for one week.

You can select which predictors and predictor groups will run during the job:

  • Predictors runs individual predictors. They run in the order added.

  • Predictor groups runs predictor groups. They run in the order added. The predictors within each group run in the order of their names (comparing Unicode character values).

If both individual predictors and predictor groups are selected in the same job, the individual predictors run first, followed by the predictor groups.

导入/导出应用

在初级卫生系统中,HMIS通常涉及分布式 应用程序,同一应用程序在不同的位置运行 地理位置(PHC,CHC,医院,地区和州)。 这些物理位置中许多都没有Internet连接,并且 因此他们离线工作。在某个时候(通常在该地区 级别),则数据需要同步才能具有 特定地理区域的统一数据库。对于 因此,重要的是能够从一个位置导出数据( 正在离线工作(例如在医疗机构级别),然后导入 另一个(例如在地区级别)。 因此,导出和导入的此功能是HMIS的关键功能。 此功能还可以帮助我们克服某些方面对Internet的依赖 度,因为数据更新可以通过没有密钥的USB密钥进行传输 连接性,或者在互联网有限的情况下通过电子邮件 连接性。 DHIS2提供了强大的导出-导入功能来 满足这些需求。

要访问导入/导出应用,请在顶部标题栏中搜索 进出口。导入/导出应用程序提供了许多服务详细信息 可以在下面找到。

汇入资料

导入进度记录器

No matter what you import ("Data", "Events", "Org unit geometry", "Metadata" or "Tracked Entity Instances" data), you can always view the progress of the import by looking at the "Job Summary" at the top of the page.

导入摘要

On import request completion, we show import summaries above the import form. Any conflicts or errors are shown in the table under the main summary for the import.

元数据导入

可以从侧边栏单击来访问元数据导入 元数据导入。

  1. 选择要上传的文件

  2. Select a format: JSON , CSV , or XML

  3. Select the appropriate settings for:

    • 识别码
    • 导入报告模式
    • 预热模式
    • 导入策略
    • 原子模式
    • 合并模式
  4. 如果要调整以下一项或多项,请单击**高级选项**。 the following settings before importing:

    • 冲洗模式
    • 跳过分享
    • 跳过验证
    • 异步
    • 包容性策略
  5. 点击**导入**按钮,该按钮将上传文件并启动 导入过程。

Tip

It is highly recommend to use the Dry run option to test before importing data; to make sure you keep control over any changes to your Metadata, and to check for problems with out-of-sync data elements or organisation unit names

Note

If an organisation unit e.g. Nduvuibu MCHP had a unknown reference to an object with ID aaaU6Kr7Gtpidn , it means that the object with ID aaaU6Kr7Gtpidn was not present in your imported file, and it was not found in the existing database.

You can control this using Identifier option, to indicate if you want to allow objects with such invalid references to be imported or not. If you choose to import invalid references you will have to correct the reference manually in DHIS2 later.

DXF2中的匹配标识符

DXF2格式目前支持匹配两个标识符,即 内部DHIS2标识符(称为UID),也使用外部 标识符称为“代码”。进口商尝试搜索时 对于引用(例如上面的引用),它将首先转到UID字段, 然后转到代码字段。这使您可以从旧版导入 系统中没有每个元数据对象的UID。即如果你是 从旧版系统导入设施数据,您可以省略ID 完整字段(DHIS2将为您填写),然后将 代码字段中的旧系统自己的标识符,此标识符为 必须是唯一的。这不仅适用于组织单位,而且 用于各种元数据,从而可以轻松地从其他系统导入。

资料汇入

可以通过单击侧边栏上的数据来访问数据导入 进口。

  1. 选择要上传的文件

  2. Select a format: JSON , CSV , XML , ADX , or PDF

  3. Select the appropriate settings for:

    • 战略
    • 预热缓存
  4. 如果要调整以下一项或多项,请单击**高级选项**。 the following settings before importing:

    • 数据元素ID方案
    • 组织单位ID方案
    • ID方案
    • 跳过现有支票
  5. 点击**导入**按钮,该按钮将上传文件并启动 导入过程。

提示

**强烈建议您先使用空运行选项**进行测试 导入数据;确保您可以控制自己的任何更改 元数据,并检查数据元素不同步或 组织单位名称

PDF资料

DHIS2支持以PDF格式导入数据。这可以用来 导入由离线PDF数据输入表单生成的数据。请参阅 **数据集管理**一节中介绍了如何生成PDF的详细信息 可用于离线数据输入的表格。

To import a PDF data file, navigate to the PDF Data Import item in the side menu. Upload the completed PDF file and click Import .

事件汇入

Event Import can be accessed from the sidebar by clicking on Event Import.

  1. Select a format: JSON , CSV , or XML

  2. 如果要调整以下一项或多项,请单击**高级选项**。 the following settings before importing:

    • 事件ID方案
    • 数据元素ID方案
    • 组织单位ID方案
    • ID方案
  3. 点击**导入**按钮,该按钮将上传文件并启动 导入过程。

Earth Engine Import

Earth Engine Import can be accessed from the sidebar by clicking on Earth Engine Import.

Import high resolution population data from WorldPop using Google Earth Engine. A Google Earth Engine account is required to use this importer.

Select which Earth Engine data should be imported

The first section of the form is used to configure the Earth Engine data to import.

  1. Select which Earth Engine dataset should be imported. Currently the choices are Population and Population age groups .

  2. After a dataset has been selected, a period must be selected. Only one period can be imported at a time.

  3. Choose how the data should be rounded. By default data is not rounded.

  4. Select which organisation units to import data to. If you select facility level organisation units, then you must choose an associated geometry for the facilities. Without an associated geometry for facilities, the Earth Engine cannot determine the population.

Select the data elements to import the Earth Engine data into

Once you have configured the Earth Engine dataset, you need to select which data element to import the data to. For datasets with disaggregation groups, such as "Population age groups", the DHIS2 data element must have disaggregations in the form of category option combos that match the Earth Engine dataset disaggregation groups.

Configuring data elements for Earth Engine import

When configuring the DHIS2 data elements that will contain Earth Engine data, if you plan to import data to multiple org unit levels, ensure that those levels are added as Aggregation Levels in the data element configuration.

Some Earth Engine datasets contain disaggregation groups, the DHIS2 data element must be configured with corresponding category option combos. For example the "Population age groups" dataset is disaggregated by gender (Male, Female) and 5-year age groups.

In DHIS2 this means that you must have a Male/Female category, and a 5-year age group category (<1yr, 1-4yr, 5-9yr, 10-14yr... 80+yr). These are combined into a category combination.

Pro-tip: To automatically match the category option combo to the Earth Engine disaggregation group, add a Code to each category option combo that matches the earth engine group name. For example, with "Population age groups", the groups are named: F_0, F_1, F_5..., M_0, M_1, M_5...

Run the import

Once the data element and category option combos have been selected, the Preview button is enabled. After reviewing the data you want to import, you can do a dry run first, or proceed with the actual import.

Organisation Unit Geometry Import

Accessed from the sidebar by clicking on Org Unit geometry import . Two geometry formats are supported: GeoJSON and GML. GeoJSON is the recommended format and can also be used to import associated geometries (catchment areas).

GeoJSON import

  1. Upload a file using the GeoJSON format.

  2. By default the GeoJSON feature id should match the organisation unit id.

  3. Check Match GeoJSON property to organisation unit scheme to match by a feature propery. Type the GeoJSON property name and select the Organisation unit ID scheme ( Id , Code or Name ).

  4. Check Import as associated geometry to import the GeoJSON features as associated geometries the organisation units (e.g. catchment areas). Select at geometry attribute where the data should be imported. This requires an attribure of type GeoJSON applied to Organisatiot unit . This attribute can be defined in the Maintenance app.

  5. Click on the Start import button which will upload the file and start the 导入过程。

Tip

It is highly recommend to use the Dry run option to test before importing data; to make sure you keep control over any changes to your organisation unit geometries.

GML import

  1. Upload a file using the GML (Geographic Markup Language) format.

  2. 点击**导入**按钮,该按钮将上传文件并启动 导入过程。

跟踪实体实例导入

Tracked Entity Instances Import can be accessed from the sidebar by clicking on TEI Import.

  1. 选择要上传的文件

  2. Select a format: JSON or XML

  3. Select the appropriate settings for:

    • 识别码
    • 导入报告模式
    • 预热模式
    • 导入策略
    • 原子模式
    • 合并模式
  4. 如果要调整以下一项或多项,请单击**高级选项**。 the following settings before importing:

    • 冲洗模式
    • 跳过分享
    • 跳过验证
    • 包容性策略
  5. 点击**导入**按钮,该按钮将上传文件并启动 导入过程。

Tip

It is highly recommend to use the Dry run option to test before importing data; to make sure you keep control over any changes to your Tracked Entity Instances.

汇出资料

元数据导出

单击侧边栏上的,可以访问元数据导出 元数据导出。

  1. 选择您要导出的对象列表。

  2. Select a format: JSON

  3. Select a compression type: zip , gzip or uncompressed

  4. Decide whether to check Skip sharing and access settings

  5. 点击**导出元数据**,这将打开一个新的网络浏览器窗口 that will give you a file to download to your local computer.

具有依赖项的元数据导出

具有依赖项的元数据导出使您可以为以下内容创建罐头导出 元数据对象。这种类型的导出将包括元数据对象 和元数据对象的相关对象;即元数据 与主要对象一起属于

Object types and their dependencies
Object type Dependencies included in export
数据集 Data elements

Sections

Indicators

Indicator types

Attributes

Data entry forms

Legend sets

Legends

Category combinations

Categories

Category options

Category option combinations

Option sets
程式 Data entry form

Tracked entity

Program stages

Program attributes

Program indicators

Program rules

Program rule actions

Program rule variables

Program attributes

Data elements

Category combinations

Categories

Category options

Category option combinations

Option sets
Category combination 类别组合

类别

类别选项

Category 选项组合

属性
仪表板 Dashboard items

Charts

Event charts

Pivot tables

Event reports

Maps

Reports

Resources
数据元素组 Data elements

Category combinations

Categories

Category options

Category option combinations

Option sets

Attributes

Legend sets

Legends
OptionSets 选项

  1. Select an object type: Data sets , Programs , Category combination , Dashboard , Data element groups or OptionSets .

  2. Select an object.

  3. Select a format: JSON

  4. Select a compression type: Zip , GZip or Uncompressed

  5. Click Export metadata dependencies which will open a new web-browser window that will give you a file to download to your local computer.

资料汇出

可以通过单击数据从侧边栏访问数据导出 出口。

  1. Select which organisation units to export from.

  2. Select if you want export to include descendants of organisation units selected in Step 1 or only the manually selected 组织单位。

  3. Select which data sets to export.

  4. Set the start and end date.

  5. Select a format: JSON , CSV , XML , or ADX

  6. Select a compression mode: Zip , GZip or Uncompressed

  7. 如果要调整以下一项或多项,请单击**高级选项**。 the following settings before exporting:

    • 包括已删除
    • 数据元素ID方案
    • 组织单位ID方案
    • ID方案
  8. Click Export data which will open a new web-browser window that will give you a file to download to your local computer.

活动导出

通过单击事件可以从边栏中访问事件导出 出口。

You can export event or tracker data in JSON, CSV, or XML formats.

  1. 选择一个组织单位。

  2. Select the inclusion:

    • Selected : Export event data only for the selected 组织单位

    • Directly below : Export event data including the first level of the organisation units inside the selections as well as the selected organisation unit itself.

    • All below : Export event data for all organisation units inside the selections as well as the selected organisation unit itself.

  3. 选择一个程序和一个程序阶段(如果适用)。

  4. Set the start date and end date.

  5. Select a format: JSON , CSV , or XML .

  6. Select a compression mode: Zip , GZip or Uncompressed .

  7. 如果要调整以下一项或多项,请单击**高级选项**。 the following settings before exporting:

    • 包括已删除
    • 数据元素ID方案
    • 组织单位ID方案
    • ID方案
  8. Click Export events which will open a new web-browser window that will give you a file to download to your local computer.

跟踪实体实例导出

Tracked entity instances export can be accessed from the sidebar by clicking on TEI export.

You can export event or tracker data in JSON, CSV, or XML format.

  1. Select the organisation units that should be included.

  2. Decide whether you want to filter by program or tracked entity type.

  3. Select a format: JSON , CSV , or XML .

  4. 如果要调整以下一项或多项,请单击**高级选项**。 the following settings before exporting:

    • 按上次更新日期筛选
    • 分配的用户模式
    • 包括已删除
    • 包括所有属性
    • 数据元素ID方案
    • 事件ID方案
    • 组织单位ID方案
    • ID方案
  5. 点击**导出跟踪的实体实例**,这将打开一个新的 web-browser window that will give you a file to download to your local computer.

工作概述

The job overview page can be accessed from the sidebar by clicking on Job Overview .

This page allows you to see the progress of all the imports you have started this session. You can see the list of all jobs on the left side and details about a specific selected job on the right.

按导入作业类型过滤

By default jobs of all import types are shown in the job list, but you can filter categories you are interested in by clicking on the job type filters above the job list.

重新创建上一份工作

You can recreate previously run import jobs by clicking on the Recreate job button at the bottom of the page, assuming you have selected a job from the list. This will take you to the correct import page and fill in all the form details exactly as the job you chose to recreate.

方案

The various schemes used in many of the import and export pages are also known as identifier schemes and are used to map metadata objects to other metadata during import, and to render metadata as part of exports.

Available values
Scheme 描述
ID, UID Match on DHIS2 stable Identifier, this is the default id scheme.
CODE Match on DHIS2 Code, mainly used to exchange data with an external system.
名称 Match on DHIS2 Name, please note that this uses what is available as object.name , and not the translated name. Also note that names are not always unique, and in that case, they can not be used.
ATTRIBUTE:ID Match on metadata attribute, this attribute needs to be assigned to the type you are matching on, and also that the unique property is set to true . The main usage of this is also to exchange data with external systems, it has some advantages over CODE since multiple attributes can be added, so it can be used to synchronize with more than one system.

ID方案

The ID scheme applies to all types of objects, but can be overwritten by more specific object types.

配置元数据同步

关于数据和元数据同步

您可以在不同的DHIS2实例之间同步数据和元数据。 给定中央本地部署策略中的两个实例,元数据 在中央系统创建的可以与本地系统同步 并且在本地系统创建的数据可以与 中央系统。当您有多个独立服务器时,这很有用 DHIS2实例和全局元数据都需要创建 本地实例。

元数据的创建和更新是否在中央系统进行,以及 启用元数据同步任务,获取元数据 向下同步到绑定到 中央实例。这些本地实例将依次推送数据值, 事件和跟踪程序的数据以及完整的数据注册集 中央实例。启用或禁用元数据版本控制 在本地实例上同步,不会阻碍元数据 同步过程。这是因为元数据同步 与中央实例的版本控制端点交互,而不与 带有本地实例的端点。

生成的元数据导出的每个快照都称为元数据 版。新的元数据版本仅包含 先前版本和当前版本之间的导出 两个时间戳记。所有元数据版本都在DHIS2中维护 数据库,并且可用于连接到该数据库的所有本地实例。 您可以安排每个本地实例以下载新的元数据 版本。建议保持元数据版本的大小较小 和逻辑。

警告

DHIS2的每个实例(无论是中央实例还是本地实例)都可以创建元数据 版本。本地实例用于同步来自 中央系统,而不是自己创建元数据。

如果在本地实例上创建了新的元数据版本,则此 实例无法从中央接收新的元数据版本 实例,因为元数据版本的内容将不存在 同步。

如果已在本地实例上创建元数据版本,则必须 在您可以从数据库中手动删除这些版本之前 与中央实例同步。

假设中央和本地DHIS2实例具有相同的元数据 快照,直到版本10。然后本地实例创建一个新的快照 快照,称为版本11。之后,中央实例创建一个 名为版本11的新快照。 同步元数据,未下载版本11。然而 本地实例上版本11的内容与 中央实例上版本11的内容。

注意

您也可以使用**导入导出**应用程序来同步元数据 手动。

工作流程

  1. 在中央实例上,配置元数据版本控制。你应该 一旦中央实例包含元数据,请执行此操作。

  2. 将本地实例连接到中央实例。

  3. 在本地实例上,配置自动同步。

在中央实例上配置元数据版本控制

注意

要同步元数据,中央系统的用户帐户必须 具有以下权限:

** F _METADATA _MANAGE **

只有具有此权限的用户才可以创建和 下载元数据。这是为了确保中央系统的安全性 创建元数据的位置。而不是提供 对字段实例具有ALL权限的用户,您需要创建一个 仅具有此特定权限的用户。

  1. On the central instance, open the System Settings app and click 同步

  2. Go to the Metadata versioning section and select Enable 元数据的版本控制 同步

  3. (可选)选择**如果DHIS2版本不同,则不同步元数据**。

  4. 选择一种元数据版本: 尽力而为**或**原子

    • *尽力而为*表示如果元数据导入遇到 缺少参考(例如,数据上缺少数据元素 元素组导入),它将忽略错误并继续 进口。

      • Atomic *表示全部或全部-如果以下情况将导致元数据导入失败 任何引用都不存在。

      Note

      Each metadata entity is associated with a "User" object. If this "User" reference is missing while importing metadata version of type ATOMIC, the import will fail at the validation phase itself. This means that the user who creates metadata also needs to synchronize down to local instances to successfully import the metadata version of type ATOMIC.

  5. Click Create new version . The new version is added to the 版本表。

将本地实例连接到中央实例

要启用元数据同步,必须配置连接 在本地实例和中央实例之间。

  1. On the local instance, open the System Settings app and click 同步

  2. 将中央DHIS2实例的详细信息添加到本地实例:

    • **远程服务器URL **

    • 远程服务器用户名

    • 远程服务器密码

  3. Go to the Metadata versioning section and select Enable 元数据同步的版本控制

  4. (可选)选择**如果DHIS2版本不同,则不同步元数据**。

    元数据模式在DHIS2版本之间可能会发生变化 使不同的元数据版本不兼容。

    启用后,此选项将不允许元数据同步 如果中央实例和本地实例具有不同的DHIS2,则会发生 版本。这适用于通过 用户界面和API。

    唯一可能禁用此选项的时间是 同步具有以下内容的基本实体,例如数据元素 在DHIS2版本之间没有变化。

  5. (可选)配置电子邮件通知以通知用户有关 元数据同步成功或失败:

    1. Open the System Settings app and click Email .

    2. 输入**主机名**, 端口 用户名 密码**和 **电子邮件发件人

    3. Click Server and enter a System notifications email 地址

      此电子邮件地址将收到有关元数据的通知 同步状态。

    Tip

    When you receive email notification about a metadata synchronization failure, check which metadata version that causes the error and resolve it. Then you avoid future errors when the system downloads new metadata versions.

在本地实例上配置自动元数据同步

一旦配置了自动元数据同步(计划) 在本地实例上,调度程序将在该特定时间运行,并且 从中央同步(下载和导入)元数据 实例。本地用户无需手动干预 实例。

调度程序完成元数据同步后, 本地实例将具有与中央实例完全相同的元数据 系统。

注意

用户密码不同步。他们被取消为 安全原因。元数据同步后,管理员用户必须 重设这些密码。

  1. On the local instance, open the Data Administration app and 点击**计划**。

  2. In the Metadata Synchronization section, select Enabled .

  3. 选择一个时间段: 每天 每周 每月**或 **每年

  4. 点击**开始**。

在中央或本地实例上手动创建新的元数据版本

  1. Open the System Settings app and click Synchronization .

  2. Go to the Metadata versioning section and select Enable 元数据同步的版本控制

  3. (可选)选择**如果DHIS2版本不同,则不同步元数据**。

  4. Select Best effort or Atomic .

  5. Click Create new version . The new version is added to the 版本表。

当系统是*中央实例*时,您将在 版本表:

目的 描述
Master version The latest version in the system.
Version Name of the version. The name is automatically generated by system.
When The timestamp of the metadata version creation at the central instance.
类型 Type of metadata version.

当system是* local instance *时,您会在 版本控制 表:

目的 描述
Master version The latest version of the central instance.

Note

The master version information is the central instance's latest version. This is important to look at the difference between the versions of metadata that exist at central and at local.
Last sync attempt If the last sync attempt is a failure, this will be displayed.
Version Name of the version. The name is automatically generated by system.
When The timestamp of the metadata version creation at the central instance.
类型 Type of metadata version.
Last sync Timestamp of when the last sync happened for this version in this system.

参考信息:元数据同步配置参数

执行元数据同步的过程称为元数据 同步任务。该任务在同步以下内容之前执行一系列步骤 元数据:

  • 从本地推送数据(聚合数据和匿名事件数据) 实例到中央实例。

  • 获取本地实例的当前元数据版本。然后使用 此版本信息作为获取元数据列表的基准 在基准之后创建的版本。

  • 如果在中央实例上创建了新版本,它将执行 元数据版本的同步。邮件 每次成功后将发送给配置的用户(如果有) 在本地实例上同步元数据版本。

Once the Metadata Sync Task has run at the scheduled time, the task can retry (if any of the steps fail) based on the configuration of the following parameters defined in dhis.conf file:

Parameter Default value
metadata.sync.retry 3
metadata.sync.retry.time.frequency.millisec 30000

每次重试将在指定的时间(毫秒)后进行。如果 即使所有重试后,步骤仍然失败,然后调度程序 停止执行,然后将邮件发送给配置的用户 (如果有)。如果未指定任何值,则默认值为 用过的。

metadata.sync.retry = 5

metadata.sync.retry.time.frequency.millisec = 10000

移动

本章涵盖了各种移动技术,包括Web,J2ME,SMS 服务和SMS命令。

DHIS2 Mobile简介

DHIS2提供了一系列选项,允许从移动设备输入数据 设备,包括专用的GPRS / 3G J2ME客户端和两个版本的 DHIS2已专门针对移动浏览器进行了优化。每 以下将详细描述这些解决方案 部分。 DHIS2提供了多个Android客户端,具体说明请参见 本指南其他部分中的详细信息。

现场数据的收集在技术上可能具有挑战性, 昂贵。手机解决方案具有显着的潜力 降低了部署分布式数据收集系统的复杂性。 使用安装在手机或Web浏览器上的简单Java客户端 可以在手机上使用,现场工作人员可以直接向 DHIS2数据库通过他们的移动设备。

尽管手机解决方案具有巨大的潜力,但仍有 这种部署的复杂性。手机缺乏处理能力,并且 显示屏很小,需要充电,通常这样 在贫困或断断续续的地区进行部署最有意义 网络覆盖范围。

下面简要介绍了每种移动解决方案, 在单独的部分中详细讨论:

  • DHIS2 Light:针对所有用户的移动浏览器优化数据输入模块 设备

    该模块允许直接通过浏览器的数据输入 移动设备。各种各样的设备和移动浏览器 支持的功能包括:Opera mini 3和4(基本和高级)-Opera mini 4,诺基亚S40手机,Windows Phone 7,Window Mobile 6,Palm Pre,Blackberry(v5和v6),Firefox移动版,iOS设备(iPhone) 和Android设备。该客户端没有离线支持,并且 需要有效的GPRS / 3G连接。不需要新的 在手机上安装应用程序以支持新功能,但是 确实需要稳定的数据连接才能使用。这个解决方案是 [基于移动浏览器的数据输入](#mobile_web_based)中进行了介绍

  • DHIS2 Smartphone客户端:移动浏览器优化的数据输入 智能手机设备模块

    该模块允许直接通过浏览器的数据输入 手机。支持离线数据输入,并且不需要 在手机上安装特殊客户端的任何操作。

  • J2ME GPRS / 3G客户端

    DHIS-mobile包含两个独立的J2ME客户端,它们支持 GPRS / EDGE / 3G作为一种传输机制。一个客户支持设施 汇总报告,第二个客户端支持基于名称的 程序跟踪。这些客户端分为单独的应用程序 使部署更容易。一些卫生工作者可能同时患有 手机上安装的应用程序。这两个客户端都支持 脱机存储数据并在支持J2ME的设备上工作(功能 手机)。 。?>

    需要有效的GPRS / 3G连接才能将数据发送到 DHIS2数据库,但可以离线输入和传输数据 存在连接时。该客户主要用于 支持J2ME应用程序的低端设备,尽管 离线支持会增加一些内存要求,从而限制了 手机选择。虽然该解决方案主要在诺基亚上进行了测试 手机,它也可以在其他几款支持J2ME的手机上使用。

    “ J2ME”一章中描述了设施报告J2ME客户端。 GPRS / 3G客户端”

基于移动浏览器的数据输入

移动浏览器数据输入入门

此方法适用于通过移动浏览器在智能手机上进行数据输入 通过导航到DHIS2实例的URL,例如:完整 [dhis2.org](dhis2.org)上的演示的URL链接 http://apps.dhis2.org/dev/mobile/index.action 。还有你的手机 浏览器将自动检测服务器所在的DHIS2应用程序 给出了网址(例如: http://apps.dhis2.org/dev )。这是登录表格 使用用户名和密码访问应用程序。点击“登录” 继续或“重置”重置:

登录后,有功能列表:

- Aggregate Reporting: Entries for aggregate data with defined/assigned dataset by organisation-units

- 追踪:

  • 查找人员:根据姓名,电话号码或ID查找人员,以及 组织单位。

  • 活动计划:按组织单位输入人员的数据, 人员和程序/程序阶段

  • 人员注册:注册新人员

  • 匿名:基于程序的匿名人条目

- Messages: Manage the messages and discussions from the server. Message reply is available. User can send feedback message in Messages.

**-报告:**服务器的输出报告。

-**设置:**用户信息(例如:名字,姓氏,电话 号码,电子邮件)和界面语言。

**-注销:**退出应用程序。

-桌面版本 :导航至DHIS2的桌面版本 行政。这需要来自客户端移动设备的大量资源, 例如:足够的内存来加载页面。不建议 适用于普通GPRS / 3G / ...电话。

上面的列表将详细说明:

  1. Aggregate Reporting: Entries for aggregate data with 定义/分配的数据集 组织单位。

    点击“汇总报告”,然后选择一个组织单位 从列表中出现,数据集列表将针对 输入汇总数据。请参见以下示例:

    步骤1:从 清单

    步骤2:从中选择一个数据集(输入表单) 清单

    步骤3:选择一个期间(基于所选期间的类型 数据集) 清单

    步骤4:输入 数据

    步骤5:在填写完数据后保存输入的数据,选择 数据完整性选项,如果 有。

  2. Tracking: Find/Add Person, Visit Schedule, Person 注册, 匿名

    2.1 查找/添加人 :根据姓名,电话号码查找人 或ID,以及组织单位。

    • 步骤1:输入姓名,电话号码或ID,然后选择 组织单位,然后单击 搜索。

    • 步骤2:选择一个 人

      然后将显示该人的所有信息

    • 步骤3:选择下一个程序阶段以输入 数据

      要查看所有程序阶段,请单击该程序的名称 程序(Child Heath程序为屏幕 射击)

    2.2: Visit Schedule : Choose An Organization Unit

    • 当前活动计划:已注册的受益人列表, 已注册,尚未完成/完成一个/许多程序,并且在 至少是程序阶段开放的数据输入。

      + 步骤1:选择一个人 条目

      + 第2步:选择当前的活动阶段 进入 数据

      您还可以查看此人的信息(ID,性别, 点击“详细信息”(位于 列表 出现)

      所选的详细信息 人:

    • 所有活动计划:所有已注册受益人的列表, 已注册,尚未完成/完成一个/许多程序。

    • 单 事件:

    2.3:**人员注册:**注册新人员

    • 步骤1:个人输入 信息

    • 步骤2:为刚注册的人注册程序,然后 点击 “注册”。

    • 步骤3:输入所选程序所需的信息,然后 点击 “注册”

      这里是 结果:

    2.4:**匿名:**基于特定条目的匿名人员条目 程式

  3. Messages: Manage the messages and discussions from the 服务器。留言回复为 可用的。

    显示的数字是未读邮件。点击查看 邮件列表(未读邮件为粗体和深蓝色 颜色):

    然后,您可以通过以下方式获取讨论的消息/主题: 留下回覆讯息,请看这里 例:

    用户可以在“消息”部分中创建反馈并将其发送到服务器。 发送新的反馈后,消息(反馈)将是 在“消息”下列出以进行进一步的跟踪。

  4. Reports: The output reports from the 服务器

    (将会被更新)

  5. Settings: User-information (e.g.: First-name, Surname, Phone 号码,电子邮件)和界面 语言。

    这是用于设置用户帐户/访问权限和 界面语言。单击“保存”以完成设置,请参阅 这个例子 下面:

  6. **登出:**登出 应用

  7. 台式机版本 :浏览至DHIS2的台式机版本 行政。

    这是桌面版本的GUI(需要大量内存 (用于加载),不建议在普通移动设备上使用。该示例 DHIS2演示(来自 dhis2.org )

  1. 单击“基于名称的数据条目”后,下一个将指导 在以下步骤中选择:

    步骤1:选择组织 单元

    步骤2:选择活动 类型

    (该屏幕截图带有“当前活动计划”的示例 选项)

    通常会有以下两种类型的活动:

    +“当前活动计划”:受益者列表 已注册,已注册,尚未完成/完成一个/许多程序,并且 至少有一个程序阶段可供数据输入。

    +“所有活动计划”:所有已注册受益人的列表, 已注册,尚未完成/完成一个/许多程序。

    步骤3:选择受益人 条目

    (带有“ Hybia Welde”选项的示例的屏幕截图)

    第4步:选择一个当前活动的程序阶段以输入 数据

    (屏幕截图显示了“出生后16-24个月”的示例 选项)

    您还可以查看收款人的信息(ID,性别, 点击“详细信息”(位于 清单 出现)

    所选的详细信息 受益人:

  2. Beneficiary Registration: Registry a new 受益人

    步骤1:选择一个 组织单位

    步骤2:填写受益人登记 形成

    有必要的信息:全名,性别,出生日期(和 血型)。

    点击“保存”以注册新的受益人。

    收款人是时,会出现“成功保存”消息 创建/注册 成功。

  3. Beneficiary Enrollment: Enrol a beneficiary to one or many 程式

    Before enrolling a beneficiary to a program, the search function for a beneficiary is provided:

    If the beneficiary is found, the result will be listed. The simply click on the beneficiary name for navigating to the programs in which the beneficiary enrolled:

    The below screen-shot example describes the beneficiary named "Nguyen Van A":

    - Has not enrolled any programs before

    - There is one program: "Child Health Program" available for enrolment

    The list of the available programs for enrolment will be listed. Just click on the program for enrolment by specifying the date of enrolment and the date of incident. See the example:

    After clicking on the "ENROLL" button, if successful, the program enrolled will be listed under "Enrolled Programs for" + \<Name of the beneficiary>, see the example:

  4. Messages: Manage the messages and discussions from the 服务器。留言回复为 可用的。

    显示的数字是未读邮件。点击查看 邮件列表(未读邮件为粗体和深蓝色 颜色):

    然后,您可以通过以下方式获取讨论的消息/主题: 留下回覆讯息,请看这里 例:

  5. Reports: The output reports from the 服务器

    (将会被更新)

  6. Settings: User-information (e.g.: First-name, Surname, Phone 号码,电子邮件)和界面 语言。

    这是用于设置用户帐户/访问权限和 界面语言。单击“保存”以完成设置,请参阅 这个例子 下面:

  7. Feedback: the extra function for creating a new message to 发送到服务器。由此产生的新反馈将是 列在 “ 消息

    点击“反馈”后,将有一个表格 编辑/发送新消息/讨论。看例子 下面:

    发送新的反馈后,消息(反馈)将是 在“消息”下列出以供进一步关注 向上。

  8. **登出:**登出 应用

  9. 台式机版本 :浏览至DHIS2的台式机版本 行政。

    这是桌面版本的GUI(需要大量内存 (用于加载),不建议在普通移动设备上使用。该示例 DHIS2演示(来自 dhis2.org )

J2ME GPRS / 3G客户端

DHIS2 GPRS / 3G移动模块为远程客户端提供了一种机制 使用手机将数据直接输入DHIS2系统。那里 客户端的两个功能,即:

该解决方案依赖于具有数据连接的手机 可用(即GPRS,Edge,3G),通过它与DHIS2通信 实例,必须与其他任何实例一样,可以在互联网上公开使用 网络服务器。手机上的客户端应用程序下载数据条目 表格从服务器发送到电话,因此表格可以是 无需安装新应用程序即可更新。这也是至关重要的 社区报告功能,需要定期下载 服务器上的活动计划。

  • 设备报告,用于常规DHIS2的数据输入和报告 汇总数据,

  • 活动报告,用于支持个人活动报告 与社区模块。

数据连接可用性

在许多情况下,数据连接可用性可能是一个问题 否则,DHIS2移动报告将是一个很好的解决方案, 直接将数据获取到DHIS2。如果是这样,您可能 想考虑尝试单独描述的基于SMS的解决方案 文件。请记住,即使当前存在数据连接 服务器与手机之间进行通信所必需的 仅在初始化或更新移动应用程序时才需要 以及向服务器发送报告时。手机存储了所有输入的 本地数据,因此只有临时访问数据才能正常工作 定期连接。

J2ME GPRS 3G设施报告客户端

基于Web的解决方案的服务器端组件包含在 DHIS2的常规版本。

为了配置DHIS2基于Web的移动报告,您应该 请遵循以下步骤。

  • 为您设置的数据集设置“可用于移动报告”标志 想要报告:在* Maintenance-> DataSet *-> * Edit *下标记 “可用于移动报告”复选框并保存。

  • 为移动用户创建用户角色。选择 维护->用户->用户角色->添加新 。添加用户角色名称 和说明。为角色添加所需的数据集。手机 用户角色至少需要具有DHIS2 Web API的特权。 通过单击“保存”来保存用户角色。

  • 创建一个将由客户端用于登录的用户 维护->用户->用户->添加新 。填写所有必填项 详细信息,请记住密码必须至少为8位数字 长,包含一个大写字母和一个数字。分配所需的 上一步中创建的用户的用户角色。

    Important

    Assign the user to exactly one organisation unit. Each mobile reporting client will need their own user name and password.

数据集和报告表格的详细配置

尽管前面的步骤是测试 解决方案可能需要对数据集进行更详细的配置,并且 在以下各节中进行介绍。

数据集到电话上的表单布局的映射

默认情况下,数据集映射到电话上的单个表单。如果 数据集分为多个部分,每个部分显示为 手机上的单独页面。如果数据元素具有多个类别 选项组合将显示为带有类别的标题 组合选项如下。

Form design element DHIS2 Metadata Metadata element
Form title 资料集 Short Name if it exists, otherwise Name
Page tile Section Section name (or form name if no sections)
Question 数据元素 Alternative name if it exists, otherwise Name
Question name if combos 类别选项组合 名称

表格排序

默认情况下,数据元素将根据全局排序进行排序 在DHIS2中分配。如果使用节,则按节的特定排序 订单将被使用。在某些情况下,当不使用节时,数据 元素可能在多个数据集中使用,并且在方式上存在冲突 应该在单个数据集中排序。为此工作 情况是将整个数据集包装在一个部分中(请注意, 仅在数据元素具有相同的类别选项组合时才有效)

数据集的版本控制

为了能够在移动设备上比较和更新数据集 服务器上的版本的手机,数据集会自动 编辑数据集结构时版本化。发生的一些变化 在DHIS2服务器上,将导致移动客户端更新其表格 新版本。

  • 创建数据集

  • 编辑数据集

  • 在数据集中创建/编辑/删除部分

  • 排序部分顺序

  • 更新数据元素(影响许多相关的数据集)

  • 删除数据元素(影响许多相关的数据集)

  • 编辑数据元素类别

  • 编辑DataElement类别组合

语言支持

提供多语言支持。

DataSet和DataElement通过基于Web的功能进行转换。 如果请求的语言,则服务器上的默认语言在移动设备上使用 无法使用手机版。

移动应用程序设置

安装和初始化

安装

Download the jar packages from the DHIS2 homepage: https://www.dhis2.org/downloads

初始化

出厂前应进行初始化 终端用户。鉴于可能的电话配置差异很大, 无法描述顺序所需的确切步骤 以便在电话上启用客户端。但是,对于大多数手机而言, 使用USB将DHIS2 Web Mobile客户端“ JAR”文件复制到电话中 电缆或通过蓝牙就足够了。当然,GPRS / 3G连接 必须启用。请与您的移动服务提供商联系,以获取详细信息 有关电话和网络的配置。

客户端安装到手机上后,进行初始化 必须通过提供用户名,密码和服务器URL来进行此过程。

  1. 首次登录服务器。

    客户端第一次登录服务器,或者如果客户端是 重新初始化后,用户名,密码和服务器URL必须为 输入。

    如果客户端无法登录,则可能有几种可能 您看到的错误消息。

    • 找不到连接:指定的服务器URL不正确。 检查服务器地址,确保服务器实际上是 可达,然后重试。

    • 用户名或密码无效:用户名或密码为 不正确的

    • 应用程序无权访问受限API: 可以联系服务器,但是用户没有 访问移动报告模块所需的权限

  2. 设置PIN码:初始登录过程后,输入PIN码 号码可以由用户输入。这将使登录过程 更加容易,因为用户只需记住四位数的密码 数字,而不是分别输入用户名和密码 时间。如果事先初始化电话,则可以预设PIN码 交货,也可以由用户自行设置 提供了用户名和密码。

    After entering the PIN, press (Menu)->Next.

  3. 下载所有表格:指定PIN后,所有表格都会 从服务器下载并本地存储在手机上。

    如果已将用户配置为报告汇总数据集,则 将显示适当的数据集列表。如果用户是 负责基于社区的报告,分配清单 显示活动。

    注意 :如果卫生工作者负责这两个设施 报告和社区报告,DHIS2服务器将发送所有表格 设施报告和社区报告在移动设备上以及 移动设备,屏幕上会选择是否显示设备 报告或社区报告。

    错误

登录(常规使用)

启动应用程序后,将显示PIN表单。

  • PIN码:输入四位数的PIN码。

  • 重新初始化命令:此功能将清除手机上的所有数据 然后从登录屏幕开始,输入用户名和密码。

  • 错误:无效的PIN:如果用户输入了无效的PIN,则他们 将需要输入正确的PIN或重新初始化应用程序 使用正确的用户名和密码。

设施报告模块

输入数据

从“选择报告表”中选择汇总数据集后 窗口,用户将需要选择适当的时间段。一个列表 的可用时间段会自动生成。

  1. 用户输入PIN后,他们可以从以下列表中进行选择 可用的数据集。选择适当的数据集,然后按“下一步”。

  2. 选择期间:将自动列出可用期间 显示给用户。他们可以从中选择合适的时期 列表。

  3. 填写值:选择期间后,可以显示表格 有两种模式,具体取决于

    • 带有部分的表格

      每个表单部分都显示在一个带有名称的屏幕中 标题窗口中该部分的内容。

      要在屏幕之间导航,请按“下一步”。

    • 不带节的表单(不带节的数据集)

      所有字段都显示在一个屏幕上,标题为 数据集的名称

    用户只需用适当的填充每个数据元素 值。

  4. 保存并完成:

    完成数据输入后,用户可以选择保存数据 本地电话上或直接将数据上传到DHIS2 服务器。

    If the user saves the data form, they can edit the form at a later point in time if they need to. When selecting a period once again, the period will be marked as "Saved' as seen in the next screen shot.

    If the user selects "Complete", and the data entry form is not complete, the user will be asked if they are certain they wish to submit the form as incomplete. Once the form has been submitted, a message should be displayed informing the user that the transmission was successful.

笔记
  1. 期间清单:

    标有星号( *)的期间是已完成的期间 还是保存,取决于数据的状态 条目。

    All periods that are not in period list are considered old and will be deleted automatically.

  2. 存储值持续时间

    在手机上保存的表格数量仅受 移动设备的有效存储量。

    表格仅保存有限的时间,具体取决于频率 特定数据集的集合。

    • 每日表格:2个月(当月和上个月)

    • 每周表格:4周(当前和前3周)

    • 月度表格:2个月(当月和上个月)

    • 季度表格:2个季度(当前和上一个季度)

    • 年度表格:2年(当前和前一年)

  3. 填写完毕的表格-无法修改的表格

    如果表单已完成,则用户可以在其上查看表单 电话,但他们无法对该表单进行任何后续编辑。每 该字段显示为灰色,并且对于编辑无效。

  4. 重新编辑填写好的表格

    如果用户希望编辑已经提交给的数据 服务器,则可以通过点击“编辑”按钮来实现。他们是 假设数据集尚未锁定,则允许执行此操作 有关时期。如果他们尝试上传数据,则用户 系统会通知您该数据集已被锁定,但尚未锁定 可以上传数据。

  5. 更新表格:

    此功能用于在手机和手机上同步表格 服务器。输入PIN后自动触发该过程 数。

    注意:检查和下载更新的表单过程在 背景。完成后,显示提示询问用户是否 刷新表单列表或留在原处。

  6. 多国语言支持:

    此功能帮助用户选择手机GUI的语言 (图形用户界面)和内容的语言(表格)。

    表单必须在服务器上翻译,否则为默认语言 用来。

    首次登录的默认语言是英语。更改语言 设置菜单将同时影响界面和内容。

    多国语言界面:在“设置”菜单中,有以下列表: 支持的语言(从服务器下载)。仅GUI语言 重新启动应用程序后更改。

    多语言内容(表单):表单语言在更改后 点击“保存”。如果表格很多,则需要几分钟 保存设置。

故障排除
  • 数据已在手机上输入,但未出现在服务器上

    通常在用户在手机上输入数据时发生,但不能 将其发送到服务器。这可能是由于 电话,电话信用不足或覆盖范围不足。通常 显示错误消息,如下所示。

    Users should be informed that if they see this error, then it means that their data has not been transmitted.

SMS Command { #mobile_sms_command }

SMS命令功能可帮助DHIS2系统接收来自用户的SMS, 患者,甚至是匿名的。 SMS命令是包含以下内容的对象: 每个SMS表单的配置:报告来自电话或j2me的数据 应用,提醒用户,注册患者或用户等。

设置短信命令

在这里您可以创建新的短信 命令

通常每个SMS命令都有其自己的属性,然后进行设置 过程可能彼此不同。目前,我们有4种类型的 短信 命令:

使用KEY _VALUE _PARSER和J2ME _PARSER,SMS命令将具有 数据集,因为它们用于报告数据。如果报告了数据 在已批准的期间内,将发送SMS响应 返回包含有关批准状态的信息 期。

使用ALERT _PARSER和UNlocated _PARSER,SMS命令将具有 用户组,因为它们用于发送短信(例如SMS,DHIS2) 会话, 电子邮件。

有某些对于所有SMS命令类型都通用的参数。 如果用户使用这些参数,则在系统中配置默认值 确实为这些参数提供了任何值,那么那些默认参数将 使用。这是这些参数的列表

Common Parameters
Parameter 类型 描述
Code Value Separator To provide custom code value separator. Default is "="
Field Separator To provide custom field separator. Default is "|"
Reply message if no codes are sent (only the command) To provide message if no code is found in SMS text input. Default is "Parameter missing"
Wrong format message To provide message if command is not formatted correctly. Command should be formatted as per code value separator. This message will also be sent back if any mandatory parameter is missing.
No user message To provide message if sending phone number is not registered in DHIS2.
User belong to more than one OrgUnit message Certain SMS command types require user ( retrieved from sending phone number ) to be associated with only one organization unit. This message can be configured to be sent back in case that requirement is not fullfilled.
Success Message To provide message that will be sent upon successful completion of the process.

短信命令类型

SMS命令基本上由其解析器类型定义。换句话说, 每个SMS命令都有一个唯一的解析器来解析纯文本SMS,然后 结果将用于该SMS命令的目的。

用于报告数据的SMS命令

为了报告数据,例如数据集(聚合),我们使用SMS 具有KEY _VALUE _PARSER(用于电话的纯文本)的命令,或 J2ME _PARSER(用于j2me 应用)

如果命令的名称为“ report”,并带有代码的数据元素列表 像上面一样。格式应为: [命令名称] [代码] [值] [代码] [值] [代码] [值] ...., [值]当然可能是 更改取决于实际数据,因此您必须准备一个SMS文本,例如 此示例:**报告vo2 vn5 a2 b6 z3 x1 **

如果命令具有分隔符,例如“。”,则SMS文本 应该:

**报告vo.2.vn.5.a.2.b.6.z.3.x.1 **

或**报告vo.2 | vn.5 | a.2 | b.6 | z.3 | x.1 **

此外,在SMS文本输入中,可以这样指定orgUnit ** org orgUnitCode **如果在SMS中未指定orgUnit,则将检索用户 首先从发送电话号码开始,然后从该用户发送orgUnit。如 就PeriodType而言,应以这种格式指定 “ ddMM”,例如3108,但如果未指定,则使用PeriodType 将从附加到SMSCommand的DataSet中检索

使用J2ME _PARSER,您不需要准备那些SMS文本,因为 J2ME将完成这项工作

用户可以将自定义响应消息设置为“格式错误的消息”,“否 用户消息”,“用户属于多个OrgUnit消息”和 “成功消息”。如果未设置自定义消息,则系统将使用 默认消息。

实体注册的SMS命令

TRACKED _ENTITY _REGISTRATION _PARSER可用于注册跟踪 实体进入系统。

命令名称后将跟与以下内容有关的跟踪实体属性 与该命令关联的特定程序。程序 创建此命令时将完成选择。

默认文本模式(如果不是字段分隔符和代码值分隔符 为该解析器提供)如下所示。 ** childProgram fn = xmen | ln = xmen2 | age = 4 **

In case field separator is for example "," then text would look like this. childProgram fn=xmen,ln=xmen2,age=4

其余行为与其他命令相同。如果用户不 提供这些参数,然后将使用默认参数。

用于程序阶段数据输入的SMS命令

PROGRAM _STAGE _DATAENTRY _PARSER可用于进入程序阶段 特定跟踪实体实例的相关数据。

命令名称后将跟与特定名称有关的数据元素 该命令所关联的程序阶段。程序与程序 创建此命令时将完成阶段选择。

默认文本模式(如果不是字段分隔符和代码值分隔符 为该解析器提供)如下所示。 **程序阶段 bcgd = 1 | opvd = 2 | wght = 34 **

In case field separator is for example "," then text would look like this. programstage bcgd=1,opvd=2,wght=34

其余行为与其他命令相同。如果用户不 提供这些参数,然后将使用默认参数。

短信命令,用于警报,注册

为了提醒用户,我们使用具有ALERT _PARSER的SMS命令 (用于电话的纯文本)或UNlocated _PARSER(用于j2me应用程序)。 UNlocated _PARSER也可以用于注册IDSR 谣言。

这些命令的格式为: [命令名称] [文本],用于 例:

在A镇提醒一个紧急情况

仅从用户收到具有ALERT _PARSER的命令

用于事件注册的SMS命令

事件注册可用于将匿名事件注册到 系统基于通过SMS收集的数据。此命令类型是 与类型WITHOUT _REGISTRATION的程序相关联。例如 使用此解析器可以跟踪出生事件。

这些命令的格式为: [命令名称] [代码] [分隔符]] [值],例如:

出生A = 1,B = 2,G =男性

代码/值分隔符是可配置的。管道“ |”默认情况下为 字段分隔符。具有EVENT _REGISTRATION _PARSER的命令将为 仅从DHIS2用户收到。成功接收命令后 然后将解析SMS中接收到的数据,并在其中注册事件 DHIS2。

短信服务

SMS服务是用于发送/接收SMS的常规服务。任何 其他DHIS2模块可以包括此服务并利用它发送和发送 从现场的用户或工作人员接收短信。

设置短信服务

使该服务正常运行的前提条件很少。 有两种方法可以完成这些步骤。一种方法是配置 网关从移动配置模块中的GUI。另一种方法是 使用SMS Web Api。

  • 配置短信网关

配置短信网关

There are five different types of Gateways supported by SMS Service. SMS can be sent if any one of the gateway is configured. If more than one gateways are present, then they will be used in round-robin fashion for load balancing. There are different parameters for different type of gateway. The Gateway can be configured in GUI in Mobile Configuration Module as shown in the figure. More information about parameters needed to configure gateway can be found in [Gateway Configurations] section of new SMS app.(#gateway.configuration)

配置GenericHttp网关

Many DHIS2 instances are using GenericHttpGateway to connect to their local gateways. These local gateways provides HTTP APIs for sending SMS. In new GenericHttpGateway it is now possible to configure generic configuration template for gateway configuration. This template is converted into request payload by replacing place holders with actual values taken from gateway key value parameters.

网关配置

下表显示了配置网关所需的参数。

Gateway Configuration Parameters
Parameter BulkSMS Gateway Clickatell Gateway Generic HTTP Gateway SMPP网关 描述
Gateway Name 可选的 可选的 可选的 可选的 Used as gateway identity. Default name will be stored in case this parameter is not configured. Its use is recommended
User Name 需要 Optional (if token is used) 需要 需要 Used for API authentication
密码 需要 Optional (if token is used) 需要 需要 Used for API authentication
Auth-Token 不适用 Optional (if password is used) 不适用 不适用 Used for API authentication
URL Template 不适用 不适用 需要 需要 Url Tempalte is only required in case of GenericHttpGateway . For example " http://smsgatewa1.com "
Headers 不适用 不适用 可选的 不适用 Header option can be checked to send selected parameter as http header. For example username/password/token can be sent in http header.
useGet 不适用 不适用 可选的 不适用 HTTP POST method is used by default for posting data toward gateway. But in certain cases if HTTP GET method is required for doing so then useGet parameter can be set to true. Default value for useGet is false.
systemType 不适用 不适用 不适用 需要 SystemType parameter is required for SMPP gateway. Default value is 'cp'
typeOfNumber 不适用 不适用 不适用 需要 TypeOfNumber parameter is required for SMPP gateway. Default value is 'UNKNOWN'. Other possible values are UNKNOWN, INTERNATIONAL, NATIONAL, NETWORK_SPECIFIC, SUBSCRIBER_NUMBER, ALPHANUMERIC and ABBREVIATED
numberPlanIndicator 不适用 不适用 不适用 需要 NumberPlanIndicator parameter is required for SMPP gateway. Default value is UNKNOWN. Other possible values are UNKNOWN, ISDN, DATA, TELEX, LAND_MOBILE, NATIONAL, PRIVATE, ERMES, INTERNET and WAP
bindType 不适用 不适用 不适用 需要 BindType parameter is required for SMPP gateway. Default value is TX. Other possible values are BIND_TX, BIND_RX and BIND_TRX
compressed 不适用 不适用 不适用 可选的 Compressed parameter is optional for SMPP gateway. Default value is false
sendUrlParameters 不适用 不适用 可选的 不适用 网关参数将附加 url 例如 https://samplegateway.com/messages?apiKey={apiKey}&to={recipients},content={text},deliveryreport={dp}
contentType 不适用 不适用 可选的 不适用 The type in which data will be sent to sms gateway. Default is application/x-www-form-urlencoded. Other supported types are application/json, application/xml and text/plain
configurationTemplate 不适用 不适用 可选的 不适用 Generic configuration template can be used to provide the data in the form acceptable to external gateway. For example username=${username}&password=${password}&to=${recipients}&countrycode=880&message=${text$}&messageid=0 . Json/xml template can also be provided.

Configuring SMS

This document covers the functionality of the SMS Configuration App. For additional information about SMS service integration, please refer to the Mobile document.

短信命令

SMS commands process SMS messages received by a DHIS2 instance, taking certain actions depending on the command and message content. Multiple SMS commands can be set up to process and handle data in multiple ways. A SMS command is an object containing the configurations for each SMS form: reporting data from phones or j2me apps, alerting users, registering patients or users, etc.

Listing available commands

To see all available commands, navigate to the "Commands" page. All commands will be listed in a table. On this page the following actions are available:

  • Add commands (1)
  • Edit commands (2)
  • Delete commands (3)
  • Batch-delete commands (4)

SMS Commands - List

Delete available commands

Deleting commands can be done by individually checking the checkboxes of each command (1) that should be deleted or by selecting all displayed commands by checking the checkbox in the table head (2). After selecting the commands to delete, the "Delete selected" button needs to be clicked (3).

SMS Commands - Delete selection

To prevent accidental deletions, a confirmation dialog will show up.

SMS Commands - Delete confirmation

Adding commands

Caution

Commands are not active immediately after they are added! They must then be edited in order to configure the necessary fields!

After clicking on the "Add command" button in the command overview page, a dynamic form will appear. Depending on the parser type, different inputs will be displayed:

Parser type User group 程序 程序阶段 资料集
Alert parter
Event registration parser
J2ME parser
Key value parser
Program stage data entry parser
Tracked entity registration parser
Unregistered parser

Event registration parser

These commands can have short codes for their associated program stage. Only programs of type "Event program" can be chosen for this command. Therefore only one program stage exists, which will be selected automatically.

Program stage data entry parser

These commands can have short codes for their associated program stage. Only programs of type "Tracker program" can be chosen for this command. Unlike "Event registration" parsers, a program stage has to be chosen for this parser type.

Editing commands

When editing commands, changing the parser type as well as the additional data supplied when adding the command is not possible. The only way this is currently possible is by creating a new command and deleting the old one.

有某些对于所有SMS命令类型都通用的参数。 如果用户使用这些参数,则在系统中配置默认值 确实为这些参数提供了任何值,那么那些默认参数将 使用。这是这些参数的列表

These common fields are:

Parameter 类型 描述
Field Separator To provide custom field separator. Default is "|"
Reply message if no codes are sent (only the command) To provide message if no code is found in SMS text input. Default is "Parameter missing"
Wrong format message To provide message if command is not formatted correctly. Command should be formatted as per code value separator. This message will also be sent back if any mandatory parameter is missing.
No user message To provide message if sending phone number is not registered in DHIS2.
User belong to more than one OrgUnit message Certain SMS command types require user ( retrieved from sending phone number ) to be associated with only one organization unit. This message can be configured to be sent back in case that requirement is not fullfilled.
Success Message To provide message that will be sent upon successful completion of the process.

Some commands have the option to add short codes, which are explained in the individual sections for each parser type down below.

Editing alert parser commands

When editing an alert parser command, only two fields are editable, the fields that are shared between most parser types are not present:

  • Name (required)
  • Confirm message

Both are text fields.

Editing event registration parser commands

Commands of this parser type have all the shared fields. Additionally short codes can be defined. A short code can be added for every data element connected to the program stage that was selected when adding the command:

SMS Commands - Event registration parser short codes

Editing J2ME parser commands

Commands of this parser type have all the shared fields. The SMS command will have a dataset because those are used for reporting data. If data is reported for a Period which is already approved then SMS response will be sent back containing information about approval status of the period. Additionally short codes can be defined. Each command is connected to a dataset. The dataset has data elements, which have category combos, which have at least one category option combo. For every existing "data element - category option combo" combination, a short code can be provided.

Required values notice Make sure at least one SMS short code is provided when completeness method "Receive at least one data value" is chosen, otherwise received messages will not be processed.

Short code formulas

Each short code can have an optional formula. By providing a formula, the value of a different data element can be either added or subtracted.

This can be done by clicking the "Add formula" / "Edit formula" button below the short code's input field:

SMS Commands - J2Me parser short codes - Add/Edit formula button

When clicking the button, a modal will appear which offers a dropdown to select a data element, and the formula operator, which can be either "+" or "-":

SMS Commands - J2Me parser short codes - Add/Edit formula modal

By clicking "Save", the formula will be added to the main edit form, it does not get saved to the command automatically! In order to save a changed formula, you need to submit the whole form.

Removing a short code formula

If a short code has a formula, it can be removed by clicking the "Edit formula" button. The modal that will appear, has a button "Remove". By clicking that button, the formula will be removed from the short code in the main form and the modal will close. It does not get saved to the command automatically! In order to save the removal of the formula, you need to submit the whole form.

SMS Commands - J2Me parser short codes - Add/Edit formula modal

Editing key value parser commands

This command type works identically to J2ME parser commands work. Please check the documentation above.

Editing program stage data entry parser commands

Commands of this parser type have all the shared fields. Additionally short codes can be defined. A short code can be added for every data element connected to the program stage that was selected when adding the command:

SMS Commands - Program stage data entry parser short codes

Editing tracked entity registration parser commands

Commands of this parser type have all the shared fields. Additionally short codes can be defined. A short code can be added for every tracked entity attribute connected to the program that was selected when adding the command:

SMS Commands - Program stage data entry parser short codes

Editing unregistered parser commands

This command type works identically to alert parser commands work. Please check the documentation above.

SMS Gateways

An SMS gateway lets a DHIS2 instance send and receive SMS messages. Different gateway types can be added and configured below. At least one gateway is needed to send and receive SMS messages. Load balancing will use all gateways if there are multiple available.

There are four types of Gateways supported by the SMS Service: * Generic gateways * BulkSMS gateways * Clickatell gateways * SMPP gateways

Listing gateways

To see all available gateways, navigate to the "Gateway configurations" page. All gateways will be listed in a table. On this page the following actions are available:

  • Add gateways (1)
  • Edit gateways (2)
  • Delete gateways (3)
  • Batch-delete gateways (4)
  • Set the default gateway (5)

SMS Gateways - List

Adding gateways

After clicking on the "Add gateway" button in the gateway configurations overview page, a dynamic form will appear. It's devided into two sections:

  1. The gateway type (1)
  2. The gateway's configuration, depends on the gateway type (2)

SMS Gateways - Adding gateways

For more details about configuring gateways, please refer to the Gateway Configurations section of the "Mobile" maintenance documentation.

Editing gateways

Editing is similar to adding gateways with the exception that the gateway type cannot be altered. If a gateway has the wrong type, it needs to be deleted and added again. For more information how to edit gateways, please refer to the "Adding gateways" section above.

View inbound SMS

To see all inbound sms, navigate to the "Received" page. All received sms will be listed in a paginated table. On this page the following actions are available:

  • Filtering the inbound SMSes (1)
  • Deleting SMSes (2)
  • Batch-deleting SMSes (3)

SMS Inbound SMSes - Listing inbound SMSes

筛选

Resetting filters

All set filters can be reset by clicking on the "Reset filter" button.

SMS Inbound SMSes - Filter inbound SMSes by status

Filtering by status

The list of inbound SMSes can be filtered by the following statuses:

  • 所有
  • Failed
  • Incoming
  • Processed
  • Processing
  • Sent
  • Unhandled

SMS Inbound SMSes - Filter inbound SMSes by status

Filtering by phone number

By entering a phone number in the input field above the table with the SMSes, the table can be filtered by that phone number.

SMS Inbound SMSes - Filter inbound SMSes by status

View outbound SMS

This section is identical to the "Inbound"/"Received" SMSes section, with only one difference: The list cannot be filtered by a phone number. Please refer to the "View inbound SMS" section.

Caution

The screenshots and information in this section is stale and in process of being updated.

将应用程序安装到DHIS2中

Apps can be installed by uploading zip file into the App Manager. In, Services → Apps, click on the App Hub menu item. The app can be uploaded by pressing the Browse button and after selecting the zip package, the file is uploaded automatically and installed in DHIS2. You can also browse through apps in the DHIS2 AppHub and download apps from there. The DHIS2 AppHub allows for app searching, reviewing, commenting, requesting features, rating on the apps by the community.

启动应用程序

After installation, your apps will be integrated with the menu system and can be accessed under services and from the module overview page. It can also be accessed from the home page of the apps module. Click on an app in the list in order to launch it.

关于数据维度

数据维度:DHIS2中的核心构建块

DHIS2中的数据值至少由以下三个维度描述:1)数据 元素,2)组织单位和3)期间。这些尺寸构成了 数据模型的核心构建块。

作为一个例子,如果你想知道2014年12月在Gerehun CHC接种麻疹的儿童数量,描述该值的三个维度是数据元素"给予的麻疹剂量",组织单位"Gerehun CHC"和时期"2014年12月"。所有数据值至少具有描述*什么*、*在哪里*和*何时*的这三个维度。

除了数据元素,组织单位和期间 维度,数据值也可能与其他数据相关联 尺寸。此功能的常见用法是描述数据值 由同一位置的多个合作伙伴报告 相同的数据元素和时间段。原则上,它可以用作 “自由形式”的维,用于描述相同的多个观测值 现象在同一时间和地点。有关此的更多信息, 请参见第34章:其他数据维度。

组织单位 数据元素
Gerehun CHC Measles doses given Dec-09 22
Tugbebu CHP Measles doses given Dec-09 18

Data elements: the what dimension

数据元素类别

上面提到的数据元素“给定的麻疹剂量”可以进一步提高 按数据元素类别的组合分类。每 DHIS2的系统管理员可以自由定义任何数据元素 数据元素的类别维度。但是,有一些最好的 通常应遵循的实践。

Given the example of Measles vaccination, if you want to know whether these vaccines were given at the facility (fixed) or out in the community as part of the outreach services then you could add a dimension called—e.g., "Place of service", with the two possible options "Fixed" and "Outreach". Then all data collected on measles immunisation would have to be disaggregated along these to options. In addition to this you might be interested in knowing how many of these children who were under 1 year or above 1 year of age. If so you can add an Age dimension to the data element with the two possible options "\<1 y" and ">1 y". This implies further detail on the data collection process. You can also apply both categories "Place of service" and "Age" and combine these into a data element category combination e.g. called "EPI disaggregation". You would then be able to look at four different more detailed values in stead of only one as in the example above for the data element "Measles doses given": 1) "Fixed and \<1 y, 2) Fixed and >1 y, 3) Outreach and \<1 y, and 4) Outreach and >1 y. This adds complexity to how data is collected by the health facilities, but at the same time opens up for new possibilities of detailed data analysis of Measles immunisation.

Example of detailed storage of data values when using data element categories "Place of Service" and "Age" (simplified for readability compared to the actual database table)
组织单位 数据元素 Place of service 年龄
Gerehun CHC Measles doses given Fixed \<1 y Dec-09 12
Gerehun CHC Measles doses given Outreach \<1 y Dec-09 4
Gerehun CHC Measles doses given Fixed >1 y Dec-09 4
Gerehun CHC Measles doses given Outreach >1 y Dec-09 2
Tugbebu CHP Measles doses given Fixed \<1 y Dec-09 10
Tugbebu CHP Measles doses given Outreach \<1 y Dec-09 4
Tugbebu CHP Measles doses given Fixed >1 y Dec-09 3
Tugbebu CHP Measles doses given Outreach >1 y Dec-09 1

数据元素组集

尽管上述数据元素类别及其选项 提供数据点的详细程度(分解) 收集以及如何将数据值存储在数据库中 元素组集和组可用于向其中添加更多信息 数据收集后的数据元素。例如,如果您正在分析 报告中要同时包含许多数据元素 这些基于一些标准。而不是查看所有数据 以免疫和营养形式捕获,您可能想要 沿程序维度分离或分组数据元素(称为 DHIS2中设置的数据元素组),其中“免疫”(或EPI)和 “营养”将是两个群体。

扩展报告以包括来自其他程序或更大程序的数据 健康数据的主题将意味着有更多的小组加入这样的小组 维度,例如“疟疾”,“生殖健康”,“种群”。为了这 例如,您将创建一个名为“ Programme”的数据元素组集 (或您认为合适的任何名称),并代表不同的名称 在这个维度上的程序,您将定义数据元素组 被称为“ EPI”,“营养”,“疟疾”,“生殖健康”等, 并将所有这些组添加到“程序”组集中。链接或标记 数据元素“给定的麻疹剂量”必须达到这样的尺寸(以 我们的示例)将其添加到“ EPI”组中。您向哪些组添加“麻疹 剂量”不会影响医疗机构收集数据的方式, 但为您的数据分析增加了更多可能性。所以对于组集 尺寸分为三个层次;组集(例如“计划”), 组(例如“ EPI”)和数据元素(例如“给定的麻疹剂量”)。

指标可以分为指标组,然后进一步分为 指标组集(维度)与数据完全相同 元素。

组织单位 数据元素 Programme
Gerehun CHC Measles doses given EPI Dec-09 22
Gerehun CHC Vitamin A given Nutrition Dec-09 16
Tugbebu CHP Measles doses given EPI Dec-09 18
Tugbebu CHP Vitamin A given Nutrition Dec-09 12
Gerehun CHC Malaria new cases 疟疾 Dec-09 32
Tugbebu CHP Malaria new cases 疟疾 Dec-09 23

组织单位:* where *维度

Organisation units in DHIS2 should typically represent a location, such as a Community Health Centre or referral hospitals, or an administrative unit like "MoHS Sierra Leone", "Bo District" or "Baoma Chiefdom". In non-health sector applications, they could be "schools" or "water points". Orgunits are represented in a default hierarchy, usually the default administrative hierarchy of a country or region, and are therefore assigned an organisational level. As an example, Sierra Leone has four organisation unit levels; National, District, Chiefdom, and Facility, and all orgunits are linked to one of these levels. An orgunit hierarchy in DHIS2 can have any number of levels. Normally data is collected at the lowest level, at the health facility, but can be collected at any level within the hierarchy, such as both the districts as well as the facility level.

当设计更高级别的报告时,在 地区或省一级,DHIS2将使用层次结构来 汇总任何给定单位在任何时间的所有医疗机构的数据 水平。捕获数据的组织单位级别始终代表 可能用于数据分析的最低详细程度,以及 组织级别定义了可用的聚合级别 沿地理维度。

组织单位组集和组

虽然设施级别通常是 DHIS2中的分解,有多种方法可以灵活地组织组织 通过使用组织单位将单位分解为任意数量的维度 组和组集功能。例如,如果所有设施都 指定为“社区卫生中心”或“地区 医院,可以创建一个名为 “类型”并添加具有上述类型名称的组。在 为了使组集在分析中正常运行,每个 组织单位应是一个小组的成员(强制性和 排除)。换句话说,设施 不应同时是“社区卫生中心”和“地区” 医院”。

继承组织单位组集的值

您可以通过继承来提高汇总数据的完整性 组织单位中“父”组织单位的设置 层次结构。如果您要汇总数据,这将特别有用 100多个组织单位。见 [维护]( https://docs.dhis2.org/master/zh/user/html/manage_organisation_unit.html#create_organisation_unit_group_set ) 应用程序文档了解更多 细节。

备用组织单位层次结构-组集和组的高级使用

A more advanced use of organisation unit group sets is to create alternative hierarchies e.g. use administrative borders from other ministries. In Sierra Leone that could mean an alternative hierarchy of 1:MoHS, 2:Districts, and 3: Local councils, instead of the four-level hierarchy with chiefdoms and facilities. For instance, if all facilities are linked to a specific local council, it would be possible to look at data aggregated by local council instead of chiefdom. Then you would first need to create a group set called "Local council" and then create one organisation unit group for every local council, and finally link all facilities to their corresponding local council group.

District OrgUnit Type 数据元素
Bo CHC Measles doses given Dec-09 121
Bo CHP Measles doses given Dec-09 98
Bo MCHP Measles doses given Dec-09 87
Bombali CHC Measles doses given Dec-09 110
Bombali CHP Measles doses given Dec-09 67
Bombali MCHP Measles doses given Dec-09 59

使用组集和组的最佳实践

如上所述,所有组织单位都应是 组集中的单个组。如果组织单位不存在 在任何组中或存在于组集中的多个组成员中, 这可能会导致分析模块中出现意外结果。 DHIS2有 完整性检查以识别不存在的组织单位 任何组织单位组集合成员,或存在多个 组。

期间:*何时*维度

周期维度成为分析数据时的重要因素 随着时间的流逝当查看累积数据时,当创建季度数据时 或年度汇总报告,或在进行合并数据的分析时 具有不同的特征,例如每月例行数据,年度 人口普查/人口数据或六个月的工作人员数据。

期间类型

在DHIS2中,根据一组固定的时期类型来组织时期 如下面所描述的。以下列表适用于默认的ISO 8601日历 类型。

  1. 日常

  2. 每周:系统支持各种每周期间类型,包括 周一,周三,周四,周六和周日为开学日的第一天 星期。您通过配置为使用 所需的每周期间类型。分析引擎将归因于 到一个月的每周数据,其中包含四天或以上的时间 周。

  3. 每两周一次:两周,从第一周开始 年。

  4. 每月:指标准日历月。

  5. 每两个月:从一月开始的两个月。

  6. 季度:从1月开始的标准ISO季度。

  7. 六个月:从一月开始的六个月

  8. 每年:这是一个日历年。

  9. 4月财政年度:从4月1日开始的财政年度期间, 于明年3月31日结束

  10. 财政年度:从7月1日开始的财政年度, 于明年6月31日结束

  11. 财政年度:从10月1日开始的财政年度, 于明年9月31日结束

  12. 4月的每个月六个月:从4月1日开始的六个月期间, 六个日历月的持续时间。

作为一般规则,所有组织单位应收集相同的数据 使用相同的频率或周期性。因此,数据输入表单为 与单个期间类型相关联以确保数据始终 根据正确且相同的周期性收集 国家。

但是有可能使用不同的方式收集相同的数据元素 通过将相同的数据元素分配给多个数据集来创建周期类型 具有不同的时期类型,但随后变得至关重要 确保没有组织单位同时使用两个数据集/期间收集数据 类型,将导致数据值重叠和重复。如果 正确配置的DHIS2中的聚合服务将聚合 数据一起,例如来自该国一部分的月度数据 从该国其他地区到本国的季度数据 季度报告。为了简单起见并避免数据重复,它是 建议对所有组织单位使用相同的期间类型 尽可能使用相同的数据元素。

相对时期

除了上一节中介绍的固定期间类型外, DHIS2还支持在分析模块中使用相对时间段。

在DHIS2中创建分析资源时,可以 使用相对期间功能。最简单的情况是 您想设计一个每月可以重复使用的月度报告 无需更改报告模板以适应 期间的变化。相对期间称为“上个月”,允许 为此,用户可以在生成报告时通过 report参数选择要在报告中使用的月份。

稍微高级一点的用例是当您想每月 免疫摘要报告,并希望查看来自 当前(报告)月份以及该年度的累计值 至今。相对期间称为“今年”提供了这样一个 相对于运行时选择的报告月份的累计值 那个报告。其他相对期间是最近的3,6或12个月 周期是从选定的值计算回来的累积值 报告月份。如果您要使用数据汇总创建报表 您可以选择季度(一年中到目前为止已经过去的季度) “过去四个季度”。其他相对期间在 手册的报告表部分。

组织单位 数据元素 Reporting month So far this year Reporting month name
Gerehun CHC Measles doses given 15 167 Oct-09
Tugbebu CHP Measles doses given 17 155 Oct-09

期间汇总

虽然需要以给定的频率收集数据以实现标准化 数据收集和管理,这并不限制 可用于数据分析和报告的期间类型。就像 数据汇总到组织层次结构中 根据期间层次结构汇总,因此您可以按季度创建 和年度报告基于每月收集的数据 基础。数据输入表单(数据集)的已定义期间类型定义 报告中最低的期间详细信息级别。

期间维度上的总和和平均汇总

在汇总期间维度上的数据时,有两种选择 如何进行计算,即求和或平均值。这个选项是 通过使用DHIS2中的每个数据元素指定 “添加/编辑数据元素”对话框中的“聚合运算符”属性。

常规收集的大多数数据应通过以下方式汇总 总结几个月或几周,例如创建一个季度 关于麻疹免疫的报告之一将总结三个月的值 用于“给定的麻疹剂量”。

Other types of data that are more permanently valid over time like "Number of staff in the facility" or an annual population estimate of "Population under 1 year" need to be aggregated differently. These values are static for all months as long as there are valid data. For example, the "Estimated population under 1", calculated from the census data ,is the same for all months of a given year, or the number of nurses working in a given facility is the same for every month in the 6 months period the number is reported for.

This difference becomes important when calculating an annual value for the indicator morbidity service burden for a facility. The monthly head-counts are summed up for the 12 months to get the annual headcount, while the number of staff for the facility is calculated as the average of the two 6-monthly values reported through the 6-monthly staff report. So in this example the data element "OPD headcount" would have the aggregation operator "SUM" and the data element "Number of staff" would have it set to "AVERAGE".

平均数据元素的另一个重要特征是有效性 时期的概念。平均值是任何时期的固定值 在注册期间内输入。对于 例如,日历年之后的年度人口估计将 无论该年之内的任何时期都具有相同的值 什么时期类型。如果给定设施的1岁以下人口是 2015年为250,表示 2015年1月15日,2015年第3季度,2015年第12周以及2015年内的任何时期。 这对覆盖率指标的计算方式有影响,因为 即使在做这些事情时,仍将使用全部年度人口作为分母值 月度报告。如果您想查看估计的年度覆盖率 给定月份的值,那么您可以选择设置 指标为“年化”,表示每月的覆盖值 乘以12的系数,将季度值乘以4,以便 产生有效的年度总数。年度指标功能可以 因此可以用来模拟每月人口估算的使用。

数据收集与数据分析

数据收集与存储

数据集确定系统中可用的原始数据,例如 它们描述了如何根据周期性以及如何收集数据 空间范围。数据集定义了要构建的数据的构造块 捕获并存储在DHIS2中。对于每个数据维度,我们决定 数据的详细程度应按以下方式收集:1)数据 要素(例如诊断,疫苗或发生的任何事件)及其 类别(例如年龄和性别),2)时期/频率维度,以及 3)组织单位规模。对于任何报告或数据分析 永远无法检索比数据中定义的数据更详细的数据 集,因此数据集的设计及其相应的数据条目 表格(数据收集工具)决定哪种数据分析 将有可能。

输入不等于输出

重要的是要了解数据输入表单或数据集 本身并不与基础数据值内在关联,并且 数据的含义仅由数据元素(及其元素 类别)。这使得修改数据集和表单非常安全 而不更改数据(只要数据元素保持不变)。 表格和数据之间的这种松散耦合使DHIS2在使用时更加灵活 涉及设计和更改新表格,以及准确提供 形成用户想要的形式。

仅将数据链接到数据元素而不链接到表单的另一个好处是, 是基于以下指标创建指标和验证规则的灵活性 数据元素,以及提供任何类型的输出报告(以枢纽 表格,图表,地图等),可以单独或跨多个数据组合 表格,例如关联来自不同健康计划的数据。由于 这种灵活的功能可以集成来自各种程序的数据 (表格)和来源(例行和半永久性(人口,员工, 设备))DHIS2数据库用作集成数据存储库 对于较大的HIS中聚合数据的许多或全部部分。该图 下面说明了这种灵活性。

![](资源/图像/data_dimensions/dhis_input_output.jpg)

在此示例中,我们看到来自多种形式的数据元素可以是 结合以创建给定的指标。举一个更具体的例子 可能会在年度数据集中收集“一岁以下的人口” 然后按地区收集数据,例如“完全免疫 在设施级别按月计算)。 我们可以得出有效每月人口的近似值, 并将其与完全 按月接种疫苗的儿童,有可能产生一个 指标“完全免疫覆盖率”,由总计 完全免疫的儿童总数除以有效儿童 每月人口。

数据元素和表格的扩展示例

下表将数据元素合并为两组诊断(全部 疾病)和发病率/死亡率(新病例,随访,转诊, 死亡),其数据元素类别为PHU /社区。死亡是 以其他尺寸(例如 PHU /社区)比发病率高。

此输出表结合了两个数据元素类别HIV _Age和 性别与数据元素组设置为ART Group。该组启用 登台和入口点小计,汇总了以下数据元素: 该组。年龄组和性别的小计将是其他 可能容易包含在此处的列。

这在数据透视表中如何工作

在Excel数据透视表或任何其他基于OLAP的数据中进行数据分析时 工具的尺寸变得非常强大,可以提供许多 对数据的不同看法。每个数据元素类别或组集 成为支点字段,选项或组成为其中的值 每个领域。实际上,类别和组集已得到处理 数据透视表中的方式完全相同,orgunits,句点和 数据元素。所有这些都成为了可以 用于重新排列,旋转,过滤和向下钻取数据。这里 我们将展示一些数据示例如何在数据透视表中使用 表。

以发病率和死亡率数据为例,数据透视表可以 展示如何使用维度来查看不同数据 聚合级别。

当没有任何枢纽字段时,将查看完全聚合的数字 在表区域中排列为列或行字段,但列出了 表本身上方的页面字段(过滤器)。

在这里,我们选择查看发病率总数。各种数据 发病率元素已被归入main _de _groups 发病率(稍后我们将回到死亡率)。上方的字段 表本身全部设置为“全部”,这意味着表中的总数 将包含来自所有国家,地区,酋长国,ou _type, 年,月,红色字段中列出的各种类别,以及 发病率组中的所有数据元素。

如我们所见,这不是一个非常有用的表示,因为发病率 分为新的案例,跟进,转诊,然后在 年龄组。另外,我们看不到各种诊断。第一步是 包括诊断字段(是一个组集),该操作由 将“诊断”字段向下拖动到一个行字段,如 下图,并在其中添加称为“发病率死亡率”的组 栏位栏位会显示新个案,跟进和转介。

将此图与下面的图进行对比。

它们都显示相同的数据(某些行已在 屏幕截图(取决于图片大小),尽管以其他方式。

  • 底部图中使用的“数据元素”字段显示每个 诊断为三个要素;一项跟进,一项新的跟进 推荐。这是在其中定义数据元素的方式 DHIS2,因为这对于聚合有意义。你不想 汇总的跟进和新的,因此这些没有作为 类别,重点是简化汇总和 分解。

  • 取而代之的是“诊断”组集,将这三个 (跟踪,新推荐),然后可以使用 另一组,即所谓的“发病率”。这个 允许我们像两个图中的第一个一样组织数据, 每行只有一次诊断,而新的是一组 后续,推荐为行。

使用组集的想法是,您可以将任何组组合在一起, 不同的数据元素。因此,如果我们添加死亡率数据(通过检查 从main _de _groups字段的下拉菜单中移动 表格中的此字段)我们还可以看到死亡人数,因为 死亡率数据元素已被列为“死亡”组 “发病率”组。结果如下所示。

结果是一个更加用户友好的数据透视表。现在,另一个数字 显示组集和元素之间的关系(这些是 假数据值)。

数据透视表的这一小细节显示了实际数据元素 链接到组集:

  • DHIS2中定义的四个数据元素是麻疹死亡, 麻疹跟进,新麻疹和麻疹转诊

  • 它们都属于“诊断”组 一起麻疹

  • 组集合“发病率死亡率”包含新病例组, 追踪,转介和死亡。

  • 只有麻疹死亡数据元素具有与组有关的数据 死亡,因此这是显示数据值(20)的位置 右上角。对于新的麻疹患者也是如此;值(224)为 显示在数据元素Measles new和 组新病例(在该组中确定发病率)

  • 数据元素未与 发病率分组保持空白。因此,在这种情况下,我们 如果我们从 桌子,刚诊断出来,小组确定了发病率, 如前图所示

Now lets see how the data element categories can be used. In the data entry form for Morbidity the new cases and follow-ups use one age category, the referral data another,, and the mortality data a third age breakup, so these are available as three individual age group fields in the pivot tables called morbidity_age, referrals_age and mortality_age. It doesn't make sense to use these while looking at these data together (as in the examples above), but e.g. if we only want to look at the only the new cases we can put the MobidityMortalityGroups field back up as a page field and there select the New cases group as a filter. Then we can drag the Morbidity_age field down to the column area and we get the following view:

下表说明了重用数据元素的好处 跨数据集和类别组合的类别。 VCCT,ART和 PMTCT数据收集在三个不同的数据集中,前两个 性别和年龄细分,以及仅PMTCT年龄(给出了性别)。 这三个人的年龄段相同,因此可以查看 同一表中所有这三个数据集中的数据元素并使用 年龄维度。在前面的例子中,发病率和死亡率 数据是不可能的,因为所有新病例,转诊和死亡 有不同的年龄段。

在下表中,PMTCT数据已从表中删除,并且 性别类别添加到列区域,以便您可以分析 VCCT和ART按年龄和性别分类的数据。性别的可选小计 也已添加,以及所有年龄段和 性别。

案例研究:从纸质表格到多维数据集-经验教训

通常,DHIS2数据集的设计基于某些要求 从已经使用的纸质表格中获取。纸质表格的逻辑是 与DHIS2的数据元素和数据集模型不同,例如经常 表格标题中的字段由列标题和 每行文字,有时还带有一些介绍性表格 提供更多上下文的标题。在数据库中捕获 一个原子数据元素,与视觉中的位置无关 表格格式,因此确保带有 可选的数据元素类别可捕获每个类别的全部含义 纸质表格中的单个字段。

设计数据集时要记住的另一重要事项是 数据集和相应的数据输入表单(这是一个数据集 (带有布局)是数据收集工具,而不是报告或分析 工具。还有其他更为复杂的工具可用于数据输出和 在DHIS2中进行报告,而不是在数据输入表中进行报告。纸质表格通常是 设计时要同时考虑数据收集和报告 您可能会看到诸如累积值之类的信息(除了 每月值),重复年度数据(相同的人口数据) 每月报告一次)甚至指标值,例如 与每月原始数据的格式相同。当您将原始数据存储在 DHIS2每个月都有您所需的所有处理能力 不需要电脑工具(实际上这是愚蠢的,大多数 可能导致不一致)注册手动计算的值,例如 如上所述。您只想捕获原始数据 您的数据集/表格,并将计算结果留给计算机,以及 将这些价值呈现给报表工具 DHIS2。

从表格到类别组合-设计多维数据集

正如我们在上面的示例中看到的,数据元素类别和 类别选项在添加时有助于表示表格数据 纸张形式的字段的尺寸。我们还看到了数据 元素是描述DHIS2中数据的必需维度之一。 正如我们将在下面的示例中看到的那样,通常有不止一种方法可以 代表DHIS2中的纸质表格,可能很难知道哪个 用数据元素名称表示和表示的维 作为类别,甚至如上所述的分组。这里有一些 从使用数据元素和类别中学到的一般经验教训 组合:

  • 在设计维度时,请牢记数据用途,而不是数据收集。 这意味着在收集时分解数据值 应该容易地沿各个维度进行汇总,例如 加起来是有意义的总数。

  • 尽可能重复使用尺寸,因为这样可以提高功能 比较分类数据(例如年龄段,固定/外展, 性别)。

  • 分解维度之和应为总计。在某些 在这种情况下,数据元素可以被收集为彼此的子集。在 在这种情况下,应使用类别来分解数据元素 不被使用。例如,我们可能会收集“已确认的数量 疟疾病例”,并按“ 5岁以下”和“ 5岁以上”分类。 第三个数据元素“ 1岁以下已确认的疟疾病例数”可能 表单上也存在。然后创建似乎合理 三个年龄段:1岁以下,5岁以下和5岁以上来描述 分解。但是,未满1岁的孩子实际上是 未满5岁的儿童,总计时,将导致重复。从而, 类别通常应由互斥组成 类别选项,例如各个类别选项的总和 产生一个连贯的总数。

  • 不同级别的尺寸; 1)分类和2)分组。 分解维度决定了您如何收集以及如何详细 您会存储数据,因此请仔细计划。组维度为 更加灵活,即使在数据之后也可以更改和添加 集合(将其视为标记)。

  • 最好考虑一下如何将数据用于集成 数据存储库,而不是如何在表单上实际收集它 或在设计元数据模型时通过程序执行。理想情况下,相同 跨表格和数据集应使用分解类型 数据元素将被一起分析或用于构建 指标。重用定义,以便数据库可以集成 即使表单本身可能是重复的( 实践,通常是这样)。

为了更好地解释我们介绍的方法和可能性 纸质表格示例,并将逐步进行设计 数据元素,类别,类别选项和类别组合。

此表单有很多表,每个表都可能代表一个数据 元素类别组合(此后称为Catcombo)。如 这样对数据集就没有限制,只有一个 尺寸或Catcombo,它可以有很多,正如我们在上面看到的那样 由于表格之间的尺寸差异很大,因此有必要。在 在下面的段落中,我们将分析如何分解这种形式 到其组成部分中,并提出实施途径 DHIS2。

** ANC表**。左上角的这张桌子是比较简单的一张 以这种形式。它具有两个维度,第一列带有ANC 活动或服务(第一次访问,IPT第二次剂量等),第二次和 第三栏代表提供服务的地方 两个选项:“固定”和“外联”。由于ANC服务是关键 现象在这里进行分析,通常需要查看 不论“ ANC第1次访问”的实际位置如何, 使用此维度作为数据元素非常有意义 尺寸。

Thus, all items on the first column from "1 st ANC" visit to "2 nd IPT dose given by TBA" are represented as individual data elements. The where dimension is represented as a data element category (from now on referred to as category) with the name "fixed/outreach" with the two data element category options (from now on catoptions) "fixed" and "outreach". There is no other dimension here so we add a new catcombo with the name "Fixed/Outreach" with one category "Fixed/Outreach". Strictly speaking there is another dimension in this table, and that is the at PHU or by TBA dimension which is repeated for the two doses of IPT, but since none of the other ANC services listed have this dimension it does not seem like a good idea to separate out two data elements from this table and give them another catcombo with both fixed/outreach and at PHU/by TBA. reusing the same catcombo for all the ANC services makes more sense since it will be easier to look at these together in reports etc. and also the fact that there is not much to lose by repeating the at PHU or by TBA information as part of the data element name when it is only for four data elements in a table of eleven data elements.

**交货表。**此表比较棘手,因为它有很多 信息,您会看到并非所有行都具有相同的列 (某些列将合并,并且一个字段将变灰/禁用。)。要是我们 首先看一看“协助运送”一栏 只能是一维,但只能向下到“未经训练的待定”行, 其余三行与谁协助交付 所有。另一个方面是交货地点,无论是在PHU中还是在 顶列标题中所述的社区。这些交付是 进一步分为交付结果,无论是现场直播还是现场直播 仍然出生,这似乎是另一个层面。所以如果我们无视 暂时排在最下面的三排,这里似乎有3个尺寸,1) 2)分娩地点,以及3)分娩结果。钥匙 决定要使用什么作为数据元素,主要维度, 您最常使用并希望在其中轻松获得的总数 报告和数据分析。

在这种情况下,结果维度为“活产总数” 许多指标的常用值(孕产妇死亡率,出生率 由熟练的卫生人员参加)。在这种情况下, 按“维度也可以毫无问题地使用,但是 轻松获得活产婴儿总数信息的附加价值是 对我们而言至关重要的一点。这意味着从该表(或 第1至6行)只有两个数据元素; “活产”和“仍然 出生”。

接下来,还有两个维度,“ PHU /社区”及其两个维度 选项和“参加的生日”以及选项(“ MCH助手”,“ SECHN”, “助产士”,“ CHO”,“训练有素的TBA”,“未训练的TBA”)。这两个类别 组成分配给两个数据元素的组合“出生” “活产”和“静止产”。考虑到最后三行 交货表,我们可以看到“复杂交货”没有 有维度的帮助,但有地方和结果。 “低 出生体重”也没有维度的帮助,而不是 结果还是。交货后提供的LLITN没有任何信息 完全没有额外的尺寸。由于三行中的任何一行都不能共享 catcombo与任何其他行一样,我们决定将这些字段表示为 称为平面数据元素,表示在以下位置没有类别的数据元素 全部,只需在列中添加其他信息 数据元素名称的标题,因此以 跟随具有默认(与否相同)catcombo的数据元素; “ PHU活产中的复杂分娩”,“ PHU仍在分娩”,“社区活产中复杂的分娩”, “社区死胎中的复杂分娩”,“ PHU”,“社区低出生体重”和“分娩后给予LLITN”。

** NAT-NATAL CARE表**此表很简单,我们使用了相同的表 方法与ANC表相同。第一个列出了3个数据元素 列,然后将其链接到称为“固定/外展”的类别组合。 对这些数据元素重新使用相同的固定/扩展类别将启用 使用ANC数据和其他数据进行固定/外展分析 同一类别。

** TT表**此表比以前的表复杂一些 我们决定使用“ TT1”,“ TT2” ...“ TT5”作为数据元素 可以很容易地获得每一个的总数。有 固定/扩展维度,但也有“在学校内” 仅适用于非孕妇,或更正确地适用于 这两个作为学校免疫接种是否女孩 怀孕与否。我们咨询了表格后面的计划人员,并 发现可以将所有学校TT免疫接种注册为 非怀孕的,这可以简化模型,因为我们可以重复使用 “ TT1”至“ TT5”数据元素。所以我们最终得到了一个新类别 具有三个选项(固定,外展,在校)的“ TT地点”,以及 另一个类别称为“怀孕/非怀孕”,其中有两个选项。的 然后,新的Catcombo“ TT”是这两者的组合,并应用于 5个TT数据元素。由于我们同意将所有在校免疫接种 “非怀孕于”下的是指选项的组合(“怀孕+入 学校)将永远不会以任何数据输入形式使用,因此成为 可能的optioncombo,可以。只要表格是自定义的 设计之后,您可以选择要使用的选项组合或 不会,因此拥有这样的被动或未使用也不是问题 catoptions。在TT地点类别中将学校作为一种选择 简化了模型,因此我们认为这是值得的。的 替代方法是为“学校中的TT1”再创建5个数据元素 ...“ TT5 in school”,但添加这些内容会有些混乱 连同“ TT1” ...“ TT5”以及TT Catcombo。作为一个学校 TT位置类别中的位置可以更轻松地获得总分 给出了TT1..TT5疫苗,这是最重要的数字和最 经常用于数据分析的值。

早孕和晚期妊娠并发症及分娩 将这两张表合二为一,并说明原因。这两个表是一个 有点令人困惑,而不是最好的设计。最重要的数据来了 这些表中是怀孕并发症和孕产妇 死亡人数。这些数据元素包含有关导致问题的更多详细信息 并发症或死亡(两个表格的第一列),以及 死亡地点(在PHU或社区),以及并发症的结果 (如果不是死亡的话)可以是“在PHU管理”或“ 我们决定为这两个表创建两个数据元素。 “妊娠并发症”和“孕产妇死亡”两类 组合,每个数据元素一个。对于怀孕 并发症数据元素还有两个附加维度, 并发症的原因(合并后第一列的列表 两个表格)和结果(由PHU或“已转介”管理),因此这些是 组成该类别组合的类别和选项。对于 “孕产妇死亡”数据元素同类别与不同 使用原因,然后使用另一类死亡地点(在PHU中 或在社区中)。这样,两个数据元素可以共享一个类别 这样很容易得出怀孕总数 并发症和产妇死亡。虽然清单上的并发症 您可以看到纸质表格分为两个(早工和晚工) 那例如第2和第3个月的疟疾列在早期, 但实际上是在怀孕后期。没有明确的 区分早期和晚期并发症的形式,因此 我们放弃了尝试在数据库中做出这种区分。

**计划生育服务表**此表有2个维度, 计划生育方法(避孕方法)以及客户是新客户还是新客户 继续。我们只得到了一个数据元素“计划生育 客户”,然后添加两个类别的“ FP方法” 避孕药作为选项,另外一个类别“ FP客户类型” 新的或继续的选项。这样很容易获得总数 计划生育客户的数量是要看的主要价值 数据分析,从那里您可以轻松获得方法的详细信息 或有多少新客户。

设计数据集的分步方法

  1. 识别纸质表格中的不同表(或子数据集) 具有相同的尺寸

  2. 为每个表标识描述数据字段的维

  3. 确定关键维度,最有意义的维度是 孤立地(当其他人崩溃时,总结)。这是 您的数据元素维度,起点和核心 多维模型(子数据集)。数据元素维可以 如果两个或更多个维度的合并更有意义, 数据分析。关键是要确定哪个构成最多 当其他维度崩溃时,要独自看待。

  4. 对于所有其他/其他维度,请确定其选项,然后 以及尺寸及其选项的解释性名称。

  5. 这些其他维度中的每一个都是数据元素类别 并且它们的选项将是类别选项。

  6. 将每个子数据集的所有类别合并为一个类别 组合并将其分配给表中的所有数据元素 (或子数据集,如果您愿意)。

  7. When you are done with all the tables (sub datasets), create a 新数据集并添加您已识别的所有数据元素(在 整个纸质表格)。

  8. Your dataset will then consist of a set of data elements that 链接到一个或多个类别组合。

附加数据维度

关于其他数据维度

DHIS2 has the ability to add dimensions to data in addition to what was described in the previous chapter. We will call these dimensions “attribute categories” (ACs). The categories described in the previous chapter we will call “disaggregation categories” (DCs) to differentiate them from ACs.

ACs and DCs are quite similar—they work in much the same way, are accessed through the same part of the maintenance interface, and exist in the same part of the database. The main difference between them is what they are connected to. A DC is attached to a data element; however, an AC is attached to a data set. This means values for all DC options can be entered on the same data entry screen, whereas you must choose the AC option before you begin to enter data.

在设置系统时,您可以仅使用DC而不考虑AC 共。但是,AC是简化数据输入屏幕或 减小类别选项组合的叉积的大小。

Tip

When you’re deciding which categories should be DCs and which should be ACs, here’s a good rubric:

  • Use DCs when you want to use different combinations of categories on different data elements within a data set

  • Use DCs when you want to enter all the category option combinations on one data entry screen

  • Use ACs when you want to use the same combination of categories for all the data in a data set

  • Use ACs when you want to enter only one category option combination on one data entry screen

While we referred to DCs as part of the what dimension for simplicity in the former chapter, it’s actually more complex. Either DCs or ACs can answer any question about a data element, including what (of course), who , why , how , or even a where or a when beyond the organisation unit and period dimensions.

创建或编辑属性类别及其选项

The process of creating an attribute category as well as its options and combinations, is discussed in the section Manage categories . As noted there, disaggregation categories are configured by editing a data element and attribute categories are configured by editing a data set.

具有分类类别和属性类别的数据输入

When entering aggregate data, one must first choose the attribute categories, and then one can enter the data across disaggregation categories on a single page.

For instance, in the graphic below, the attribute categories are Implementing Partner (AIDSRelief Consortium) and Project (Improve access to medicines). The disaggregation categories are gender (male/female/etc.), age (<15, 15-24, 25-49, >49).

具有分类类别和属性类别的分析

In order to do analysis with disaggregation and attribute categories, check the “Data dimension” box in the category editing screen of the Maintenance app, as discussed in Create or edit a category .

具有属性类别的批准

To include attribute categories in approvals, create a category option group that contains the same category options as the attribute category. Then create a category option group set and add that the category option group set as a data approval level.

This is covered in more detail in the section Approving by category option group set and Approving by multiple category option group sets .

属性类别和数据值表

For some, the way attribute categories work with disaggregation categories is clearer when we look at how the data values are stored in DHIS2’s database. If diving into the database internals doesn’t help you understand how the different types of categories work together, please feel free to ignore it.

Each data value is associated with a data element, a period, and an organisation unit, which are represented in this way:

dataelementid

periodid

sourceid

(请注意,这些是数字数据库ID,而不是DHIS2 uid。)

And of course, each data value has a value, adding the value column to the database:

dataelementid

periodid

sourceid

value

Each data value also references the disaggregation category options and the attribute category options assigned to it. For instance, in the example above, the data value entered in the box “Male <15” will have the option “Male” for the disaggregation category gender , and the option “<15” for the disaggregation category age . The combination of these two options is represented in the database by a single category option combination meaning “Male, <15”. The data value references this disaggregation category option combination in the categoryoptioncomboid :

dataelementid

periodid

sourceid

value

categoryoptioncomboid

Likewise, the same data value will have the option “AIDSRelief Consortium” for the category Implementing Partner , and the option “Improve access to medicines” for the category Project . There will also be a database category option combination meaning “Implementing Partner, Improve access to medicines”. The data value references this attribute category option combination in the attributeoptioncomboid :

dataelementid

periodid

sourceid

value

categoryoptioncomboid

attributeoptioncomboid

Note

The above column list does not include all of the columns in the datavalue table.

If you have not defined a disaggregation category combination for a data element, the categoryoptioncomboid will reference a “default” category option combination, which is defined internally in DHIS2 as the category default with the option default (the only option in the default category). Likewise, if you have not defined an attribute category combination for the dataset in which you enter the data, the attributeoptioncomboid references the same “default” category option combination.

We hope this investigation of how data values are stored in DHIS2’s database makes it clearer how data values can be associated with various groups of category options, both from disaggregation categories and attribute categories.

关系模型

关系表示跟踪器模型中两个实体之间的链接。关系被视为DHIS2中的数据,并且基于关系类型,类似于被跟踪实体实例基于被跟踪实体类型的方式。

关系始终包括两个实体,并且这些实体可以包括“跟踪的实体实例”,“注册”和“事件”,以及这些的任意组合。请注意,当前应用程序中并非所有这些组合都可用。

另外,关系可以定义为单向或双向。 唯一的功能差异是当前这些功能需要不同的级别 创建的权限。单向关系要求用户拥有数据 对“从”实体的写访问和对“至”实体的数据读访问, 双向关系需要双方的数据写访问权限。

关系类型

关系类型是关系具有的属性的定义。 关系始终包含两个方面,分别称为“从”和“到”,以及 每边可以包含哪些实体由关系确定 类型。确定每个属性可以包含的属性称为 约束,分别来自fromConstraint和toConstraint。这些约束是 在以后处理数据时很重要,以了解之间的关系 可以也不能包含。

关系类型中定义的每个约束都包含几个 属性。主要属性是关系实体,它决定什么 关系可以包含的一种实体。实体可以是 每个约束如下:

  • 跟踪实体实例
  • 注册
  • 事件

根据您选择的关系实体的类型,可以选择 每个约束的其他限制。下表说明了 您可以配置不同的组合:

跟踪实体实例 注册 事件
追踪实体类型 需要 可选的 --
程序 -- 需要 --
程序阶段 -- 需要 可选的

这些额外的限制要求实体匹配限制 在创建之前进行设置。例如,如果您的关系是 母亲和孩子,两个约束都将具有所需的跟踪实体 将类型设置为“人”,并且可以选择将“入学率”设置为“孕产妇健康” 程序和子程序。这样,仅跟踪实体实例 属于“人”类型并且已注册所需程序的人员 被包括在这些关系中。

除了关系类型可以具有的约束外,每个关系 可以设置为双向,真或假。如果该属性设置为false,则 关系被视为单向的。如前所述,唯一 这些关系之间的功能差异是访问的严格程度 创建或更新它们时-双向是最严格的。人际关系 根据关系是否在UI中呈现不同 是双向或单向的。

关于双向关系要注意的一件事是 “从”和“到”两面在数据库中仍然很重要,这意味着每个实体 必须匹配该侧的约束。但是,从用户角度来看, 在每个方面,每个实体的存储都是无关紧要的。

DHIS2词汇表

A

Aggregation
In the context of DHIS2, aggregation refers to how data elements are combined within a particular hierarchical relationship. As an example, all the health facilities in a particular district would contribute to the total value for the particular district in question. Different aggregation operators are supported within DHIS2, such as SUM, AVERAGE, and COUNT.
Analytics

Analytics refers to the process which processes and prepares data which has been entered into DHIS2 into a format which is more suitable for retrieving indicators and aggregated data. When data is entered into DHIS2, it is stored in a format which is optimized for writing the data. However, when data needs to be processed into indicators or aggregated (e.g from months to quarters), it is more efficient to transform and store this data in a different format which is optimized for read-only operations. The analytics system of DHIS2 is used extensively by the analytics apps (GIS, Pivot Table, Event reports, etc.).

It is important to keep in mind that because the data which has been entered into DHIS2 must be processed into the analytics format, the data which appears in the analytics apps only represents the data which was present in the system the last time analytics was run. If data has been entered after that, analytics will need to be run again for this data to appear in the analytics apps.

Aggregate data
In the context of DHIS2, aggregate data refers to either data elements or indicators that have been derived from other hierarchical data sources. For instance, aggregate facility data would result from the aggregate totals of all patients that have attended that facility for a particular service. Aggregate district data would result from the aggregate totals of all facilities contained with a particular district.
Application programming interface
An application programming interface is a specification of how different software components should interact with each other. The DHIS2 API (or WebAPI) can be used to interface DHIS2 with other software, to build reports or custom data entry forms.
Approvals

Approvals can be used to control the visibility and editibility of data. When data is submitted from the lowest reporting level, it can be approved by the next higher level. This approval has two effects:

  1. Data is no longer able to be edited in the data entry screens at the lower level.

  2. Depending on the system settings which have been enabled, the data will become visible at the approval level.

As an example, data is entered at the facility level, and the submitted for approval. Once the data has been approved at the district level, the data will become locked in the data entry screens for the facility level. It will also become visible in the analytics apps to district users.

B

Bi-monthly
Refers to a two-month period, such as January 1 st to February 28 th .

C

Category
Categories are groups of category options. The are used in combinations to disaggregate data elements. Categories are typically a single type of concept, such as "Age" or "Gender".
Category combinations
Category combinations are used to disaggregate data elements. As an example, the data element "Number of confirmed cases of malaria" could be disaggregated subdivided into to categories: "Age" and "Gender". In turn each of these categories, would consist of several category options, such as "Male" and "Female" for the gender category. Category combinations may consist of one or several categories.
Category combination options

Category combination options are dynamically composed of all of the different combinations of category options which compose a category combination. As an example, two categories "Gender" and "Age", might have options such as "Male" or "Female" and "<5 years" or ">5 years". The category combination options would then consist of:

  • Male <5 years
  • Male >5 years
  • Female <5 years
  • Female >5 years
Category option
Category options are atomic elements that are grouped into categories.
Comma separated values
Comma separated values are series of tabular data stored in a plain-text format. They are commonly used with DHIS2 to export and import data values.

D

Data dictionary
A collection of data elements and indicators, which can be exchanged with other DHIS2 systems. Typically used to define a set of data elements and indicators when setting up the DHIS2 system.
Data exchange format
In the context of DHIS2, the "data exchange format" refers to a XML schema that enables the transportation of data and meta-data between disconnected DHIS2 instances, as well as between different applications that support the DXF schema.
Datamart
A set of database tables in DHIS2 that contains processed data elements and indicator values that is generated based on aggregation rules and calculated data element and indicator formulae. Datamart tables are used for analysis and report production. Typically, users should not work directly with unaggregated data values, but rather with values that have resulted from a datamart export for analysis.
Data element
A data element is the fundamental building block of DHIS2. It is an atomic unit of data with well-defined meaning. Essentially it is a data value that has been actually observed or recorded which is further characterized by a number of dimensions. As an example the data element "Number of fully immunized children" would refer to the number of children that received this particular service. Data elements are always linked to a period as well as an organizational unit. They optionally may be linked to other dimensions.
Data element group
Data element groups are used to categorize multiple data elements according to a common theme, such as "Immunization" or "ART". Typically, they are used during reporting and analysis to allow related data elements to be analysed together.
Data element group sets
Data element groups are used to categorize multiple data element groups into a common theme.
Dimension
A dimension is used to categorize data elements during analysis. Dimensions provide a mechanism to group and filter data based on common characteristics. Typically, related data elements may be aggregated or filtered during analysis with the use of dimensions. Dimensions may be a member of a hierarchy. For instance the "Period" dimension may be broken down into "Day->Month->Quarter->Year".

DXF

H

Health management information system
Typically, an electronic database system that is used to record aggregated data on service delivery, disease incidence, human resource data and other information used to evaluate the performance of delivery of health services. Typically, an HMIS does not contain the highly detailed data of electronic medical record systems or individual patient data.

I

Indicator

The divisor of an indicator. Can be composed of multiple data elements with the use of an indicator formula.

Indicator = {\frac{Numerator}{Denominator}}

This is obviously a very generalized example. The numerator and indicator themselves can be composed of various data elements, factors, and the four basic operands (addition, multiplication, division and subtraction).

N

Numerator
The dividend of a indicator. Can be composed of multiple data elements and factors with the use of indicator formulas.

O

Organisational unit
An organisational unit is usually a geographical unit, which exists within a hierarchy. As an example, in the United States, "Georgia" would be considered an organisational unit with in the orgunit level of "State". Organizational units can also be used to specify an administrative unit, such as a ward within a hospital. The organisational unit dimension specifies essentially where a particular data value occurs.
Organisational unit level
Refers to a level within an organizational hierarchy. Typically, countries are administered at different levels, such as 1) Country 2) States 3) Counties 4) Health facilities. In the context of DHIS2, health facilities typically are the lowest orgunit level. Data is aggregated upwards from the lowest orgunit level to the highest.

P

Period
A period is a specific time interval which consists of a start date and end date. For instance "January 2011" would refer to the time interval of January 1 st 2011-January 31 st 2011.

U

Unique identifier
A unique identifier (UID) is a semi-random series of letters and numbers used by DHIS2 to identify specific resources. UIDs begin with a letter, and are followed by exactly 10 letters or digits.

About demo server, D2 cluster and database design

使用DHIS2演示服务器

DHIS2团队在以下位置维护演示服务器 https://play.dhis2.org/demo 。到目前为止,这是最简单的尝试方法 DHIS2。只需在Web浏览器中打开链接并使用用户名登录 =管理员和密码=区。

注意

该服务器上的所有更改每晚都会删除,因此请不要保存任何更改 在此服务器上的重要工作。严格用于示范 仅用于目的\!

Spinning up a local DHIS2 instance using D2 Cluster

Running D2 Cluster

Using Docker containers to run a d2 cluster is an easy way to get started with DHIS2 on your local computer. This approach is appropriate for a stand-alone installation and demos. Simply follow the guide here .

Prerequisites to running D2 Cluster

You must be sure that you have installed Yarn and Nodejs . A current version of Docker must be installed on your machine as well. Please refer to the guide for detailed information.

下载并安装服务器版本

可以从此处下载最新的稳定服务器版本 [网站]( http://stable.dhis2.org/ )。有关如何的详细信息 安装它,请参阅 实施手册。

登录到DHIS2

Regardless of whether you have installed the server version or ran a DHIS2 instance locally, you will use a web-browser to log on to the application. DHIS2 should be compatible with most modern web-browsers, although you will need to ensure that Java Script is enabled.

要登录到应用程序,请输入 http://localhost:8080/dhis 您正在使用DHIS2 live软件包,或将 localhost 替换为 安装服务器版本的服务器的名称或IP地址。

在线或脱机启动DHIS2后,将显示 屏幕将提示您输入注册的用户名和密码。 输入所需信息后,单击登录按钮进行登录 进入应用程序。默认的用户名和密码为“ admin”, '区'。在第一次登录时应立即更改它们 时间。

您可以从菜单中选择想要显示DHIS2的语言。 屏幕底部的“更改语言”对话框。不是全部 语言可能可用。

如果您忘记了密码,可以点击“忘记了 密码?”链接。您必须已将您的电子邮件地址和 服务器必须正确配置为发送电子邮件。

如果要创建自己的帐户(和服务器管理员 允许),只需点击“创建帐户”并按照说明进行操作 提供。

登录DHIS2后,请参考本节中的特定部分。 可用的不同功能的手册。

注销DHIS2

只需单击配置文件,然后单击右上角的“注销” DHIS2菜单中的。

设计DHIS2数据库快速入门

DHIS2 provides a powerful set of tools for data collection, validation, reporting and analysis, but the contents of the database, e.g., what to collect, who should collect it and on what format will depend on the context of use. However, in order to do anything with DHIS2, you must first create meta-data. Meta-data, or data about the data, describes what should be collected (data elements and categories), where it should be collected (organisation units) and how frequently it should be collected (periods). This meta-data needs to be created in the DHIS2 database before it can be used. This can be done through the user interface and requires no programming or in-depth technical skills of the software, but does require a good understanding of the processes which you are trying to collect data form.

本节将对DHIS2进行非常简短的介绍。 数据库设计,主要说明准备数据库所需的各个步骤 新的DHIS2系统供使用。每个步骤的执行方法均在其他部分进行了说明 有关设计选择的章节和最佳做法将在 实施者手册。以下是要遵循的步骤:

1 \。建立组织层次结构

2 \。定义数据元素

3 \。定义数据集和数据输入表格

4 \。定义验证规则

5 \。定义指标

6 \。定义报告表和设计报告

7 \。设置GIS模块

8 \。设计图表并自定义仪表板

组织层次结构

The organisational hierarchy defines the organisation using the DHIS2, the health facilities, administrative areas and other geographical areas used in data collection and data analysis. This where dimension to the data is defined as a hierarchy with one root unit (e.g., Ministry of Health) and any number of levels and nodes below. Each node in this hierarchy is called an organisational unit in DHIS2.

此层次结构的设计将确定 在收集和汇总数据时可供用户使用的分析 这种结构。只能有一个组织层次结构 同时,其结构需要仔细考虑。额外 层次结构(例如,平行的行政分组,例如“ 所有权”)可以使用组织组和组集进行建模, 但是组织层次结构是数据的主要载体 地理维度上的汇总。通常是国家 公共卫生中的组织层次结构有4-6级,但是任何 支持级别数。层次结构是由父子构成的 关系,例如国家或卫生部(根)可能有8 上级单位(省),每个省(级别2)可能会再次 有10-15个地区作为他们的孩子。通常情况下,卫生设施 将位于最低层,但也可以位于 更高的水平,例如偏斜的国家或省级医院 支持组织树(例如,可以定位叶节点 处于第2级,而其他大多数叶节点处于第5级)。

通常,由健康定义一个地理层次结构 系统。例如行政办公室所在的位置(例如卫生部, 省,区),但通常还有其他行政区域 在可能添加或可能不添加的国家/地区中,具体取决于其添加方式 边界将改善数据分析。设计层次结构时 任何组织单位的孩子人数可能表明 结构的实用性,例如具有一个或多个1-1关系 在两个级别之间不是很有用,因为对于 子级和父级。在另一个极端上,这个数字很高 等级中间的儿童数量(例如,一个地区的50个地区 省)可能需要在之间添加一个附加级别 增加数据分析的实用性。最低水平,健康 设施通常会有大量的孩子(10-60岁),但是对于 层次结构中更高的其他级别。 5-20个孩子是 推荐的。太少或太多的孩子可能表明该水平 应该删除或添加。

请注意,很容易更改 在稍后的阶段,唯一的问题是改变组织 收集数据的单位(叶节点),例如分裂或合并 卫生设施。层次结构的汇总基于 随时可以使用当前的层次结构,并且将始终反映最新的层次结构 组织结构的变化。请参阅以下章节 组织单位,以学习如何创建组织单位并 建立层次结构。

数据元素

The Data Element is perhaps the most important building block of a DHIS2 database. It represents the what dimension, it explains what is being collected or analysed. In some contexts this is referred to an indicator, but in DHIS2 we call this unit of collection and analysis a data element . The data element often represents a count of something, and its name describes what is being counted, e.g. "BCG doses given" or “Malaria cases”. When data is collected, validated, analysed, reported or presented, the data elements or expressions built upon data elements describes what the data is. As such the data elements become important for all aspects of the system and they decide not only how data is collected, but more importantly how the data values are represented in the database, which again decides how data can be analysed and presented.

It is possible to add more details to this what dimension through the disaggregation dimension called data element categories. Some common categories are age and gender, but any category can be added by the user and linked to specific data elements. The combination of a data element's name and its assigned category defines the smallest unit of collection and analysis available in the system, and hence describes the raw data in the database. Aggregations can be done when zooming out of this dimension, but no further drill-down is possible, so designing data elements and categories define the detail of the analysis available to the system (on the what dimension). Changes to data elements and categories at a later stage in the process might be complicated as these will change the meaning of the data values already captured in the database (if any). So this step is one of the more decisive and careful steps in the database design process.

设计数据元素时的一种最佳实践是考虑数据 元素作为数据分析的一个单元,而不仅仅是数据中的一个字段 收集表格。每个数据元素都独立存在于数据库中, 完全脱离收集表格,报告和其他 输出基于数据元素和由以下内容组成的表达式/公式 数据元素而不是数据收集表单。所以数据分析 需求应该驱动流程,而不是数据的外观 收集表格。一个简单的经验法则是数据的名称 元素必须能够独立运行并描述数据值 也在其收集形式的范围之外。例如。数据元素 无论是在“ “ RCH”形式或“ OPD”形式,但就其本身而言并非唯一 描述现象(被引荐给谁?),而应改为 称为“来自孕妇的总推荐数”或“来自OPD的总推荐数”。 两个不同的数据元素具有不同的含义,尽管该字段 纸质表格上的用户只能说“总推荐人”,因为 表格将始终知道这些引用来自何处。在数据库中或 数据元素存储库,此上下文不再有效,并且 因此,数据元素的名称在 描述数据。

数据元素的通用属性可以通过什么来建模 称为数据元素组。这些小组在 感觉它们是由用户定义的,包括其名称和名称 会员资格。组对于浏览和显示相关信息均有用 数据,但也可以用于将数据元素聚合在一起。团体 松散耦合到数据元素,而不直接绑定到数据 值,这意味着它们可以在任何时间点进行修改和添加 而不干扰原始数据。

数据集和数据输入表格

DHIS2中的所有数据输入都是通过使用数据集来组织的。一种 数据集是为数据分组在一起的数据元素的集合 集合,并且在分布式安装的情况下,它们还定义了 在DHIS2实例之间导出和导入的大块数据(例如 从地区办公室本地安装到国家服务器)。 数据集不直接链接到数据值,而仅通过它们 数据元素和频率,因此可以修改数据集, 随时删除或添加而不影响原始数据 已经被系统捕获,但是这种变化当然会影响 如何收集新数据。

数据集具有控制数据收集的期间类型 频率,可以是每天,每周,每月,每季度,每六个月, 或每年。数据集中要包含的数据元素和 时段类型由用户定义,并带有名称,简称, 和代码。

为了使用数据集收集特定组织单位的数据,您需要 必须将组织单位分配给数据集,并且该机制控制 哪些枪支可以使用哪些数据集,并同时定义 数据完整性的目标值(例如,多少医疗机构 预计每个月都会提交RCH数据的地区)。

一个数据元素可以属于多个数据集,但这需要 仔细思考,因为这可能导致重叠和不连续的数据 如果例如收集数据集被赋予不同的频率,并且 由相同的枪械使用。

数据输入表

将数据集分配给组织单位后,将创建该数据集 可在您拥有的orgunits的Data Entry(在Services下)中找到 根据数据集将其分配给有效期 期间类型。然后将显示一个默认的数据输入表单,该表单是 只是属于数据集的数据元素的列表 带有用于输入值的列。如果您的数据集包含数据 类别,例如年龄段或性别,再加上其他元素 列将基于默认格式自动生成 类别。除了默认的基于列表的数据输入表单 还有两种选择,基于节的表单和自定义表单。

部分表格

截面表单在使用时提供了更多的灵活性 表格形式,设计快速简单。通常您的数据输入 表单将需要多个带有副标题的表,有时您需要 禁用(灰显)表中的某些字段(例如,某些类别 不适用于所有数据元素),这两个功能均受支持 部分形式。定义数据集后,您可以定义它的部分 带有数据元素的子集,标题和可能的灰色字段 部分的表格。也可以定义数据集中各部分的顺序。 在“数据输入”中,您现在可以开始使用“部分”表单(应显示 当部分可用于所选数据集时自动显示)。您 可以在默认格式和部分格式之间切换 数据输入屏幕。大多数表格数据输入表格都应该可行 与节形式有关,您可以利用该节更多 表单(或默认表单)对您来说越容易。如果这两种类型 表格不符合您的要求,那么第三个选择是 完全灵活,但更耗时的自定义数据输入 形式。

自订表格

当您要设计的表单对于默认表单而言过于复杂时 部分表格,那么您最后的选择是使用自定义表格。这需要 更多的时间,但在设计方面为您提供了充分的灵活性。在 DHIS2有一个用于表单设计器的内置HTML编辑器(FcK编辑器) 您可以在用户界面中设计表单,也可以粘贴到HTML中 直接使用编辑器中的“源”窗口。在自定义表单中,您 可以插入静态文本或数据字段(链接到数据元素+ 类别)在表格上的任何位置,您有完全的自由 设计表单的布局。将自定义表单添加到 数据集,它将在数据输入中可用并自动使用。您 可以切换回默认值,并且顶部的部分(如果存在)形式 数据输入屏幕的右上角。

验证规则

设置完系统的数据输入部分并开始 收集数据,然后有时间定义有助于质量的数据质量检查 以提高所收集数据的质量。您可以添加尽可能多的 您喜欢的验证规则,这些规则由左和右组成 副表达式又由数据元素组成,带有 双方之间的运算符。典型规则是将小计与 总的东西。例如。如果您有两个数据元素“艾滋病毒检测 ”和“艾滋病毒检测结果呈阳性”,那么您知道 表格(同一时期和组织单位)的总数 测试必须始终等于或高于肯定测试的数量。 这些规则应该是绝对规则,这意味着它们是 数学上正确,而不仅仅是假设或“大部分时间 正确”。可以在填写每个表格后在数据输入中运行规则, 或同时处理多种形式的批量处理,例如 适用于上一个报告月份的所有设施。结果 测试将列出所有违规行为以及每个方面的详细值 发生违规的表达式可以很容易地返回 进行数据输入并更正值。

指标

指标可能代表了最强大的数据分析功能 DHIS2。虽然数据元素表示原始数据(计数) 收集的指标代表提供覆盖率的公式, 发生率,比率和其他基于公式的分析单位。一个 指标由一个因素(例如1、100、100、100 000), 分子和分母,后两者都是基于表达式的 一个或多个数据元素上。例如。指标“ BCG覆盖 <1年” 被定义为一个因子为100的分子(分子的“ BCG剂量 1岁以下的儿童”)和分母(“ 1岁以下的目标人群” 年”)。指标“ DPT1到DPT3的辍学率”是一个100%的公式 x(“给定DPT1剂量”-“给定DPT3剂量”)/(“给定DPT1剂量”)。

DHIS2中的大多数报告模块都支持数据元素和指标 您也可以将它们合并到自定义报告中,但是重要的是 指标与原始数据的差异和强度(数据元素的 数据值)是比较不同数据的能力 地理区域(例如人口稠密地区与农村地区)作为目标 分母可以使用分母。

指标可以随时添加,修改和删除 而不干扰数据库中的数据值。

报告表和报告

DHIS2中的标准报告是一种非常灵活的数据呈现方式 已收集。数据可以由任何组织汇总 单位或组织单位级别,按数据元素,按指标以及以上 时间(例如每月,每季度,每年)。报告表是自定义的 标准报告的数据源,并且可以在 用户界面,以后可以在外部报表设计器中访问,例如 iReport或通过自定义HTML报告。然后可以将这些报告设计 设置具有参数的易于访问的一键式报告,以便 用户可以运行相同的报告,例如每个月都有新数据 输入,并且与所有级别的用户相关,因为 可以在运行报告时选择组织单位。

地理信息系统

在集成的GIS模块中,您可以轻松地在地图上显示数据, 既在多边形(区域)上,又在点(健康设施)上,以及 作为数据元素或指标。通过提供您的坐标 组织单位到系统中,您可以快速掌握 这个模块。有关如何开始的详细信息,请参见GIS部分。

图表和仪表板

显示指标数据最简单的方法是通过图表。 易于使用的图表对话框将指导您完成创建 各种类型的图表,其中包含指标,组织单位的数据 和您选择的时期。这些图表可以轻松地添加到其中之一 仪表板上的四个图表部分,可以轻松完成 登录后立即可用。确保将仪表板模块设置为 用户设置中的启动模块。

DHIS2教程

使用数据透视表应用创建记分卡

Scorecards definition: In public health settings such as Ministries of Health, scorecards offer a useful and standardized method for combining related indicators into one table. A scorecard gives an overall view of the performance of a health program such as a vaccination program, highlighting successes, weaknesses, and areas for improvement Here's what a typical scorecard looks like:

本教程说明了如何在DHIS2数据透视表中创建记分卡 表格应用。使用枢纽分析表有几个优点 创建一个记分卡,例如:

  • 您可以将计分卡保存在仪表板上并离线使用。

  • 您可以与其他DHIS2用户共享计分卡。

让我们开始吧\!

为记分卡创建图例

首先,我们将为记分卡创建一个三色的“交通灯”图例。 记分卡具有三种基本颜色,易于扫描且易于操作 理解。

  1. Open the Maintenance app. Click the menu in the top right corner 并从应用程序列表中选择维护。您也可以输入 在搜索字段中查找单词维护的首字母 该应用程序。

  2. 在维护应用程序中,向下滚动到页面底部 to the Other section.

  3. Go to Legend and click the + .

  4. In the Legend Management page, scroll to the bottom of the page 并通过点击蓝色+按钮来创建新的图例。

  5. 输入图例的名称(例如“ Traffic light”)作为起始值 以及字段中的最终值。您在此处输入的值取决于 您希望为记分卡设置的性能等级。

  6. 将**图例项数**更改为3以显示三种颜色 计分卡。要更改图例项的颜色,请点击蓝色+ 按钮,然后编辑 颜色。

在数据透视表应用中创建记分卡

  1. Open the Pivot Table app from the top right menu of the 仪表板。您还可以在中输入数据透视表的首字母 搜索字段。

  2. Go to Data in the pane on the left side and select 列表中的**指标**。

  3. Select an Indicator group such as “ANC” in the second list.

  4. 使用箭头,选择要在其中查看的指标类型 您的计分卡。

  5. Click Update . This button is in the menu at the top of the 工作区

  6. Go to Periods and select a period for which you want to display 数据。在这个“交通灯”示例中,我们将使用相对时间段 section. In Quarters , select This quarter**and **Last quarter . Clear any other checkboxes and click Update .

  7. Go to Organisation Units in the same left side pane, and click 齿轮按钮旁边的箭头。

  8. 选择**选择级别**。

  9. Select District from the list (next to the gear button). Click 更新

如您所见,记分卡在 工作区。现在该调整外观。

整理记分卡的布局和显示

  1. In the workspace, click Layout .

  2. In Table layout , drag Organisation units down to the **Row 尺寸**部分。

  3. Drag Data to the Column dimensions section.

  4. In the Column dimensions pane, drag Periods below Data , and click Update .

  5. In the workspace, click Options .

  6. Go to Data and clear all the checkboxes.

  7. 转到**样式** > 图例集 ,然后从列表中选择 您在维护应用中创建的图例。在这个例子中,我们 称之为交通信号灯。

  8. 转到**样式** > 图例显示样式 ,然后选择**背景 颜色**。

  9. 点击**更新**。

记分卡已准备好\!

保存并分享您的计分卡

  1. In the workspace, go to the Favorites menu.

  2. 点击**另存为**。输入您的记分卡名称。

  3. To share your Scorecard, select Favorites .

  4. Enter the name of a user group name, and click Save . Your 与仪表板共享的人可以查看记分卡。

使用TextPattern

DHIS2版本2.29中引入了TextPattern,作为一种定义 包含变量,生成的值和原始文本的模式 然后可以生成一个文本值。当前用例 TextPattern是为跟踪的实体自动生成的属性, 您要在其中生成例如基于特定ID的唯一ID的位置 模式。

本指南将涵盖与之相关的基本和高级主题 TextPattern,但主要侧重于如何定义TextPatterns 以及存在哪些限制和警告。

TextPattern语法

TextPattern是一系列* segments ,由“ +”连在一起 字符。细分具有特定的符号,在大多数情况下, 参数 format *,它允许对该值进行进一步操作。

TextPattern segments
Segment notation 描述 Paramenter (format) Example (segment → input value → result)
"Plain text" The plain text segment will remain unchanged in all generated values. This special segment is defined by wrapping text between two double quotes. If your pattern should include separation symbols like a dash, you should use this "-".
The plain text segment also allows for placeholder text. That means you can specify that parts of the plain text segment should be any of a set of characters. Currently there are 4 supported special characters you can use:
* \d (0-9)
* \x (a-z)
* \X (A-Z)
* \w (a-zA-Z0-9)
没有 "Hello world" → None → Hello world
"Hello \x\x\x" → "Hello you" → Hello you

"\d\d\d" → "123" → 123
CURRENT_DATE(format) Current date segment will be generated by the server at the time of generation. This is useful if you want your patterns to have a time-constraint that is disconnected from the context. You should not use this if you need to control which date is injected into the pattern. Date format CURRENT_DATE(yyyy) → 01-01-2018 → 2018
ORG_UNIT_CODE(format) This segment represents the organisation unit code associated with the generation. Text format ORG_UNIT_CODE(...) → OSLO → OSL
RANDOM(format) Random segments will be replaced by a value randomly generated by the server based on the format. Generated segments, like Random, bases its uniqueness on the rest of the pattern. That means a random value can appear twice, as long as the rest of the pattern is different, which means the generated text as a whole will be unique. Generation format RANDOM(X####) → None → A1234
SEQUENTIAL(format) Sequential segments will be replaced by a number, based on a counting value on the server. Sequential segments will start at the value 1, and for each generated value count up until no more values are available, based on the format. Like Random segments, uniqueness is based on the rest of the pattern, so each possible version of the pattern will have it's own sequential counter starting from 1. Generation format "A"+SEQUENTIAL(###) → None → A001
"A"-SEQUENTIAL(###) → None → A002

"B"-SEQUENTIAL(###) → None → B001

"B"-SEQUENTIAL(###) → None → B002

除纯文本外,大多数段都具有参数* format * 分割。下表列出了可用格式以及它们的格式 使用的示例符号和使用它们的示例符号。

Parameter formats
格式 描述
Date format This format is based directly on the java SimpleDateFormat, which means any pattern valid for SimpleDateFormat, will be valid as a date format in TextPattern CURRENT_DATE(dd-MM-yyyy) → 31-12-2018
CURRENT_DATE(MM-yyyy) → 12-2018
Text format The text format allows for some basic text manipulation. Leaving the format empty will return the value unmodified, but using "^", "." and "$", you can modify the value before it is returned. Each "." represents a character, while "^" represents the start of the text and "$" represents the end. When using formats, the input value must be at least the same length as the format. ORG_UNIT_CODE(....) → OSLO

ORG_UNIT_CODE(..) → OS

ORG_UNIT_CODE(..$) → LO

ORG_UNIT_CODE(^...$) → OSLO

^....$ will require the input value to be exactly 4 characters.
Generation format The generation format accepts a combination of one or more of he following characters: "#", "X", "x" and "*". They respectively represent a number(0-9), an uppercase letter (A-Z), a lowercase letter(a-z) or any of the above(0-9,a-z,A-Z). The SEQUENTIAL segment only accepts "#", since it will only generate numbers. The number of characters in the format decides the size of the value generated. Using just one "#" will in other words only allow for 10 values (0-9), while "###" will allow for 1000 values (000-999). SEQUENTIAL generated values have leading zeroes, so the length of the generated value will always match the format length. RANDOM(X###) → A123
RANDOM(****) → 1AbC

SEQUENTIAL(###) → 001

SEQUENTIAL(######) → 000001

有关格式的一些重要注意事项:

  • 日期格式用途非常广泛,但是请注意哪个日期或时间 您正在使用的组件。使用小于一天的组件(对于 即使可用,也不建议使用小时或秒)。

  • 文本格式可以标记输入的开始和结束 值,但实际上“ ^ ...”和“ ...”将给出完全相同的值 结果。您唯一想使用“ ^”的时间是 强制输入值的长度。例如,“ ^ .... $”将 接受OSLO,因为它的开始和结束之间是4个字符,但是 PARIS有5个字符,将被拒绝。

  • 当文本格式用于唯一值时,例如组织单位 代码,请确保格式不会破坏唯一性。 (例如:“ PARIS”和“ PANAMA CITY”的ORG _UNIT _CODE(..) 都返回PA,这意味着这两个组织单位将 现实份额产生的价值)

  • 生成格式是了解容量的主要方法 您的模式。确保格式足够长以覆盖更多内容 超出您所需的值。

要结束本教程的语法部分,这里有几个 例 TextPattern:

ORG_UNIT_CODE(...)+“-” + CURRENT_DATE(yyyyww)+“-” + SEQUENTIAL(#####)

此模式将有99999个可能的值(基于SEQUENTIAL。00000 从1)开始就从未使用过。另外,剩下的图案 每个产生价值的组织单位都会改变 (ORG _UNIT _CODE)和每周(CURRENT _DATE(yyyyww) 年和周)。这实际上意味着每个新的一周,每个组织 单位将具有可以使用的99999个新值。

“ ABC_” + RANDOM(****)

此模式的纯文本段不会对 模式的总容量,但是生成的段(RANDOM) 将允许14776336可能的值。原因是 * 可以是62个可用字符中的任何一个(0-9,a-z,A-Z)。 您可以在下面进一步了解有关了解模式容量的信息 本教程。

设计用于生成ID的TextPattern

TextPattern的一种用例是生成唯一的ID。在这个部分 我们将介绍与设计相关的准则和常见问题 用于ID的TextPatterns。

ID不得包含敏感信息或包含以下内容的信息: 组合可以识别一个人。 TextPattern当前不 支持使用此类值的细分受众群,但可能会在 未来。

以下列表突出显示了一些特定于TextPattern的内容 设计id的TextPattern时需要考虑的限制:

  • 确保电池的容量(可能值的数量) TextPattern涵盖了您的用例。最好有更多的价值 比需要的少。使用TextPattern跟踪实体属性 将需要在其中存在一个生成的细分 TextPattern。

  • TextPattern在整个系统中是唯一的,但仅适用于 使用它的对象。换句话说,如果您有一个追踪实体 TextPattern的属性,由多个Tracked实体使用(非 被误认为是跟踪的实体实例),生成的所有值 将使用该属性在所有跟踪的实体之间共享。这个 也表示如果您有两个跟踪的实体属性, 相同的TextPattern语法,每个属性都将能够生成 因为唯一性基于属性,所以彼此具有相同的值。

  • SEQUENTIAL段位于实施编号中,从 1,对每个值加1,然后依次递增直到没有更多值 可用。但是,实际上,您很可能最终会 用户生成和保留从未使用过的值时的差距,或者 如果用户发送的值中SEQUENTIAL段的值较高 值比服务器上记录的值大。

  • 当前的实现依赖于用户客户端发送 存储新值时,TextPattern中包含的值。那 表示生成正确的ID取决于用户,并且 用户客户端,以提供正确的数据。

了解TextPattern容量

设计TextPattern时要记住的最重要的事情是, 是容量-表示潜在值的总数a TextPattern可以产生。

在当前的TextPattern实现中,主要有三个 决定容量的因素:

  1. TextPattern中生成的段的容量

  2. CURRENT _DATE段的存在

  3. ORG _UNIT _CODE段的存在

日期段(如CURRENT _DATE)的存在将有效 分段每次更改时重置容量。根据日期 格式,它可以在任何地方更改,从每年到每天。 **重要提示:如果您的 日期格式不包含年份,格式将解析为相同 每年的价值。**这意味着已经使用了价值。例如, 如果您的TextPattern看起来像这样:

CURRENT_DATE(ww)+“-” + RANDOM(#)

这种模式每周最多为您提供10个唯一值,但是 一年后,CURRENT _DATE(ww)将与去年相同,并且您 将没有可用的新值。如果您改用“ yyyy-ww”,它将 每年,每周都独一无二。

组织单位代码将使您的价值观在每个不同的领域都独一无二 组织单位,这意味着您是否具有以下文本模式:

ORG_UNIT_CODE()+“-” + RANDOM(#)

此模式将为您提供10种不同的唯一值 组织单位。

计算生成段的容量

了解如何计算TextPattern的容量至关重要 设计TextPatterns时。生成的细分将是主要的 任何TextPattern的组件,以容量为单位,然后根据 存在ORG _UNIT _CODE或CURRENT _DATE时。

让我们从SEQUENTIAL段开始。格式中的每个“ \#”代表 一个0到9之间的数字。要计算总容量,请乘以 每个“ \#”的可能值的数量。由于总是10(0-9) 数学很简单:

SEQUENTIAL(#)= 10 = 10
序列(###)= 10 * 10 * 10 = 1000
SEQUENTIAL(#####)= 10 * 10 * 10 * 10 * 10 = 100000

由于服务器上的SEQUENTIAL计数器从1开始而不是0,因此实际 容量为999,但在大多数情况下并不重要。

一旦涉及到RANDOM,计算就会变得更多 复杂。与SEQUENTIAL类似,“ \#”具有10个可能的值, 另外,我们有“ X”和“ x”,每个都有26个可能的值,以及 “ *”可以是前面的任何一个,表示62(10 + 26 + 26) 可能的值。

要计算容量,您需要将每个字符 格式化并替换为可能的值数,然后相乘 它们都像我们在SEQUENTIAL中所做的一样:

RANDOM(#)= 10 = 10
随机(X)= 26 = 26
RANDOM(*)= 62 = 62
 
推荐文章