閱讀及檢閱 Automation Anywhere 文件

Automation Anywhere Automation 360

關閉內容

內容

開啟內容

移轉的變數對應

  • 已更新:2021/10/12
    • Automation 360 v.x
    • 移轉
    • RPA 工作區

移轉的變數對應

移轉時,部分變數會直接從之前的產品版本對應至 Automation 360,而部分變數的行為則不同或包含組態變更。

使用者定義的變數

Automation 360 中,定義於bots的所有變數在移轉期間都會建立為當做輸入使用當做輸出使用類型,以在上層bots和下層bots之間交換值。

如果是在 Enterprise 11 中的上層bot和下層bot之間對應變數,且部分對應變數無法在上層bot或下層bot中使用,移轉程序就會移除這些變數。移轉程序會移除與上層bots一起移轉的下層bots,以及已移轉的下層bots這類變數。

檢閱下列使用者定義的變數如何移轉。

陣列

本節說明 [陣列] 變數如何移轉至 Automation 360。在某些情況下,您可能必須在移轉之前或之後執行一些動作或確認某些項目。

子類型 [值]
具有此子類型的變數將移轉至 [表格],而所有欄值均為 [字串]。
子類型 [讀取自文字檔案]
具有此子類型的變數將移轉至 [表格],而所有欄值均為 [字串]。

以下動作新增為移轉的一部份,用以設定變數中的資料:

Automation 360 動作 函數
[CSV/TXT] > [開啟] 開啟要讀取的檔案。
[CSV/TXT] > [讀取] 傳回 [表格] 變數中的值。
[CSV/TXT] > [關閉] 關閉檔案。
子類型 [讀取自資料庫]
具有此子類型的變數將移轉至 [表格] 套件,而所有欄值均為 [字串]。

以下動作新增為移轉的一部份,用以設定變數中的資料:

Automation 360 動作 函數
[資料庫] > [連線] 使用相應的連線字串新增 [連線] 動作。
[資料庫] > [輸出至資料表] 新增 [輸出至資料表] 動作,用於將結果傳回資料表變數中。
[資料庫] > [中斷連線] 新增 [中斷連線] 動作以中斷資料庫連線。

另請參閱:Databasepackage

子類型 [讀取自 Excel/CSV 檔案]
具有此子類型的變數將移轉至 [表格],而所有欄值均為 [字串]。

以下動作新增為移轉的一部份,用以設定變數中的資料:

Automation 360 動作 函數
[進階 Excel] > [開啟] 開啟要讀取的檔案。
[進階 Excel] > [取得多個儲存格] 如果變數宣告中已選擇 [所有儲存格] 或 [範圍] 選項,則傳回 [表格] 變數值。
[進階 Excel] > [立即讀取] 如果變數宣告中已選擇 [整列] 選項,則傳回 [表格] 變數值。
[進階 Excel] > [讀取欄] 如果變數宣告中已選擇 [整欄] 選項,則傳回 [表格] 變數。

此外,[指派清單至清單資料表] 套件用於將傳回值儲存至變數。

[進階 Excel] > [關閉] 關閉檔案。
Action required:Automation 360 中,空白表格變數會傳回執行階段錯誤。如果您移轉的bot包含一個空白表格變數,您必須在 Automation 360 中解決此問題。
陣列變數:DLL 函數接受的輸入類型
當系統將陣列變數從 Enterprise 11 bot傳遞給不同類型的 DLL 函數時,DLL 函數接受以下項目作為輸入類型:
  • UInt16[]、Int16[]、Int32[]、Int64[]、Int[]、Char[]、Single[]、Decimal[]、Float[]、Double[]、Boolean[]、bool[]、Byte[]、String[] 和 Datetime[]
  • UInt16、Int16、Int32、Int64、Int、Char、Single、Decimal、Float、Double、Boolean、bool、Byte、String 和 Datetime
  • List<UInt16>、List<Int16>、List<Int32>、List<Int64>、List<Int>、List<Char>、List<Single>、List<Decimal>、List<Float>、List<Double>、List<Boolean>、List<bool>、List<Byte>、List<String>、List<Date-Time>
  • UInt16[,]、Int16[,]、Int32[,]、Int64[,]、Int[,]、Char[,]、Single[,]、Decimal[,]、Float[,]、Double[,]、Boolean[,]、bool[,]、Byte[,]、String[,] 和 Datetime[,]
更多資訊
您可以移轉包含陣列變數的 Enterprise 10Enterprise 11 bots

以下是一些關鍵的行為差異:

  • Enterprise 10Enterprise 11 中,索引位置的開頭為 1,而在 Automation 360 中,索引位置的開頭為 0。例如,$arrayVariable(1,1)$ 變成 $arrayVariable[0][0]$
  • 如果陣列有 10 列/欄,且有一個迴圈執行 10 次以上,則 Enterprise 10/Enterprise 11 會傳回帶有索引位置的陣列變數的名稱。
  • Enterprise 11 中,如果您在任何命令 (例如 $array(field1),其中 field1 不是變數) 中將常數字串值傳遞給陣列指數,則按原來的方式使用該值 (例如,$array(field1))。但是,將bot移轉到 Automation 360 後,如果命令具有非變數值,則會出現編譯時間錯誤。
Action required: 如果使用無效索引存取 Enterprise 11 中的任何陣列,請務必在移轉之前或之後解決bot錯誤。
字典

本節說明如何將 [字典] 變數移轉至 Automation 360。在某些情況下,您可能必須在移轉之前或之後執行一些動作或確認某些項目。

子類型 [值]
系統將這些變數移轉至 Automation 360 中具有 [字串] 子類型的 [字典] 類型。
子類型 [讀取自 CSV 檔案]
移轉程序會新增使用 [CSV/Text] 套件讀取 CSV 檔案的動作,並將資料儲存在表格變數中。此程序還會新增對 [表格] 變數執行廻圈的動作,並使用 [字典] 套件的 [放置] 動作在 [字典] 變數中新增鍵和值。
字典變數:DLL 函數接受的輸入類型
當系統將字典變數從 Enterprise 11 bot傳遞給不同類型的 DLL 函數時,DLL 函數接受以下項目作為輸入類型:UInt16、Int16、Int32、Int64、Int、Char、Single、Decimal、Float、Double、Boolean、bool、Byte、String 和 Datetime。
更多資訊
您可以移轉包含字典變數的 Enterprise 10Enterprise 11 bots

以下表格說明一些鍵行為差異以及這些鍵在 Automation 360 中的運作方式:

Enterprise 10Enterprise 11 行為 Automation 360 行為
Enterprise 10Enterprise 11 中,字典索引鍵不區分大小寫。 Automation 360 中,字典索引鍵需區分大小寫。

為了維持bot執行復原力,移轉程序將所有字典索引鍵轉換為小寫值。若有變數作為字典索引鍵使用,則使用字串運算式 [小寫] 來取得小寫的鍵名稱。

清單

本節說明 [清單] 如何移轉至 Automation 360。在某些情況下,您可能必須在移轉之前或之後執行一些動作或確認某些項目。

子類型 [值]
這些變數被移轉至具有子類型 [字串] 的 [清單]。
子類型 [陣列]
這些變數被移轉至具有子類型 [字串] 的 [清單]。
子類型 [讀取自文字檔案]
呼叫透過讀取檔案宣告的變數時,會在要移轉的動作上方新增 [舊版自動化] 套件的 [從文字檔案匯入清單] 動作。
宣告為 [設為隨機]
[清單] 變數可以在 Enterprise 10Enterprise 11 中宣告為設為隨機,以從清單中傳回一個隨機項目。移轉程序會在 [清單] 套件中新增新的 [大小] 動作來取得清單大小,並且在 [數字] 套件中新增 [指派隨機數字] 動作來尋找隨機位置並使用它來取得隨機清單項目。
Action required:Automation 360 中,在廻圈外使用的空白清單變數會傳回執行階段錯誤。如果您移轉的bot符合此條件,則您必須在 Automation 360 環境中解決此問題。
更多資訊
  • Enterprise 10Enterprise 11 中,無需指定任何索引即可存取 [清單]。在 Automation 360 中,您必須指定相應的索引以從清單中擷取特定值。

    範例:[清單] 變數可透過索引存取,方法如下:

    $listVariable[0]$

    在此,0 代表清單中的第一個值。

  • Enterprise 10Enterprise 11 中,索引位置從 1 開始,在 Automation 360 中則是從 0 開始。
  • Enterprise 11 行為:Enterprise 11 中,當使用具有固定索引的清單時,系統會傳回清單的第一個索引中可用的值。

    範例:例如,假設您有一個值為 1、2、3 和 4 的清單,而且您使用 $IntList(3)$ 來擷取清單的第三個索引位置中的值。系統會傳回清單的第一個索引位置中可用的值 (1),而不是指定的索引位置 (3)。

    Automation 360 行為:Automation 360 中,系統會傳回指定索引位置可用的值 (至於上面的範例,它會傳回 3)。

    已移轉bots的行為:使用清單中此類具有固定索引之運算式並移轉至 Automation 360Enterprise 11 bots會傳回指定索引位置中可用的值。

  • 如果清單有 10 個項目,且有一個迴圈執行 10 次以上,則 Enterprise 10Enterprise 11 會在第 10 次迭代後傳回清單的第一個值。
清單變數:DLL 函數接受的輸入類型
當系統將清單變數從 Enterprise 11 bot傳遞給不同類型的 DLL 函數時,DLL 函數接受以下項目作為輸入類型:
  • UInt16[]、Int16[]、Int32[]、Int64[]、Int[]、Char[]、Single[]、Decimal[]、Float[]、Double[]、Boolean[]、bool[]、Byte[]、String[] 和 Datetime[]
  • UInt16、Int16、Int32、Int64、Int、Char、Single、Decimal、Float、Double、Boolean、bool、Byte、String 和 Datetime
  • List<UInt16>、List<Int16>、List<Int32>、List<Int64>、List<Int>、List<Char>、List<Single>、List<Decimal>、List<Float>、List<Double>、List<Boolean>、List<bool>、List<Byte>、List<String>、List<Date-Time>
  • UInt16[,]、Int16[,]、Int32[,]、Int64[,]、Int[,]、Char[,]、Single[,]、Decimal[,]、Float[,]、Double[,]、Boolean[,]、bool[,]、Byte[,]、String[,] 和 Datetime[,]

    另請參閱:List package

隨機

本節說明 [隨機] 變數如何移轉至 Automation 360。在某些情況下,您可能必須在移轉之前或之後執行一些動作或確認某些項目。

子類型 [隨機字串]
當存在 [字串] 子類型的 [隨機] 變數時,移轉程序會新增 [字串] 套件的 [產生隨機字串] 動作,以在 [If] 條件之上產生一個隨機字串,並將值指派給在 Automation 360 中相應的移轉變數
子類型 [隨機數字]
當存在 [數字] 子類型的 [隨機] 變數時,移轉程序會新增 [數字] 套件的 [指派隨機數字] 動作,以在 [If] 條件之上產生一個隨機字串,並將值指派給在 Automation 360 中相應的移轉變數。

本節說明如何將 [] 移轉至 Automation 360。在某些情況下,您可能必須在移轉之前或之後執行一些動作或確認某些項目。

子類型 [值]
Automation 360 中,這些變數始終作為 [字串] 移轉,即使其中包含數字、布林值或日期時間值亦然。若有需要,在 Automation 360 中會使用運算式將字串轉換為其他類型。
子類型 [讀取自文字檔案]
為了在移轉期間維持bot執行的完整性,在呼叫透過讀取檔案宣告的變數時,系統會將 [字串] 套件的 [自文字檔案匯入字串] 動作新增至正在移轉的動作的正上方。
更多資訊
使用變數內值類型變數的Bots,可以移轉至 Automation 360。對於使用 Insert Keystrokes 命令中變數內變數的 Enterprise 11 botsStringpackage的 [評估值] action 將新增到所移轉的bot

另請參閱:Stringpackage | Numberpackage | 布爾值 package | 日期時間package

系統變數

在某些使用案例中,系統變數 (如錯誤行號、錯誤說明以及作業系統名稱) 會在 Automation 360 中傳回不同的值。在決策制定或字串操作中使用這些變數的Bots需在移轉後進行審查。

廻圈內使用的一些系統變數,在移轉後成為廻圈中的使用者定義變數。在某些情況下,使用者定義的變數可能需要在移轉的bot中進行一些設定。

部分系統變數在 Automation 360 中是以動作的形式移轉。這些動作會新增至使用這些變數的動作正上方。

如果在以下系統變數的索引位置定義了變數,您可能需要修正移轉的bots,因為移轉程序無法確定該變數是否包含索引或欄名稱。若不解決,bot可能會傳回在記錄中找不到金鑰執行階段錯誤。移轉程序將變數的值視為名稱;但若是索引,則您必須視情況進行變更。
  • $Filedata Column$
  • $Dataset Column$
  • $XML Data Node$
  • $Excel Column$

以下表格提供了有關各種系統變數及其如何移轉至 Automation 360 的資訊。有些變數是動作的一部分,有些變成動作,有些仍然被稱為系統變數,但有語法變化。

系統變數 系統變數如何移轉到 Automation 360
$Day$ Automation 360 中變成 $System:Day$
$Month$ Automation 360 中變成 $System:Month$
$Year$ Automation 360 中變成 $System:Year$
$Date$ Automation 360 中變成 $System:Date$

Enterprise 11Enterprise 10 bot中的變數設定的日期格式儲存在 [AADefaultDateFormat] 全域值中。

$Hour$ Automation 360 中變成 $System:Hour$
$Minute$ Automation 360 中變成 $System:Minute$
$Clipboard$ Automation 360 中變成 $System:Clipboard$
$Machine$ Automation 360 中變成 $System:Machine$