Android Capture App支持的程序规则¶

https://example.org/api/programRules?fields=program[name],name,programRuleActions[data],condition&filter=programRuleActions.data:like:hasValue&filter=condition:like:hasValue&rootJunction=OR

#### 如何解决？ { #how-to-fix-it } 

上面的示例显示了使用hasValue函数的不同方式如何与2.2版产生相同的效果。没有强制性的更改，但是要记住，在编写新程序规则时，保持一致可能有助于避免问题。

### 变量评估 { #capture_app_pr_changes_eval_var }

#### 描述 { #description } 

这是强制性的改变。 *!#{variable_name}* 只能使用布尔类型变量（BOOLEAN 和 TRUE_ONLY）。

#### 如何通过API进行识别？ { #how-to-identify-via-api } 

获取类型为NOT BOOLEAN或TRUE_ONLY的dataElements的programRulesVariables

获取所有programRule.conditions

手动（或通过脚本以编程方式）检查是否在programRule.conditions列表（通过第二个API调用获得）中使用了任何程序规则变量（通过第一个API调用获得）。

例如，从第一个列表中，我们得到：

``xml
<programRuleVariable name="AdditionalMedication"/>
<programRuleVariable name="age"/>
<programRuleVariable name="Age in years"/>
<programRuleVariable name="AgeYears"/>
<programRuleVariable name="allergies"/>
<programRuleVariable name="apgarcomment"/>

这表明NON BOOLEAN变量被错误地使用。

#### 如何解决？ { #how-to-fix-it } 

确保在您的条件下评估BOOLEAN或TRUE_ONLY变量。如果程序规则变量不是该类型，请使用d2：hasValue（＃{variable_name}）或d2：hasValue（'variable_name'）更新程序规则条件

在上面的示例中，条件应更改为：

``xml
<condition>年龄</condition>

### 评估文字 { #capture_app_pr_changes_eval_text }

#### 描述 { #description } 

这是强制性的改变。在 ASSIGN、DISPLAY TEXT、DISPLAY KEY/VALUE PAIR、SHOW WARNING、SHOW ERROR、WARNING ON COMPLETE 或 ERROR ON COMPLETE 类型的程序规则操作中，如果要计算和分配/显示的表达式是文本，则必须用单引号括起来引号。

#### 如何通过API进行识别？ { #how-to-identify-via-api } 

获取程序规则，这些操作的类型为文本，并且在字段数据上带有某些内容，并验证其数据内容以查找不带引号的字符串。

例如，我们可以在此处检测到第一个“程序规则操作”中没有引号的文本字段错误，而第二个正确。

``xml
<programRule name="PR04- !#{varible_name} - BOOLEAN - Assign text without quotes">
<program name="JB_Testing_2.2"/>
<programRuleActions>
<programRuleAction>
<programRuleActionType>显示警告</programRuleActionType>
<data>嵌入</data>
<content>PR04 文本带引号：</content>
</programRuleAction>
</programRuleActions>
</programRule>

#### 如何解决？ { #how-to-fix-it } 

扫描生成的列表（通过建议的API调用）以查找“程序规则操作”中未引用文本的数据组件，然后转到每个已标识的程序规则并进行更新。

### 字符串和对象的串联 { #capture_app_pr_changes_concat }

#### 描述 { #description } 

这是强制性的改变。在 ASSIGN、DISPLAY TEXT、DISPLAY KEY/VALUE PAIR、SHOW WARNING、SHOW ERROR、WARNING ON COMPLETE 或 ERROR ON COMPLETE 类型的程序规则操作中，如果要计算和分配/显示的表达式是文本，则必须用单引号括起来引号（与之前的更改相同）；但是，最重要的是，如果需要连接两个字符串或函数组合，则必须使用 *d2:concatenate* 函数。

#### 如何通过API进行识别？ { #how-to-identify-via-api } 

获取程序规则，这些操作是文本类型的，具有字段数据上的任何内容，并验证其数据内容以检查是否在两个或多个字符串（或其他对象）被合并的情况下使用了d2：concatenate函数

获取程序规则，其中哪些操作为文本类型，并验证其数据内容以查找不带引号的字符串。

例如，我们可以在不使用d2：concatenate的情况下在一个动作中检测到两个字符串的错误。

``xml
<programRule name="PR08- Assign text and variable without concatenate">
<program name="JB_Testing_2.2"/>
<programRuleActions>
<programRuleAction>
<programRuleActionType>显示警告</programRuleActionType>
<data>年龄为 10，模数""另一个字符串</data>
<content>PR05 不带连接的文本是：</content>
</programRuleAction>
</programRuleActions>
</programRule>

到：
``xml
<data>d2:concatenate('Age is 10 and modulus','another string')</data>