文字動作

文字動作可讓您在桌面流程中處理、操縱和轉換文字值。

若要合併文字值清單和建立單一文字值，請使用加入文字動作。 此動作需要您指定清單和分隔符號。

若要將單一文字值分割成清單，請部署分割文字動作，並指定文字值和分隔符號來分隔清單項目。

若要取代文字中的子文字，請使用取代文字動作。 以下範例用特徵取代文字產品特徵。

使用剖析文字動作在其他文字中搜尋文字值。

某些文字動作讓您能夠使用一般運算式。 例如，您可以在剖析文字動作中啟用 Is 規則運算式，以搜尋由規則運算式指定的文字。 如需有關規則運算式的詳細資訊，請移至規則運算式語言 - 快速參考資料。

此外，您也可以停用僅限第一個事件，將動作傳回包含所有相符文字位的清單。

下列範例搜尋庫存中偵測到的項目中以大寫字母開頭的所有單字。 名為相符的產生清單會儲存項目和庫存值。 位置清單會儲存找到值的位置 (1 到 18)。

除了在文字中搜尋之外，Power Automate 還可讓您使用裁剪文字動作來裁剪文字中的文字值。 您可以使用第一個出現指定字元或字串標記的標幟來定義要裁剪的文字。 您可以在指定的文字標幟之前、之後或之間裁剪值。

CroppedText 變數會儲存裁剪後的文字，同時您可以使用 IsFlagFound 變數來檢查動作是否找到設定的標幟。

若要確定數位是儲存為數值，請使用將文字轉換為數字動作。 若要執行反向轉換，請使用將數字轉換成文字。

同樣地，您可以使用轉換文字成日期時間，和轉換日期時間成文字，來確保日期正確格式化。

使用 [識別文字中的實體] 動作

桌面流程讓您可透過識別文字中的實體動作，從自然語言文字 (如數字、日期及度量單位) 擷取各種實體。

識別文字中的實體動作會取得文字或包含文字的變數，並傳回包含結果的資料表。 每個實體都會根據其結構傳回不同的結果，但是所有資料表都包含一個原始文字欄位，用於儲存輸入文字的實體部分。

下表顯示識別文字中的實體動作可以識別的實體的各種範例。

實體	輸入文字	傳回值
日期時間	我會返回 2019 年 1 月 4 日	值：2019/1/4 上午 12:00:00 原始文字：2019 年 1 月 4 日
日期時間	安排今晚 7 點開會	值：2021/9/30 下午 7:00:00 原始文字：今晚 7 點
維度	您的體重為 200 磅	值：200 單位：磅 原始文字：200 磅
維度	一個龍捲風呼嘯著穿越大約 10 英里長的區域	值：10 單位：英里 原始文字：十英里
溫度	室外溫度為攝氏 40 度	值：40 單位：C 原始文字：40 攝氏度
貨幣	本季度淨利息收入下降 27% 至 2.54 億美元	值：254000000 單位：美元 原始文字：$ 254 百萬
數字範圍	此數字大於 20 且小於或等於 35	從：20 到：35 原始文字：此數字大於 20 且小於或等於 35
數字範圍	從 5 到 10	從：5 到：10 原始文字：從 5 到 10
數字範圍	小於 4.565	從：0 到：4.565 原始文字：小於 4.565
數值	一打	值：12 原始文字：一打
數值	三分之二	值：0.666666666666667 原始文字：三分之二
序數	我喜歡前兩本書	值：1 原始文字：第一
序數	第 11	值：11 原始文字：第十一
百分比	100%	值：100 原始文字：百分之 100
電話號碼	電話：+1 209-555-0100	值：+1 209-555-0100 原始文字：+1 209-555-0100
Email	felix@contoso.com	值：felix@contoso.com 原始文字：felix@contoso.com
IP 位址	我的電腦 IP 位址是 1.1.1.1	值：1.1.1.1 原始文字： 1.1.1.1
提及	@Alice	值：@Alice 原始文字：@Alice
主題標籤	#新聞	值：#新聞 原始文字：#新聞
URL	www.microsoft.com	值：www.microsoft.com 原始文字：www.microsoft.com
GUID	123e4567-e89b-12d3-a456-426655440000	值：123e4567-e89b-12d3-a456-426655440000 原始文字：123e4567-e89b-12d3-a456-426655440000
加引號的文字	在「值」欄位中輸入值	值："value" 原始文字："value"

注意

識別文字中的實體動作支援 14 種不同的語言。 不過，某些實體可能不適用於特定語言。 如需有關語言限制的詳細資訊，請移至 Microsoft 識別器文字 - 跨文化支援的實體。

附加一行至文字

附加一行新文字至文字值。

輸入參數

引數	選用	接受	預設值	描述
Original text	否	文字值		原始文字
Line to append	是	文字值		做為新行新增的文字

變數已產生

引數	類型​	描述
Result	文字值	新文字

例外狀況

此動作不包括任何例外狀況。

取得子文字

從文字值擷取子文字。

輸入參數

引數	選用	接受	預設值	描述
Original text	否	文字值		要從中擷取一段文字的文字
Start index	無法使用	文字開頭、字元位置	字元位置	指定如何尋找擷取文字的起點
Character position	否	數值		要擷取的第一個字元的位置。 此值是從零起始的索引，從零開始計算第一個字元
Length	無法使用	文字結尾、字元數	字元數	指定子文字會延續至文字結尾，或只包含特定字元數
Number of chars	否	數值		要擷取的字元數

變數已產生

引數	類型​	描述
Subtext	文字值	擷取的子文字

例外狀況

例外	描述
起始索引或長度超出範圍	指出起始索引或長度超出範圍

裁剪文字

檢索在給定文字中出現於指定文字標幟之前、之後或之間的文字值。

輸入參數

引數	選用	接受	預設值	描述
Original text	否	文字值		要從中擷取一段文字的文字
Mode	無法使用	取得指定標幟之前的文字，取得指定標幟之後的文字，取得兩個指定標幟之間的文字	擷取指定標幟之前的文字	指定要擷取標幟之前、之後還是之間的文字。
起始標幟	否	文字值		擷取的文字將位於此標幟之後。 標幟可以是任何字元或文字
結尾標幟	否	文字值		擷取的文字將位於此標幟之前。 標幟可以是任何字元或文字
Ignore case	無法使用	布林值	誤判為真	指定要使用區分大小寫還是不區分大小寫的比對方式來尋找標幟

變數已產生

引數	類型​	描述
CroppedText	文字值	新的裁剪文字
IsFlagFound	布林值	指示是否找到標幟

例外狀況

此動作不包括任何例外狀況。

填補文字

透過將字元新增至現有文字的左邊或右邊建立固定長度的文字。

輸入參數

引數	選用	接受	預設值	描述
Text to pad	是	文字值		要加長的文字
Pad	無法使用	向左、向右	向左	指定是否要新增字元至現有文字的左邊或右邊
Text for padding	是	文字值		為使原始文字加長而新增的字元或文字
Total length	是	數值	10	最終填補文字的字元總長度。 會重複加入用於填補的文字，直到最終文字達到指定的長度為止

變數已產生

引數	類型​	描述
PaddedText	文字值	新的填補文字

例外狀況

此動作不包括任何例外狀況。

修剪文字

從現有文字開頭和/或結尾處移除所有空白字元出現的位置 (如空格、索引標籤或新行)。

修剪文字動作會接收文字值做為輸入，並根據要修剪參數產生文字輸出。 以下是要裁切參數的可用選項：

• 開頭處的空白字元
• 結尾處的空白字元
• 開頭和結尾的空白字元

輸入參數

引數	選用	接受	預設值	描述
Text to trim	是	文字值		要修剪的文字
What to trim	無法使用	開頭的空白字元、結尾的空白字元、開頭和結尾的空白字元	開頭和結尾的空白字元	指定要移除空白字元的位置

變數已產生

引數	類型​	描述
TrimmedText	文字值	修剪後的新文字

例外狀況

此動作不包括任何例外狀況。

反轉文字

反轉文字字串中的字母順序。

輸入參數

引數	選用	接受	預設值	描述
要反轉的文字	否	文字值		要反轉的文字

變數已產生

引數	類型​	描述
ReversedText	文字值	新的反轉文字

例外狀況

此動作不包括任何例外狀況。

變更文字大小寫

將文字大小寫變更為大寫、小寫、字首大寫或句首大寫。

輸入參數

引數	選用	接受	預設值	描述
Text to convert	是	文字值		The text to convert
Convert to	無法使用	大寫、小寫、字首大寫、句首大寫	大寫	指定要使用的文字大小寫樣式

變數已產生

引數	類型​	描述
TextWithNewCase	文字值	新的轉換文字

例外狀況

此動作不包括任何例外狀況。

將文字轉換為數字

將數字的文字表示方式轉換為包含數值的變數。

輸入參數

引數	選用	接受	預設值	描述
Text to convert	否	文字值		只包含數字的文字變數，要轉換為數值變數。 忽略空格，但非數字的文字會擲回例外狀況

變數已產生

引數	類型​	描述
TextAsNumber	數值	新數值

例外狀況

例外	描述
提供的文字值無法轉換成有效的數字	指出提供的文字值無法轉換成有效的數字

將數字轉換為文字

使用指定的格式將數字轉換為文字。

輸入參數

引數	選用	接受	預設值	描述
Number to convert	否	數值		要轉換為文字的數值
Decimal places	是	數值	2	截斷之前要包含的小數位數。 也可以透過在結尾加上零這種方式填補文字
Use thousands separator	無法使用	布林值	是	指定是否要使用標點符號做為千分位分隔符號

變數已產生

引數	類型​	描述
FormattedNumber	文字值	格式化為文字的數字

例外狀況

此動作不包括任何例外狀況。

將文字轉換為日期時間

將日期和/或時間值的文字表示方式轉換為日期時間值。

輸入參數

引數	選用	接受	預設值	描述
Text to convert	否	文字值		要轉換為日期時間值的文字。 此文字必須採用可辨識的日期時間值格式
Date is represented in custom format	無法使用	布林值	否	指定要轉換的文字是否包含非標準、無法辨識的日期和時間格式表示方式
Custom format	否	文字值		日期儲存在文字中的格式。 例如，自訂格式可以表示為代表日期的 yyyyMMdd 以及代表時間的 hhmmss

變數已產生

引數	類型​	描述
TextAsDateTime	日期時間	日期時間值

例外狀況

例外	描述
提供的文字值無法轉換成有效的日期時間	指出提供的文字值無法轉換成有效的日期時間

將日期時間轉換為文字

使用指定的自訂格式將日期時間值轉換為文字。

輸入參數

引數	選用	接受	預設值	描述
Datetime to convert	否	日期時間		要轉換為文字的日期時間值
Format to use	無法使用	標準、自訂	標準	指定要使用標準日期時間格式，或是建立自訂格式
Custom Format	否	文字值		用來顯示日期時間值的自訂格式。 例如，日期時間可以表示為代表日期的 MM/dd/yyyy 以及代表時間的 hh:mm:sstt
Standard format	無法使用	簡短日期、完整日期、簡短時間、完整時間、完整日期時間 (簡短時間)、完整日期時間 (完整時間)、一般日期時間 (簡短時間)、可排序的日期時間	簡短日期	動作用來顯示日期時間值的標準日期時間格式

變數已產生

引數	類型​	描述
FormattedDateTime	文字值	已格式化為文字值的日期時間

例外狀況

此動作不包括任何例外狀況。

建立隨機文字

產生由隨機字元數組成的指定長度文字。 此動作在產生密碼時很實用。

輸入參數

引數	選用	接受	預設值	描述
Use uppercase letters (A-Z)	無法使用	布林值	是	指定產生的文字中是否要包含大寫字元
Use lowercase letters (a-z)	無法使用	布林值	是	指定產生的文字中是否要包含小寫字元
Use digits (0-9)	無法使用	布林值	是	指定產生的文字中是否要包含數字
使用符號 ( , . <> ? ! + - _ # $ ^ )	無法使用	布林值	確判為真	指定產生的文字中是否要包含符號
Minimum length	是	數值	6	隨機文字的長度下限。 針對特定長度的文字，將最小值和最大值設為該數字
Maximum length	是	數值	10	隨機文字的長度上限。 針對特定長度的文字，將最小值和最大值設為該數字

變數已產生

引數	類型​	描述
RandomText	文字值	產生的隨機文字

例外狀況

此動作不包括任何例外狀況。

聯結文字

透過使用指定的分隔符號分隔項目的方式，將清單轉換成文字值。

若要將清單的所有內容聯結到單一文字值，請使用加入文字動作。 首先在指定要加入的清單屬性中指定要使用的對應清單。 您可以透過在分隔清單項目的分隔符號屬性下拉式清單中進行對應的選擇，來選擇分隔符號來分隔聯結文字中的清單項目：

• 無會透過組合清單中的所有項目來建立單一聯結文字，而不用分隔符號分隔它們。
• 標準可讓您透過在標準分隔符號屬性下拉式清單中選擇對應的選項，來將分隔符號設為空格、索引標籤或新行。 您也可以透過修改次數屬性來選擇在每個清單項目之間顯示分隔符號的次數。
• 自訂可讓您設定自己的分隔符號。

輸入參數

引數	選用	接受	預設值	描述
Specify the list to join	否	文字值清單		要轉換為文字的清單
Delimiter to separate list items	無法使用	否、標準、自訂	否​​	指定不使用分隔符號、使用標準分隔符號或使用自訂分隔符號
Custom delimiter	否	文字值		要做為分隔符號使用的字元
Standard delimiter	無法使用	空格、定位字元、新行	空格	指定要使用的分隔符號
Times	是	數值	1	指定要使用指定的分隔符號的次數

變數已產生

引數	類型​	描述
JoinedText	文字值	新的分隔文字

例外狀況

此動作不包括任何例外狀況。

分割文字

建立包含以指定分隔符號或規則運算式分隔之文字子字串的清單。

輸入參數

引數	選用	接受	預設值	描述
The text to split	否	文字值		要分割的文字
Delimiter type	無法使用	標準、自訂	標準	使用的分隔符號為標準或自訂格式
Custom delimiter	否	文字值		做為分隔符號使用的字元
Standard delimiter	無法使用	空格、定位字元、新行	空格	使用的分隔符號
Times	是	數值	1	指定分隔符號使用的次數
Is regular expression	無法使用	布林值	誤判為真	指定分隔符號是否為規則運算式。 規則運算式會建立各種可能的分隔符號範圍。 例如，'\d' 表示分隔符號可以是任何數字

注意

Power Automate 的標準運算式引擎是 .NET。 如需有關規則運算式的詳細資訊，請移至規則運算式語言 - 快速參考資料。

變數已產生

引數	類型​	描述
TextList	文字值清單	新清單

例外狀況

例外	描述
提供的規則運算式無效	指出提供的規則運算式無效

剖析文字

剖析文字以找出指定的子文字或規則運算式模式第一次或所有出現的位置。

輸入參數

引數	選用	接受	預設值	描述
Text to Parse	否	文字值		要剖析的文字
Text to Find	否	文字值		要搜尋的子文字或規則運算式
Is regular expression	無法使用	布林值	否	指定子文字是否為規則運算式。 例如，\d 表示子文字可以是任何數字
Start Parsing at Position	否	數值		開始尋找「要尋找的文字」的位置。 第一個位置是零，因此使用 0 從頭開始尋找
First occurrence only	無法使用	布林值	是	指定只要尋找第一次出現的位置，或是找出「要尋找的文字」每一次出現的位置
Ignore case	無法使用	布林值	否	指定要使用區分大小寫或不區分大小寫的比對方式來尋找指定的文字

注意

Power Automate 的標準運算式引擎是 .NET。 如需有關規則運算式的詳細資訊，請移至規則運算式語言 - 快速參考資料。

變數已產生

引數	類型​	描述
Position	數值	「要尋找的文字」在「要剖析的文字」中的位置。 如果在原始文字中找不到該文字，此變數將會保留值 -1
Positions	數值清單	「要尋找的文字」在「要剖析的文字」中的位置。 如果在原始文字中找不到該文字，此變數將會保留值 -1
Match	文字值	符合所指規則運算式的結果
Matches	文字值清單	符合所指規則運算式的結果

例外狀況

例外	描述
提供的規則運算式無效	指出提供的規則運算式無效

取代文字

將指定的子文字所有出現的位置都取代為其他文字。 它也可和規則運算式搭配使用。

輸入參數

引數	選用	接受	預設值	描述
Text to parse	否	文字值		要剖析的文字
Text to find	否	文字值		要搜尋的子文字或規則運算式
Use regular expressions for find and replace	無法使用	布林值	否	指定子文字是否為規則運算式。 規則運算式會建立各種可能的子文字範圍。 例如，'\d' 表示子文字可以是任何數字
Ignore case	無法使用	布林值	否	指定要使用區分大小寫或不區分大小寫的比對方式來尋找要取代的子文字
Replace with	否	文字值		要取代所找到文字的文字或規則運算式
Activate escape sequences	無法使用	布林值	否	指定是否要使用特殊序列。 例如，替代文字中的 '\t' 會解譯為定位字元

注意

Power Automate 的標準運算式引擎是 .NET。 如需有關規則運算式的詳細資訊，請移至規則運算式語言 - 快速參考資料。

變數已產生

引數	類型​	描述
Replaced	文字值	更新後的新文字

例外狀況

此動作不包括任何例外狀況。

規則運算式的逸出文字

逸出最小的字元集 (,、*、+、?、|、{、[、(、)、^、$、.、# 和空白字元)，方法是將其取代為逸出代碼。

輸入參數

引數	選用	接受	預設值	描述
Text to escape	否	文字值		要逸出的文字

變數已產生

引數	類型​	描述
EscapedText	文字值	逸出的文字

例外狀況

此動作不包括任何例外狀況。

識別文字中的實體

識別文字中的實體，例如數字、單位、資料/時間和其他跨多種語言以自然語言表示的項目。

輸入參數

引數	選用	接受	預設值	描述
要識別的文字	否	文字值		用於識別實體的文字
實體類型	N/A	日期時間、維度、溫度、貨幣、數字範圍、數字、序數、百分數、電話號碼、電子郵件、IP 位址、提及、主題標籤、URL、GUID、加引號的文字	日期時間	要辨識的實體類型 (日期時間、電子郵件、URL 等)
語言	無法使用	英文、中文 (簡體)、西班牙文、西班牙文 (墨西哥)、葡萄牙文、法文、德文、意大利文、日文、荷蘭文、韓文、瑞典文、土耳其文、印地文	英語	指定文字的語言

變數已產生

引數	類型​	描述
RecognizedEntities	資料表	識別的實體

例外狀況

此動作不包括任何例外狀況。

建立 HTML 內容

產生豐富的 HTML 內容並將之儲存在變數中。

此動作允許使用者以格式化且直觀的方式建立 HTML 內容，該內容儲存在文字變數中。 然後可以在需要 HTML 格式的以下動作中使用該變數。

此功能主要服務於電子郵件傳送動作「傳送電子郵件」、「傳送 Exchange 電子郵件」和「透過 Outlook 傳送電子郵件」(與其「正文」輸入參數有關)。 具體來說，當啟用正文為 HTML 選項時，產生的變數可以原樣用在流程中後續電子郵件傳送動作的「正文」參數中。

輸入參數

輸入參數透過嵌入式 HTML 編輯器進行設定。

HTML 編輯器的初始檢視允許對呈現的 HTML 內容進行開箱即用的編輯，透過頂部的工具列提供一組格式選項，包括插入連結、影像 (透過本機路徑或 URL) 的功能和資料表，甚至動態內容的變數。

啟用文字編輯器選項會切換到可以使用 HTML 語言 (包括對應元素標籤) 的檢視。

文字編輯器中不需要<標題>和<正文>元素來呈現 HTML 內容。

變數已產生

引數	類型​	描述
HtmlContent	文字值	HTML 程式碼

例外狀況

此動作不包括任何例外狀況。