免疫接种（EPI）三角测量安装指南{ #imm-tri-installation }¶
这是免疫（扩大免疫方案）三角测量软件包的安装指南。
系统默认语言：系统默认语言：英语
总览¶
元数据参考和元数据 json 文件提供了有关软件包版本和内容的技术细节。元数据包由一个模块组成，这是一个**仪表板**包。
该软件包旨在提供指标和分析，以便对来自三个不同软件包的数据进行三角测量：
- HMIS 的免疫接种（EPI）汇总包
- 综合疾病监测（IDS）汇总包
- 以病例为基础的疫苗可预防疾病（VPDs）追踪系统
虽然该仪表板软件包并不要求这些软件包已经安装和使用，但重要的是，它必须安装在一个同时提供常规免疫数据和监测数据的 DHIS2 实例中。在一些国家，这些计划是在不同的 DHIS2 实例中收集和管理的，因此有必要首先将数据集中到一个地方。设计指南]（#imm-tri-design）对此有进一步解释。
安装¶
模块的安装包括以下几个步骤：
- [使用 DHIS2 元数据准备元数据文件]（#preparing-the-metadata-file）。
- [将元数据文件导入 DHIS2]（#importing-metadata）。
- 配置导入的元数据。
- 导入后调整元数据
在开始 DHIS2 的安装和配置过程之前，建议首先阅读安装指南的各个部分。根据导入类型确定适用的章节：
- 导入空白的 DHIS2 实例
- 导入具有现有元数据的 DHIS2 实例。
本文件中概述的步骤应在测试/暂存 DHIS2 实例中进行测试，然后才应用于生产环境。
要求¶
安装模块需要 DHIS2 的管理员用户账户。
应格外注意确保服务器本身和 DHIS2 应用程序的安全，并应定义对所收集数据的访问权限。有关 DHIS2 系统安全的详细信息不在本文讨论范围之内，请参阅DHIS2 文档。
准备元数据文件¶
尽管并非总是必要，但在将元数据文件导入DHIS2之前对其进行某些修改通常可能是有利的。
注
请注意，必须使用纯文本编辑器，而不是 Microsoft Word 等文字处理程序来执行搜索和替换操作。
指标类型¶
指标类型是一种可能造成导入冲突的对象类型，因为在不同的 DHIS2 数据库中使用某些名称 （如 "百分比"）。由于指标类型由其因子（包括 "仅分子 "指标的 1）定义，因此它们是明确的，可通过搜索和替换 UID 来替换。这种方法有助于避免潜在的导入冲突，并防止实施者创建重复的指标类型。下表包含可替换的 UID，以及用于识别现有 UID 的 API 端点：
| 目的 | 用户标识 | 应用程序接口端点 |
|---|---|---|
| 仅分母（数字） | CqNPn5KzksS | .../api/indicatorTypes.json?filter=number:eq:true&filter=factor:eq:1`。 |
导入元数据¶
使用 Import/Export DHIS2 应用程序导入元数据包。建议在尝试实际导入元数据之前使用 "模拟运行 "功能来发现问题。如果 "模拟运行 "报告了任何问题或冲突，请参阅下面的[导入冲突]（#处理-导入-冲突）部分。如果 "试运行"/"验证 "导入无误，请尝试导入元数据。如果导入成功且无任何错误，则可以继续配置 模块。在某些情况下，"模拟 "过程中不会显示导入冲突或问题，但在尝试实际导入时会显示。在这种情况下，导入摘要将列出需要解决的任何错误。
处理导入冲突¶
注
如果将软件包导入新的 DHIS2 实例，由于目标数据库中没有元数据，因此不会出现导入冲突。导入元数据后，进入"配置 "部分。
可能会发生多种冲突，但最常见的是配置包中的元数据对象的名称、简称和/或代码已经存在于目标数据库中。这些问题有几种不同的解决方案，各有利弊。例如，哪种方案更合适取决于发生冲突的对象类型。
备选方案1¶
重命名 DHIS2 数据库中存在冲突的现有对象。这种方法的优点是无需修改 .json 文件，而是通过 DHIS2 的用户界面进行更改。这可能更不容易出错。这也意味着配置包保持原样，例如在发布包更新时，这可能是一个优势。在培训材料和文档中也经常引用原始软件包对象。
备选方案2¶
重命名.json文件中存在冲突的对象。这种方法的优点是现有的DHIS2元数据保持不变。当存在培训材料或文档（例如链接到所讨论对象的数据字典的SOP）时，这可能是一个因素，并且不存在通过修改用户熟悉的元数据而使用户感到困惑的风险。
请注意，对于备选项1和2，修改可以简单到在名称中添加一个小的前缀/后缀，以最大程度地减少混乱的风险。
备选3¶
第三种也是更复杂的方法是修改.json文件以重新使用现有的元数据。例如，在某个概念的某个选项集已经存在的情况下（例如“性别”），可以从.json文件中删除该选项集，并且对其UID的所有引用都将替换为数据库中已经存在的相应选项集。这样做的最大优点（不限于直接导入冲突的情况）是避免在数据库中创建重复的元数据。执行这种类型的修改时，需要考虑一些关键因素：
- 它需要有关DHIS2详细元数据结构的专业知识
- 该方法不适用于所有类型的对象。特别地，某些类型的对象具有依赖关系，这种依赖关系以这种方式难以解决，例如与分解有关。
- 将来对配置包的更新将很复杂。
组态¶
成功导入所有元数据后，需要执行一些步骤，模块才能正常运行。
分享中¶
首先，您必须使用 DHIS2 的*共享*功能来配置哪些用户（用户组）应查看与软件包相关的元数据和数据。
有关共享的更多信息，请参阅 DHIS2 文档。
软件包包括三个核心用户组：
- 免疫接种访问（查看元数据/查看数据）
- 免疫管理（查看和编辑元数据/无法访问数据）
- 免疫数据采集--（查看元数据/采集和查看数据）。不使用此功能，因为这是一个仅限仪表盘的软件包。
用户会根据其在系统中的角色被分配到相应的用户组。软件包中其他对象的共享可能会根据设置进行调整。更多信息请参阅 DHIS2 共享文档。
指标映射{ #indicator-mapping }¶
仅实施_仪表盘软件包_时，必须使用现有实例中的元数据对象配置指标分子和分母。配置信息可在元数据文件中的文档以及分子和分母描述中获取。为便于识别，指标名称中带有"[CONFIG]"前缀，指标配置完成后应删除该前缀。
删除元数据{ #removing-metadata }¶
为了保持实例清洁并避免出错，建议您删除实例中不必要的元数据。删除不必要的元数据需要 DHIS2 和各种附属程序的高级知识。