For the complete DHIS2 documentation index, see llms.txt.

世界卫生组织死因 - 追踪器安装指南{ #crvs-cod-installation }¶

介绍¶

本文件旨在指导管理员在 DHIS 2 数据库中安装死因模块的过程。需要充分了解 DHIS 2，包括 Tracker（基于病例）功能。

死因模块由一个包含 DHIS 2 元数据的文件组成。更具体地说，它包括

用于 Tracker 计划：

带有数据元素、选项集、自定义数据输入表、程序规则、程序指标等的跟踪程序。
用于验证数据的标准报告。
包含关键数据图表的仪表板。
本文件介绍如何安装该模块并进行日常维护。其中包括调整和改进诊断/医疗术语词典这一关键任务，这对模块的运行至关重要。

此外，node.js script for linking the Cause of Death module in DHIS 2 with the IRIS software 用于将死因半自动编码为完整的 ICD-10 并将结果发回 DHIS 2 数据库。提供的输出可将这些数据再次导出至 ANACOD 数据分析工具。该功能将在另一份文件中介绍。

模块说明{ #description-of-the-module }¶

本节概述了模块的设计和结构。

数据收集表{ #the-data-collection-form }¶

数据收集表是根据《国际死因医学证明书》制作的。因此，它使用了一个模仿该证书布局的自定义表单。不过，表单中内置的编码和验证逻辑也可以在没有自定义表单的情况下工作，从而使该模块可以在移动设备上使用，例如 DHIS 2 安卓应用程序。

处理 "年龄"{ #dealing-with-age }¶

在收集死者年龄数据时，数据收集表支持使用出生日期和估计年龄。为便于分析数据，表格中增加了一个以年为单位的年龄数据元素，但该元素为禁用/只读字段。根据输入的出生日期或估计年龄，程序规则会计算出以年为单位的年龄，并将该值分配给以年为单位的年龄数据元素。

词典{ #dictionary }¶

该模块的一个重要组成部分是词典（ICD-SMoL - 本地词典）。词典的功能是将数据录入中使用的医学术语与用于报告和分析死因的 ICD-SMoL 代码联系起来。在 DHIS 2 中，字典是作为选项集实施的。医学术语是选项名称，选项代码由三部分组成：ICD-SMoL 代码、ICD-10 代码和 ID。ID 是必要的，因为多个术语可能指代相同的 ICD-SMoL 和 ICD-10 代码，而代码必须是唯一的。ID 本身由两部分组成：国家代码（或模块提供的 INT）和计数器。对国际术语和特定国家术语进行跟踪，将使今后更容易识别不同国家使用的术语，从而为国际词典提出建议。

完全本地化的法文 "死因 "模块使用与英文 ICD-SMoL - 本地字典不同的本地字典。该词典由不同的选项集维护，仅包含在法文软件包文件中。

词典按术语长度排序，最短的术语排在前面。这样可以确保用户在词典中搜索时，首先显示与搜索词匹配比例最大的医学术语。

选择根本死因{ #selecting-underlying-cause-of-death }¶

选择基本死因是该模块的一个关键组成部分。这需要通过四个复选框来完成，复选框显示（最多）四个原因中哪个是根本原因。程序规则用于确保只能选择其中一个复选框，并且每个复选框只能在为该行/原因选择了诊断的情况下使用。

一旦选择了基本病因，就会在两个只读字段中指定所选病因的 ICD-SMoL 名称和代码。

安装¶

要求和准备{ #requirements-and-preparation }¶

为了安装该模块，需要DHIS2上的管理员用户帐户。在DHIS2的生产实例上执行此文档中概述的过程之前，应在测试/分阶段环境中进行测试。

应格外注意确保服务器本身和 DHIS 应用程序的安全，以限制对所收集数据的访问。即使在使用该模块时没有任何直接的病人标识符（如身份证或姓名），年龄、性别和医疗机构也足以识别个人身份。有关确保 DHIS 2 系统安全的详细信息不在本文件的讨论范围之内，请参阅 DHIS 2 文档。

选择模块版本{ #choosing-a-version-of-the-module }¶

导入元数据¶

使用 DHIS 2 Import/Export 应用程序的元数据导入功能，通过带有 DHIS 2 元数据的 .json 文件导入模块。导入已有元数据的 DHIS 2 数据库中的元数据时，如果查看详细的导入摘要，可能会看到错误。这些错误可能需要采取措施，例如，如果您要将模块导入的数据库中已经存在具有相同名称或代码的数据元素。在这种情况下，您必须更改数据库中的标识符（名称、代码），或修改导入文件中的名称/代码。任何此类修改都应首先在测试或暂存环境中进行，以确保修改不会影响系统的其他部分。

附加配置¶

成功导入所有元数据后，在模块开始运行前还需要采取几个步骤。

在用户开始输入数据之前，必须将程序分配给新的或现有的用户角色。此外，用户需要有必要的权限才能输入和/或查看跟踪器数据。有关配置用户角色的更多信息，请参阅 DHIS 2 文档。
方案必须分配给输入数据的组织单位。
您也可以选择使用 DHIS 2 的共享功能，配置哪些用户（用户组）应查看与计划相关的元数据和数据。可为计划本身、数据元素、计划指标、综合指标、选项集和分析结果配置共享功能。

调整跟踪器程序¶

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

向表单添加其他变量。
对于跟踪程序，将程序链接到现有的跟踪实体类型和/或修改跟踪实体属性。模块中包含一个占位跟踪实体。
根据国家惯例修改数据元素/选项名称。
向变量和/或数据输入表单添加翻译。
但是，强烈建议不要更改或删除任何包含的表格/元数据。这一方面是因为所包含的变量是国际死亡通知表中的标准推荐变量，另一方面是因为修改有可能会破坏功能，例如计划规则和计划指标。例如，表格中的几乎所有变量都与一个或多个计划规则相关联，如果删除或替换变量，这些计划规则就会失效。更改默认变量也会使将来的模块更新复杂化。

保养¶

模块的维护主要包括两个方面：医学术语词典的维护和与 DHIS 2 新版本相关的维护。

词典维护{ #dictionary-maintenance }¶

医学术语词典是模块的关键组成部分，对于生成有意义的数据至关重要。本节将介绍如何检查字典的完整性（例如所使用的代码是否有效）、列出已收集到但字典中没有的术语（因此应考虑将其纳入）以及如何向字典中添加新术语。模块中包含多个 SQL 视图，以方便执行这些任务。

检查字典的完整性{ #checking-integrity-of-dictionary }¶

如上所述，字典是作为 DHIS 2 中的选项集实施的，医疗术语作为选项名称，选项代码采用特殊格式，由 ICD-SMoL 代码、ICD-10 代码和 ID 组成，并用 |（管道）符号分隔。字典中包含 SQL 视图，用于验证字典中的所有条目是否遵循此格式：

代码格式无效的字典条目 - 列出代码不符合"[内容]|[内容]|[内容]"格式的条目。
具有无效 ICD-SMoL 引用的字典条目 - 代码的 ICD-SMoL 部分不在 ICD-SMoL 列表中的列表条目，该列表作为单独的选项集提供。
混合主类和子类的词典条目--对于同一 ICD-SMoL 代码，有些条目链接到主 ICD-SMoL 代码，有些条目链接到具体代码（例如，有些条目链接到 5-4 和 5-4.1）。在分析 DHIS 2 中的数据时，这可能会产生误导性输出，因为死亡人数可能会被重复计算。

在词典中添加术语{ #adding-terms-to-the-dictionary }¶

SQL 视图 "字典中未找到的术语 "将列出所有以自由文本形式输入的医学术语，即在数据输入过程中字典中未找到的术语，以及这些术语的输入次数。如果这些术语出现频率高且有意义，则应考虑将其纳入字典。

在将术语添加到词典之前，必须确定正确的 ICD-SMoL 和 ICD-10 编码。这些代码与 ID 一起构成词典中要使用的代码。为查找 ID，词典中包含一个 SQL 视图 "下一个词典索引号"，它将显示下一个要使用的 ID。它有两列：termtype 和 nextvalue。如上所述，建议每个国家使用一个县代码来为词典添加本地内容，在这种情况下，该代码将列在 termtype 下，下一个要使用的编号将列在 nextvalue 列中。如果尚未添加任何本地术语，则使用 [国家代码]00001 作为第一个 ID，例如，如果使用 GH 作为国家代码，则使用 GH00001。添加第一个本地术语后，SQL 视图将随时显示下一个要使用的 ID。

为确保正确的术语首先显示在词典中，必须按术语的长度排序。在字典中添加新术语后，必须重新排序，这样新术语就不会总是排在最后。这可以通过下面的 SQL 查询来完成（适用于 PostgreSQL 数据库）：

``sql 有序为 ( 选择 uid、 name、代码、 row_number() OVER (ORDER BY length(name),name) AS sort_order 从选项值其中 optionsetid = (select optionsetid from optionset where code = 'ICD_SMOL_DICTIONARY') ) 更新 optionvalue ov set sort_order = ord.sort_order from ordered ord 其中 ov.uid = ord.uid 且 ov.optionsetid = (select optionsetid from optionset where code = 'ICD_SMOL_DICTIONARY')； ```

注意*，这是一个 UPDATE 查询，必须直接在数据库中执行，而不是通过 DHIS2 用户界面。

升级 DHIS

当 DHIS2 的新版本发布时，在升级系统的任何生产实例之前，必须在暂存/测试服务器上测试模块的所有功能。