CloudConvert模組

在Adobe Workfront Fusion案例中,您可以自動化使用CloudConvert的工作流程,並將其連結至多個協力廠商應用程式和服務。 CloudConvert模組可讓您監視和管理CloudConvert帳戶中的工作、工作,以及匯入和匯出檔案。

Adobe Workfront 計畫*
Pro或更高版本
Adobe Workfront 授權*
計畫,工作
Adobe Workfront Fusion 授權**

目前授權需求:無Workfront Fusion授權需求。

舊版授權需求:Workfront Fusion for Work Automation and Integration

產品

目前產品需求:如果您有Select或Prime Adobe Workfront計畫,貴組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。 Workfront Fusion包含在Ultimate Workfront計畫中。

舊版產品需求:您的組織必須購買Adobe Workfront Fusion及Adobe Workfront,才能使用本文所述的功能。

CloudConvert API資訊

CloudConvert聯結器會使用以下專案:

基礎URL
https://api.cloudconvert.com/v2/
API版本
v2
API標籤
v2.14.22

將CloudConvert連線至Workfront Fusion connect-cloudconvert-to-workfront-fusion

若要將您的CloudConvert帳戶連線至Workfront Fusion,您必須從您的CloudConvert帳戶取得API金鑰。

  1. 登入您的CloudConvert帳戶並開啟您的儀表板。

  2. 開啟​ 授權 > API金鑰 ​區段。

  3. 按一下​ 建立新的API金鑰

  4. 輸入API金鑰的名稱,啟用您要使用的範圍,然後按一下[建立]。

  5. 複製提供的Token並將其儲存在安全的地方。

  6. 在Workfront Fusion中,開始建立案例並開啟CloudConvert模組的​ 建立連線 ​對話方塊。

    如需指示,請參閱在 Adobe Workfront Fusion中建立情境。

  7. 輸入您在步驟5中儲存的Token,然後按一下[繼續] 以建立連線。

CloudConvert模組及其欄位 cloudconvert-modules-and-their-fields

當您設定CloudConvert模組時,Workfront Fusion會顯示下列欄位。 除了這些欄位以外,可能還會顯示其他CloudConvert欄位,視您在應用程式或服務中的存取層級等因素而定。 模組中的粗體標題表示必填欄位。

如果您在欄位或函式上方看到對應按鈕,則可以使用它來設定該欄位的變數和函式。 如需詳細資訊,請參閱在 Adobe Workfront Fusion中將資訊從一個模組對應到另一個模組。

常見任務

擷取網站

此動作模組會擷取指定的網站,並以PDF、JPG或PNG格式儲存。

您可以指定網站的URL和其他資訊,例如要儲存資訊的位置。

模組會傳回檔案ID和任何關聯欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
URL
輸入您要擷取的網站URL。
輸出格式
選取您要以PNG、JPG或PDF格式儲存擷取的網站。
檔案名稱
輸入目標輸出檔案的檔案名稱(包括副檔名)。
Headers

(選用)定義請求標頭。

這在指定的URL需要授權時很有用。

轉換與引擎特定選項
指定轉換和引擎特定選項。 若要檢視可用的選項,請參閱input_formatoutput_formatCloudConvert API檔案。
下載檔案
如果您也想在模組的輸出中包含檔案資料,請啟用此選項。

轉換檔案

將檔案轉換為選取的輸出格式。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
輸入檔案
選取您要使用Workfront Fusion上傳檔案,或提供要從中上傳檔案的URL。
上傳檔案
從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。
從URL匯入檔案
  • URL

    輸入要轉換的檔案URL。

  • Headers

    定義請求標頭(選用)。 這在指定的URL需要授權時很有用。

格式
選取是否要指定要轉換之檔案的輸入格式。 如果未指定,則會使用輸入檔案的副檔名作為輸入格式。
Input Format
選取檔案的目前格式。
輸出格式
選取您要轉換檔案的目標檔案格式。
檔案名稱
選擇目標輸出檔案的檔案名稱(包括副檔名)。
轉換與引擎特定選項
指定轉換和引擎特定選項。 若要檢視可用的選項,請參閱input_formatoutput_formatCloudConvert API檔案。
下載檔案
如果您也想在模組的輸出中包含檔案資料,請啟用此選項。

建立封存

可讓您新增一或多個檔案至ZIP、RAR、7Z、TAR、TAR.GZ或TAR.BZ2封存檔案。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
輸入檔案
指定您要新增至封存的檔案。
上傳檔案
從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。
從URL匯入檔案

URL

輸入要封存的檔案URL。

標頭

定義請求標頭(選用)。 這在指定的URL需要授權時很有用。

輸出格式
選取已封存檔案的目標格式。
檔案名稱
輸入目標輸出檔案的檔案名稱(包括副檔名)。
轉換與引擎特定選項
指定轉換和引擎特定選項。 若要檢視可用的選項,請參閱input_formatoutput_formatCloudConvert API檔案。
下載檔案
如果您也想在模組的輸出中包含檔案資料,請啟用此選項。

合併檔案

至少將兩個檔案合併到一個PDF中。 如果輸入檔案不是PDF,則會自動轉換成PDF。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
輸入檔案
指定您要合併的檔案。
上傳檔案
從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。
從URL匯入檔案

URL

輸入要封存的檔案URL。

標頭

定義請求標頭(選用)。 這在指定的URL需要授權時很有用。

輸出格式
選取合併檔案的目標格式。
檔案名稱
輸入目標輸出檔案的檔案名稱(包括副檔名)。
轉換與引擎特定選項
指定轉換和引擎特定選項。 若要檢視可用的選項,請參閱input_formatoutput_formatCloudConvert API檔案。
下載檔案
如果您也想在模組的輸出中包含檔案資料,請啟用此選項。

最佳化檔案

此動作模組會最佳化並壓縮PDF、PNG或JPG格式的檔案。

您可以指定檔案以及最佳化及儲存檔案的引數。

模組會傳回檔案ID和任何關聯欄位,以及連線存取的任何自訂欄位和值。 您可以在情境中的後續模組中對應此資訊。

當您設定此模組時,會顯示下列欄位。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
輸入檔案
選取您要使用Workfront Fusion上傳檔案,或提供要從中上傳檔案的URL。
上傳檔案
從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。
從URL匯入檔案
  • URL:輸入要轉換的檔案URL。
  • Headers: (選用)定義要求標題。 這在指定的URL需要授權時很有用。
Optimization for

針對特定目標需求選取最佳化設定檔。

  • 網頁:網頁的最佳化(預設)

    • 移除Web多餘和不必要的資料
    • 縮減取樣、剪下並聰明地壓縮影像
    • 合併字型和子集字型
    • 將色彩轉換為RGB
  • Print:最佳化列印

    • 移除列印時多餘和不必要的資料

    • 縮減取樣、剪下並聰明地壓縮影像

    • 合併字型和子集字型

    • 將顏色轉換為CMYK

  • 封存:針對封存用途最佳化

    • 移除多餘和不必要的資料以進行封存

    • 智慧型壓縮影像

    • 合併字型和子集字型

  • 掃描的影像:最佳化掃描的影像

    • 主要包含點陣化影像的PDF最佳化的設定檔

    • 壓縮影像,而不大幅降低視覺品質

  • 最大尺寸縮減:最佳化最大尺寸縮減

    • 使用最大可能的壓縮

    • 可能會降低視覺品質

輸入格式
選取要最佳化的輸入檔案格式。
檔案名稱
輸入目標輸出檔案的檔案名稱(包括副檔名)。
轉換與引擎特定選項
指定轉換和引擎特定選項。 若要檢視可用的選項,請參閱input_formatoutput_formatCloudConvert API檔案。
下載檔案
如果您也想在模組的輸出中包含檔案資料,請啟用此選項。

工作

建立工作(進階)

此模組會建立工作。 工作可以是名稱欄位中識別且使用輸入欄位相互連結的一或多個工作。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
輸入檔案
選取您要使用Workfront Fusion上傳檔案,或提供要從中上傳檔案的URL。
上傳檔案
從先前的模組中選取來源檔案,或對應來源檔案的名稱和資料。
從URL匯入檔案
  • URL:輸入您要處理的檔案URL。
  • Headers: (選用)定義要求標題。 這在指定的URL需要授權時很有用。
工作

新增將在工作內執行的任務。

請在對應區段中尋找作業欄位的說明。

  • 執行命令

    如需有關執行命令的詳細資訊,請參閱CloudConvert API檔案

  • 將檔案匯出至暫存URL

    指定工作名稱和輸入工作名稱(例如轉換)。

標籤
輸入標籤。 標籤是用來識別工作的任意字串。 註解沒有任何效果,可用來將工作與ID建立關聯。

刪除工作

此模組會刪除工作,包括所有任務和資料。

NOTE
工作會在結束24小時後自動刪除。
Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
工作ID
輸入或對應您要刪除之工作的ID。

取得工作

此模組會擷取工作詳細資料。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
工作ID
輸入或對應您要擷取其詳細資訊之作業的ID。

列出工作

此模組會擷取已在您帳戶中執行的所有工作。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
狀態
選取工作狀態,以篩選傳回的工作。
限制
設定Workfront Fusion 2.0在一個執行週期中傳回的工作數量。

新工作事件

在您的帳戶或任務中建立、完成或失敗時觸發。

NOTE
  • 由建立工作(進階)模組所建立的工作包含​ 多個 ​工作。
  • 建立、完成或失敗的​ 個別 ​任務時,也會觸發新工作事件觸發器。
Webhook名稱
輸入webhook名稱。
Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
輸出格式
選取您要以PNG、JPG或PDF格式儲存擷取的網站。
事件
選取在建立、完成或失敗工作或任務時是否觸發模組。
NOTE
  • 如果使用陣列彙總(例如,您有許多不同格式的檔案要轉換),請使用​ 我不知道新增工作對話方塊中的輸入格式 ​選項。 否則會傳回錯誤。

  • 連結工作內的工作(名稱>輸入、名稱>輸入……):

    >

任務

取消工作

此模組會取消處於等待或處理狀態的任務。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
任務ID
輸入或對應您要取消之工作的ID。

刪除工作

刪除任務,包括所有資料。

NOTE
任務結束後24小時會自動刪除。
Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
任務ID
輸入(對應)您要刪除之任務的ID。

下載檔案

此模組會從指定的工作擷取檔案名稱和檔案資料。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
任務ID
輸入或對應您要從其中下載檔案的工作的ID。

取得工作

此模組會擷取任務詳細資料。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
任務ID
輸入或對應您要擷取其詳細資訊之任務的ID。

列出任務

此模組會根據篩選設定擷取您帳戶中的所有工作。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
狀態
選取任務狀態,以篩選傳回的任務。
工作ID
輸入或對應工作ID以僅傳回指定工作內的工作。
操作

輸入作業型別,以僅傳回具有指定作業的任務。

注意:請使用List Possible Operations模組來擷取作業。

限制
輸入或對應您希望模組在每個案例執行週期中傳回的最大記錄數。

重試工作

此模組會根據其他任務的設定(裝載)建立新任務。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion
任務ID
輸入或對應您要建立新任務的任務ID。

其他

取得我的資訊

擷取有關目前使用者的已驗證帳戶詳細資料。

Connection
如需有關將您的CloudConvert帳戶連線到Workfront Fusion的說明,請參閱本文中的將CloudConvert連線到Workfront Fusion

進行API呼叫

可讓您執行自訂API呼叫。

選取設定API呼叫所需的HTTP要求方法。 如需詳細資訊,請參閱Adobe Workfront Fusion中的HTTP要求方法。

Connection
如需有關將[Fusion App]帳戶連線到Workfront Fusion的說明,請參閱建立與Adobe Workfront Fusion的連線 — 基本說明
URL

輸入相對於https://api.cloudconvert.com/的路徑。 例如: /v2/tasks

如需可用端點的清單,請參閱CloudConvert API v2檔案

方法
Headers

以標準JSON物件的形式新增請求的標頭。

例如, {"Content-type":"application/json"}

Workfront Fusion 2.0會為您新增授權標頭。

查詢字串

以標準JSON物件的形式新增API呼叫的查詢。

例如: {"name":"something-urgent"}

Body
以標準JSON物件的形式新增API呼叫的內文內容。在JSON中使用條件陳述式(例如if)時,請將引號放在條件陳述式之外。

範例: ​清單任務

以下API呼叫傳回您CloudFront帳戶中的所有任務:

URL: /v2/tasks

方法: GET

在組合 > 內文 > 資料下的模組輸出中,可找到搜尋的相符專案。

在我們的範例中,傳回6項工作:

疑難排解 troubleshooting

請參閱下表以瞭解可能的錯誤及其解決方案:

錯誤

後續步驟

輸出檔案大小超過案例所允許的限制。

請參閱檔案大小限制。

您已超過轉換時間上限。

免費的CloudConvert計畫每天提供25分鐘的轉換時間。 如果您的使用量超過免費方案的限制,則可切換為(預付)套件或訂閱。

無法讀取框架大小:無法搜尋至1508。 /output/JLIADSA00137P0.mp3�:無效的引數。

例如,將檔案從MP3轉換為WAV時會擲回此錯誤。 請確定您選取了正確的區域,因為它會找到檔案的參照,而不只是正確的檔案。

RuntimeError:

已超過重複專案的最大數目。

在您的CloudConvert儀表板工作清單中找到對應的CloudConvert工作,並檢查工作的持續時間:

CloudConvert > Convert a File模組的逾時設為3分鐘。 如果工作的持續時間超過3分鐘(可能是因為CloudConvert服務暫時超載),模組會擲回上述錯誤。

在此案例中,請考量下列其中一個選項:

- 在情境設定中啟用 允許儲存未完成的執行 選項,以儲存未完成的執行,以供稍後手動解析。 您可以選擇使用Break指示詞將錯誤處理路由附加至CloudConvert模組,以自動解決未完成的執行。- 停用CloudConvert > 轉換檔案模組中的 下載檔案選項。 在此情況下,模組不會等待轉換結果。 若要取得轉換結果,請建立新案例並使用CloudConvert > 新增工作事件觸發器。

CloudConvert聯結器的範例工作流程

INFO
範例: ​將視訊從MOV轉換為MP4格式
  1. 造訪https://cloudconvert.com/video-converter

  2. 按一下​ 選取檔案 ​並選擇您的範例MOV檔案。

  3. 按一下​ 轉換成 ​旁的下拉式清單,然後選擇​ MP4

  4. 按一下​ 扳手 ​圖示。

  5. 視需要設定MP4壓縮設定。

  6. 按一下​ 轉換

  7. 轉換完成後,請按一下​ 下載

  8. 檢閱轉換後的視訊。

  9. 重複步驟1至8,直到找到步驟5的最佳轉換設定為止。

  10. 造訪https://cloudconvert.com/api/v2/convert#convert-tasks

  11. 為​ input_format ​欄位選擇​ mov

  12. 為​ output_format ​欄位選擇​ mp4

  13. 所有可能的引數清單,例如video_codec、crf等。 將會出現。

  14. 在Workfront Fusion 2.0中,在您的情境中插入​ CloudConvert > 轉換檔案 ​模組。

  15. 開啟模組的設定。

  16. 設定模組,如下所示:

  17. 確定在「轉換及引擎特定選項」欄位中包含所有設定:針對步驟5中的每個設定,找出步驟13中的對應引數及其對應值。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43