共用方式為

Cloudmersive 檔案處理 （預覽版）

檔案處理可讓您輕鬆建立、處理、轉換和更新檔案。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
邏輯應用程式 標準 所有 Logic Apps 區域， 但下列區域除外：
     - Azure Government 區域
     - Azure 中國區域
     - 美國國防部 （DoD）
Power Apps 進階 除下列區域外的所有 Power Apps 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
Power Automate（自動化服務） 進階 除下列區域外的所有 Power Automate 區域 ：
     - 美國政府 （GCC）
     - 美國政府（海灣合作委員會高中）
     - 由 21Vianet 營運的中國雲
     - 美國國防部 （DoD）
連絡人​​
名稱 Cloumdersive 支持
URL https://account.cloudmersive.com/contact-support
Email support@cloudmersive.com
連接器中繼資料
Publisher Cloudmersive有限責任公司
網站 https://www.cloudmersive.com/nlp-api
隱私策略 https://www.cloudmersive.com/privacy-policy
類別 人工智慧;內容和文件

此連接器對於處理檔案、檔案和文字至關重要。 Cloudmersive 檔案處理涵蓋了廣泛的常見檔案處理需求，包括壓縮、加密或提取 zip、處理檔案和文字。 無狀態高安全性處理，確保快速效能和強安全性。 您可以在 檔案處理 API 頁面進一步了解。

若要使用檔案處理連接器，您需要 Cloudmersive 帳戶。 您可以使用 Microsoft 帳戶註冊或建立 Cloudmersive 帳戶。 請按照以下步驟獲取您的 API 密鑰。

取得 API 金鑰和密碼

  • 註冊 Cloudmersive 帳戶
  • 使用您的 Cloudmersive 帳戶登錄並單擊 API 密鑰

您可以在此處建立並查看 API 金鑰頁面上列出的 API 金鑰。 只需將此 API 金鑰複製並貼上到 Cloudmersive 檔案處理連接器中即可。

現在您已準備好開始使用 Cloudmersive 檔案處理連接器。

正在建立連線

連接器支援下列驗證類型：
預設值 建立連線的參數。 所有區域 不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
API 金鑰 （來自 https://cloudmersive.com） securestring 此 API 的 API 金鑰 對

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

Base 64 編碼、將二進位或檔案資料轉換為文字字串

將二進位或檔案資料編碼/轉換為文字字串
Base 64解碼，將Base 64字串轉換為二進位內容

解碼/將基數 64 UTF-8 文字字串轉換為二進位內容
偵測文字檔案的行結尾

偵測輸入檔案的行尾類型（Windows、Unix 或 Mac）。
偵測檔案的文字編碼

檢查檔案的文字編碼
加密和密碼保護 zip 檔案

加密和密碼會使用指定的密碼和加密演算法來保護現有的 zip 檔案
在文字輸入中尋找字串

尋找輸入內容中輸入字串的所有出現項目，並傳回相符項
在文字輸入中尋找正則運算式正則運算式

尋找輸入內容中輸入正規表示式的所有出現項目，並傳回相符項
壓縮檔案以建立新的 zip 封存

通過壓縮輸入文件創建一個新的 zip 存檔。
壓縮檔案和資料夾以建立具有進階選項的新 zip 存檔

透過壓縮輸入檔案、資料夾來建立新的 zip 檔案，並利用進階選項來控制產生的 zip 檔案的結構。
將文字中的字串取代為另一個字串值

取代輸入內容中輸入字串的所有出現項目，並傳回結果
將文字中的字串取代為正則運算式正規表示式字串

取代輸入內容中所有出現的輸入正規表示式正則表達式字串，並傳回結果
建立網頁式檢視器

為簡單的 Web 型文件檢視器建立 HTML 內嵌程式碼;支援 Office 文件類型和 PDF。
從 Word DOCX 文件取得註解作為一般清單

將儲存在 Word 文件 （DOCX） 格式檔案中的註解和檢閱註解傳回為平面清單 （而不是批註和回覆的階層）。
從 zip 存檔中提取、解壓縮檔案和資料夾

透過解壓縮檔案和資料夾來解壓縮 zip 封存。
從文字字串中修剪前導和尾端空格

從文字中修剪前導和尾端空格，留下修剪後的字串。 空格包括換行符、空格和其他空格字元。
從文字字串中移除 HTML

從文字中刪除 HTML，只留下文字。 格式化的文字將變成純文字。 對於防範 HTML 和跨Site-Scripting 攻擊非常重要。
從文字字串中移除空格

從文字中刪除所有空格，只留下非空格字元。 空格包括換行符、空格和其他空格字元。
檢測，檢查文本字符串是否為基數 64 編碼

檢查、檢測輸入字串是否為基數 64 編碼
解密並移除 zip 檔案上的密碼保護

解密並移除具有指定密碼的加密 zip 檔案的密碼保護
設定、變更文字檔案的行結尾

設定文字檔的行尾類型;設定為 Windows、Unix 或 Mac。
驗證檔案是否可執行

驗證輸入檔案是否為有效的二進位可執行檔。

Base 64 編碼、將二進位或檔案資料轉換為文字字串

作業識別碼：
EditText_Base64Encode

將二進位或檔案資料編碼/轉換為文字字串

參數

名稱 機碼 必要 類型 Description
內容編碼
 ContentToEncode byte

輸入內容以編碼為 Base 64

傳回

以 64 為基數編碼的結果

身體
Base64EncodeResponse

Base 64解碼，將Base 64字串轉換為二進位內容

作業識別碼：
EditText_Base64Decode

解碼/將基數 64 UTF-8 文字字串轉換為二進位內容

參數

名稱 機碼 必要 類型 Description
Base64ContentToDecode
 Base64ContentToDecode string

輸入內容以從 Base 64 解碼為二進位

傳回

以 64 為基數解碼的結果

身體
Base64DecodeResponse

偵測文字檔案的行結尾

作業識別碼：
EditText_DetectLineEndings

偵測輸入檔案的行尾類型（Windows、Unix 或 Mac）。

參數

名稱 機碼 必要 類型 Description
要執行操作的輸入檔案。
 inputFile True file

要執行操作的輸入檔案。

傳回

以 64 為基數解碼的結果

身體
DetectLineEndingsResponse

偵測檔案的文字編碼

作業識別碼：
EditText_TextEncodingDetect

檢查檔案的文字編碼

參數

名稱 機碼 必要 類型 Description
要執行操作的輸入檔案。
 inputFile True file

要執行操作的輸入檔案。

傳回

偵測文字編碼的結果

身體
TextEncodingDetectResponse

加密和密碼保護 zip 檔案

作業識別碼：
ZipArchive_ZipEncryptAdvanced

加密和密碼會使用指定的密碼和加密演算法來保護現有的 zip 檔案

參數

名稱 機碼 必要 類型 Description
輸入檔案內容
 InputFileContents byte

輸入 Zip 檔案存檔內容（以位元組為單位）
密碼
 Password string

要放在 Zip 文件上的密碼;密碼越長，越安全
EncryptionAlgorithm
 EncryptionAlgorithm string

要使用的加密算法;可能的值為 AES-256 （建議）、AES-128 和 PK-Zip （不建議，舊版、弱式加密演算法）。 預設值為AES-256。

傳回

response
object

在文字輸入中尋找字串

作業識別碼：
EditText_FindSimple

尋找輸入內容中輸入字串的所有出現項目，並傳回相符項

參數

名稱 機碼 必要 類型 Description
文字內容
 TextContent string

輸入文字內容
目標字串
 TargetString string

要尋找的目標輸入字串

傳回

尋找字串的結果

身體
FindStringSimpleResponse

在文字輸入中尋找正則運算式正則運算式

作業識別碼：
EditText_FindRegex

尋找輸入內容中輸入正規表示式的所有出現項目，並傳回相符項

參數

名稱 機碼 必要 類型 Description
文字內容
 TextContent string

輸入文字內容
目標規則運算式
 TargetRegex string

目標輸入正規表示式 （regex） 以尋找
火柴盒
 MatchCase boolean

設定為 True 以符合大小寫，設定為 False 以忽略大小寫

傳回

尋找字串的結果

身體
FindStringRegexResponse

壓縮檔案以建立新的 zip 封存

作業識別碼：
ZipArchive_ZipCreate

通過壓縮輸入文件創建一個新的 zip 存檔。

參數

名稱 機碼 必要 類型 Description
第一個要執行操作的輸入檔案。
 inputFile1 True file

第一個要執行操作的輸入檔案。
要執行操作的第二個輸入檔案。
 inputFile2 file

要執行操作的第二個輸入檔案。
要執行操作的第三個輸入檔案。
 inputFile3 file

要執行操作的第三個輸入檔案。
要執行操作的第四個輸入檔案。
 inputFile4 file

要執行操作的第四個輸入檔案。
要執行操作的第五個輸入檔案。
 inputFile5 file

要執行操作的第五個輸入檔案。
要執行操作的第六個輸入檔案。
 inputFile6 file

要執行操作的第六個輸入檔案。
要執行操作的第七個輸入檔案。
 inputFile7 file

要執行操作的第七個輸入檔案。
要執行操作的第八個輸入檔案。
 inputFile8 file

要執行操作的第八個輸入檔案。
要執行操作的第九個輸入檔案。
 inputFile9 file

要執行操作的第九個輸入檔案。
要執行操作的第十個輸入檔案。
 inputFile10 file

要執行操作的第十個輸入檔案。

傳回

從作業輸出檔案內容

OutputContent
binary

壓縮檔案和資料夾以建立具有進階選項的新 zip 存檔

作業識別碼：
ZipArchive_ZipCreateAdvanced

透過壓縮輸入檔案、資料夾來建立新的 zip 檔案，並利用進階選項來控制產生的 zip 檔案的結構。

參數

名稱 機碼 必要 類型 Description
檔案名稱
 FileName string

此檔案的名稱
檔案內容
 FileContents byte

此檔案的內容
目錄名稱
 DirectoryName string

此目錄的名稱
檔案名稱
 FileName string

此檔案的名稱
檔案內容
 FileContents byte

此檔案的內容

傳回

response
object

將文字中的字串取代為另一個字串值

作業識別碼：
EditText_ReplaceSimple

取代輸入內容中輸入字串的所有出現項目，並傳回結果

參數

名稱 機碼 必要 類型 Description
文字內容
 TextContent string

輸入文字內容
目標字串
 TargetString string

要比對和取代的目標輸入字串
替換與字串
 ReplaceWithString string

取代目標字串

傳回

取代字串的結果

身體
ReplaceStringSimpleResponse

將文字中的字串取代為正則運算式正規表示式字串

作業識別碼：
EditText_ReplaceRegex

取代輸入內容中所有出現的輸入正規表示式正則表達式字串，並傳回結果

參數

名稱 機碼 必要 類型 Description
文字內容
 TextContent string

輸入文字內容
RegularExpressionString
 RegularExpressionString string

目標輸入正規表示式 （regex） 字串以匹配和替換;支援所有正規表示式值
替換與字串
 ReplaceWithString string

替換目標字串;支援從RegularExpressionString引用索引的正則表達式匹配值，例如$1、$2等

傳回

取代正則運算式字串的結果

身體
ReplaceStringRegexResponse

建立網頁式檢視器

作業識別碼：
ViewerTools_CreateSimple

為簡單的 Web 型文件檢視器建立 HTML 內嵌程式碼;支援 Office 文件類型和 PDF。

參數

名稱 機碼 必要 類型 Description
要執行操作的輸入檔案。
 inputFile True file

要執行操作的輸入檔案。

傳回

建立檢視器的結果

身體
ViewerResponse

從 Word DOCX 文件取得註解作為一般清單

作業識別碼：
EditDocument_DocxGetComments

將儲存在 Word 文件 （DOCX） 格式檔案中的註解和檢閱註解傳回為平面清單 （而不是批註和回覆的階層）。

參數

名稱 機碼 必要 類型 Description
輸入檔案位元組
 InputFileBytes byte

選用項目：要操作的輸入檔案位元組
輸入檔案網址
 InputFileUrl string

選用：要作為輸入操作的檔案 URL。 這可以是公用 URL，您也可以使用 begin-editing API 上傳文件，並將該作業的安全 URL 結果傳入，作為此處的 URL （此 URL 不是公用的）。

傳回

從 Word 文檔 DOCX 獲取註釋的結果

身體
GetDocxCommentsResponse

從 zip 存檔中提取、解壓縮檔案和資料夾

作業識別碼：
ZipArchive_ZipExtract

透過解壓縮檔案和資料夾來解壓縮 zip 封存。

參數

名稱 機碼 必要 類型 Description
要執行操作的輸入檔案。
 inputFile True file

要執行操作的輸入檔案。

傳回

執行 zip 擷取作業的結果

身體
ZipExtractResponse

從文字字串中修剪前導和尾端空格

作業識別碼：
EditText_TrimWhitespace

從文字中修剪前導和尾端空格，留下修剪後的字串。 空格包括換行符、空格和其他空格字元。

參數

名稱 機碼 必要 類型 Description
TextContaining空格
 TextContainingWhitespace string

輸入文字字串以移除空格

傳回

從字串中移除空格的結果

身體
RemoveWhitespaceFromTextResponse

從文字字串中移除 HTML

作業識別碼：
EditText_RemoveHtml

從文字中刪除 HTML，只留下文字。 格式化的文字將變成純文字。 對於防範 HTML 和跨Site-Scripting 攻擊非常重要。

參數

名稱 機碼 必要 類型 Description
包含文字的 HTML
 TextContainingHtml string

輸入文字字串以從中移除 HTML

傳回

從字串中刪除 HTML 的結果

身體
RemoveHtmlFromTextResponse

從文字字串中移除空格

作業識別碼：
EditText_RemoveAllWhitespace

從文字中刪除所有空格，只留下非空格字元。 空格包括換行符、空格和其他空格字元。

參數

名稱 機碼 必要 類型 Description
TextContaining空格
 TextContainingWhitespace string

輸入文字字串以移除空格

傳回

從字串中移除空格的結果

身體
RemoveWhitespaceFromTextResponse

檢測，檢查文本字符串是否為基數 64 編碼

作業識別碼：
EditText_Base64Detect

檢查、檢測輸入字串是否為基數 64 編碼

參數

名稱 機碼 必要 類型 Description
Base64ContentToDetect
 Base64ContentToDetect string

輸入內容文字以偵測它是否為基數 64 編碼

傳回

以 64 為基數的檢測結果

身體
Base64DetectResponse

解密並移除 zip 檔案上的密碼保護

作業識別碼：
ZipArchive_ZipDecrypt

解密並移除具有指定密碼的加密 zip 檔案的密碼保護

參數

名稱 機碼 必要 類型 Description
要執行操作的輸入檔案。
 inputFile True file

要執行操作的輸入檔案。
必要;輸入封存的密碼
 zipPassword True string

必要;輸入封存的密碼

傳回

response
object

設定、變更文字檔案的行結尾

作業識別碼：
EditText_ChangeLineEndings

設定文字檔的行尾類型;設定為 Windows、Unix 或 Mac。

參數

名稱 機碼 必要 類型 Description
行結尾類型
 lineEndingType True string

'Windows' 將使用回車符和換行符，'Unix' 將使用換行符，'Mac' 將使用回車符。
要執行操作的輸入檔案。
 inputFile True file

要執行操作的輸入檔案。

傳回

執行變更明細結束作業的結果

身體
ChangeLineEndingResponse

驗證檔案是否可執行

作業識別碼：
ValidateDocument_ExecutableValidation

驗證輸入檔案是否為有效的二進位可執行檔。

參數

名稱 機碼 必要 類型 Description
要執行操作的輸入檔案。
 inputFile True file

要執行操作的輸入檔案。

傳回

文件驗證結果

身體
DocumentValidationResult

定義

GetDocxComments回應

從 Word 文檔 DOCX 獲取註釋的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
評論
 Comments array of DocxComment

文件中的註解
評論計數
 CommentCount integer

文件中的註解數

Docx評論

在 Word 文件中註解

名稱 路徑 類型 Description
路徑
 Path string

文件中註解的路徑
作者
 Author string

註解的作者姓名
作者姓名縮寫
 AuthorInitials string

評論作者姓名首字母
評論文字
 CommentText string

註解文字內容
評論日期
 CommentDate date-time

註解的日期時間戳記
是頂層
 IsTopLevel boolean

如果註解位於最上層，則為 True，如果此註解是另一個註解的子回覆，則為 false
是回覆
 IsReply boolean

如果此註解是對另一個註解的回覆，則為 true，否則為 false
父級註解路徑
 ParentCommentPath string

此註解父級的路徑，如果此註解是回覆，否則此值為空
Done
 Done boolean

如果此註解在 Word 中標示為 [完成]，則為 True，否則為 false

Base64Detect回應

以 64 為基數的檢測結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
IsBase64編碼
 IsBase64Encoded boolean

如果輸入字串是基數 64 編碼，則為 true，否則為 false

Base64Encode回應

以 64 為基數編碼的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
Base64TextContent結果
 Base64TextContentResult string

執行基數 64 編碼作業的結果，表示編碼的原始檔案內容的文字字串

Base64Decode回應

以 64 為基數解碼的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
內容結果
 ContentResult byte

執行 base 64 解碼作業的結果，二進位檔案內容

TextEncodingDetect回應

偵測文字編碼的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
文字編碼
 TextEncoding string

文件中使用的文本編碼;可能的值為 ASCII、UTF7、UTF8、UTF16、BigEndianUnicode 和 UTF32

FindStringSimple回應

尋找字串的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
相符
 Matches array of FindStringMatch

找到的相符項目
匹配計數
 MatchCount integer

比賽數量

尋找字串匹配

在較長文字字串中尋找目標字串的個別比對結果

名稱 路徑 類型 Description
字元位移開始
 CharacterOffsetStart integer

比賽開始的從 0 開始的索引
字元偏移結束
 CharacterOffsetEnd integer

比賽結束的從 0 開始的索引
包含線
 ContainingLine string

包含相符項目之行的文字內容

FindStringRegex回應

尋找字串的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
相符
 Matches array of FindRegexMatch

規則運算式相符
匹配計數
 MatchCount integer

比賽數量

尋找正則表達式匹配

在較長文字字串中尋找目標正則運算式的個別正則運算式比對結果

名稱 路徑 類型 Description
字元位移開始
 CharacterOffsetStart integer

比賽開始的從 0 開始的索引
字元偏移結束
 CharacterOffsetEnd integer

比賽結束的從 0 開始的索引
包含線
 ContainingLine string

包含相符項目之行的文字內容
比對值
 MatchValue string

比對值
匹配組
 MatchGroups array of string

正規表示式正則表達式匹配組;這些對應於比對值

ReplaceStringSimpleResponse

取代字串的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
文字內容結果
 TextContentResult string

執行取代字串作業的結果

ReplaceStringRegex回應

取代正則運算式字串的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
文字內容結果
 TextContentResult string

執行 base 64 解碼作業的結果，二進位檔案內容

DetectLineEndings回應

以 64 為基數解碼的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
主要換行類型
 PrimaryNewlineType string

檔案中的換行符類型;可能的 vlaues 是 “Mac” （舊版 Mac OS 僅使用回車符）;“Unix”（Unix 和 Linux 操作系統，以及現代 Mac OS）;“Windows”（Windows 操作系統）
主要改行終止符
 PrimaryNewlineTerminator string

用來終止換行符的字元;可以是回車、換行或回車 + 換行
輸入長度
 InputLength integer

輸入字串的長度（以字元為單位）

變更線結束回應

執行變更明細結束作業的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
文字內容結果
 TextContentResult string

文字內容結果

RemoveHtmlFromText回應

從字串中刪除 HTML 的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
文字內容結果
 TextContentResult string

執行從字串中移除 HTML 作業的結果

從TextResponse移除空白

從字串中移除空格的結果

名稱 路徑 類型 Description
成功
 Successful boolean

成功則為 true，否則為 false
文字內容結果
 TextContentResult string

執行從字串中移除空格作業的結果

DocumentValidationError

在文件中發現驗證錯誤

名稱 路徑 類型 Description
Description
 Description string

錯誤描述
路徑
 Path string

XPath 新增至錯誤
Uri
 Uri string

相關部分的 URI
IsError
 IsError boolean

如果這是錯誤，則為 True，否則為 false

文件驗證結果

文件驗證結果

名稱 路徑 類型 Description
文件有效
 DocumentIsValid boolean

如果文件有效且沒有錯誤，則為 true，否則為 false
密碼保護
 PasswordProtected boolean

如果文件受密碼保護，則為 true，否則為 false
錯誤計數
 ErrorCount integer

在文件中找到的驗證錯誤數目
警告計數
 WarningCount integer

在文件中找到的驗證警告數目
錯誤和警告
 ErrorsAndWarnings array of DocumentValidationError

找到的錯誤和警告的詳細資料

Viewer回應

建立檢視器的結果

名稱 路徑 類型 Description
Html嵌入
 HtmlEmbed string
成功
 Successful boolean

壓縮檔案

zip 檔案中檔案的表示法

名稱 路徑 類型 Description
檔案名稱
 FileName string

此檔案的名稱
檔案內容
 FileContents byte

此檔案的內容

郵遞目錄

zip 檔案中目錄的表示法

名稱 路徑 類型 Description
目錄名稱
 DirectoryName string

此目錄的名稱
目錄內目錄
 DirectoriesInDirectory array of ZipDirectory

直接包含在此目錄中的子目錄
檔案目錄
 FilesInDirectory array of ZipFile

直接包含在此目錄中的子檔案

ZipExtract回應

執行 zip 擷取作業的結果

名稱 路徑 類型 Description
成功
 Successful boolean

如果作業成功，則為 true，否則為 false
檔案在 Zip 中
 FilesInZip array of ZipFile

zip檔案根目錄中的頂層檔案
目錄InZip
 DirectoriesInZip array of ZipDirectory

zip根目錄中的頂層目錄;目錄可以包含子目錄和檔案

物件

這是類型 'object'。

二進位

這是基本數據類型 『binary』。