本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 資料表
<a name="actions-data-tables"></a>

資料表動作可讓您使用資料表格式的結構化資料。這些動作可讓您在自動化中建立、轉換和輸出表格式資料。

## 排序資料表
<a name="sort-table"></a>

依資料欄排序資料表。用來以遞增或遞減順序組織您的資料。

**屬性：**
+ **資料表** （必要）：要排序的資料表變數 （例如 `my_table`)
+ **要排序的資料欄名稱** （必要）：要排序的資料欄名稱 （例如「總數量」)
+ **排序順序** （下拉式清單）：選擇「遞增」（最小先） 或「遞減」（最大先） - 預設：遞減
+ **已排序資料表** （輸出）：新已排序資料表的變數名稱

## 篩選條件表
<a name="filter-table"></a>

保持資料列符合條件。用來從較大的資料集擷取相關資料列。

**屬性：**
+ **資料表** （必要）：要篩選的資料表變數 （例如 `my_table`)
+ **Filter Expression** （必要）：使用資料欄名稱和運算子 (==、＞、＜、！=) 的布林運算式。結合條件與 & (AND) 或 \$1 (OR)。針對具有空格和文字值的資料欄名稱使用單引號 （例如 "'Team' == 'Sales' & 'Total amount' > 100")
+ **篩選資料表 **（輸出）：篩選資料表的變數名稱

範例篩選條件：

```
# Column 'amount' is greater than 25
"amount > 25"

# Column 'team' equals text 'Sales'
"team == 'Sales'"

# Multiple conditions
"amount > 25 & status == 'active'"

# Grouped conditions
"(amount > 25 & team == 'Sales') | (amount > 50 & team == 'Marketing')"

# Column 'title' contains text 'Director'
"title.str.contains('Director')"

# Column 'Customer No' equals a variable customer_id
"`Customer No` == " + str(customer_id)

# Column 'ProfitCenter' equals variable profitCenter
"`ProfitCenter` == '" + str(profitCenter) + "'"
```

## 查詢值
<a name="lookup-value"></a>

搜尋資料表中的值。用來查詢一個資料欄中的值，並從相同資料列中的另一個資料欄取得對應的值。

**屬性：**
+ **資料表** （必要）：要搜尋的資料表 （例如 `my_table`)
+ **要搜尋的資料欄名稱** （必要）：包含查詢值的資料欄 （例如 "Employee ID")
+ **要搜尋的值 **（必要）：要尋找的值 （例如 "12345")
+ **要輸出的資料欄名稱** （必要）：要從中擷取結果的資料欄 （例如 "Date of hire")
+ **儲存格值** （輸出）：儲存找到值的變數。如果找不到，則傳回第一個相符項目或空白。

## 新增資料欄
<a name="add-columns"></a>

在資料表中建立新資料欄。新增的資料欄會附加到現有資料表的結尾。

**屬性：**
+ **資料表** （必要）：要修改的資料表 （例如 `my_table`)
+ **要新增的資料欄名稱 **（必要）：新資料欄名稱陣列 （例如 【"Name"、"Address"】)
+ **預設值 **（選用）：新資料欄中所有儲存格的初始值 （例如 "N/A")
+ **更新資料表** （輸出）：修改資料表的變數名稱

## 移除資料欄
<a name="remove-columns"></a>

從資料表中刪除資料欄。輸出包含所有剩餘資料欄的資料表。

**屬性：**
+ **資料表** （必要）：要修改的資料表 （例如 `my_table`)
+ **要移除的資料欄** （必要）：資料欄名稱或索引號碼的陣列。索引號碼從 0 開始，可以是特定數字 （例如 【0，1，2】) 或範圍 （例如 range(0，2))
+ **更新資料表** （輸出）：修改資料表的變數名稱

## 保留資料欄
<a name="keep-columns"></a>

從資料表捨棄額外的資料欄。用來選取您要保留的特定資料欄子集。

**屬性：**
+ **資料表** （必要）：要修改的資料表 （例如 `my_table`)
+ **要保留的資料欄** （必要）：要保留的資料欄名稱陣列 （例如 【"Name"、"Address"】)
+ **更新資料表** （輸出）：修改資料表的變數名稱

## 新增資料列
<a name="add-new-row"></a>

將新資料列附加至資料表。您可以使用特定值或空白資料列建立新資料列，並新增至資料表底部。

**屬性：**
+ **資料表** （必要）：要修改的資料表 （例如 `my_table`)
+ **資料列值** （選用）：新資料列的值陣列，從第一欄開始 （例如 【"Q1"、"Sales"、100】)。如果為空，請新增空白資料列。缺少值會導致空白儲存格。
+ **更新資料表** （輸出）：修改資料表的變數名稱

## 移除資料列
<a name="remove-rows"></a>

從資料表刪除資料列。輸出包含所有剩餘資料列的資料表。

**屬性：**
+ **資料表** （必要）：要修改的資料表 （例如 `my_table`)
+ **要移除的資料列** （必要）：資料列位置陣列 （以 0 為基礎的索引）。索引號碼從 0 開始，可以是特定數字 （例如 【0，1，2】) 或範圍 （例如 range(0，2))
+ **更新資料表** （輸出）：修改資料表的變數名稱

## 移除重複項目
<a name="remove-duplicates"></a>

刪除重複的資料列。用於根據特定資料欄建立唯一資料列的資料集。

**屬性：**
+ **資料表** （必要）：要清除的資料表 （例如 `my_table`)
+ **要檢查的資料欄** （選用）：用於重複偵測的資料欄名稱陣列 （例如 【"Name"、"Address"】)。如果為空， 會檢查整個資料列的唯一性。透過指定資料欄的組合值來識別重複項目。
+ **要保留的重複資料列 **（下拉式清單）：選擇要保留的「第一個」或「最後一個」出現 （預設值：第一個）
+ **更新資料表** （輸出）：修改資料表的變數名稱

## 附加資料表
<a name="append-tables"></a>

結合兩個資料表的資料列。用來將資料從一個資料表新增至另一個資料表。

**屬性：**
+ **要附加至 的資料表** （必要）：接收其他資料列的主資料表 （例如 `main_table`)
+ **要新增的資料表 **（必要）：提供要附加資料列的來源資料表 （例如 `new_data`)
+ **處理資料欄差異 **（下拉式清單）：
  + 「新增」：保留兩個資料表中的所有資料欄
  + "Ignore"：只保留與主資料表相符的資料欄
  + "Error"：需要完全符合資料欄
+ **合併資料表** （輸出）：合併資料表的變數名稱

## 建立新資料表
<a name="create-new-table"></a>

建立空白資料表。用來設定具有必要資料欄的資料表，以在後續步驟中將資料列新增至 。新資料表沒有資料列。

**屬性：**
+ **資料欄名稱 **（選用）：新資料表的資料欄名稱陣列 （例如 【"Name"、"Address"】)。如果為空， 會建立沒有資料欄的資料表。
+ **新資料表** （輸出）：新建立資料表的變數名稱

## 將文字轉換為資料表
<a name="convert-text-to-table"></a>

將分隔文字轉換為結構化資料表。

**屬性：**
+ **要轉換的文字** （必要）：包含資料表資料的分隔文字 （例如 "Year，Qty 2001，100")
+ **值分隔符號** （選用）：字元分隔資料列中的值 （預設值："，")
+ **換行分隔符號** （選用）：字元分隔列 （預設值：" ")
+ **具有標頭 **（核取方塊）：第一列是否包含資料欄名稱。若為 True， 會使用第一列做為標頭；若為 False，則 會產生預設名稱 (Column0、Column1 等）。
+ **新資料表** （輸出）：新建立資料表的變數名稱

## 將資料表轉換為 HTML
<a name="convert-table-to-html"></a>

建立 HTML 格式的資料表。用來將資料表輸出為文件、電子郵件等的格式化文字。

**屬性：**
+ **資料表** （必要）：要格式化的資料表 （例如 `my_table`)
+ **格式化資料表文字** （輸出）：儲存 HTML 格式文字的變數

## 範例
<a name="data-tables-examples"></a>

**循環瀏覽資料表中的資料列**

若要循環瀏覽資料表中的資料列，請使用「處理流程」下的「循環瀏覽項目」動作。提供資料表變數做為「項目集合」的輸入。將「項目參考」更新為 ，`row`因為每個項目代表資料表的單一資料列。

**使用或更新資料列中的儲存格值**

循環資料表中的資料列時，請使用 的語法參考個別儲存格值，`row["column name"]`其中資料欄名稱會取代為特定儲存格的資料欄名稱。

若要更新資料列中儲存格的值，請使用「一般」下的「儲存值」動作。「要儲存的值」是您要用來更新儲存格的值。「可變名稱」是使用與上述相同語法的儲存格參考`row["column name"]`。