如何通过工作流或API上传附件
向工作表中写入文件或图片,可以通过工作流或API实现。工作流仅支持URL上传,API支持URL和Base64两种方式。
一、通过工作流上传附件
通过Webhook触发工作流的方式,接收外部数据新增到工作表,或更新工作表数据,同时可以上传附件。
在工作流的新增记录节点或更新记录节点中,附件字段传入的内容,必须是1个或多个下载文件地址组成的Json字符串。
上传一个文件时,格式二选一:url1或 ["url1"] ,例如:
https://help.nocoly.com/logo.png
或["https://help.nocoly.com/logo.png"]
上传多个文件时,内容必须是这种格式:["url1","url2"],例如:
["https://help.nocoly.com/logo.png","https://help.nocoly.com/img/introduction.mp4"]
,更多文件依次类推。
工作流配置示例
通过新增记录节点或更新记录节点上传附件,附件字段选择文本字段。
例如下面的工作表,我们把文件的下载链接先写入到一个文本字段[文件下载链接]中。然后通过工作流,自动下载并保存到[附件]字段中。
1、工作流触发节点配置
2、将附件下载链接写入到附件字段中
3、测试
在文件下载链接写入到字段中,写入符合格式标准的内容。直接复制下面内容即可(包括[])。
["https://help.nocoly.com/logo.png","https://help.nocoly.com/img/introduction.mp4"]
二、通过API上传文件
参考下图的接口文档
参数介绍
{
controlId: //附件控件的id;
"value": //外部文件链接,多个文件用“,”逗号隔开;
"editType":0 //数据更新类型, 0覆盖已有文件 ,1增加当前文件(默认0:覆盖,新建记录可不传该参数,更新时必填);
"valueType":1//上传文件的方式,1 = 外部文件链接,2= 文件流字节编码base64格式字符串 (默认 1 ,为1时外部链接放在value参数中,为2时文件流base64信息放在下方的controlFiles参数中 ) ;
"controlFiles":[{
"baseFile":"QABAAQQQAAG9nCwAAAA==", //base64字符串(文件流字节编码);
"fileName":"带后缀的文件名.xlsx" //文件名称,带后缀;
}]
}
URL方式示例
如果上传1个文件,给附件字段的赋值内容是:"url1" ,例如:
"https://help.nocoly.com/logo.png"
如果是两个文件,则内容格式是 : "url1,url2",例如,
"https://help.nocoly.com/logo.png,https://help.nocoly.com/logo.png"
,更多文件依次类推。
{
"appKey": "0a265**3a155de01",
"sign": "ZmFkZjExMmNlY***NDA4ZjI5N2YxZDEwMjlkZWNkOTRkNTg5NjBkYWQzOTYxYjgwMWM4ZDg5NzYwOGMxZjZmOA==",
"worksheetId": "61111f2eb94**ac37d7d6e",
"controls": [
{
"controlId": "61111f2eb94aac37d7d6f",
"value": "测试"
},
{
"controlId":"61111f2eb10caac37d7d71",
"value":"https://help.nocoly.com/logo.png",
"editType":0,
"valueType":1//设置1
}
]
}
Base64文件流方式示例
{
"appKey": "0a265**3a155de01",
"sign": "ZmFkZjExMmNlY***NDA4ZjI5N2YxZDEwMjlkZWNkOTRkNTg5NjBkYWQzOTYxYjgwMWM4ZDg5NzYwOGMxZjZmOA==",
"worksheetId": "61111f2eb94**ac37d7d6e",
"controls": [
{
"controlId": "61111f2eb94aac37d7d6f",
"value": "测试"
},
{
"controlId":"61111f2eb10caac37d7d71",
"editType":0,
"valueType":2,//设置2
"controlFiles":[
{
"baseFile":"QABAAQQQAAG9nCwAAAA==",
"fileName":"带后缀的文件名.xlsx"
}]
}
]
}
可能遇到的超时问题
如果您使用的是批量新增记录的接口,同时需要上传附件,那么可能遇到超时的问题,因为需要等到附件上传完毕才会返回成功状态。
推荐的做法
先将附件的URL写入到一个文本字段中,保证基本数据快速的写入,然后再通过工作流处理附件上传的问题,参考上面的示例。
三、API写入和工作流写入附件的对比
主要就是文件地址格式的不同。
工作流中传入的格式是:["url1","url2"]
API中传入的格式是:"url1,url2"
四、URL的格式
- 附件的URL必须保证本平台服务器可访问
- 通过URL可直接下载保存附件
- URL的结尾必须是扩展名
正确的URL
相关搜索:文件上传、附件上传、上传文件
文档问题反馈
文档中是否有错别字、内容过期、难以理解等问题? 点此给我们反馈吧