變數動作

若要在桌面流程中手動建立變數，請部署設定變數動作。 此動作需要您提供新變數的名稱和值。

重要

保留關鍵字不能當作變數名稱。 有關保留關鍵字的完整清單，請前往桌面流程中的保留關鍵字。

若要增加或減少變數的數值，請分別使用增加變數和減少變數動作。

大部分動作都會將其結果輸出至變數。 例如，建立新清單動作會產生空白清單。

同樣地，產生亂數動作會產生隨機的數值。 如果您在此動作中啟用產生多個數字，您將建立一個包含多個隨機數值的清單變數。

若要將項目新增至現有的清單，請部署新增項目至清單動作，並填入寫死的值或變數以定義要新增的項目。 同樣地，您可以使用 從清單移除項目動作從清單中移除項目。

注意

清單索引從 0 開始，表示清單中的第一個項目的索引一率為 0。 使用標記法 %ListName[0]% 來參照清單中的第一個項目，%ListName[1]% 為第二個，依此類推。

如果要建立資料表變數，請部署建立新資料表動作，並使用視覺化建立器指定其初始項目。

若要操縱資料表變數，請使用相應動作子群組的動作，例如在資料表中尋找或替換和更新資料表項目動作。

建立新資料表

建立新資料表變數。

輸入參數

引數	選用	接受	預設值	描述
新增資料表	否	資料表		輸入資料表

變數已產生

引數	類型​	描述
資料表	資料表	新資料表

例外狀況

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

將資料列插入資料表

在特定索引值的結尾或之前插入列。

輸入參數

引數	選用	接受	預設值	描述
資料表	否	資料表		要使用的資料表變數。 此變數必須先前已由產生資料表變數的動作指定
進入位置	無法使用	資料表結尾，資料列索引之前	資料表結尾	指定是否要在資料表結尾或指定的列索引之前插入新列
資料列索引	否	數值		插入將列索引之前指定為進入位置參數時要使用的列索引值
新值	否	清單，資料列		此參數接受清單或資料列變數，其中欄計數應與資料表中的欄計數相符

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	名描述
項目索引超出範圍	表示提供的項目索引超出範圍
輸入引數無效	表示輸入參數無效
不相容類型錯誤	表示提供了不相容類型的輸入參數

從資料表刪除資料列

刪除在對應列索引的資料表列。

輸入參數

引數	選用	接受	預設值	描述
資料表	否	資料表		要使用的資料表變數。 此變數必須由生成資料表變數的操作指定
資料表索引	否	數值		資料表中應刪除的資料列索引

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	名描述
項目索引超出範圍	表示指定的資料表項目超出範圍

更新資料表項目

更新定義資料行上的資料表列項目。

輸入參數

引數	選用	接受	預設值	描述
資料表	否	資料表		要使用的資料表變數。 此變數必須先前已由產生資料表變數的動作指定。
Column	否	文字值		要更新之項目的資料行名稱或索引。
資料列	否	數值		要更新之項目的列索引。
新值	否	文字值		在指定的列索引和欄更新的新值。

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	名描述
項目索引超出範圍	表示指定的資料表項目超出範圍
資料行名稱不存在	表示提供的資料行名稱不存在
資料行索引超出範圍	表示提供的資料行索引超出範圍
不相容類型錯誤	指示提供了不相容類型的輸入參數

在資料表中尋找或取代

尋找及/或替換資料表值。

輸入參數

引數	選用	接受	預設值	描述
資料表	否	資料表		要使用的資料表變數。 此變數必須先前已由產生資料表變數的動作指定
搜尋模式	無法使用	尋找，尋找並取代	尋找	要搜尋的模式 (「尋找」或「尋找及取代」)
所有相符的項目	無法使用	布林值	確判為真	指定是要在找到的所有相符儲存格中，或是僅在第一個相符儲存格中尋找或取代文字
要尋找的文字	否	文字值		要在資料表中尋找的文字
使用規則運算式尋找	無法使用	布林值	誤判為真	指定是否使用規則運算式比對儲存格內容與要尋找的文字
相符案例	無法使用	布林值	誤判為真	指定是否搜尋區分大小寫的資料
與整個儲存格內容相符	無法使用	布林值	誤判為真	指定是否搜尋僅包含指定文字的儲存格
要取代的文字	否	文字值		用於取代相符儲存格的文字
搜尋依據	無法使用	所有位置，在資料行	所有位置	搜尋文字的順序 (所有位置，或在資料行中)
資料行索引或名稱	否	文字值		資料行標題或索引值

變數已產生

引數	類型​	描述
DataTableMatches	資料表	包含要比對之列和欄索引的資料表

例外狀況

例外狀況	描述
提供的規則運算式無效	指出提供的規則運算式無效
資料行名稱不存在	表示提供的資料行名稱不存在
資料行索引超出範圍	表示提供的資料行索引超出範圍
不相容類型錯誤	表示提供了不相容類型的輸入參數

將資料行插入資料表

在特定索引值結尾或之前插入資料行。

輸入參數

引數	選用	接受	預設值	描述
資料表	否	資料表		要使用的資料表變數。 此變數必須由生成資料表變數的操作指定。
進入位置	無法使用	資料表結尾，資料行索引之前	資料表結尾	指定要將新資料行插入至資料表結尾還是指定的資料行索引之前。
資料行名稱	否	文字值		指定新資料行的標題。
資料行索引	否	數值		指定為進入位置參數選擇先前資料行索引選項時所使用的列索引值。

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	描述
資料行索引超出範圍	表示提供的資料行索引超出範圍。
重複的資料行名稱	指示已存在使用該名稱的資料行。

從資料表刪除資料行

刪除指定資料行索引或資料行名稱的資料表資料行。

輸入參數

引數	選用	接受	預設值	描述
資料表	否	資料表		要使用的資料表變數。 此變數必須由生成資料表變數的操作指定。
指定包含以下內容的資料行:	無法使用	名稱，索引	姓名	指定要依名稱還是索引來尋找資料行。
資料行名稱	否	文字值		應刪除的資料行的名稱。
資料行索引	否	數值		應刪除的資料行索引。 資料行索引從 0 開始。

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	描述
資料行名稱不存在	表示提供的資料行名稱不存在
資料行索引超出範圍	表示提供的資料行索引超出範圍

從資料表刪除空白資料列

從資料表刪除儲存格全部為空白的資料列。

輸入參數

引數	選用	接受	預設值	描述
資料表	否	資料表		要使用的資料表變數。 此變數必須先前已由產生資料表變數的動作指定

變數已產生

此動作不會產生任何變數。

例外狀況

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

從資料表刪除重複的資料列

如果每資料列中的值具有相同的資料類型，則從資料表中刪除所有重複的資料行。

輸入參數

引數	選用	接受	預設值	描述
資料資料表	否	資料表		要使用的資料表變數。 必須通過生成數據表變數的操作來定義指定的變數。

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	描述
資料行儲存格中的類型不相符	指示單一資料行中有二個或多個值的資料類型不同

清除資料表

刪除資料表的所有資料列，保持資料表標題不受影響。

輸入參數

引數	選用	接受	預設值	描述
資料資料表	否	資料表		要使用的資料表變數。 必須通過生成數據表變數的操作來定義指定的變數。

變數已產生

此動作不會產生任何變數。

例外狀況

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

排序運算列表

如果資料表的所有值都具有相同的資料類型，則按指定列對資料表行進行升序或降序排序。

輸入參數

引數	選用	接受	預設值	描述
資料資料表	否	資料表		要使用的資料表變數。 必須通過生成數據表變數的操作來定義指定的變數。
指定包含以下內容的資料行:	無法使用	名稱，索引	姓名	指定要依名稱還是索引來尋找資料行。
資料行名稱	否	文字值		應排序的列的名稱。
資料行索引	否	數值		應排序的列的索引。 資料行索引從 0 開始。
順序	無法使用	遞增、遞減	遞增	對資料表進行排序的順序。

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	描述
資料行名稱不存在	表示提供的資料行名稱不存在
資料行索引超出範圍	表示提供的資料行索引超出範圍
資料行儲存格中的類型不相符	指示單一資料行中有二個或多個值的資料類型不同

篩選運算列表

根據已執行的規則篩選運算列表列。

在協助您建立所需篩選器的操作內建精靈中，您可以將多個篩選器套用至按名稱或索引定義的不同欄位。 每個篩選器都由它所針對的特定列、選定的運算符以及分配給它的值組成。

此外，多個篩選器透過 AND 和/或 OR 規則一起套用。 AND 規則首先在產生的篩選器表達式中解析，然後是 OR 規則。

輸入參數

引數	選用	接受	預設值	描述
資料資料表	否	資料表		要使用的資料表變數。 必須通過生成數據表變數的操作來定義指定的變數。
要套用的篩選條件	否	使用者定義的篩選規則	無法使用	套用至定義欄的篩選規則

變數已產生

引數	類型​	描述
篩選數據表	資料表	套用篩選條件後產生的運算列表

例外狀況

例外狀況	描述
資料行名稱不存在	表示提供的資料行名稱不存在
資料行索引超出範圍	表示提供的資料行索引超出範圍
資料行儲存格中的類型不相符	指示單一資料行中有二個或多個值的資料類型不同

合併運算列表

將兩個資料表合併在一起，指定列數不同時的合併行為。

輸入參數

引數	選用	接受	預設值	描述
第一個運算列表	否	資料表		要使用的第一個數據表變數。 這也是操作生成的變數，用於保存合併的數據表
第二個運算列表	否	資料表		合併到第一個數據表中的第二個數據表
合併模式	無法使用	新增額外資料行、忽略額外資料行、額外資料行出錯	新增額外欄	當表的列數不同時應用的合併行為

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	描述
缺少結構描述	指示數據表的列數不同

聯結運算列表

根據指定的聯結規則來聯結兩個運算列表。

在説明您建立所需聯接規則的操作內置精靈中，您可以通過相應地指定第一個和第二個數據表中的列以及它們之間應用的比較運算符來設置多個規則。

輸入參數

引數	選用	接受	預設值	描述
第一個運算列表	否	資料表		要使用的第一個數據表變數。 必須通過生成數據表變數的操作來定義指定的變數。
第二個運算列表	否	資料表		要使用的第二個數據表變數。 必須通過生成數據表變數的操作來定義指定的變數。
聯結作業	無法使用	內部、左邊、全部	內部	用於聯接兩個表的連接操作
聯結規則	否	使用者定義的加入規則	無法使用	定義用於連接兩個數據表的列和操作

變數已產生

引數	類型​	描述
聯接數據表	資料表	執行聯結作業後產生的運算列表

例外狀況

例外狀況	描述
資料行名稱不存在	表示提供的資料行名稱不存在
資料行索引超出範圍	表示提供的資料行索引超出範圍

從 CSV 文字變數讀取

從 CSV 文字產生運算列表。

輸入參數

引數	選用	接受	預設值	描述
CSV 文字	否	文字值		要讀取的 CSV 文字變數。
Trim fields	無法使用	布林值	確判為真	指定是否自動修剪所擷取儲存格的前置空格與結尾空白。
First line contains column names	無法使用	布林值	誤判為真	指定是否要使用 CSV 文字的第一列來設定結果資料表的欄名稱。 啟用此選項，可避免將名稱當做資料讀入資料表中。 後續動作可以使用欄名稱 (而不是欄號) 來存取資料表所保存的資料。
將 CSV 欄位擷取為文字	無法使用	布林值	誤判為真	指定是將 CSV 文字欄位的內容純粹作為文字檢索還是作為最接近的匹配類型檢索。 例如，日期時間為日期，數字為數字。
Columns separator	無法使用	預先定義、自訂、固定欄寬	預先定義	指定是否使用預先定義的欄分隔符號、自訂的欄寬或固定欄寬。
分隔符號	無法使用	系統預設、逗號、分號、定位字元	系統預設	要剖析 CSV 文字的欄分隔符號。
Custom separator	否	文字值		用於剖析 CSV 文字的自訂欄分隔符號。
Fixed column widths	否	文字值		用於剖析 CSV 文字的固定欄寬。 使用逗號、空格、定位字元或分行符號來分隔寬度。

變數已產生

引數	類型​	描述
CSVTable	資料表	做為運算列表的 CSV 文字內容

例外狀況

例外狀況	描述
CSV 剖析失敗	指示解析 CSV 文字時出現問題

將運算列表轉換為文字

將運算列表轉換為 CSV 文字。

輸入參數

引數	選用	接受	預設值	描述
資料資料表	否	資料表		要使用的資料表變數。 必須通過生成數據表變數的操作來定義指定的變數。
Include column names	無法使用	布林值	誤判為真	指定是否應將指定變數的欄名稱設為 CSV 文字的第一列。
Use custom columns separator	無法使用	布林值	誤判為真	指定是使用自訂列分隔符號還是預先定義的列分隔符號。
分隔符號	無法使用	系統預設、逗號、分號、定位字元	系統預設	要在所指定 CSV 文字中使用的欄分隔符號。
Custom columns separator	否	文字值		要在指定的 CSV 文字中使用的自訂欄分隔符號。

變數已產生

引數	類型​	描述
CSVText	文字值	儲存 CSV 結果的變數

例外狀況

例外狀況	描述
轉換失敗	指示將運算列表轉換為 CSV 文字時發生問題

截斷數字

取得數值的整數或小數位數，或將值四捨五入進位至指定的小數點後數字。

輸入參數

引數	選用	接受	預設值	描述
Number to truncate	否	數值		包含要截斷/進位之數值的數字或變數
Operation	無法使用	取得整數部分、取得小數部分、四捨五入數字	取得整數部分	指定要對所指數字執行的作業
Decimal places	是	數值	3	要將指定數字四捨五入到的小數位數。 輸入 0 會傳回整數結果

變數已產生

引數	類型​	描述
TruncatedValue	數值	截斷或進位的數字

例外狀況

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

產生亂數

產生介於最小值與最大值之間的隨機亂數或隨機亂數清單。

輸入參數

引數	選用	接受	預設值	描述
Minimum value	是	數值	0	要產生的亂數下限
Maximum value	是	數值	100	要產生的亂數上限
Generate multiple numbers	無法使用	布林值	否	指定要產生單一亂數或亂數清單
How many numbers	是	數值	10	指定要產生多少個亂數
Allow duplicates	無法使用	布林值	否	指定要允許或避免相同數字在亂數清單中出現超過一次

變數已產生

引數	類型​	描述
RandomNumber	數值	新產生的亂數
RandomNumbers	數值清單	新產生的亂數清單

例外狀況

例外	描述
無法產生亂數	指出產生亂數時發生錯誤

清除清單

從清單中移除所有項目。

輸入參數

引數	選用	接受	預設值	描述
List to clear	否	一般值清單		要移除其元素的清單變數

變數已產生

此動作不會產生任何變數。

例外狀況

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

從清單中移除項目

從清單中移除一或多個項目。

輸入參數

引數	選用	接受	預設值	描述
Remove item by	無法使用	索引、數值	索引	指定要移除位於指定索引處的項目，或移除包含特定值的項目
At index	否	數值		要移除的項目索引編號
With value	否	一般值		要移除的項目
Remove all item occurrences	無法使用	布林值	否	移除符合所指定項目的所有出現位置
From list	否	一般值清單		包含要移除之項目的清單

變數已產生

此動作不會產生任何變數。

例外狀況

例外狀況	名描述
項目索引超出範圍	指出項目索引超出範圍
找不到項目	指出項目不存在清單中

排序清單

排序清單的項目。 使用相同類型的項目。

輸入參數

引數	選用	接受	預設值	描述
List to sort	否	一般值清單		包含要排序之清單的變數
Sort by list item's properties	無法使用	布林值	誤判為真	如果清單項目是物件 (例如檔案、資料夾等)，請啟用此選項以依特定屬性排序項目。 將此選項保持在停用狀態，可依預設屬性排序元素 (例如，檔案物件依其完整路徑進行排序)
First property to sort by	是	文字值		要據以排序清單之項目屬性的名稱。 請參閱說明檔案，以了解每個物件的屬性名稱
Sort	無法使用	遞增、遞減	遞增	指定要依第一個屬性的遞增或遞減順序進行排序
Second property to sort by	是	文字值		做為排序清單依據的第二個屬性名稱
Sort	無法使用	遞增、遞減	遞增	指定要依第二個屬性的遞增或遞減順序進行排序
Third property to sort by	是	文字值		做為排序清單依據的第三個屬性名稱
Sort	無法使用	遞增、遞減	遞增	指定要依第三個屬性的遞增或遞減順序進行排序

變數已產生

此動作不會產生任何變數。

例外狀況

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

隨機排列清單

建立隨機排列的清單。

輸入參數

引數	選用	接受	預設值	描述
List to shuffle	否	一般值清單		包含要隨機排列的清單的變數

變數已產生

此動作不會產生任何變數。

例外狀況

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

合併清單

將兩份清單合併成一份。

輸入參數

引數	選用	接受	預設值	描述
First list	否	一般值清單		要合併的第一份項目清單
Second list	否	一般值清單		要合併的第二份項目清單

變數已產生

引數	類型​	描述
OutputList	一般值清單	合併的清單。 初始清單不受影響

例外狀況

例外	描述
提供的清單為不相容的類型	指出提供的清單為不相容的類型

反轉清單

顛倒清單項目的順序。

輸入參數

引數	選用	接受	預設值	描述
List to reverse	否	一般值清單		要反轉其項目順序的清單

變數已產生

此動作不會產生任何變數。

例外狀況

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

從清單移除重複的項目

移除清單中多次出現的項目，使結果清單中的每個項目都不重複。

輸入參數

引數	選用	接受	預設值	描述
List to remove duplicate items from	否	一般值清單		要從中移除重複項目的清單變數
Ignore text case while searching for duplicate items	無法使用	布林值	否	指定搜尋重複的項目時，是否對文字執行不區分大小寫的比較 (僅適用於文字項目構成的清單)

變數已產生

此動作不會產生任何變數。

例外狀況

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

尋找共同的清單項目

比較兩份清單，並建立擁有兩個清單之共同項目的新清單。

輸入參數

引數	選用	接受	預設值	描述
First list	否	一般值清單		包含要比較的第一份清單的變數
Second list	否	一般值清單		包含要比較的第二份清單的變數

變數已產生

引數	類型​	描述
IntersectionList	一般值清單	共同項目的新清單

例外狀況

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

減去清單

比較兩份清單，並使用第一份清單中擁有但第二份清單中沒有的項目建立新清單。

輸入參數

引數	選用	接受	預設值	描述
First list	否	一般值清單		包含要比較的第一份清單的變數
Second list	否	一般值清單		包含要比較的第二份清單的變數

變數已產生

引數	類型​	描述
ListDifference	一般值清單	新的結果清單

例外狀況

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

將資料表欄擷取至清單中

將資料表欄的內容轉換成清單。

輸入參數

引數	選用	接受	預設值	描述
Data table	否	資料表		包含要轉換成清單之欄的資料表
Column name or index	否	文字值		欄名稱 (如有定義欄名稱)，或是要擷取之欄的索引編號

變數已產生

引數	類型​	描述
ColumnAsList	一般值清單	包含所指定資料表內容的新清單

例外狀況

例外	描述
欄名稱不存在	指出欄名稱不在資料表中
欄索引超出範圍	指出欄索引超出範圍

將 JSON 轉換為自訂物件

將 JSON 字串轉換為自訂物件。

輸入參數

引數	選用	接受	預設值	描述
JSON	否	文字值		JSON 文字，或先前所建立包含一項的變數，要將其轉換為自訂物件

變數已產生

引數	類型​	描述
JsonAsCustomObject	一般值	從提供的 JSON 轉換而來的自訂物件

例外狀況

例外狀況	描述
剖析 JSON 時發生錯誤	指出剖析指定的 JSON 時發生錯誤

將自訂物件轉換為 JSON

將自訂物件轉換為 JSON 字串。

輸入參數

引數	選用	接受	預設值	描述
Custom object	否	自訂物件		要轉換為 JSON 的自訂物件

變數已產生

引數	類型​	描述
CustomObjectAsJson	文字值	從提供的自訂物件轉換而來的 JSON

例外狀況

例外	描述
剖析自訂物件時發生錯誤	指出剖析自訂物件時發生錯誤

將項目新增至清單

將新項目附加至清單。

輸入參數

引數	選用	接受	預設值	描述
Add item	否	一般值		要新增至清單的值或變數。 提供值清單以附加多個元素。 如果清單有特定類型的元素，則新元素會轉換為該類型
Into list	否	一般值清單		要附加新元素的目標清單變數

變數已產生

引數	類型​	描述
NewList	一般值清單	新清單

例外狀況

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

建立新的清單

建立新的空白清單。

輸入參數

此動作不需要任何輸入。

變數已產生

引數	類型​	描述
清單	一般值清單	新清單

例外狀況

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

增加變數

依特定量增加變數的值。

輸入參數

引數	選用	接受	預設值	描述
Variable name	否	數值		要增加的數值
Increase by	否	數值		要用來增加變數的數值，或先前所建立包含一個數值的變數

變數已產生

此動作不會產生任何變數。

例外狀況

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

減少變數

依特定量，減少變數的值。

輸入參數

引數	選用	接受	預設值	描述
Variable name	否	數值		要用來減少變數的數值，或先前所建立包含一個數值的變數
Decrease by	否	數值		要用來減少變數的數值，或先前所建立包含一個數值的變數

變數已產生

此動作不會產生任何變數。

例外狀況

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

執行 Power Fx 運算式

執行提供的 Power Fx 運算式。

注意

此動作僅適用於已啟用 Power Fx 的桌面流程 (預覽版)。

輸入參數

引數	選用	接受	預設值	描述
運算式	否	*		要執行的 Power Fx 運算式

變數已產生

此動作不會產生任何變數。

例外狀況

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

設定變數

設定新的或現有變數的值、建立新變數，或覆寫先前建立的變數。

輸入參數

引數	選用	接受	預設值	描述
目標	否	*		要指派給變數的值

變數已產生

引數	類型​	描述:
NewVar	*	要設定之變數的名稱

注意

變數名稱必須以字母或底線 (_) 開頭。 在第一個字元之後，變數名稱可以包含字母、底線和數字 (0-9)。 名稱不區分大小寫，表示 myVar、myvar 和 MYVAR 會視為相同的變數。 以下保留關鍵字不能用作變數名稱：if、then、else、switch、case、default、loop、from、to、step、foreach、in、while、next、exit、label、goto、call、output、function、block、end、error、wait、for、set、main、and、or、xor、not、true、false、yes、no、disable、on、repeat、times、throw、action、mod、global、input、import

例外狀況

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