RPA 功能｜VLOOKUP 的好朋友：UiPath Lookup Data Table

在開始閱讀正文之前，也別忘了先追蹤我們的 臉書粉絲專頁 與 方格子帳號！

Lookup Data Table 功能介紹

這個功能和 Excel 中的 VLOOKUP、資料搜尋功能相似，當我們設定好範圍後，可讓用戶輸入一個值（可能是文字、數字等）之後，就能獲得其他相關欄位值的內容。

以圖一為舉例來說，先設定好 A1:B5 的搜尋範圍，接著我們輸入「Eddy」，便可以利用此一功能得到 Eddy 的年齡資訊。

UiPath 中也有另一個名稱相似的功能叫做「Lookup Range」，這個功能主要是可用以告訴我們變數欄位的位置，例如我們搜尋 Eddy，此一功能就會告訴我們這個值是在 A2 的位置上，而這與 Lookup Data Table 有根本上的不同。

如果還想學習更多 UiPath 功能、實作案例並了解最新自動化趨勢， 歡迎加入「零基礎快速學習 RPA－利用 UiPath 建構自動化機器人」線上課程！ 課程優惠只到 2024 年 2 月 5 日，快點擊連結立即了解：https://mastertalks.tw/products/rpa-uipath?ref=RPARPA

---

功能參數說明

點選 Lookup Data Table，便可看到如上圖二的 Activity 介面，必填的內容包括 Input 和 Output，以下也針對其 Properties 一一進行介紹：

• Input：需填入以下兩個資訊 a) DataTable：用來告訴 UiPath 要在哪個範圍之內搜尋資料，前面通常會配合 Read Range功能，並將其 Output 轉變為此處的 Input 資訊。 b) LookupValue：用來告訴 UiPath 要以哪個欄位資訊去搜尋，以前面的舉例來說，LookupValue 指的就是 Eddy。
• Lookup Column：搜尋欄，用來告訴 UiPath 希望用哪個數值「行」當作範圍去搜 LookupValue，以下有兩種方法表示，建議讀者兩者擇一即可。 a) Column Index：輸入你想要作為搜尋欄的索引（Index），假設是前面舉例的 Name，我們就可以輸入 0，格式為 Int32。 b) Column Name：輸入你想要作為搜尋欄的名字，需和 Excel 標題列格式一致，而字串形式要加上 '' ''，格式為 String。
• Target Column：目標欄，用來告訴 UiPath 希望用哪個數值「行」當作範圍來取值，以下有兩種方法表示，建議讀者兩者擇一即可。 a) Column Index：輸入你想要作為搜尋欄的索引（Index），假設是前面舉例的 Age，我們就可以輸入 1，格式為 Int32。 b) Column Name：輸入你想要作為目標欄的名字，同樣需和 Excel 標題列格式一致，而字串形式要加'' ''，格式為 String。
• Output：我們可以從此功能得到兩個 Output 資訊 a) CellValue：可以將搜尋到的儲存格內容變成 Output 輸出，以前面舉例來說，就是 25。 b) Rowindex：這個功能就是那個儲存格在的索引位置 (Index)，如果有勾 Add headers，那麼像上表的 Eddy 所在的 A 欄就是 0，因此便會回傳 0 這個數值到 Rowindex。

---

實作案例

我們同樣以前面所提的案例來進行實作，今天希望將 Name 當成搜尋值，得到對應的 Age 資料，接下來我們就用此例來練習 Lookup Data Table 功能：

Step1 如下圖四，首先我們先使用 Input Dialog 功能，讓流程一開始先跳出一個視窗，讓用戶可以填寫要用哪個名字進行搜尋。

如下圖五，我們便可看到我們在圖四輸入的文字內容已化為標題，使用者可在文字框中輸入 Eddy，作為等等要用的搜尋值（VarName）。

Step2 接著我們使用先前提及的Excel Application Scope、Excel Read Range功能，先指定 UiPath 要針對哪個 Excel 檔案進行操作，並讀取所需要的內容範圍，而在此例中，我們將指定其讀取「Sheet1」工作表的內容。

Step3 接著我們使用 Lookup Data Table 功能，先在 Input 填入 Step2 所指定的 Excel 範圍「VarDT」，以及我們在 Step1 設定的「VarName」變數。

在 Lookup Column 則是以 Excel 的 「Name」設定為搜尋欄，並將 Target Column 中的 Column Index 設為 1（也就是 Age 欄）設定為目標欄。

Step4 最後，我們可以使用 Message Box 功能來進行此一流程的測試，執行後就可以得到如下圖的結果。在這個 Message Box 中，我們主要是讓其輸出 Output 的 CellValue，也就是圖九中的「25」，來完成這次的範例練習。

---

常見誤區

• Excel 中原先的資料型態可能會影響此一功能之使用，甚至會出現「Error(Int32Converter cannot convert from System.Double.)」的字樣，此時可用 Generic Value 來做較通用的搭配，也歡迎參考連結說明
• 如果使用者希望於 Excel 中也顯示 Output 結果，我們則需要另外使用 Write Range 功能來填值。

---

結語與心得

RPAI 數位優化器認為 Lookup Data Table 功能的實用度高達五顆星！

一來是 Vlookup 功能本來就是我們使用 Excel 時常會使用的函數，二來我們可以透過此一功能來協助清理資料，將各種表單資訊串聯在一起。

希望此次分享能幫助到大家，這些功能雖然簡單，卻是我們創造自動化流程的每塊基石，因此透過理解這些功能，將能使我們的工作更為順暢與自動化，讓我們一起由簡單開始，成就不簡單！

如果你／妳喜歡這篇文章，歡迎點點愛心或留言，讓我們相互交流和成長！ 這次的分享到此告一段落，想了解更多 RPA + AI 與數位轉型的最新趨勢與觀點、RPA 軟體功能介紹及實務應用案例，也歡迎追蹤 RPAI 數位優化器的社群和我們交流互動，我們下次見！ 🚀 Instagram：RPAI 數位優化器 🚀 臉書粉絲專頁：RPAI 數位優化器 🚀 YouTube 頻道：RPAI 數位優化器

---

延伸學習資源

• Lookup Data Table (uipath.com)
• (30) How to Lookup Data Table in UiPath — Full tutorial — YouTube