跳至主要内容

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

使用者可以透過工作流或API將文件或映像寫入工作表，如果是工作流，則僅支援URL；如果是API，它支援兩種方法，URL和Base64。

一、透過工作流上傳文件​

Webhook觸發的工作流接收外部資料新增至工作表或更新工作表中的資料，同時可以上傳文件。

在工作流的【新增資料】節點或【更新資料】節點中，文件欄位傳入的內容必須是由一個或多個檔案位址組成的Json字串。

  • 上傳檔案時，格式為： url1 或 "url1" ，例如：https://XXX.XXX.com/logo.png或【"https://XXX.XXX.com/logo.png"】
  • 上傳多個檔案時，格式必須為：【"url1", "url2"】 ，例如：【"https://XXX.XXX.com/logo.png","https://XXX.XXX.com/img/introduction.mp4"】。

二、工作流設定​

如果您想透過【新增資料】節點或【更新資料】節點上傳文件，請選擇文字欄位作為檔案欄位。

例如，在下面的工作表中，先將文件的下載連結寫入文字欄位【下載連結】 ，然後透過工作流，自動下載並儲存到【文件】欄位。

1. 設定觸發節點​

2. 將下載連結寫入文件欄位​

三、透過API​

更多細節如下圖所示。

參數介紹

{  controlId: //ID of the file control;  "value": //Links to external files. If there are multiple files, separate them with English commas;  "editType":0 //Data update type. 0-Overwrite existing file; 1-Add current file (Default: 0-Overwrite. This parameter may not be passed for new records, but is required for updated records);  "valueType":1//Ways to upload files. 1-external file link; 2-file stream byte-encoded base64 string (Default: 1. When it is 1, the external link is placed in the value parameter; when it is 2, the file stream base64 information is placed in the controlFiles parameter below);  "controlFiles":【{       "baseFile":"QABAAQQQAAG9nCwAAAA==", //base64 string (file stream byte encoding);      "fileName":"File name with suffix.xlsx" //File name with suffix;  }】}

1. URL-範例​

  • 如果上傳 1 個文件，則指派給文件欄位的值為“url1”，例如，"https://XXX.XXX.com/logo.png"
  • 如果上傳多個文件，格式為“url1,url2”，例如"https://XXX.XXX.com/logo.png,https://XXX.XXX.com/logo.png".
{  "appKey": "0a265**3a155de01",  "sign": "ZmFkZjExMmNlY***NDA4ZjI5N2YxZDEwMjlkZWNkOTRkNTg5NjBkYWQzOTYxYjgwMWM4ZDg5NzYwOGMxZjZmOA==",  "worksheetId": "61111f2eb94**ac37d7d6e",  "controls": 【    {      "controlId": "61111f2eb94aac37d7d6f",      "value": "Test"    },    {      "controlId":"61111f2eb10caac37d7d71",      "value":"https://XXX.XXX.com/logo.png",      "editType":0,      "valueType":1//Setting1      }  】}

2. Base64-範例​

{  "appKey": "0a265**3a155de01",  "sign": "ZmFkZjExMmNlY***NDA4ZjI5N2YxZDEwMjlkZWNkOTRkNTg5NjBkYWQzOTYxYjgwMWM4ZDg5NzYwOGMxZjZmOA==",  "worksheetId": "61111f2eb94**ac37d7d6e",  "controls": 【    {      "controlId": "61111f2eb94aac37d7d6f",      "value": "Test"    },    {        "controlId":"61111f2eb10caac37d7d71",        "editType":0,        "valueType":2,//Setting2         "controlFiles":【            {           "baseFile":"QABAAQQQAAG9nCwAAAA==",           "fileName":"File name with suffix.xlsx"       }】      }  】}

3. 可能遇到的逾時問題​

如果您使用的是批次新增資料接口，同時需要上傳文件，則可能會遇到逾時問題，因為需要等到文件上傳完畢後才會返回成功狀態。

建議方法

首先將文件的URL寫入文字欄位，以確保可以快速寫入基礎資料，然後透過工作流上傳文件。有關更多詳細資訊，請參閱上面的示例。

四、透過 API 和 工作流​

主要區別在於文件地址的格式。

  • 工作流中的格式為：【"url1", "url2"】 。
  • API 中的格式為：「url1,url2」。

五、URL的格式​

  • 文件的 URL 必須可由伺服器存取。
  • 可以直接透過網址下載文件並儲存。
  • URL 的結尾必須是副檔名。

文檔問題反饋

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