跳至主要内容

如何通過工作流或API上傳附件

嚮工作錶中寫入文件或圖片，可以通過工作流或API實現。工作流僅支持URL上傳，API支持URL和Base64兩種方式。

一、通過工作流上傳附件​

通過Webhook觸發工作流的方式，接收外部數據新增到工作錶，或更新工作錶數據，同時可以上傳附件。

在工作流的新增記錄節點或更新記錄節點中，附件字段傳入的內容，必須是1個或多個下載文件地址組成的Json字符串。

  • 上傳一個文件時,格式二選一：url1或 ["url1"] ，例如: https://help.mingdao.com/logo.png 或 ["https://help.mingdao.com/logo.png"]

  • 上傳多個文件時，內容必須是這種格式：["url1","url2"],例如： ["https://help.mingdao.com/logo.png","https://help.mingdao.com/img/introduction.mp4"] ，更多文件依次類推。

工作流配置示例​

通過新增記錄節點或更新記錄節點上傳附件，附件字段選擇文本字段。

例如下麵的工作錶，我們把文件的下載鏈接先寫入到一個文本字段[文件下載鏈接]中。然後通過工作流，自動下載並保存到[附件]字段中。

1、工作流觸發節點配置​

2、將附件下載鏈接寫入到附件字段中​

3、測試​

在文件下載鏈接寫入到字段中，寫入符閤格式標準的內容。直接復製下麵內容即可（包括[]）。

["https://help.mingdao.com/logo.png","https://help.mingdao.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.mingdao.com/logo.png"

  • 如果是兩個文件，則內容格式是 : "url1,url2"，例如，"https://help.mingdao.com/logo.png,https://help.mingdao.com/logo.png"，更多文件依次類推。

{
  "appKey": "0a265**3a155de01",
  "sign": "ZmFkZjExMmNlY***NDA4ZjI5N2YxZDEwMjlkZWNkOTRkNTg5NjBkYWQzOTYxYjgwMWM4ZDg5NzYwOGMxZjZmOA==",
  "worksheetId": "61111f2eb94**ac37d7d6e",
  "controls": [
    {
      "controlId": "61111f2eb94aac37d7d6f",
      "value": "測試"
    },
    {
      "controlId":"61111f2eb10caac37d7d71",
      "value":"https://help.mingdao.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

相關搜索：文件上傳、附件上傳、上傳文件

文檔問題反饋

文檔中是否有錯彆字、內容過期、難以理解等問題？ 點此給我們反饋吧