3.3、网络

功能模块如图所示：

WEB请求(GET)

功能：该节点可用于发出HTTP GET请求。GET请求用于从web服务获取数据。

配置界面功能说明：

设置：

• 连接设置：
  • 请求地址：输入一个get请求的url地址。
  • 请求地址列：从包含要请求的URL的输入表中选择一个常量URL或一列。
  • 延迟(毫秒)：为了避免web服务过载，可以指定两个连续请求之间的延迟时间。
  • 最大并行工作线程数：设置并发请求数量。
  • 忽略不匹配的主机名：如果选中，则节点信任服务器的SSL证书，即使证书与主机不匹配。
  • 信任所有证书：如果选中，则节点信任所有证书，而不管它们的来源或过期日期。
  • 自动重定向跳转：如果选中，节点将遵循重定向(HTTP状态码3xx开头的)。
  • 分块发送大型数据：指定节点是否允许使用HTTP分块传输编码。如果启用了该功能，则将以一系列块的形式将大型消息发送到服务器。
  • 启用异步HTTP客户端：主要的功能是实现http的异步非阻塞请求。
  • 超时(秒)：单个请求的超时时间，以秒为单位。
  • 响应列名：输出表中响应结果列的名称。
• 身份验证：
  • 无需验证：目前系统默认为无需验证。
• 异常处理：
  • 连接失败(超时、证书错误等)：设置请求到服务器的连接时出现问题时应该发生的情况。选择在节点执行中失败，或者在相应的行中输出状态代码和错误消息。
  • 服务器端错误(HTTP 5xx)：设置在接收到带有5xx状态码的响应时应该发生的情况。
  • 客户端错误(HTTP 4xx)：设置在接收到带有4xx状态码的响应时应该发生的情况。
  • 限流错误(HTTP 429)：此状态码由服务器返回，提示传入请求的速率过高。
  • 错误报告：如果启用，对应于请求的每个输出行将包含一个额外的单元格，如果请求失败，该单元格将提供错误原因的描述。如果请求成功，则单元格将包含一个缺失的值。
• 请求头：
  • 模板：系统提供常见的请求头消息模板，可选择已有模板使用。
  • 合并：选择多个模板，或者选择已有模板和用户自定义添加的请求消息头字段进行合并操作。
  • 替换：选择多个模板，或者选择已有模板和用户自定义添加的请求消息头字段进行替换操作。
  • 添加请求头参数：可添加请求消息头字段。
  • 删除请求头参数：可删除请求消息头字段。
  • 编辑请求头参数：可编辑请求消息头字段。
• 响应头：
  • 包含所有响应头消息：如果选中，请求响应结果中出现的所有报头字段将被提取到列中显示。
  • 添加、删除、编辑响应头参数：自定义添加、删除、编辑响应头参数字段，响应结果将按照所设置字段输出显示。

WEB请求(POST)

功能：该节点可用于发出HTTP POST请求。POST请求用于从web服务获取数据。

配置界面功能说明：

设置：

• 连接设置：
  • 请求地址：输入一个post请求的url地址。
  • 请求地址列：从包含要请求的URL的输入表中选择一个常量URL或一列。
  • 延迟(毫秒)：为了避免web服务过载，可以指定两个连续请求之间的延迟时间。
  • 最大并行工作线程数：设置并发请求数量。
  • 忽略不匹配的主机名：如果选中，则节点信任服务器的SSL证书，即使证书与主机不匹配。
  • 信任所有证书：如果选中，则节点信任所有证书，而不管它们的来源或过期日期。
  • 自动重定向跳转：如果选中，节点将遵循重定向(HTTP状态码3xx开头的)。
  • 分块发送大型数据：指定节点是否允许使用HTTP分块传输编码。如果启用了该功能，则将以一系列块的形式将大型消息发送到服务器。
  • 启用异步HTTP客户端：主要的功能是实现http的异步非阻塞请求。
  • 超时(秒)：单个请求的超时时间，以秒为单位。
  • 响应列名：输出表中响应结果列的名称。
• 身份验证：
  • 无需验证：目前系统默认为无需验证。
• 异常处理：
  • 连接失败(超时、证书错误等)：设置请求到服务器的连接时出现问题时应该发生的情况。选择在节点执行中失败，或者在相应的行中输出状态代码和错误消息。
  • 服务器端错误(HTTP 5xx)：设置在接收到带有5xx状态码的响应时应该发生的情况。
  • 客户端错误(HTTP 4xx)：设置在接收到带有4xx状态码的响应时应该发生的情况。
  • 限流错误(HTTP 429)：此状态码由服务器返回，提示传入请求的速率过高。
  • 错误报告：如果启用，对应于请求的每个输出行将包含一个额外的单元格，如果请求失败，该单元格将提供错误原因的描述。如果请求成功，则单元格将包含一个缺失的值。
• 请求头：
  • 模板：系统提供常见的请求头消息模板，可选择已有模板使用。
  • 合并：选择多个模板，或者选择已有模板和用户自定义添加的请求消息头字段进行合并操作。
  • 替换：选择多个模板，或者选择已有模板和用户自定义添加的请求消息头字段进行替换操作。
  • 添加请求头参数：可添加请求消息头字段。
  • 删除请求头参数：可删除请求消息头字段。
  • 编辑请求头参数：可编辑请求消息头字段。
• 响应头：
  • 包含所有响应头消息：如果选中，请求响应结果中出现的所有报头字段将被提取到列中显示。
  • 添加、删除、编辑响应头参数：自定义添加、删除、编辑响应头参数字段，响应结果将按照所设置字段输出显示。

发送邮件

功能：该节点用于发送邮件通知。

配置界面功能说明：

设置：

• 邮件：
  • 收件人：输入收件人邮箱地址，如果需要填写多个收件人邮箱，以英文逗号分隔。
  • 抄送：输入抄送人邮箱地址，如果需要填写多个抄送人邮箱，以英文逗号分隔。
  • 密送：输入密送人邮箱地址，如果需要填写多个密送人邮箱，以英文逗号分隔。
  • 主题：填写邮件主题。
  • 邮件内容：填写邮件内容。内容可以是纯文本或者是html格式的页面。
  • 优先级：设置邮件优先级标记。优先级标识只有在标准邮件类型中才会显示。
• 附件：
  • 添加附件：点击“浏览”按钮上传邮件附件，附件大小请以收件方服务器允许接收的最大邮件附件参数为准。
• 邮件服务器(SMTP)：
  • 邮件发送服务器地址：填写邮件发送服务器地址。具体邮箱服务器地址请以发件方服务器提供的地址为准。例如QQ邮箱服务器地址填写smtp.qq.com。
  • 连接安全协议：选择连接安全协议。发送邮件服务器是否有安全协议，请以发件服务器商提供的信息为准填写。
  • 邮件发送服务器端口：填写服务器端口。具体端口请以发件服务器商提供的信息为准。例如QQ邮件服务器端口为465或587。
  • 发件人邮箱：填写发件人邮箱地址。
  • 服务器需要身份验证：勾选之后，账号和密码为可填写状态。填写用于发送邮件的发件人邮箱地址和密码。（注：密码通常为客户端专用授权密码。授权密码获取请以具体发件邮箱服务器商提供的方式获取。）
  • 连接超时(毫秒)：一般使用默认值。如果发件邮件内容较大，可适当调整邮件发送超时时间。
  • 读取超时(毫秒)：一般使用默认值。如果发件邮件内容较大，可适当调整邮件读取超时时间。

读取邮件

功能：该节点可用于接收邮件及邮件附件。

配置界面功能说明：

设置：

• 读取邮件：

  • 邮件文件夹：默认收件箱，用于接收邮件。
  • 读取状态：默认读取全部状态邮件，可手动更改选择已读或未读邮件。
  • 回复状态：默认读取全部状态邮件，可手动更改选择已回复或未回复邮件。
  • 邮件排序：默认选择全部，按收件时间降序排序，可手动更改选择最新或最早排序。
  • 读取邮件数：默认10封邮件，可手动调节读取邮件数量。
  • 过滤邮件(正则匹配标题)：用户可自定义正则表达式，过滤掉不符合匹配规则的邮件。
    例如输入正则表达式：^[A-Za-z0-9]+$ ，表示只保留邮件标题为英文字母或数字的邮件。
  • 读取附件：勾选后会读取邮件附件。注：若文件附件较大，积木执行时间会较长。

• 邮件服务器(IMAP)：

  • 邮件接收服务器：填写邮件接收服务器地址。具体邮箱服务器地址请以邮件服务商的提供地址为准。
    例如，阿里云邮箱服务器地址填写imap.aliyun.com。
  • 邮箱端口：填写邮箱服务器端口。具体端口请以邮件服务商提供的信息为准。例如阿里云邮箱服务器端口为993。
  • 邮箱账户：填写收件人的邮箱地址。
  • 邮箱密码：填写收件人的邮箱密码。

API发布

注：该积木为付费企业版高级功能，需要搭配DataBeam调度工具一起使用。

功能：该积木功能可将处理后的数据通过API接口发布到数据库，数据将存储于数据库表中。通过API接口调用的方式获取数据，或者与其他报表系统对接，进行数据报表展示等。

配置界面功能说明：

发布设置：

• 发布地址：发布地址由IP+端口+路径组成。
  • 发布地址IP：填写DataBeam调度工具安装部署的服务器地址，如果是安装在本机，则填写本机IP即可，或者输入http://127.0.0.1。
  • 发布地址端口：发布地址端口为DataBeam调度工具的启动端口。此端口在调度工具的配置文件中修改。一般调度工具默认端口7700，如果用户对此端口进行过自定义修改，则填写自定义修改后的端口。
  • 发布地址路径：填写用户在DataBeam调度工具的配置文件中自定义的路径。
• API KEY：填写用户在DataBeam调度工具的配置文件中自定义的key值。
• API表名：填写用户用户自定义的数据库表名称。API发布后数据将存储在该表中。
  • 随机安全表名：点击后由系统随机生成一个数据库表名称。
  • 删除已存在表：当API发布时如果数据库已存在该表，则删除原始旧表，重新生成新表。
• API表主键：当表中有唯一主键列时，填写主键列名，多个列时以逗号分隔。
• API文档预览：数据通过API接口发布成功后，可以点击文档预览接口，查看对应接口请求数据。接口说明参加该配置界面的具体接口说明文档。

HTTP设置：

• 延迟(毫秒)：为了避免web服务过载，可以指定两个连续请求之间的延迟时间。
• 最大并行工作线程数：设置并发请求数量。
• SSL套接字协议：
  • 忽略不匹配的主机名：如果选中，则节点信任服务器的SSL证书，即使证书与主机不匹配。
  • 信任所有证书：如果选中，则节点信任所有证书，而不管它们的来源或过期日期。
• 自动重定向跳转：如果选中，节点将遵循重定向(HTTP状态码3xx开头的)。
• 分块发送大型数据：定节点是否允许使用HTTP分块传输编码。如果启用了该功能，则将以一系列块的形式将大型消息发送到服务器。
• 启用异步HTTP客户端：主要的功能是实现http的异步非阻塞请求。
• 超时(秒)：单个请求的超时时间，以秒为单位。
• 响应列名：输出表中响应结果列的名称。

HTTP响应：

• 响应头：
  • 包含所有响应头消息：如果选中，请求响应结果中出现的所有报头字段将被提取到列中显示。
  • 添加、删除、编辑响应头参数：自定义添加、删除、编辑响应头参数字段，响应结果将按照所设置字段输出显示。