移动¶
本章涵盖了各种移动技术，包括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）。这是登录表格 使用用户名和密码访问应用程序。点击“登录” 继续或“重置”重置：
登录后，有功能列表：
- 汇总报告： 按组织单位定义/分配数据集的汇总数据条目。 按组织单位定义/指定数据集的汇总数据条目
-追踪：
-
查找人员：根据姓名，电话号码或ID查找人员，以及 组织单位。
-
活动计划：按组织单位输入人员的数据， 人员和程序/程序阶段
-
人员注册：注册新人员
-
匿名：基于程序的匿名人条目
- 消息： 管理来自服务器的消息和讨论。 可以回复消息。用户可以在 "信息 "中发送反馈信息。
**-报告：**服务器的输出报告。
-**设置：**用户信息（例如：名字，姓氏，电话 号码，电子邮件）和界面语言。
**-注销：**退出应用程序。
-桌面版本：导航至DHIS2的桌面版本 行政。这需要来自客户端移动设备的大量资源， 例如：足够的内存来加载页面。不建议 适用于普通GPRS / 3G / ...电话。
上面的列表将详细说明：
-
** 汇总报告：** 汇总数据的条目，包括 定义/分配的数据集 组织单位。
点击“汇总报告”，然后选择一个组织单位 从列表中出现，数据集列表将针对 输入汇总数据。请参见以下示例：
步骤1：从 清单
步骤2：从中选择一个数据集（输入表单） 清单
步骤3：选择一个期间（基于所选期间的类型 数据集） 清单
步骤4：输入 数据
步骤5：在填写完数据后保存输入的数据，选择 数据完整性选项，如果 有。
-
跟踪： 查找/添加人员、访问日程、人员 注册， 匿名
2.1 查找/添加人：根据姓名，电话号码查找人 或ID，以及组织单位。
-
步骤1：输入姓名，电话号码或ID，然后选择 组织单位，然后单击 搜索。
-
步骤2：选择一个 人
然后将显示该人的所有信息
-
步骤3：选择下一个程序阶段以输入 数据
要查看所有程序阶段，请单击该程序的名称 程序（Child Heath程序为屏幕 射击）
2.2:访问日程*：选择组织单位
-
当前活动计划：已注册的受益人列表， 已注册，尚未完成/完成一个/许多程序，并且在 至少是程序阶段开放的数据输入。
+ 步骤1：选择一个人 条目
+ 第2步：选择当前的活动阶段 进入 数据
您还可以查看此人的信息（ID，性别， 点击“详细信息”（位于 列表 出现）
所选的详细信息 人：
-
所有活动计划：所有已注册受益人的列表， 已注册，尚未完成/完成一个/许多程序。
-
单 事件：
2.3：**人员注册：**注册新人员
-
步骤1：个人输入 信息
-
步骤2：为刚注册的人注册程序，然后 点击 “注册”。
-
步骤3：输入所选程序所需的信息，然后 点击 “注册”
这里是 结果：
2.4：**匿名：**基于特定条目的匿名人员条目 程式
-
-
**消息：**管理"...... "中的消息和讨论。 服务器。留言回复为 可用的。
显示的数字是未读邮件。点击查看 邮件列表（未读邮件为粗体和深蓝色 颜色）：
然后，您可以通过以下方式获取讨论的消息/主题： 留下回覆讯息，请看这里 例：
用户可以在“消息”部分中创建反馈并将其发送到服务器。 发送新的反馈后，消息（反馈）将是 在“消息”下列出以进行进一步的跟踪。
-
报告： 来自 服务器
（将会被更新）
-
设置： 用户信息（如：名、姓、电话、传真、传真号码等）：名、姓、电话 号码，电子邮件）和界面 语言。
这是用于设置用户帐户/访问权限和 界面语言。单击“保存”以完成设置，请参阅 这个例子 下面：
-
**登出：**登出 应用
-
台式机版本：浏览至DHIS2的台式机版本 行政。
这是桌面版本的GUI（需要大量内存 （用于加载），不建议在普通移动设备上使用。该示例 DHIS2演示（来自 dhis2.org)
-
单击“基于名称的数据条目”后，下一个将指导 在以下步骤中选择：
步骤1：选择组织 单元
步骤2：选择活动 类型
（该屏幕截图带有“当前活动计划”的示例 选项）
通常会有以下两种类型的活动：
+“当前活动计划”：受益者列表 已注册，已注册，尚未完成/完成一个/许多程序，并且 至少有一个程序阶段可供数据输入。
+“所有活动计划”：所有已注册受益人的列表， 已注册，尚未完成/完成一个/许多程序。
步骤3：选择受益人 条目
（带有“ Hybia Welde”选项的示例的屏幕截图）
第4步：选择一个当前活动的程序阶段以输入 数据
（屏幕截图显示了“出生后16-24个月”的示例 选项）
您还可以查看收款人的信息（ID，性别， 点击“详细信息”（位于 清单 出现）
所选的详细信息 受益人：
-
受益人注册： 注册一个新的 受益人
步骤1：选择一个 组织单位
步骤2：填写受益人登记 形成
有必要的信息：全名，性别，出生日期（和 血型）。
点击“保存”以注册新的受益人。
收款人是时，会出现“成功保存”消息 创建/注册 成功。
-
受益人注册： 为受益人注册一个或多个 程式
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:
-
**消息：**管理"...... "中的消息和讨论。 服务器。留言回复为 可用的。
显示的数字是未读邮件。点击查看 邮件列表（未读邮件为粗体和深蓝色 颜色）：
然后，您可以通过以下方式获取讨论的消息/主题： 留下回覆讯息，请看这里 例：
-
报告： 来自 服务器
（将会被更新）
-
设置： 用户信息（如：名、姓、电话、传真、传真号码等）：名、姓、电话 号码，电子邮件）和界面 语言。
这是用于设置用户帐户/访问权限和 界面语言。单击“保存”以完成设置，请参阅 这个例子 下面：
-
反馈： 用于创建新信息的额外功能，以 发送到服务器。由此产生的新反馈将是 列在 “ 消息”
点击“反馈”后，将有一个表格 编辑/发送新消息/讨论。看例子 下面：
发送新的反馈后，消息（反馈）将是 在“消息”下列出以供进一步关注 向上。
-
**登出：**登出 应用
-
台式机版本：浏览至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.
数据集和报告表格的详细配置¶
尽管前面的步骤是测试 解决方案可能需要对数据集进行更详细的配置，并且 在以下各节中进行介绍。
数据集到电话上的表单布局的映射¶
默认情况下，数据集映射到电话上的单个表单。如果 数据集分为多个部分，每个部分显示为 手机上的单独页面。如果数据元素具有多个类别 选项组合将显示为带有类别的标题 组合选项如下。
| 外形设计元素 | DHIS2 元数据 | 元数据元素 |
| 表格标题 | 资料集 | 简称（如果存在），否则 名称 |
| 页码 | 删除源指标,增加目标指标 | 科室名称（如无科室，则为表格名称） |
| 问题 | 数据元素 | 替代名称（如果存在），否则 名称 |
| 问题名称（如有组合 | 类别选项组合 | 名称 |
表格排序¶
默认情况下，数据元素将根据全局排序进行排序 在DHIS2中分配。如果使用节，则按节的特定排序 订单将被使用。在某些情况下，当不使用节时，数据 元素可能在多个数据集中使用，并且在方式上存在冲突 应该在单个数据集中排序。为此工作 情况是将整个数据集包装在一个部分中（请注意， 仅在数据元素具有相同的类别选项组合时才有效）
数据集的版本控制¶
为了能够在移动设备上比较和更新数据集 服务器上的版本的手机，数据集会自动 编辑数据集结构时版本化。发生的一些变化 在DHIS2服务器上，将导致移动客户端更新其表格 新版本。
-
创建数据集
-
编辑数据集
-
在数据集中创建/编辑/删除部分
-
排序部分顺序
-
更新数据元素（影响许多相关的数据集）
-
删除数据元素（影响许多相关的数据集）
-
编辑数据元素类别
-
编辑DataElement类别组合
语言支持¶
提供多语言支持。
DataSet和DataElement通过基于Web的功能进行转换。 如果请求的语言，则服务器上的默认语言在移动设备上使用 无法使用手机版。
移动应用程序设置¶
安装和初始化¶
安装¶
从 DHIS2 主页下载 jar 包： https://www.dhis2.org/downloads
初始化¶
出厂前应进行初始化 终端用户。鉴于可能的电话配置差异很大， 无法描述顺序所需的确切步骤 以便在电话上启用客户端。但是，对于大多数手机而言， 使用USB将DHIS2 Web Mobile客户端“ JAR”文件复制到电话中 电缆或通过蓝牙就足够了。当然，GPRS / 3G连接 必须启用。请与您的移动服务提供商联系，以获取详细信息 有关电话和网络的配置。
客户端安装到手机上后，进行初始化 必须通过提供用户名，密码和服务器URL来进行此过程。
-
首次登录服务器。
客户端第一次登录服务器，或者如果客户端是 重新初始化后，用户名，密码和服务器URL必须为 输入。
如果客户端无法登录，则可能有几种可能 您看到的错误消息。
-
找不到连接：指定的服务器URL不正确。 检查服务器地址，确保服务器实际上是 可达，然后重试。
-
用户名或密码无效：用户名或密码为 不正确的
-
应用程序无权访问受限API： 可以联系服务器，但是用户没有 访问移动报告模块所需的权限
-
-
设置PIN码：初始登录过程后，输入PIN码 号码可以由用户输入。这将使登录过程 更加容易，因为用户只需记住四位数的密码 数字，而不是分别输入用户名和密码 时间。如果事先初始化电话，则可以预设PIN码 交货，也可以由用户自行设置 提供了用户名和密码。
After entering the PIN, press (Menu)->Next.
-
下载所有表格：指定PIN后，所有表格都会 从服务器下载并本地存储在手机上。
如果已将用户配置为报告汇总数据集，则 将显示适当的数据集列表。如果用户是 负责基于社区的报告，分配清单 显示活动。
注意：如果卫生工作者负责这两个设施 报告和社区报告，DHIS2服务器将发送所有表格 设施报告和社区报告在移动设备上以及 移动设备，屏幕上会选择是否显示设备 报告或社区报告。
错误：
登录（常规使用）¶
启动应用程序后，将显示PIN表单。
-
PIN码：输入四位数的PIN码。
-
重新初始化命令：此功能将清除手机上的所有数据 然后从登录屏幕开始，输入用户名和密码。
-
错误：无效的PIN：如果用户输入了无效的PIN，则他们 将需要输入正确的PIN或重新初始化应用程序 使用正确的用户名和密码。
设施报告模块¶
输入数据¶
从“选择报告表”中选择汇总数据集后 窗口，用户将需要选择适当的时间段。一个列表 的可用时间段会自动生成。
-
用户输入PIN后，他们可以从以下列表中进行选择 可用的数据集。选择适当的数据集，然后按“下一步”。
-
选择期间：将自动列出可用期间 显示给用户。他们可以从中选择合适的时期 列表。
-
填写值：选择期间后，可以显示表格 有两种模式，具体取决于
-
带有部分的表格
每个表单部分都显示在一个带有名称的屏幕中 标题窗口中该部分的内容。
要在屏幕之间导航，请按“下一步”。
-
不带节的表单（不带节的数据集）
所有字段都显示在一个屏幕上，标题为 数据集的名称
用户只需用适当的填充每个数据元素 值。
-
-
保存并完成：
完成数据输入后，用户可以选择保存数据 本地电话上或直接将数据上传到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.
笔记¶
-
期间清单：
标有星号（ *）的期间是已完成的期间 还是保存，取决于数据的状态 条目。
All periods that are not in period list are considered old and will be deleted automatically.
-
存储值持续时间
在手机上保存的表格数量仅受 移动设备的有效存储量。
表格仅保存有限的时间，具体取决于频率 特定数据集的集合。
-
每日表格：2个月（当月和上个月）
-
每周表格：4周（当前和前3周）
-
月度表格：2个月（当月和上个月）
-
季度表格：2个季度（当前和上一个季度）
-
年度表格：2年（当前和前一年）
-
-
填写完毕的表格-无法修改的表格
如果表单已完成，则用户可以在其上查看表单 电话，但他们无法对该表单进行任何后续编辑。每 该字段显示为灰色，并且对于编辑无效。
-
重新编辑填写好的表格
如果用户希望编辑已经提交给的数据 服务器，则可以通过点击“编辑”按钮来实现。他们是 假设数据集尚未锁定，则允许执行此操作 有关时期。如果他们尝试上传数据，则用户 系统会通知您该数据集已被锁定，但尚未锁定 可以上传数据。
-
更新表格：
此功能用于在手机和手机上同步表格 服务器。输入PIN后自动触发该过程 数。
注意：检查和下载更新的表单过程在 背景。完成后，显示提示询问用户是否 刷新表单列表或留在原处。
-
多国语言支持：
此功能帮助用户选择手机GUI的语言 （图形用户界面）和内容的语言（表格）。
表单必须在服务器上翻译，否则为默认语言 用来。
首次登录的默认语言是英语。更改语言 设置菜单将同时影响界面和内容。
多国语言界面：在“设置”菜单中，有以下列表： 支持的语言（从服务器下载）。仅GUI语言 重新启动应用程序后更改。
多语言内容（表单）：表单语言在更改后 点击“保存”。如果表格很多，则需要几分钟 保存设置。
故障排除¶
-
数据已在手机上输入，但未出现在服务器上
通常在用户在手机上输入数据时发生，但不能 将其发送到服务器。这可能是由于 电话，电话信用不足或覆盖范围不足。通常 显示错误消息，如下所示。
Users should be informed that if they see this error, then it means that their data has not been transmitted.
短信命令{ #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命令类型都通用的参数。 如果用户使用这些参数，则在系统中配置默认值 确实为这些参数提供了任何值，那么那些默认参数将 使用。这是这些参数的列表
表：常用参数
| 默认值 | 类型 | 描述 |
|---|---|---|
| 代码值分隔符 | 串 | 提供自定义代码值分隔符。默认为"="。 |
| 现场分隔器 | 串 | 提供自定义字段分隔符。默认为" |
| 如果没有发送代码（只有命令），则回复信息 | 串 | 在 SMS 文本输入中找不到代码时提供信息。默认为 "缺少参数"。 |
| 格式错误信息 | 串 | 在命令格式不正确时提供信息。命令格式应与代码值分隔符一致。如果缺少任何必选参数，也会返回该信息。 |
| 无用户信息 | 串 | 如果发送的电话号码未在 DHIS2 中注册，则提供信息。 |
| 用户属于多个机关单位的信息 | 串 | 某些 SMS 命令类型要求用户（从发送电话号码中获取）只与一个组织单位相关联。如果该要求未得到满足，则可将该信息配置为回发。 |
| 成功信息 | 串 | 提供流程成功完成后将发送的信息。 |
短信命令类型¶
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 **
如果字段分隔符是","，那么文本将如下所示 this.childProgram fn=xmen,ln=xmen2,age=4
其余行为与其他命令相同。如果用户不 提供这些参数，然后将使用默认参数。
用于程序阶段数据输入的SMS命令¶
PROGRAM _STAGE _DATAENTRY _PARSER可用于进入程序阶段 特定跟踪实体实例的相关数据。
命令名称后将跟与特定名称有关的数据元素 该命令所关联的程序阶段。程序与程序 创建此命令时将完成阶段选择。
默认文本模式（如果不是字段分隔符和代码值分隔符 为该解析器提供）如下所示。 **程序阶段 bcgd = 1 | opvd = 2 | wght = 34 **
如果字段分隔符为","，则文本将如下所示 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。
- 配置短信网关
配置短信网关¶
SMS 服务支持五种不同类型的网关。SMS 可以发送。如果存在多个 网关，则将以循环方式使用这些网关，以实现负载平衡。 负载平衡。不同类型的网关有不同的参数。 不同类型的网关有不同的参数。网关可在移动配置模块的图形用户界面中配置，如图所示。 模块中的图形用户界面配置网关，如图所示。有关配置网关所需参数的更多信息 有关配置网关所需参数的更多信息，请参阅新 SMS 应用项目的 [网关 配置]部分。
配置GenericHttp网关¶
许多 DHIS2 实例都使用 GenericHttpGateway 连接到它们的 本地网关。这些本地网关提供用于发送短信的 HTTP API。 在新的 GenericHttpGateway 中，现在可以为网关配置配置通用配置模板。 模板进行网关配置。该模板通过将 替换为网关键值参数中的实际值。
网关配置¶
下表显示了配置网关所需的参数。
表网关配置参数
| 默认值 | 群发短信网关 | Clickatell 网关 | 通用 HTTP 网关 | SMPP网关 | 描述 |
|---|---|---|---|---|---|
| 网关名称 | 可选的 | 可选的 | 可选的 | 可选的 | 用作网关标识。如果未配置该参数，将保存默认名称。建议使用 |
| 用户名 | 需要 | 可选（如果使用标记） | 需要 | 需要 | 用于 API 验证 |
| 密码 | 需要 | 可选（如果使用标记） | 需要 | 需要 | 用于 API 验证 |
| 身份令牌 | 不适用 | 可选（如果使用密码） | 不适用 | 不适用 | 用于 API 验证 |
| URL 模板 | 不适用 | 不适用 | 需要 | 需要 | 只有在使用 GenericHttpGateway 时才需要 Url Tempalte。例如 "http://smsgatewa1.com" |
| 页眉 | 不适用 | 不适用 | 可选的 | 不适用 | 可以选中头信息选项，将所选参数作为 http 头信息发送。例如，用户名/密码/令牌可在 http 头信息中发送。 |
| Clickatell | 不适用 | 不适用 | 可选的 | 不适用 | 向网关发布数据默认使用 HTTP POST 方法。但在某些情况下，如果需要使用 HTTP GET 方法，则可将 useGet 参数设置为 true。useGet 的默认值为 false。 |
| 系统类型 | 不适用 | 不适用 | 不适用 | 需要 | SMPP 网关需要 SystemType 参数。默认值为 "cp |
| 数字类型 | 不适用 | 不适用 | 不适用 | 需要 | SMPP 网关需要使用 TypeOfNumber 参数。默认值为 "未知"。其他可能的值包括 UNKNOWN、INTERNATIONAL、NATIONAL、NETWORK_SPECIFIC、SUBSCRIBER_NUMBERIC、ALPHANUMERIC 和 ABBREVIATED。 |
| 数字计划指示器 | 不适用 | 不适用 | 不适用 | 需要 | SMPP 网关需要 NumberPlanIndicator 参数。默认值为 UNKNOWN。其他可能的值包括 UNKNOWN、ISDN、DATA、TELEX、LAND_MOBILE、NATIONAL、PRIVATE、ERMES、INTERNET 和 WAP。 |
| 绑定类型 | 不适用 | 不适用 | 不适用 | 需要 | SMPP 网关需要 BindType 参数。默认值为 TX。其他可能的值为 BIND_TX、BIND_RX 和 BIND_TRX |
| 压缩 | 不适用 | 不适用 | 不适用 | 可选的 | 压缩参数是 SMPP 网关的可选参数。默认值为 false |
| Content type specify what type of data is being sent. Supported types are APPLICATION_JSON, APPLICATION_XML, FORM_URL_ENCODED, TEXT_PLAIN | 不适用 | 不适用 | 可选的 | 不适用 | 网关参数将附加 url 例如 https://samplegateway.com/messages?apiKey={apiKey}&to={recipients},content={text},deliveryreport={dp} |
| ```json | |||||
| { | |||||
| "type": "bulksms", | |||||
| "name": "bulkSMS", | |||||
| "username": "bulkuser", | |||||
| "password": "abc123" | |||||
| } | |||||
| ``` | 不适用 | 不适用 | 可选的 | 不适用 | 发送到短信网关的数据类型。默认为 application/x-www-form-urlencoded。其他支持的类型有 application/json、application/xml 和 text/plain。 |
| PUT /api/33/gateways/default/{uid} | 不适用 | 不适用 | 可选的 | 不适用 | 通用配置模板可用于以外部网关可接受的形式提供数据。例如，username=${username}&password=${password}&to=${recipients}&countrycode=880&message=${text$}&messageid=0。也可提供 Json/xml 模板。 |