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

系统设置¶

常规设置¶

表格常规设置

设置	描述
分析记录的最大数量	增加该数字可提供更多分析记录。默认值为 50,000。 Warning 请谨慎使用Unlimited设置，它可能会导致服务器负载过高。
SQL 视图记录的最大数量	设置 SQL 视图中记录的最大数量。默认值为无限。
可从数据库获取的最大跟踪实体记录数	设置可从数据库获取的最大跟踪实体记录限制。如果用户没有提供任何值，则将使用默认值 50,000。设置为 0 或任何负整数将禁用此设置。警告禁用此设置可能会导致服务器负载过高。
基础设施指标	定义一个指标组，其中的成员指标应描述有关组织单位基础设施的数据。您可以在GIS应用项目中查看基础设施数据：右键单击设施，然后单击显示信息。
基础结构数据要素	定义一个数据元素组，其中的成员数据元素应描述有关组织单位基础设施的数据。基础设施数据元素可以是人口、医生、床位、互联网连接和气候。您可以在GIS应用项目中查看基础设施数据：右键单击设施，然后单击显示信息。
基建期类型	设置采集基础设施数据元素组中数据元素的频率。一般为每年一次。查看基础设施数据时，您可以选择数据源的时间段。您可以在GIS应用项目中查看基础设施数据：右键单击设施，然后单击显示信息。
用于分析的默认相对周期	设置此值将决定在分析应用项目中选择哪个相对周期作为默认值。
接收反馈者	定义一个用户组，其成员将接收通过 Dashboard 应用项目中的反馈功能发送的所有信息。这通常是超级用户团队的成员，他们能够支持和回答来自最终用户的问题。
系统更新通知接收者	定义一个用户组，该用户组的成员将收到有关可供下载的新系统更新的消息，每一个可供下载的 DHIS2 安装的新补丁版本，接收者只会收到一次消息。如果没有定义此类用户组，系统默认将其发送给所有拥有 ALL 权限的用户。

也可以通过在 "dhis.conf "文件中将 "system.update_notifications_enabled "配置变量设置为 "off "来完全禁用该功能。

它的工作原理是，每天凌晨 2:00 左右调用中央服务器上的 REST API 端点（GET，不带参数）。

分析设置¶

表格分析设置

设置	描述
用于分析的默认相对周期	定义在数据展示台应用项目和地图应用项目等分析应用项目中默认使用的相对周期。打开这些应用项目时，将自动选择相对周期。建议设置：用户最常用的相对周期。
在分析模块中显示的属性	设置是否要在数据展示台应用程序、地图应用程序和行列表应用程序等分析应用程序中显示元数据对象的名称或简称。用户可以在设置应用中覆盖此设置：在分析模块中显示的属性。
在分析模块中显示的默认数字组分隔符	在数据展示台应用项目和行列表应用项目等分析应用项目中设置默认数字组分隔符。
隐藏每日时段	在分析工具中隐藏每日时段
隐藏每周时段	在分析工具中隐藏每周时段
隐藏月经期	在分析工具中隐藏月度时段
隐藏双月期	在分析工具中隐藏双月周期
财政年度相对起始月	定义分析应用项目中相对财务年度的起始月份（4 月、7 月或 10 月）。
缓存策略	决定报告分析回复的缓存时间。如果使用计划的每晚分析更新，则可能需要选择缓存至明天早上 6 点。这是因为此时报告中的数据会发生变化，您可以安全地将数据缓存到分析表更新之时。如果要持续向分析表加载数据，请选择不缓存。对于其他情况，请选择希望缓存数据的时间。
可缓存性	设置分析数据响应是以公共可见性还是私人可见性提供。私人：在 DHIS2 服务器和终端用户之间的任何节点或服务器，只要有缓存能力，就不能缓存网页。如果服务的网页可能或确实包含敏感信息，这一点就很有用。这意味着，每次你需要一个网页时，要么从 DHIS2 服务器获取一个新页面，要么 DHIS2 服务器缓存该页面。除 DHIS2 服务器外，不允许其他服务器缓存页面。公共：DHIS2 服务器和终端用户之间任何有缓存能力的节点或服务器都可以缓存网页。这将减少 DHIS2 服务器的流量，并有可能加快随后的页面加载速度。
分析缓存模式	支持两种不同的模式：渐进：这与分析的新渐进缓存功能有关。启用后，它会覆盖分析请求的全局缓存策略。该模式将触发所有分析请求的 HTTP 和数据层缓存。启用该模式后，缓存因子为必选项。固定：请求将根据缓存策略中定义的时间段进行缓存。
缓存系数	为缓存因子选择一个值。该字段仅在分析缓存模式设置为渐进时可用。它会显示一个整数列表，每个整数代表一个绝对缓存系数。内部将使用该整数来计算每个分析请求的最终过期时间。缓存系数越大，请求的缓存时间就越长。
在分析中隐藏未经批准的数据的最长年限	设置分析是否应尊重数据的批准级别以及批准级别的时间。通常情况下，几年前的数据会被默认为已批准。为了加快分析请求的速度，可以选择忽略历史数据的实际批准级别。从不检查批准：无论数据的批准状态如何，都不会隐藏数据。检查所有数据的审批：始终检查审批状态。其他选项，例如最近 3 年：将检查 3 年以内数据的批准状态；不检查较早的数据。
在分析表导出中尊重类别选项的开始和结束日期	此设置可控制分析是否要过滤与有开始和结束日期的类别选项相关联，但与类别选项有效期间隔内的时间段不相关联的数据。
在分析表中包含零数据值	此设置允许在分析表中包含零值。这只适用于启用了存储零数据值属性的数据元素。请注意，强烈不建议在大量数据元素上设置存储零数据值，因为这会使分析表中充满零，造成不必要的性能开销。
启用嵌入式仪表板	如果启用，用户在创建新仪表盘时会看到两种仪表盘创建模式：1) 内部：基于当前实例数据的现有仪表盘创建流程：根据实例外部数据嵌入仪表盘。
允许用户切换仪表板项目视图类型	允许用户使用仪表盘项目菜单在图表、数据透视表和地图之间切换仪表盘项目视图。
允许用户在相关应用项目中打开仪表板项目	允许用户使用仪表盘项目菜单在应用项目中打开该类型项目的仪表盘项目。
允许用户显示仪表板项目的解释和详细信息	允许用户使用仪表板项目菜单查看仪表板项目的解释和详细信息。
允许用户全屏查看仪表板项目	允许用户使用仪表板项目菜单全屏查看仪表板项目。
在设施地图图层中设置机构单位组	定义默认的组织单位组集，在使用地图应用项目时可使用该组集的图标对设施进行样式标注。
设施地图图层中的机构单位级别	定义使用地图应用项目时设施图层的默认级别。除非用户为给定图层选择了不同的级别，否则将显示默认级别的组织单位。
默认基图	选择地图应用中默认选择的基图。如果未选择任何值，则将使用 OSM Light。

服务器设定¶

表格服务器设置

设置	描述
数据库服务器 CPU 数量	设置数据库服务器的 CPU 内核数。这样，当数据库托管在与应用服务器不同的服务器上时，系统就能以最佳状态运行，因为 DHIS2 中的分析功能是随可用内核数量线性扩展的。
系统通知电子邮件地址	定义接收系统通知的电子邮件地址。分析表生成等流程中的故障通知将在此发送。这对应用项目监控非常有用。
谷歌分析（通用分析）关键*	设置 Google UA 密钥，以便通过 Google Analytics 平台为您的 DHIS2 实例提供使用分析。需要注意的是，目前 DHIS2 中并非所有应用项目都支持 Google Analytics，因此用户的某些活动可能不会出现在该平台上。有关 Google Analytics 的更多信息，请访问 google.com/analytics。
谷歌地图 API 密钥	定义 Google 地图 API 的 API 密钥。使用此密钥可在 DHIS2 中查看谷歌地图图层。请注意，在 DHIS2 地图应用项目中启用谷歌地球引擎图层需要设置不同的密钥。请参阅 documentation 。
必应地图 API 密钥	定义必应地图 API 的 API 密钥。添加此密钥可在 DHIS2 地图应用项目中使用必应基础地图。有关设置密钥的信息，请参阅必应地图 API 密钥文档。

外观设置¶

表格外观设置

设置	描述
选择语言	设置语言，然后可以输入以下设置的翻译： * 应用程序标题 * 应用程序介绍 * 应用程序通知 * 应用程序左侧页脚 * 应用程序右侧页脚 * 注在每个设置接受翻译值之前，它们首先需要有一个默认/后备值。可以通过在该下拉菜单中选择系统默认值（回退）来设置该值。
申请标题	设置顶部菜单上的应用项目标题。
申请介绍	设置登录页面左上方的系统介绍。
申请通知	设置登录区域下的首页通知。
应用项目左侧页脚	设置登录页面左侧页脚区域的文本。(如果使用的是从右到左的脚本语言，如阿拉伯语，则该文本将位于登录页面的右侧页脚区域）。
应用项目右侧页脚	设置登录页面右侧页脚区域的文本。(如果使用的语言是从右到左的文字（如阿拉伯语），则该文本将位于登录页面的左侧页脚区域）。
风格（安卓）	该设置会影响 DHIS2 安卓应用项目的风格（外观和感觉）。这种风格一般不适用于网络应用项目。
开始页面	设置用户登录后将重定向到的页面或应用项目。建议设置：Dashboard 应用项目。
启用轻量级启动页面	指示应用项目渲染轻量级的快速登陆页面。建议在低带宽环境下使用。
帮助页面链接	定义用户点击配置文件（>*帮助）时将看到的 URL。
旗帜	设置仪表盘应用左侧菜单中显示的标志。
界面语言	设置用户界面使用的语言。用户可以在设置应用项目中覆盖此设置：用户设置 > 界面语言。
数据库语言	设置数据库中使用的语言。用户可以在设置应用项目中覆盖此设置：用户设置 > 数据库语言.
需要授权才能添加到查看对象列表	如果选择此选项，如果当前用户没有权限创建对象类型（私人或公开），则会隐藏菜单和索引页面项以及对象列表链接。
自定义登录页面徽标	选择此选项并上传图片，即可在登录页面添加徽标。
登录页面主题	您可以选择登录应用项目的默认布局、侧边栏布局或自定义布局。如果选择自定义布局，则需要在 "登录页面模板 "部分提供自定义模板。
登录页面模板	在这里，您可以粘贴 HTML 来定义登录页面的布局和样式。有关如何定义模板的更多详情，请参阅开发人员文档。
启用全局外壳*	启用该属性（默认设置为 true）后，全局外壳将为所有 DHIS2 网络应用项目提供通用界面和导航工具。有关全局外壳的更多技术细节，请参阅开发人员门户。

电子邮件设定¶

表格电子邮件设置

设置	描述
主机名称	设置 SMTP 服务器的主机名。使用 Google SMTP 服务时，主机名应为 smtp.gmail.com。
港口*	设置连接 SMTP 服务器的端口。
用户名	SMTP 服务器用户账户的用户名。 mail@dhis2.org
密码	SMTP 服务器用户账户的密码。
TLS	如果 SMPT 服务器要求使用 TLS 进行连接，请选择此选项。
电子邮件发件人	发送电子邮件时用作发件人的电子邮件地址。
向我发送测试电子邮件	向当前登录 DHIS2 的用户发送测试电子邮件。

访问设置¶

表格访问设置

设置	描述
自我注册账户用户角色	定义应赋予自助注册用户账户的用户角色。要启用用户自助注册：从列表中选择任意用户角色。登录页面上将显示自我注册表单的链接。注要启用自助注册，还必须选择一个自助注册账户组织单位。要禁用用户自助注册：选择禁用自助注册。
自我登记账户组织单位	定义哪个组织单位应与自助注册用户相关联。注要启用自助注册，还必须选择自助注册账户用户角色。
自助注册无需验证码	定义是否要使用 reCAPTCHA 进行用户自助注册。默认情况下已启用。
启用用户账户恢复功能	定义用户是否可以恢复自己的密码。启用此设置后，首页上将显示账户恢复表单的链接。注用户账户恢复需要配置电子邮件设置（SMTP）。
强化验证电子邮件	控制用户在访问系统前是否必须验证其电子邮件地址。只有当系统配置为发送电子邮件（SMTP）时，才能启用此设置。注意：如果未在设置应用项目中设置keyEmailHostName或keyEmailUserName值，强制验证电子邮件复选框将被禁用，且不能设置为true。如果缺少这些 SMTP 设置，强制验证电子邮件可设置为假（如果已设置为真），但在配置所需电子邮件设置之前无法启用。
多次登录失败后暂时锁定用户账户	定义在 15 分钟内连续五次尝试登录失败后，系统是否应锁定用户账户。账户将被锁定 15 分钟，然后用户可以再次尝试登录。
允许用户授予自己的用户角色	定义用户在创建新用户时是否可以将自己拥有的用户角色授予他人。
允许在添加或更新时将对象分配给相关对象	定义是否允许用户在创建或编辑元数据对象时将对象分配给相关对象。创建或编辑组织单位时，可以允许用户将组织单位分配给数据集和组织单位组集。
要求更改用户账户密码	定义是否强制用户每 3 个月、6 个月或 12 个月更改一次密码。如果不想强制用户更改密码，请选择从不。
在密码过期前向用户发送提醒	设置后，用户将在密码即将过期时收到通知。
密码到期前发送提醒的天数	如果选择在用户密码到期前向其发送提醒邮件，则会显示此设置。您可以选择在密码到期前 1 到 28 天之间发送电子邮件。
密码的最少字符数	定义用户密码中必须包含的最少字符数。可以选择 8（默认）、10、12 或 14。
CORS 允许列表	允许列出一组可从另一个域访问 DHIS2 API 的 URL。每个 URL 都应单独成行输入。跨源资源共享（CORS）是一种机制，允许从提供第一个资源的域之外的另一个域请求网页上的受限资源（如 javascript 文件）。

通知设置{ #system_notification_settings }¶

表格通知设置

设置	描述
notifierLogLevel	日志/列表中包含的信息级别，默认为 `DEBUG` (全部)
每个任务的最大通知消息	每项工作的列表中最多可包含此数量的信息（软强制执行，允许临时超出一些限制）；默认为 `500` 。
最大通知年龄天数	超过此天数的任务数据将被丢弃（软强制，空闲 1 分钟后清理）；默认为 "7
notifierMaxJobsPerType	如果每个作业类型的数据作业数超过此值，则丢弃最旧的作业，以低于此限制（软强制，空闲 1 分钟后清理）；默认为 `500`.
notifierCleanAfterIdleTime	在使用 `notifierMaxAgeDays` 和 `notifierMaxJobsPerType` 作为上限运行自动存储清理之前，通知项目必须处于空闲（未将信息从队列移至存储）状态的时间（毫秒）；默认为 `60`sec
notifierGistOverview	为 "true "时，概览页面将只显示列表中每项工作的第一条和最后一条信息；默认为 "true

日历设定¶

表格日历设置

设置	描述
日历	定义系统将使用的日历。系统支持以下日历：科普特历、埃塞俄比亚历、格里高利历、伊斯兰历（农历）、ISO 8601 历、儒略历、尼泊尔历、波斯历（阳历）和泰历。这是系统范围内的设置。在单个 DHIS2 实例中不可能有多个日历。有关公历和 ISO 8601 之间区别的更多信息，请参阅此处。
日期格式	定义系统将使用的日期格式。

资料汇入设定¶

数据导入设置适用于可以启用的其他控件验证通过Web API导入的汇总数据。他们对应视为冲突的事项提供可选约束在导入期间。将约束应用于每个单独的数据值在导入中。

表格数据导入设置

设置	描述
要求周期与数据集的周期类型相匹配	要求数据值的周期与数据值的数据元素所属的数据集的周期类型相同。
要求数据元素成为数据集的一部分	要求将数据值的数据元素分配给数据集。如果在导入时指定了特定的数据集，系统将检查数据值是否与指定的数据集相关联。
要求类别选项组合与数据元素的类别组合相匹配	要求数据值的类别选项组合是数据值数据元素类别组合的一部分。
要求组织单位与数据集的分配相匹配	要求数据值的组织单位分配给一个或多个数据集，数据值的数据元素分配给这些数据集。
要求属性选项组合与数据集的类别组合相匹配	要求数据值的属性选项组合是数据值的数据元素所属数据集类别组合的一部分。
要求指定类别选项组合	要求指定数据值的类别选项组合。如果未指定，默认情况下将返回默认类别选项组合。
要求指定属性选项组合	要求指定数据值的属性选项组合。默认情况下，如果未指定，将返回默认属性选项组合。

同步设定¶

以下设置用于数据和元数据同步。

注意

有关如何配置元数据同步的更多信息，请参阅[配置元数据同步]（https://docs.dhis2.org/master/zh/user/html/metadata_sync.html）

表格同步设置

设置	描述
远程服务器URL	定义要上传数据值到运行 DHIS2 的远程服务器的 URL。建议使用 SSL/HTTPS，因为用户名和密码会与请求一起发送（使用基本身份验证）。系统将尝试每分钟同步一次数据。系统也将使用此设置同步元数据。注意要启用数据和元数据同步，还必须在日程安排应用项目中启用数据同步和元数据同步的任务。
远程服务器用户名	用于数据同步的远程服务器上 DHIS2 用户账户的用户名。注意如果启用了元数据版本控制，则必须确保配置的用户具有 "F_METADATA_MANAGE "权限。
远程服务器密码	远程服务器上 DHIS2 用户账户的密码。密码将加密存储。
启用元数据同步版本	定义在中央实例和本地实例之间同步元数据时是否创建元数据版本。
如果 DHIS 版本不同，请勿同步元数据	不同版本的 DHIS2 元数据模式会发生变化，这可能导致不同版本的元数据不兼容。启用该选项后，如果中央实例和本地实例的 DHIS2 版本不同，将不允许进行元数据同步。这适用于通过用户界面和 API 进行的元数据同步。只有在同步基本实体（如数据元素）时禁用该选项才有价值，因为这些实体在不同 DHIS2 版本之间没有变化。
尽最大努力	元数据版本类型，决定本地实例的导入项目如何处理元数据版本。尽最大努力指的是，如果元数据导入遇到缺失引用（例如数据元素组导入中的数据元素缺失），它会忽略错误并继续导入。
原子	元数据版本类型，决定本地实例的导入项目如何处理元数据版本。原子表示全有或全无--如果任何引用不存在，元数据导入将失败。

OAuth2客户端¶

您可以在 **系统设置 **中创建，编辑和删除OAuth2客户端应用程序。

打开 **系统设置 **应用，然后单击 **OAuth2客户端 **。
点击添加按钮。
输入 ** 客户 ID** 和 ** 客户密码**。
选择 授权类型：刷新令牌或授权码。
输入**重定向URI **。如果您有多个URI，请使用一条线。