6.2.6 常用API
1、数据方法
数据方法有3种，分别是查询、修改和删除。凡是需要查询、修改和删除数据时，都可以使用数据方法。在动作中执行数据方法需要设置输入和输出，如图6-20所示。
l 选择数据方法
数据方法在数据操作→数据集的下面
l 设置传入参数
输入设置中显示的参数就是数据方法参数列表中的字段，在数据方法中显示字段名称，在输入设置中显示字段标识。通常设置为请求参数或者逻辑中声明的变量。
l 设置返回变量
查询数据需要获得返回值，修改数据和删除数据不需要获得返回值。需要返回值时，选中“使用返回值”，并输入变量名称。在后面的逻辑中使用这个变量名称访问数据方法返回的结果。
图6-20 执行数据方法
2、集合工具类
集合中包含若干个元素，且元素的类型相同。查询数据方法返回的结果是数据对象的集合，里面包含若干个数据对象，如图6-21所示。一个数据对象就是一条数据记录。
图6-21 集合与元素
系统提供集合工具类访问集合。其中有两个较为常用的方法：一个是取元素个数，一个是取首个元素。
l 取元素个数
如果需要获得某个查询数据方法，查询出了多少条记录。可以先将返回结果存为变量rows，再使用集合变量的“元素个数”方法获得，如图6-22所示。
图6-22 取集合中的元素个数
l 取首个元素
在查询数据方法返回结果中，即使只有一个数据对象，返回结果也是集合。获取数据对象，才能进行取值、赋值。因此要获取集合中的唯一一个元素或是第一个元素，就需要使用集合工具类的取首个元素方法，如图6-23所示。
图6-23 取集合中的首个元素
3、添加变量
变量是指在程序的运行过程中可以发生变化的量。变量是程序中数据的临时存放场所。在代码中可以只使用一个变量，也可以使用多个变量，变量中可以存放单词、数值、日期以及对象。由于变量能够把程序中准备使用的每一段数据都赋给一个简短、易于记忆的名字，因此它们十分有用。
在画代码中有如下3种方式添加变量，如图6-24所示。
l 声明变量
声明变量是对一个数据的命名，便于后面使用。例如将集合中的首个元素取出，存成一个变量，在后面的逻辑中直接访问这个变量。
选择“声明变量”动作后，设置“变量名称”，注意不能用中文，使用含义相同的英文即可。根据变量存储数据的类型选择“返回值类型”，返回值类型就是变量类型，不同的类型能使用的方法也不同，因此要正确选择变量的类型。设置“变量初始值”，注意值的类型要和变量类型一致。
变量值是可以修改的，使用“修改变量”方法修改变量值。
l 创建对象
创建对象是指创建一个数据对象，即当需要给某个数据集新增一条记录时，需要首先创建数据集的数据对象，然后给列赋值，最后保存。
选择“创建对象”动作后，设置“变量名称”，注意不能用中文，使用含义相同的英文即可。在“变量类型”中选择要新增记录的数据对象。创建后。对象就拥有列取值和列赋值的方法。
l 动作返回值
一些动作是有返回值的，例如自定义的数据方法、系统API字符串转整形等。动作的返回值可以直接存为变量。
图6-24 添加变量的3种方式
4、数据操作
在数据操作中，会看到仓库、数据对象、集合<数据对象>等概念。要先弄清它们的含义，才能操作数据，如图6-25所示。仓库对应数据集，提供访问数据集的方法，这些方法包括系统API和自定义的数据方法。数据对象或集合<数据对象>是这些方法的返回值或者参数。例如：查询数据方法是从仓库中查询符合条件的数据，返回值是集合<数据对象>。新增数据对象后保存到仓库，调用仓库的保存并更新方法，数据对象作为该方法的参数。
数据对象有列取值和列赋值的方法。集合<数据对象>有集合的方法。
图6-25 仓库和数据对象
常用的数据操作有赋值、取值和保存并更新，如图6-27所示。
l 赋值
赋值就是给某个列赋值，是数据对象的方法。
选择“Set 列名”动作后，在“目标对象”中选择一个数据对象，在“输入设置”的列值中输入要赋的值。通常设置为请求参数或者逻辑中声明的变量。
l 取值
取值就是获取某个列的值，是数据对象的方法。
有2种方法可以取值，一是使用“Get 列名”动作，将返回值存成新的变量；二是在表达式编辑器的上下文变量中，找到并展开数据对象，双击数据对象中的列，添加到表达式中，如图6-26所示，这样就可以获取到数据对象中的列值。
图6-26 在表达式编辑器中取值
l 保存并更新
保存并更新是将新增或修改的数据对象保存到仓库中，是仓库的方法。
选择仓库下的“保存并更新”动作后，在“数据对象”中选择一个数据对象，即可将这个数据对象保存到仓库。
图6-27 数据操作