名称：

Find | 查询

图标：

功能：

• 查询全部或等值查询
• 要查询的记录是由输出的数据库表元件的“tableName”属性值来确定的
• 如果需要复杂查询，请参考使用高级查询元件或语句查询元件

• 了解数据库表记录元件如何与存入数据的数据库中的库表相关联，请参考“可视化元件手册”的“Database Record 数据库表记录”中的说明

  使用方式：

  查询数据库中的全部记录或等值查询

• 等值查询：添加一个或多个字段名称同名的输入元件并将字段对应特定值传入来进行某个或某些字段为特定值的记录，请参考以下对输入的说明

• 全部查询：如果没有字段及输入值输入，则查询输出库表/视图的全部记录，返回的是复数的数据结构对象，每个输出对象包含一条记录

  输入：

• 此元件可以手动添加多个自定义名称的输入元件做等值查询：比如库表中有有两个字段“NianLing”和“XingBie”，查询男性人员的记录时，为查询元件添加一个输入元件命名为“XingBie”，然后将“男”放入一个字符常量元件传入“XingBie”输入元件即可；如果要查多个字段分别对应的特定值时，比如上例中，查询年龄29岁的男姓的记录，则再添加一个输入元件命名为“NianLing”，然后将29这个数字放入一个数字常量元件中传入“NianLing”名称的输入元件即可

• 等值查询时，传入的特定值常量类型由数据库表对应字段的类型决定，如年龄字段是数字类型，则应将特定年龄数字用数字常量传入输入元件，此时输入元件类型也就被自动确定为数字类型输入元件
• 注意如果添加了输入元件且是必须传值状态（输入元件是绿色三角），此时如果无值传入，则保存时生成验证提示信息，要求必须项需有传入值；如果输入元件是非必须传值状态（输入元件是黄色三角），此时如果无值传入，逻辑上没有问题，也正常运行，只是查询输入元件名称对应的字段值为“空”的记录
• <Order By>：字符类型值的输入，单数，非必须项；输入排序规则，可用来定义排序字段和按字母升序或降序方式输出查询的记录
  · 无值或无<Order By>定义时按记录插入顺序输出
  · 排序规则：要按哪个子段排序，则将子段名称放入一个字符常量中传入
  · 多个字段作为排序规则时，可以用英文逗号隔开字段名称并前后依次写入，注意先按前面写入的规则排序
  · 如果需要降序排序，则在字段名称后写“DESC”，如“NianLing DESC”，按NianLing字段值降序排序，如果升序，名称后可以写“ASC”如“XingMing ASC”，没有DESC时默认就是升序
  · 多个字段不同顺序要求时，可以写为“NianLing DESC,XingMing ASC”
  · 注意排序是按字段内容值对应的字母处理的，如果是汉字，则只能将同一汉字开始的放在一起，并不能按汉语拼音处理，需要修改此元件底层代码，必要时用拼音字母加汉字作为排序对象处理
• <Data Source>：字符类型值的输入，单数，非必须项；用来指定在哪个数据库中进行记录查询操作，用一个字符常量传入数据库名称，常量值是项目配置文件设定的某个数据库名称，无此输入元件则默认为对项目主数据库进行处理

• <Auto Commit>：布尔类型值的输入，单数，非必须项；控制操作数据库处理是否为立即进行数据库信息变更处理的模式；查询处理一般无需此定义，因为不涉及记录变更；注意这与TERSUS开发时数据库处理默认操作模式不同；如果输入为Yes，则在生成新序列号时会立即进行数据库中值的变更处理：
  · TERSUS默认的数据库执行模式是，在同一个Service服务器端处理（包括Secured Service）中，如果全部逻辑完成无异常，数据库才会执行相关操作，如果中间中断，或部分处理后报错/中断，则全部数据退回执行前状态，也就是默认成功完成全部逻辑处理才会更新数据库值

  输出：

• <Records>：数据库表类型的输出，复数，必须项；用于将记录数据输出到数据库表类型的对象中，一个对象包含一条记录；此对象的“tableName”属性值是元件触发时应查询的数据库中库表名称；

• <None>：空值输出，单数，非必须项；用于完成处理但没有任何结果时传出空值

  示例：

  案例一：查询全部记录并排序输出

  任意一个项目的目录“Common/Templates/Database/Sequence Number/Test Default Key/Test Default Key”中：
  

  案例二：等值查询—查询某个字段特定值记录

  查询申请单状态为”新申请”的记录，请参考我们视频教程中的申请审批系统相关开发部分