函数扩展工具

文档说明

该连接器函数接口目的是在目前轻流函数基础上，继续扩展的部分能力。调用方式则通过配置连接器进行使用即可。

注意：

由于接口有频率限制，为400次/分钟。
目前仅公有云轻流环境可配置调用。

该文档会逐一介绍对应的连接器事件，具体在轻流中如何进行配置调用，并附上实现录屏方便用户更直观了解效果。

配置操作

由于配置连接器的操作路径都是相同的，即：

表单添加【Q-Linker】
配置模式选择为【连接中心模版】
选择对应连接器【函数扩展工具】
选择对应连接器事件
配置【绑定变量】
配置接收字段默认内容为Q-Linker输出变量

所以该文档只会详细说明一个连接器事件【随机数生成】的具体配置过程，供用户参考进行配置。

连接器事件

随机数生成

连接器事件说明：生成count数量的随机数，仅在[min,max]区间范围内。可控制生成的随机数是否允许重复。
演示链接：随机数生成

变量说明

变量名称	是否必填	说明
min	是	随机数下限(含)
max	是	随机数上限(含)
count	是	生成数量
allow_duplicates	否	是否允许重复，选填true/false；默认为true

注意：若需要allow_duplicates为true，表单中配置时，就无需绑定变量设置allow_duplicates，或者可默认自定义值为true。

输出说明

输出名称	类型	说明
随机数	int	只会输出1个随机数
随机数列表	array	会输出对应count数量的随机数列表
随机数	int	具体随机数

表单配置

输入参数

输入参数无需任何配置，添加所需变量字段即可。
其中【是否允许重复】按需添加，若需要允许重复，可以不用添加该字段，因为默认为true。
若字段为固定默认值，也可以配置Q-linker时设置为自定义，下文会进一步说明。

Q-linker

配置模式

固定选择【使用连接中心模版】
固定选择【函数扩展工具】
选择对应事件【随机数生成】

绑定变量

选择所需配置变量即可。本文档基于演示，所以都进行了配置，实际可以按需配置。
比如随机数据的固定为1-100，返回数量为1，不允许重复。
那么min可以将图中的【字段】改为【自定义】，并设置为【1】；max可以将图中的【字段】改为【自定义】，并设置为【100】；count可以将图中的【字段】改为【自定义】，并设置为【1】；allow_duplicates可以将图中的【字段】改为【自定义】，并设置为【false】。如果都改为自定义后，表单就无需增加字段用于动态输入了。
Q-linker配置中最下方，有个按钮【自动触发】，可以按需开启，若需要打开表单时，就自动触发，就开启，若需要手动点击触发，就无需开启。

输出配置

上述两个字段，为输出接收字段，具体配置如图所示。
【返回随机数】：配置关联已有数据，选择【获取随机数】Q-linker返回的随机数，表示【返回随机数】字段接收该Q-linker返回的随机数。
【表格】：配置关联已有表格，选择【获取随机数】Q-linker返回的随机数列表，子字段关联配置随机数匹配随机数，表示【表格】的随机数子字段接收Q-linker返回的随机数数组中的随机数。

实际效果

视频：录制于 2025-04-30 22.59.21.mp4。请在原文中查看。

字符串分割

连接器事件说明：将输入字符串按照指定分隔符进行分割，可选择返回普通列表或键值对映射
普通列表格式示例为：

[
  "a=1",
  "b=2",
  "c=3"
]

键值对映射示例为：

{
  "a": "1",
  "b": "2",
  "c": "3"
}

演示链接：字符串分隔

变量说明

变量名称	是否必填	说明
input	是	输入待处理字符串
delimiter	是	分隔符
map_format	是	是否返回键值对映射；选填true/false
key_value_delimiter	是	键值对分隔符

输出说明

若map_format为true时

输出名称	类型	说明
result	object	输出处理的结果为对象

由于处理的字符串不固定，所以返回的对象中数量也不固定，所以需要额外做处理，下文会说明具体操作方式。
若map_format为false时

输出名称	类型	说明
result	array	输出处理的结果为普通数组
value	string	具体处理值

表单配置

【字符串分隔处理】Q-linker 的配置操作同理【随机数生成】，这里就不做额外阐述。

回传对象参数配置

假设待处理字符串为：a=1&b=2&c=3

若map_format为true时，返回的是对象，所以这里会详细说明具体如何操作将内容回传至对应字段中。

{
  "a": "1",
  "b": "2",
  "c": "3"
}

说明：这里我只配置了处理后的接收的3个字段（1、2、3），具体数量根据业务需求配置即可。

【回传】Q-linker，配置如上图，这里做几点说明：
URL：固定为：https://connect.oalite.com/api/returnAll
Method：固定为：POST
body：传入输出的对象result
JSON path：配置根据待处理字符串来的，也是根据输出的对象键值进行配置的。

实际效果

视频：录制于 2025-04-30 23.24.58.mp4。请在原文中查看。

索引切分字符串

连接器事件说明：将字符串按分隔符切分并返回带索引的结果
结果返回json示例：

{
   "0": "张三",
   "1": "李四",
   "2": "王五"
}

演示链接：索引切分字符串

变量说明

变量名称	是否必填	说明
content	是	待处理内容
delimiter	是	分隔符

输出说明

输出名称	类型	说明
result	object	输出处理的结果对象
index_0	string	输出分隔的第一个内容
index_1	string	输出分隔的第二个内容
index_2	string	输出分隔的第三个内容
index_3	string	输出分隔的第四个内容

由于处理的字符串不固定，所以返回的对象中数量也不固定，所以需要使用回传接口进行额外处理。
具体操作路径参考：见【字符串分隔】3.2.3.1。
若返回的数量小于等于4个，无需通过回传接口进行额外处理，可以直接配置字段接收输出变量即可。

表单配置

配置逻辑如上述内容如出一辙，这里不做额外阐述说明

实际效果

视频：录制于 2025-04-30 23.32.24.mp4。请在原文中查看。

字符串替换

连接器事件说明：替换字符串中的指定内容，支持普通替换和正则表达式替换。
示例1：普通替换
比如输入："hello world"，将字符中的"o"替换为"0",即最后输出为："hell0 w0rld"
示例2:正则表达式替换
比如输入"我的电话是12345，你的QQ是67890",需要将数字替换成"#"
使用正则表达式："\\d" ;在JSON中，反斜杠需要转义，所以正则表达式中的\\要写成\\\\
最后输出"我的电话是#####，你的QQ是#####"
演示链接：字符串替换

变量说明

变量名称	是否必填	说明
input	是	待处理内容
target	是	目标字符串或正则表达式
replacement	是	替换内容
use_regex	是	是否使用正则表达式；可选true/false

输出说明

输出名称	类型	说明
result	string	输出处理的结果

表单配置

配置逻辑如上述内容【随机数生成】如出一辙，这里不做额外阐述说明

实际效果

视频：录制于 2025-05-02 00.09.00.mp4。请在原文中查看。

字符命名法

连接器事件说明：根据传入的type类型，输出对应的类型字符命名法处理结果。
type可选值包括：
camel: 转换为驼峰命名(首字母小写)
如”hello world” -> “helloWorld”
pascal: 转换为帕斯卡命名(首字母大写)
如”hello world” -> “HelloWorld”
snake: 转换为蛇形命名(下划线分隔)
如”Hello World” -> “hello_world”
kebab: 转换为kebab命名(连字符分隔)
如”Hello World” -> “hello-world”
演示链接：字符命名法

变量说明

变量名称	是否必填	说明
type	是	命名法类型，type可选值：camel、pascal、snake、kebab
text	是	待处理内容

输出说明

输出名称	类型	说明
result	string	输出处理的结果

表单配置

配置逻辑如上述内容【随机数生成】如出一辙，这里不做额外阐述说明

实际效果

视频：录制于 2025-04-30 23.39.46.mp4。请在原文中查看。

提取中文文本的拼音首字母

连接器事件说明：将汉字转换为拼音首字母，支持设置大小写
示例：比如输入"轻流无代码"
输出若为大写"QLWDM"
输出若为小写"qlwdm"
演示链接：提取中文文本的拼音首字母

变量说明

变量名称	是否必填	说明
text	是	待处理内容
uppercase	是	是否转为大写

输出说明

输出名称	类型	说明
result	string	输出处理的结果

表单配置

配置逻辑如上述内容【随机数生成】如出一辙，这里不做额外阐述说明

实际效果

视频：录制于 2025-04-30 23.44.51.mp4。请在原文中查看。

将日期转换为中文大写格式

连接器事件说明：将YYYY-MM-DD格式的日期转换为中文大写格式，符合人行票据日期格式
示例：输入为"2023-10-30"
若需对10、20、30添加零前缀
结果为："贰零贰叁年零壹拾月零叁拾日"
若无需对10、20、30添加零前缀
结果为："贰零贰叁年壹拾月叁拾日"
演示链接：将日期转换为中文大写格式

变量说明

变量名称	是否必填	说明
date_str	是	日期字符串，格式为YYYY-MM-DD
use_zero_prefix_for_tens	是	是否对10、20、30添加零前缀

输出说明

输出名称	类型	说明
result	string	输出处理的结果

表单配置

配置逻辑如上述内容【随机数生成】如出一辙，这里不做额外阐述说明

实际效果

视频：录制于 2025-04-30 23.47.25.mp4。请在原文中查看。

表

将日期转换为中文普通格式

连接器事件说明：将YYYY-MM-DD格式的日期转换为中文普通格式，
示例：输入"2025-04-06"
输出结果为："二〇二五年四月六日"
演示链接：将日期转换为中文普通格式

变量说明

变量名称	是否必填	说明
date_str	是	日期字符串，格式为YYYY-MM-DD

输出说明

输出名称	类型	说明
result	string	输出处理的结果

表单配置

配置逻辑如上述内容【随机数生成】如出一辙，这里不做额外阐述说明

实际效果

视频：录制于 2025-04-30 23.49.00.mp4。请在原文中查看。

获取当前时间(默认时区为上海)

连接器事件说明：获取当前时间，可根据设置的自定义格式进行输出
演示链接：获取当前时间

格式代码：%Y: 年份（4位数字），如2023%m: 月份（01-12），如05%d: 日期（01-31），如09%H: 小时（24小时制，00-23），如13%I: 小时（12小时制，01-12），如01%M: 分钟（00-59），如30%S: 秒（00-59），如45%f: 微秒，如000000%a: 星期几缩写，如Mon%A: 星期几全称，如Monday%b: 月份缩写，如Jan%B: 月份全称，如January%p: AM/PM%z: UTC偏移量，如+0800%Z: 时区名称，如CST示例：中文日期：%Y年%m月%d日 → 2023年06月15日带星期：%Y-%m-%d (%A) → 2023-06-15 (Thursday)中文时间：%H时%M分%S秒 → 14时30分45秒完整日期时间：%Y年%m月%d日 %H时%M分%S秒星期%w → 2023年06月15日 14时30分45秒星期4带时区：%Y-%m-%d %H:%M:%S %z → 2023-06-15 14:30:45 +0800

变量说明

变量名称	是否必填	说明
custom_format	是	自定义的输出格式

输出说明

输出名称	类型	说明
result	string	输出处理的结果

表单配置

配置逻辑如上述内容【随机数生成】如出一辙，这里不做额外阐述说明

实际效果

视频：录制于 2025-04-30 23.52.08.mp4。请在原文中查看。

检查日期是否为周末

连接器事件说明：检查输入日期是否为周末，并输出日期为周几。
示例：输入"2025-04-04"
输出：

{
   "是否为周末": false,
   "具体周几(例如：5)": 5,
   "具体周几(例如：周五)": "周五"
}

演示链接：检查日期是否为周末

变量说明

变量名称	是否必填	说明
date	是	具体判断日期

输出说明

输出名称	类型	说明
具体周几(例如：5)	int	输出周几，为数字格式
具体周几(例如：周五)	string	输出周几，为周几格式
是否为周末	boolean	输出是否是周末

表单配置

配置逻辑如上述内容【随机数生成】如出一辙，这里不做额外阐述说明

实际效果

视频：录制于 2025-04-30 23.57.12.mp4。请在原文中查看。

自定义时间格式转换(默认时区为上海)

连接器事件说明：根据输入的时间和自定义格式，最后输出按照设置的自定义格式进行输出
演示链接：自定义时间格式转换

格式代码：%Y: 年份（4位数字），如2023%m: 月份（01-12），如05%d: 日期（01-31），如09%H: 小时（24小时制，00-23），如13%I: 小时（12小时制，01-12），如01%M: 分钟（00-59），如30%S: 秒（00-59），如45%f: 微秒，如000000%a: 星期几缩写，如Mon%A: 星期几全称，如Monday%b: 月份缩写，如Jan%B: 月份全称，如January%p: AM/PM%z: UTC偏移量，如+0800%Z: 时区名称，如CST示例：中文日期：%Y年%m月%d日 → 2023年06月15日带星期：%Y-%m-%d (%A) → 2023-06-15 (Thursday)中文时间：%H时%M分%S秒 → 14时30分45秒完整日期时间：%Y年%m月%d日 %H时%M分%S秒星期%w → 2023年06月15日 14时30分45秒星期4带时区：%Y-%m-%d %H:%M:%S %z → 2023-06-15 14:30:45 +0800

变量说明

变量名称	是否必填	说明
time_input	是	待处理的时间
custom_format	是	自定义的输出格式

输出说明

输出名称	类型	说明
周几	string	输入时间为周几
timestamp	string	输入的时间戳格式
formatted_time	string	输出自定义的格式结果

表单配置

配置逻辑如上述内容【随机数生成】如出一辙，这里不做额外阐述说明

实际效果

视频：录制于 2025-05-01 00.02.01.mp4。请在原文中查看。

获取日期对应的周数信息

连接器事件说明：根据输入的日期，输出该日期对应的周数。可选是输出本月内周数，还是本年周数
示例：输入"2025-04-04"，in_month=false，start_with_monday：true
输出：week_number：14；总周数：52
演示链接：获取日期对应的周数信息

变量说明

变量名称	是否必填	说明
date	是	日期字符串 (YYYY-MM-DD格式)，默认为当天
in_month	是	是否计算月内周数，true表示计算是本月第几周，false表示计算是本年第几周
start_with_monday	是	一周的第一天是否为周一，true表示周一为第一天，false表示周日为第一天

输出说明

输出名称	类型	说明
week_number	int	对应周数
总周数	string	对应总周数，具体是月内还是年内周数，根据in_month决定

表单配置

配置逻辑如上述内容【随机数生成】如出一辙，这里不做额外阐述说明

实际效果

视频：录制于 2025-05-02 00.18.41.mp4。请在原文中查看。

获取时区当前时间

连接器事件说明：根据输入时区偏移量，输出对应该时区的当前时间
示例：输入"8"
输出："2025-05-01 16:21:20"
演示链接：获取时区当前时间

变量说明

变量名称	是否必填	说明
tz_offset	是	时区偏移量（小时），例如8表示东八区，-5表示西五区

输出说明

输出名称	类型	说明
current_time	string	时区当前时间
时区名称	string	对应时区名称
description	string	时区描述

表单配置

配置逻辑如上述内容【随机数生成】如出一辙，这里不做额外阐述说明

实际效果

视频：录制于 2025-05-02 00.24.51.mp4。请在原文中查看。

请假天数计算

连接器事件说明：根据输入的开始日期、结束日期、自定义的休息日模式、需要移除的特定日期列表、需要增加的特定日期列表，进行计算具体的请假天数。如果自定义的休息日模式与移除日期列表和增加日期列表冲突了，具体以移除日期列表和增加日期列表为准。
注意：移除日期列表和增加日期列表，一般是用于填写国家法定节假日的。当然如果您的企业有特殊规则的话，可以按照实际需求进行修改即可。
演示链接：请假天数计算

变量说明

变量名称	是否必填	说明
start_date	是	开始日期 (YYYY-MM-DD格式)
end_date	是	结束日期 (YYYY-MM-DD格式)
rest_day_pattern	是	自定义的休息日模式，例如"0000011"表示周六和周日休息
exclude_dates	否	需要移除的特定日期列表，格式为["YYYY-MM-DD", "YYYY-MM-DD"]
add_dates	否	需要增加的特定日期列表，格式为["YYYY-MM-DD", "YYYY-MM-DD"]

输出说明

输出名称	类型	说明
请假天数	int	具体请假天数

表单配置

JOIN("\",\"",排除的特定日期列表·日期)

JOIN("\",\"",增加的工作日日期列表·日期)

【请假天数计算】q-linker配置逻辑如上述内容【随机数生成】如出一辙，这里不做额外阐述说明
这里具体说明一下，增加两个多行文字【排除的特定日期列表】、【增加的工作日日期列表】的作用，原因是因为需要将对应表格中输入的日期，进行使用公式转换成连接器事件对应字段能够接受的格式传入。所以实际绑定变量，需要绑定这两个多行文字。

实际效果

比如开始日期为【2025-05-01】，结束日期为【2025-05-11】，共11天，自定义休息日模式为"0000011"表示周六和周日休息。
移除劳动节的放假日期即【2025-05-01】-【2025-05-05】共5天，但是假设增加了【2025-05-10】、【2025-05-11】两天为工作日，共2天。
所以最后的请假天数为实际工作日的天数：
【2025-05-06】、【2025-05-07】、【2025-05-08】、【2025-05-09】、【2025-05-10】、【2025-05-11】，共6天。

视频：录制于 2025-05-01 00.16.32.mp4。请在原文中查看。

文档说明​

配置操作​

连接器事件​

随机数生成​

变量说明​

输出说明​

表单配置​

输入参数​

Q-linker​

配置模式​

绑定变量​

输出配置​

实际效果​

字符串分割​

变量说明​

输出说明​

表单配置​

回传对象参数配置​

实际效果​

索引切分字符串​

变量说明​

输出说明​

表单配置​

实际效果​

字符串替换​

变量说明​

输出说明​

表单配置​

实际效果​

字符命名法​

变量说明​

输出说明​

表单配置​

实际效果​

提取中文文本的拼音首字母​

变量说明​

输出说明​

表单配置​

实际效果​

将日期转换为中文大写格式​

变量说明​

输出说明​

表单配置​

实际效果​

将日期转换为中文普通格式​

变量说明​

输出说明​

表单配置​

实际效果​

获取当前时间(默认时区为上海)​

变量说明​

输出说明​

表单配置​

实际效果​

检查日期是否为周末​

变量说明​

输出说明​

表单配置​

实际效果​

自定义时间格式转换(默认时区为上海)​

变量说明​

输出说明​

表单配置​

实际效果​

获取日期对应的周数信息​

变量说明​

输出说明​

表单配置​

实际效果​

获取时区当前时间​

变量说明​

输出说明​

表单配置​

实际效果​

请假天数计算​

变量说明​

输出说明​

表单配置​

实际效果​

文档说明

配置操作

连接器事件

随机数生成

变量说明

输出说明

表单配置

输入参数

Q-linker

配置模式

绑定变量

输出配置

实际效果

字符串分割

变量说明

输出说明

表单配置

回传对象参数配置

实际效果

索引切分字符串

变量说明

输出说明

表单配置

实际效果

字符串替换

变量说明

输出说明

表单配置

实际效果

字符命名法

变量说明

输出说明

表单配置

实际效果

提取中文文本的拼音首字母

变量说明

输出说明

表单配置

实际效果

将日期转换为中文大写格式

变量说明

输出说明

表单配置

实际效果

将日期转换为中文普通格式

变量说明

输出说明

表单配置

实际效果

获取当前时间(默认时区为上海)

变量说明

输出说明

表单配置

实际效果

检查日期是否为周末

变量说明

输出说明

表单配置

实际效果

自定义时间格式转换(默认时区为上海)

变量说明

输出说明

表单配置

实际效果

获取日期对应的周数信息

变量说明

输出说明

表单配置

实际效果

获取时区当前时间

变量说明

输出说明

表单配置

实际效果

请假天数计算

变量说明

输出说明

表单配置

实际效果