什么是服务端命令

观看本节视频

活字格中的服务端命令包括四个要素：名称、参数、命令和返回值。其中名称和命令为必要元素，参数和返回值为非必要元素。

调用服务端命令时，通过服务端命令的名称来调用，将页面端参数的值传递到服务端，服务端执行指定的命令，执行完成后将返回值到页面端。这个过程如下图所示。

无参数的服务端命令

服务端命令可以不设置参数，设置服务端命令的名称后，直接编辑命令。

例如创建一个服务端命令，名称为“导出CSV”，然后编辑命令，选择导出CSV命令。选择CSV操作，选择数据表和CSV的文件路径。文件夹必须为已存在的文件夹，后缀名“.csv”可以省略不写。

设置完成后，您就可以调用这个服务端命令。例如在页面上选择一个单元格区域，设置为按钮。编辑按钮的命令，选择命令为“调用服务端命令”，然后单击服务端命令后的下拉，在下拉列表中选择“导出CSV”这个服务端命令。

运行页面，在页面中单击“服务端导出CSV”按钮，就会在设置的指定路径下看到导出的CSV文件。

有参数的服务端命令

服务端命令可以设置参数，设置服务端命令的名称、参数后，编辑命令。

例如创建一个服务端命令，名称为“添加员工”，然后设置参数，增加4个基础类型的参数，如下图所示。

设置参数后，编辑命令，选择数据表操作命令。操作类型为“添加”，添加字段，字段的值为设置的对应的参数。

设置完成后，您就可以调用这个服务端命令。例如在页面上选择一个单元格区域，设置为按钮。编辑按钮的命令，选择命令为“调用服务端命令”，然后单击服务端命令后的下拉，在下拉列表中选择“添加员工”这个服务端命令。

因为“添加员工”这个服务端命令中有参数，选择后就会自动列出全部的参数，您需要设置参数的值，参数的值为页面上对应的单元格。然后勾选“调用成功后重新加载数据”，这样添加数据后就会刷新页面，显示添加后的数据。

运行后，在页面的文本框中输入值后，单击“添加员工”按钮，这时就会将页面中设置的值传递到服务端，服务端执行数据表操作命令，将数据添加到数据表中。

有返回值的服务端命令

在服务端执行服务端命令时可能会发生异常情况，您可以使用返回命令，将服务端命令执行时发生的异常信息返回到页面中，帮助您定位与解决问题。

例如创建一个服务端命令，名称为“更新订单状态”，设置服务端命令的名称后，可直接编辑命令。

设置命令为条件命令，当登录用户的角色为经理时，执行数据表操作命令，更新订单表；否则返回错误码和错误信息。

设置完成后，您就可以调用这个服务端命令。例如在页面上选择一个单元格区域，设置为按钮。编辑按钮的命令，选择命令为“调用服务端命令”，然后单击服务端命令后的下拉，在下拉列表中选择“更新订单状态”这个服务端命令。

设置返回码和返回信息至页面上指定的单元格中。

运行后，使用小王登录，小王不是经理角色的用户，单击“更新订单状态”按钮，服务端就不会执行数据表操作命令来更新订单状态，而是执行返回命令，在页面中会显示返回码及返回信息。