變數動作
若要在桌面流程中手動建立變數，請部署設定變數動作。 此動作需要您提供新變數的名稱和值。
![[設定變數] 動作的螢幕擷取畫面。](media/variables/set-var-action-properties.png)
重要
保留關鍵字不能當作變數名稱。 有關保留關鍵字的完整清單，請前往桌面流程中的保留關鍵字。
若要增加或減少變數的數值，請分別使用增加變數和減少變數動作。
![[增加] 變數動作的螢幕擷取畫面。](media/variables/increase-var-action-properties.png)
大部分動作都會將其結果輸出至變數。 例如，建立新清單動作會產生空白清單。
同樣地，產生亂數動作會產生隨機的數值。 如果您在此動作中啟用產生多個數字，您將建立一個包含多個隨機數值的清單變數。
![[產生亂數] 動作的螢幕擷取畫面。](media/variables/generate-random-num-action-properties.png)
若要將項目新增至現有的清單，請部署新增項目至清單動作，並填入寫死的值或變數以定義要新增的項目。 同樣地，您可以使用 從清單移除項目動作從清單中移除項目。
注意
清單索引從 0 開始，表示清單中的第一個項目的索引一率為 0。 使用標記法 %ListName[0]% 來參照清單中的第一個項目，%ListName[1]% 為第二個，依此類推。
如果要建立資料表變數，請部署建立新資料表動作，並使用視覺化建立器指定其初始項目。
若要操縱資料表變數，請使用相應動作子群組的動作，例如在資料表中尋找或替換和更新資料表項目動作。
![[建立新資料表] 動作的螢幕擷取畫面。](media/variables/create-new-data-table-action-properties.png)
建立新資料表
建立新資料表變數。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 新增資料表 | 否 | 資料表 | 輸入資料表 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| 資料表 | 資料表 | 新資料表 |
例外狀況
此動作不包括任何例外狀況。
將資料列插入資料表
在特定索引值的結尾或之前插入列。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 資料表 | 否 | 資料表 | 要使用的資料表變數。 此變數必須先前已由產生資料表變數的動作指定 | |
| 進入位置 | 無法使用 | 資料表結尾，資料列索引之前 | 資料表結尾 | 指定是否要在資料表結尾或指定的列索引之前插入新列 |
| 資料列索引 | 否 | 數值 | 插入將列索引之前指定為進入位置參數時要使用的列索引值 | |
| 新值 | 否 | 清單，資料列 | 此參數接受清單或資料列變數，其中欄計數應與資料表中的欄計數相符 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 名描述 |
|---|---|
| 項目索引超出範圍 | 表示提供的項目索引超出範圍 |
| 輸入引數無效 | 表示輸入參數無效 |
| 不相容類型錯誤 | 表示提供了不相容類型的輸入參數 |
在資料表中尋找或取代
尋找及/或替換資料表值。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 資料表 | 否 | 資料表 | 要使用的資料表變數。 此變數必須先前已由產生資料表變數的動作指定 | |
| 搜尋模式 | 無法使用 | 尋找，尋找並取代 | 尋找 | 要搜尋的模式 (「尋找」或「尋找及取代」) |
| 所有相符的項目 | 無法使用 | 布林值 | 確判為真 | 指定是要在找到的所有相符儲存格中，或是僅在第一個相符儲存格中尋找或取代文字 |
| 要尋找的文字 | 否 | 文字值 | 要在資料表中尋找的文字 | |
| 使用規則運算式尋找 | 無法使用 | 布林值 | 誤判為真 | 指定是否使用規則運算式比對儲存格內容與要尋找的文字 |
| 相符案例 | 無法使用 | 布林值 | 誤判為真 | 指定是否搜尋區分大小寫的資料 |
| 與整個儲存格內容相符 | 無法使用 | 布林值 | 誤判為真 | 指定是否搜尋僅包含指定文字的儲存格 |
| 要取代的文字 | 否 | 文字值 | 用於取代相符儲存格的文字 | |
| 搜尋依據 | 無法使用 | 所有位置，在資料行 | 所有位置 | 搜尋文字的順序 (所有位置，或在資料行中) |
| 資料行索引或名稱 | 否 | 文字值 | 資料行標題或索引值 |
變數已產生
| 引數 | 類型 | 描述 |
|---|---|---|
| DataTableMatches | 資料表 | 包含要比對之列和欄索引的資料表 |
例外狀況
| 例外狀況 | 描述 |
|---|---|
| 提供的規則運算式無效 | 指出提供的規則運算式無效 |
| 資料行名稱不存在 | 表示提供的資料行名稱不存在 |
| 資料行索引超出範圍 | 表示提供的資料行索引超出範圍 |
| 不相容類型錯誤 | 表示提供了不相容類型的輸入參數 |
更新資料表項目
更新定義資料行上的資料表列項目。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 資料表 | 否 | 資料表 | 要使用的資料表變數。 此變數必須先前已由產生資料表變數的動作指定 | |
| 資料行 | 否 | 文字值 | 要更新之項目的資料行名稱或索引 | |
| 資料列 | 否 | 數值 | 要更新之項目的列索引 | |
| 新值 | 否 | 文字值 | 在指定的列索引和欄更新的新值 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 名描述 |
|---|---|
| 項目索引超出範圍 | 表示指定的資料表項目超出範圍 |
| 資料行名稱不存在 | 表示提供的資料行名稱不存在 |
| 資料行索引超出範圍 | 表示提供的資料行索引超出範圍 |
| 不相容類型錯誤 | 表示提供了不相容類型的輸入參數 |
從資料表刪除資料列
更新定義資料行上的資料表列項目。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 資料表 | 否 | 資料表 | 要使用的資料表變數。 此變數必須先前已由產生資料表變數的動作指定 | |
| 資料表索引 | 否 | 數值 | 資料表中應刪除的資料列索引 |
變數已產生
此動作不會產生任何變數。
例外狀況
| 例外狀況 | 名描述 |
|---|---|
| 項目索引超出範圍 | 表示指定的資料表項目超出範圍 |
截斷數字
取得數值的整數或小數位數，或將值四捨五入進位至指定的小數點後數字。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | 描述 |
|---|---|---|---|---|
| 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 的桌面流程 (預覽版)。
輸入參數
| 引數 | 選用 | 接受 | 預設值 | Description |
|---|---|---|---|---|
| 運算式 | 無 | * | 要執行的 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
例外狀況
此動作不包括任何例外狀況。