本地WebApi
本地WebApi用来维护本软件提供的接口,包括系统和自定义两种类型。界面做测试WebApi列表,右侧是WebApi的详细说明,包括请求参数列表,如下图所示:
- 系统:软件默认提供的一些接口,不允许修改。以后软件会陆续开放更多系统接口。
- 自定义:通过事件触发整个流程,但有时我们需要提供一个服务供第三方来调用,此时我们同样可以通过零代码工具来自定义一个webApi。
新增自定义WebApi
在本地webapi列表中,点击新增,打开自定义webApi的编辑界面,如下图所示,其配置方法与逻辑一致,在此不做赘述
- WebApi名称:WebApi的标识
- 请求URL:WebApi的URL
- ContentType:内容类型,一般使用JSON格式来传输数据。
- 请求方式:POST/GET,一般都是POST,只有选择x-www-form-urlencoded时,可以选择GET
- URL前缀:软件自动生成,无法修改
- WebApi描述:可以填写备注说明
配置自定义WebApi
自定义WebApi也提供了一个逻辑编辑器,配置方法与逻辑一致,在此不做赘述
内部调用
这些WebApi可以在逻辑编辑器中使用http请求节点进行调用,在软件内部可以把它看做一个功能块进行使用,如下图所示: 也可以在图纸中调用,如下图所示:
远程WebApi
用于维护外部的WebApi接口,可供本系统进行调用。界面左侧是WebApi列表,右侧是WebApi的详细信息。
新增远程WebApi
在WebApi列表中,点击“新增”按钮,打开远程WebApi编辑界面,如下图:
- 名称:WebApi的名称,填一个容易辨认的名字。
- 描述:WebApi的备注说明
- 请求方式:GET/POST/PUT/DELETE,根据IT提供的接口文档选择
- Content-Type:内容类型,根据IT提供的接口文档选择
- 请求URL:WebApi的URL,根据IT提供的接口文档填写
- 参数列表:WebApi的参数列表
- 参数名:参数的名称,根据IT提供的接口文档填写
- 参数说明:参数的备注说明
- 是否必须:勾选后,如果为空则报错
- Url拼接:勾选后,参数以QueryString形式拼接到URL中
内部调用
和本地WebApi一样,也可以在逻辑编辑器和图纸中调用设置好的远程WebApi,这里不再赘述。
Mqtt服务端
Mqtt服务端用来维护Mqtt连接。
新增Mqtt服务端
在Mqtt服务端列表中,点击“新增”按钮,打开Mqtt服务端编辑界面,如下图:
- 第一步:
- 第二步:
- 第三步:
- 名称:Mqtt服务端的标识
- 连接:
- IP地址:Mqtt服务端的IP地址
- 端口号:Mqtt服务端的端口号
- 客户端ID:用于区分不同客户端的唯一标识,建议留白自动生成
- keepalive计时(秒):保持活动间隔,表示软件与Mqtt服务端之间发送心跳消息的时间间隔,单位为秒。
- 安全:
- 连接用户名:Mqtt服务端的用户名
- 连接密码:Mqtt服务端的密码
- 消息:
- 连接时发送的消息:
- 客户端连接成功时发送的消息,可以留白不填。
- 只有当另一客户端订阅该主题时方可收到。
- 当勾选'保留'时,表示该消息被保留,当有新的客户端订阅该主题时,会立即收到该消息。
- 意外断开连接时发送的消息:
- 客户端断开连接时发送的消息,可以留白不填。
- 只有当另一客户端订阅该主题时方可收到。
- 当勾选'保留'时,表示该消息被保留,当有新的客户端订阅该主题时,会立即收到该消息。
- 连接时发送的消息:
远程Tcp服务端
远程Tcp服务端用来维护Socket连接。
新增远程Tcp服务端
在服务列表中,点击“新增”按钮,打开编辑界面,如下图:
- 服务名称:远程Tcp服务端的标识
- 服务端IP:远程Tcp服务端的IP地址
- 端口号:远程Tcp服务端的端口号
串口列表
串口列表用来维护串口连接。
新增串口
在串口列表中,点击“新增”按钮,打开编辑界面,如下图:
- 串口名:串口的名称,请根据连接的实际串口名称填写。
- 其它属性:请根据串口的设置填写。
FTP 服务器
Ftp服务端用来维护FTP连接 点击新增按钮,打开编辑界面,如下图:
- FTP名称:自定义名称
- IP地址:FTP服务器地址
- 端口号:FTP服务器端口号,一般为21
- 用户名:FTP用户名
- 密码:FTP用户密码
邮件服务
邮件服务列表如下图: 点击新增按钮,打开编辑界面,如下图:
- 邮件服务名称:邮件标识
- 发件服务器:负责将邮件传递到收件人邮箱的服务器。例:网易邮箱:smtp.163.com
- 端口号:端口号
- 邮箱账号:邮箱账号
- 密码:邮箱密码或授权码
- SSL:可勾选,加密邮件传输过程,防止账号密码和邮件内容被窃听。
自定义函数库
软件支持调用外部的dll文件,在此维护外部dll文件,然后可以在逻辑或者自定义WebApi中进行调用。
新增自定义函数库
在自定义函数列表中,点击“新增”按钮,打开编辑界面,如下图:
- 程序集名称:dll程序集的名称
- 命名空间:调用的类所在的命名空间
- 类名:调用的类名
- 方法名:调用的方法名
- 返回类型:方法返回值类型
- 参数列表:方法的传入参数