修复 - 骨料安装指南{ #rehab-agg-installation }¶

本文件包括康复汇总软件包的安装指南。

系统默认语言：系统默认语言：英语

可用翻译：法语、西班牙语、葡萄牙语、阿拉伯语

安装¶

模块的安装包括以下几个步骤：

1. 用 DHIS2 元数据准备元数据文件
2. 将元数据文件导入 DHIS2
3. 配置导入的元数据
4. 导入后调整程序

在开始 DHIS2 的安装和配置过程之前，建议首先阅读安装指南的各个部分。根据导入类型确定适用的章节：

1. 导入空白的 DHIS2 实例
2. 导入具有现有元数据的 DHIS2 实例。

本文件中概述的步骤应在测试/暂存 DHIS2 实例中进行测试，然后才应用于生产环境。

要求¶

安装模块需要 DHIS2 的管理员用户账户。

应格外注意确保服务器本身和 DHIS2 应用程序的安全，并应定义对所收集数据的访问权限。有关 DHIS2 系统安全的详细信息不在本文讨论范围之内，请参阅DHIS2 文档。

元数据文件{ #metadata-files }¶

尽管并非总是必要，但在将元数据文件导入DHIS2之前对其进行某些修改通常可能是有利的。

准备元数据文件{ #preparing-the-metadata-file }¶

默认数据维度¶

在 DHIS2 早期版本中，默认数据维度的 UID 是自动生成的。因此，虽然所有 DHIS2 实例都有默认类别选项、数据元素类别、类别组合和类别选项组合，但这些默认值的 UID 可能不同。DHIS2 的后期版本对默认维度的 UID 进行了硬编码，这些 UID 在配置包中使用。

为避免导入元数据时发生冲突，建议搜索并替换整个 .json 文件中所有出现的这些默认对象，将 .json 文件中的 UID 替换为导入该文件的实例中的 UID。表 1 显示了应替换的 UID，以及用于识别现有 UID 的 API 端点

使用列出的 API 请求识别实例中默认 dimesions 的 UID，并用实例中的 UID 替换 json 文件中的 UID。

注意

请注意，必须使用纯文本编辑器，而不是 Microsoft Word 等文字处理程序来执行搜索和替换操作。

指标类型¶

指标类型是另一种可能造成导入冲突的对象类型，因为某些名称在不同的 DHIS2 数据库中 使用（如 "百分比"）。由于指标类型由其因子（包括 "仅分子 "指标的 1）定义，因此它们是明确的，可通过搜索和替换 UID 来替换。这种方法有助于避免潜在的导入冲突，并防止实施者创建重复的指标类型。下表包含可替换的 UID，以及用于识别现有 UID 的 API 端点：

使用根组织单位 UID 的可视化{ #visualizations-using-root-organisation-unit-uid }¶

分配给特定组织单位级别或组织单位组的可视化、事件报告、报告表和地图都有一个对根（第 1 级）组织单位的引用。此类对象（如果存在于元数据文件中）包含一个占位符 <OU_ROOT_UID>。使用 .json 文件编辑器中的搜索功能可以识别该占位符，并将其替换为目标实例中 1 级组织单位的 UID。

选项代码{ #option-codes }¶

根据 DHIS2 命名规则，元数据代码使用大写字母、下划线和空格。可能出现的一些例外情况在相应的软件包文档中有所说明。 当前软件包中元数据对象的所有代码都符合命名约定。目标数据库中使用的现有元数据对象的代码可能使用小写字母。在这种情况下，必须直接在数据库中更新这些值。

重要**

在导入过程中，现有的选项代码将被更新的大写代码覆盖。 为了更新数据库中现有数据的数据值，必须使用数据库命令更新数据库中存储的值。 在替换值之前，请确保映射现有的旧选项代码和新选项代码。先使用暂存实例，然后再在生产服务器上进行调整。

对于数据元素值，请使用

``SQL UPDATE programstageinstance SET eventdatavalues = jsonb_set(eventdatavalues,'{"", "value"}', '""') WHERE eventdatavalues @> '{"":{"value"：""}}'::jsonb AND programstageid= ；

### 选项的排序顺序{ #sort-order-for-options } 

检查系统中选项的排序顺序 `sortOrder` 是否与元数据包中选项的排序顺序一致。这仅适用于 json 文件和目标实例包含相同 UID 的选项和选项集时。

导入后，确保选项集中选项的排序顺序从 1 开始，排序顺序值中不应有间隙（如 1、2、3、5、6）。

排序顺序可在维护应用程序中调整。

1. 转到适用的选项集
2. 打开 "选项 "部分
3. 使用 "按名称排序"、"按代码/数值排序 "或 "手动排序"。

康复包包含一个选项集和两个选项：

``json
{
    "optionSets"：[
        {
            "名称"："是/否（数字）"、
            "id"："TdDqpX1kdd2"、
            "代码"："YES_NO_NUM"、
            "valueType"（值类型）："integer_zero_or_positive"（整数或正数）、
            "选项"： [[
                {
                    "id"："VavIEUmBv8j"
                },
                {
                    "id"："Xu8ieCbS7jH"
                }
            ]
        }
    ],
    "选项"：[
        {
            "名称"："是"、
            "id"："VavIEUmBv8j"、
            "代码"："1",
            "sortOrder"：1,
            "optionSet"：{
                "id"："TdDqpX1kdd2"
            }
        },
        {
            "名称"："没有"、
            "id"："Xu8ieCbS7jH"、
            "代码"："0",
            "sortOrder"：2,
            "optionSet"：{
                "id"："TdDqpX1kdd2"
            }
        }
    ]
}

该 "是/否 "选项集以 "INTEGER_ZERO_OR_POSITIVE "选项值为基础，在预测器中进行评估，以确定**初级保健中心一级的康复基本套餐可用性**，并计算提供基本套餐的设施数量。

组织单位组和组套{ #rehab-orgunitgroups }¶

该软件包包括以下组织单位组：

根据各国的具体情况，可能需要进一步分类。

示例

如果为初级保健设施收集的数据需要按地区医院和保健中心进一步分类，则需要创建并维护**REHAB PHC 医院**和**REHAB PHC 保健中心**组织组，作为**REHAB PHC**组织单位组集的一部分。

该软件包包括以下组织单位组套：

必须对这些元数据对象进行配置。

1. 如果目标实例不包含任何与软件包中包含的组的描述相匹配的组织单位组，请在配置和导入过程中按照以下步骤操作：

   1. 将软件包和所含组织单位组一起导入。
   2. 在维护应用程序中为新的组织单位组分配适用的设施。

2. 如果目标实例已包含与给定元数据对象描述相匹配的组织单位组，请在配置和导入时按照以下 步骤操作：

   1. 注意目标实例中匹配组织单位组的 UID。
   2. 用步骤 1 中的相应 UID 替换元数据 json 文件中所有出现的 organisationUnitGrop UID。
   3. 导入前从元数据 json 文件中删除组织单位组元数据对象。这一步非常重要，否则目标实例中组织单位对现有组的当前分配将被覆盖。
   4. 如果不需要其他预配置/编辑，则继续导入软件包。

3. 如果目标实例不包含与所提供描述相符的组织单位组集，则必须将这些组织单位组导入目标实例。必须在用户界面或使用 API 将适用的组织单位组添加到组织单位组集中。

4. 如果目标实例已包含与所提供描述相匹配的组织单位组集，请在配置和导入时按照以下步骤进行：

   1. 用目标实例中组织单位组的相应 UID 替换元数据文件中匹配组织单位组的 UID。
   2. 导入前从元数据文件中删除组织单位组对象。这一步非常重要，否则目标实例中组织单位组对现有组集的当前分配将被覆盖。
   3. 将新导入的组织单位组添加到组织单位组集中。(见上表）。

示例

目标实例可能已包含 PHC 组织单位组。在这种情况下，请在导入前用目标实例中的相应 UID 替换该组的 UID aT5pkgRLbw5及其在 json 文件中的所有出现次数。然后，从 json 文件中删除 orgUnitGroup "PHC "元数据对象。你可以在 "organisationUnitGroups" 下找到它。

人口、发病率和人员密度数据{ #population-incidence-and-personnel-density-data }¶

康复软件包包括用于**人口**、**发病**和**人员密度**数据的数据元素、指标和其他元数据对象。

在目标实例中输入人口数据的组织单位级别可能会有所不同。

在通用康复软件包中，该元数据被添加到下表所列的设施级数据集中。

如果目标实例已有元数据基础设施，用于收集**人口、人员或发病率数据**，请参考以下步骤：

1. 选择对齐目标实例和 .json 文件中人口元数据的策略。
2. 替代方案 1：用目标系统中的 UID 替换 json 文件中数据元素的 UID 及其所有出现次数

3. 替代方案 2：考虑用 json 文件中的 UID 替换目标系统中这些数据元素的 UID。GEN 数据元素是 DHIS2 核心元数据文件库的一部分，并在其他元数据包中使用。

4. 使用**人口、人员或发病率数据**的指标将在输入数据的层面/层面上汇总数据。

5. 导入软件包后可能还需要额外的映射和配置。请参阅数据集配置部分

注意

当更新现有 DHIS2 实例中元数据元素的 UID 时，您需要在数据库中运行 SQL 命令，并在其他元数据对象（预测器、指标、验证规则表达式等）中替换其 UID 的所有出现和引用。

预测因素{ #rehab-predictors }¶

康复软件包使用预测器进行计算：

1. 在医疗机构提供基本的康复包
2. 为特定职业群体提供人员
3. 报告设施中特定职业类别的可用性。
4. 每年在特定行政级别报告康复情况的机构数量。

重要**

康复一揽子方案包括一些指标，用于报告在特定行政级别上报告康复情况（PHC 康复、SHC 康复、THC 康复）的机构所占百分比，以及最低数量的职业类别（至少 1、2 或 3）。 这些指标的分母是特定护理行政级别（有分配康复工作者任务的初级保健中心、高级保健中心、技术保健中心）内的设施总数。有几种方法可以获得这一分母的数据。

1.组织单位组计数。可以使用 "组织单位组计数"（OG{} ）来查找属于某一特定组的设施数量。但是，在跟踪随时间推移而发生的变化时，不可能使用这种方法。 2.2. 年度数据集中的数据元素，可手动输入特定行政级别的设施数量。 3. 从预测器中接收年度值的数据元素，预测器按年运行，并根据每年的实际组织单位组计数生成设施数。这一解决方案已在当前的通用软件包中实施。请注意，一旦特定行政级别内的设施数量发生变化，过去一段时间内生成的数据有可能被覆盖。

预测器元数据包括用于聚合数据值的组织单位级别。软件包元数据文件包含占位符，需要用目标数据库中相应组织单位级别的 UID 替换。

准备导入预测因子的步骤如下：

1. 确定将汇总预测因子数据的设施级别的组织单位级别 UID。使用以下 API 端点确定所需的 UID：.../api/organisationUnitLevels.json?fields=id,name。
2. 在 json 文件中找到以下组织单位级别占位符：<OU_LEVEL_FACILITY_UID>
3. 用目标实例中已识别设备级别的 UID 替换占位符。
4. 确定目标实例中设施级别的编号。
5. 使用 "输出数据元素 - UID "列中提供的 UID，查找 json 文件中**输出数据元素**的属性。
6. 查找属性："aggregationLevels"（聚合级别）：[4]`
7. 如果级别与目标实例中的级别一致，则保持数字不变。如果目标实例中的设施级别编号不同，则相应调整编号。

验证规则{ #rehab-validation-rules }¶

软件包中包含的验证规则按已配置的数据集分组。

本安装指南的附录中列出了所有验证规则组和相应的验证规则：

康复 - 验证规则

所有验证规则的组织单位组都设置为设施级别。设施级别值位于每个验证规则的 "组织单位级别 "属性中。默认设置为4`。在导入软件包之前，请调整元数据文件中的这些级别，使其与目标实例中的设备级别相匹配。

导入元数据¶

使用 Import/Export DHIS2 应用程序导入元数据包。建议在尝试实际导入元数据之前使用 "模拟运行 "功能来发现问题。如果 "模拟运行 "报告了任何问题或冲突，请参阅下面的[导入冲突]（#处理-导入-冲突）部分。如果 "试运行"/"验证 "导入无误，请尝试导入元数据。如果导入成功且无任何错误，则可以继续配置 模块。在某些情况下，"模拟 "过程中不会显示导入冲突或问题，但在尝试实际导入时会显示。在这种情况下，导入摘要将列出需要解决的任何错误。

处理导入冲突¶

注

如果将软件包导入新的 DHIS2 实例，由于目标数据库中没有元数据，因此不会发生导入冲突。导入元数据后，进入"配置 "部分。

可能会发生多种冲突，但最常见的是配置包中的元数据对象的名称、简称和/或代码已经存在于目标数据库中。这些问题有几种不同的解决方案，各有利弊。例如，哪种方案更合适取决于发生冲突的对象类型。

备选方案1¶

重命名 DHIS2 数据库中存在冲突的现有对象。这种方法的优点是无需修改 .json 文件，而是通过 DHIS2 的用户界面进行更改。这可能更不容易出错。这也意味着配置包保持原样，例如在发布包更新时，这可能是一个优势。在培训材料和文档中也经常引用原始软件包对象。

备选方案2¶

重命名.json文件中存在冲突的对象。这种方法的优点是现有的DHIS2元数据保持不变。当存在培训材料或文档（例如链接到所讨论对象的数据字典的SOP）时，这可能是一个因素，并且不存在通过修改用户熟悉的元数据而使用户感到困惑的风险。

请注意，对于备选项1和2，修改可以简单到在名称中添加一个小的前缀/后缀，以最大程度地减少混乱的风险。

备选3¶

第三种也是更复杂的方法是修改.json文件以重新使用现有的元数据。例如，在某个概念的某个选项集已经存在的情况下（例如“性别”），可以从.json文件中删除该选项集，并且对其UID的所有引用都将替换为数据库中已经存在的相应选项集。这样做的最大优点（不限于直接导入冲突的情况）是避免在数据库中创建重复的元数据。执行这种类型的修改时，需要考虑一些关键因素：

• 它需要有关DHIS2详细元数据结构的专业知识
• 该方法不适用于所有类型的对象。特别地，某些类型的对象具有依赖关系，这种依赖关系以这种方式难以解决，例如与分解有关。
• 将来对配置包的更新将很复杂。

组态¶

成功导入所有元数据后，需要执行一些步骤，模块才能正常运行。

分享中¶

首先，您必须使用 DHIS2 的*共享*功能来配置哪些用户（用户组）应查看与程序相关的元数据和数据，以及谁可以在程序中注册/输入数据。默认情况下，共享配置如下：

• 仪表板
• 可视化、地图、事件报告和报告表格
• 数据集
• 表格对象类型和关键字

有关共享的更多信息，请参阅 DHIS2 文档。

软件包包括三个核心用户组：

• 恢复访问（查看元数据/查看数据）
• 康复管理员（查看和编辑元数据/无法访问数据）
• 康复--（查看元数据/捕捉和查看数据）

用户会根据其在系统中的角色被分配到相应的用户组。软件包中其他对象的共享可能会根据设置进行调整。更多信息请参阅 DHIS2 共享文档。

用户角色¶

用户将需要用户角色才能参与DHIS2中的各种应用程序。建议以下最低角色：

1. 跟踪器数据分析：可以查看事件分析并访问仪表板，事件报告，事件可视化器，数据可视化器，数据透视表，报告和地图。
2. 跟踪器数据捕获：可以添加数据值，更新跟踪的实体，跨组织单位搜索跟踪的实体以及访问跟踪器捕获

有关配置用户角色的更多信息，请参阅 DHIS2 文档。

组织单位分配{ #organisation-unit-assignment }¶

数据集必须分配给现有层次结构中的组织单位，才能通过采集应用程序访问。下表提供了有关康复数据集组织单位分配的信息：

组织单位小组任务{ #organisation-unit-group-assignment }¶

目标系统中的组织单位必须根据组织单位组部分中的概述分配给康复组织单位组。

数据集{ #rehab-dataset-config }¶

以下数据集需要在导入后进行额外配置：

床密度{ #bed-density }¶

如果现有的 HMIS 已经收集了康复病床总数的年度数据，则不需要康复病床密度数据集。确保在所有元数据对象中，将所有出现的数据元素**"可用康复床位（总数）"** K0Y94lADtGw 替换为现有数据元素 UID：

人员密度{ #personnel-density }¶

如果年度人口数据已在现有的 HMIS 中收集，则可从数据集 Sm2fALTZROS 中删除**"GEN - Population "数据元素 DkmMEcubiPv。请确保在所有元数据对象中，将"GEN - Population "**数据元素的所有出现次数替换为引用该数据元素的现有数据元素UID：

**发病**数据的数据收集水平必须与**人口**数据的数据收集水平相同或更低。

人员密度**数据集的组织单位分配应保持在设施一级，以便进行分析输出。

重复的元数据¶

注

本节仅适用于导入已有元数据的 DHIS2 数据库。如果您使用的是新的 DHIS2 实例，请跳过本节，转到调整跟踪程序。 如果您正在使用任何依赖于当前元数据的第三方应用程序，请考虑到此次更新可能会破坏它们"。

即使成功导入了元数据而没有任何导入冲突，元数据中也可能存在重复项-数据元素，跟踪的实体属性或已存在的选项集。正如上面有关解决冲突的部分所述，要牢记的一个重要问题是，在DHIS2中更改元数据的决定还需要考虑与现有元数据有不同关联的其他文档和资源。 ，以及通过配置包导入的元数据。因此，解决重复项不仅是“清理数据库”的问题，而且还要确保做到这一点，例如，不破坏与其他系统的集成，使用培训材料的可能性，破坏SOP等。这将非常很大程度上取决于上下文。

需要牢记的重要一点是，DHIS2 有一些工具可以隐藏元数据中潜在重复的一些复杂问题。例如，如果存在重复的选项集，可以通过[共享]（#sharing）为用户组隐藏这些选项集。

调整计划{ #adapting-the-program }¶

程序导入后，您可能需要对程序进行某些修改。可以**的本地改编例子包括：

• 向表单添加其他变量。
• 根据国家惯例修改数据元素/选项名称。
• 向变量和/或数据输入表单添加翻译。
• 根据当地案例定义修改指标

但是，如果您决定更改或删除任何包含的表格/元数据，强烈建议格外小心。修改可能会破坏功能，例如程序规则和程序指示器。

指标映射{ #indicator-mapping }¶

如需部分实施康复一揽子方案，即实施一套定制的世卫组织核心指标，请参阅世卫组织-DHIS2 指标映射表。

在调整元数据时，请务必确定使用了适用指标的可视化和仪表盘，以及相应数据集中使用的数据元素和类别组合。

删除元数据{ #removing-metadata }¶

为了保持实例整洁并避免出错，建议您删除实例中不必要的元数据。删除不必要的元数据需要 DHIS2 和各种附属程序的高级知识。