當錄製腳本時,VuGen會攔截client端(瀏覽器)與server端(網站服務器)之間的對話,並且通通記錄下來,產生腳本。在VuGen的Recording Log中,您可以找到瀏覽器與服務器之間所有的對話,包含通訊內容、日期、時間、瀏覽器的請求、服務器的響應內容等等。腳本和Recording Log最大的差別在於,腳本只記錄了client端要對server端所說的話,而Recording Log則是完整紀錄二者的對話。
當執行腳本時,您可以把VuGen想象成是一個演員,它僞裝成瀏覽器,然後根據腳本,把當初真的瀏覽器所說過的話,再對網站伺服器重新說一遍,VuGen企圖騙過服務器,讓服務器以爲它就是當初的瀏覽器,然後把網站內容傳送給VuGen。
所以紀錄在腳本中要跟服務器所說的話,完全與當初錄製時所說的一樣,是寫死的(hard-coded)。這樣的作法在遇到有些比較聰明的服務器時,還是會失效。這時就需要透過「關聯(correlation)」的做法來讓VuGen可以再次成功地騙過服務器。
何謂關聯(correlation)?
所謂的關聯(correlation)就是把腳本中某些寫死的(hard-coded)數據,轉變成是擷取自服務器所送的、動態的、每次都不一樣的數據。
舉一個常見的例子,剛剛提到有些比較聰明的服務器,這些服務器在每個瀏覽器第一次跟它要數據時,都會在數據中夾帶一個唯一的辨識碼,接下來就會利用這個辨識碼來辨識跟它要數據的是不是同一個瀏覽器。一般稱這個辨識碼爲Session ID。對於每個新的交易,服務器都會產生新的Session ID給瀏覽器。這也就是爲什麼執行腳本會失敗的原因,因爲VuGen還是用舊的Session ID向服務器要數據,服務器會發現這個Session ID是失效的或是它根本不認識這個Session ID,當然就不會傳送正確的網頁數據給VuGen了。
下面的圖示說明了這樣的情形:
當錄製腳本時,瀏覽器送出網頁A的請求,服務器將網頁A的內容傳送給瀏覽器,並且夾帶了一個ID=123的數據,當瀏覽器再送出網頁B的情求時,這時就要用到ID=123的數據,服務器纔會認爲這是合法的請求,並且把網頁B的內容送回給瀏覽器。
在執行腳本時會發生什麼狀況?瀏覽器再送出網頁B的請求時,用的還是當初錄製的ID=123的數據,而不是用服務器新給的ID=456,整個腳本的執行就會失敗。
要對付這種服務器,我們必須想辦法找出這個Session ID到底是什麼、位於何處,然後把它擷取下來,放到某個參數中,並且取代掉腳本中有用到Session ID的部份,這樣就可以成功騙過服務器,正確地完成整個交易了。
哪些錯誤代表着我應該做關聯(correlation)?
假如腳本需要關聯(correlation),在還沒做之前是不會執行通過的,也就是說會有錯誤訊息發生。不過,很不幸地,並沒有任何特定的錯誤訊息是和關聯(correlation)有關係的。會出現什麼錯誤訊息,與系統實做的錯誤處理機制有關。錯誤訊息有可能會提醒您要重新登入,但是也有可能直接就顯示HTTP 404的錯誤訊息。
要如何做關聯(correlation)?
一、關聯(correlation)函數
關聯(correlation)會用到下列的函數:
web_reg_save_param:這是最新版,也是最常用來做關聯(correlation)的函數。
語法:
web_reg_save_param ( “Parameter Name” , < list of Attributes >, LAST );
web_create_html_param、web_create_html_param_ex:這二個函數主要是保留作爲向前兼容的目的的。建議使用 web_reg_save_param 函數。
詳細用法請參考使用手冊。在VuGen中點選【Help】>【Function reference】>【Contexts】>【Web and Wireless Vuser Functions】>【Correlation Functions】。
二、如何找出要關聯(correlation)數據
簡單的說,每一次執行時都會變動的值,就有可能需要做關聯(correlation)。
VuGen提供二種方式幫助您找出需要做關聯(correlation)的值:
自動關聯
手動關聯
1、自動關聯
VuGen內建自動關聯引擎(auto-correlation engine),可以自動找出需要關聯的值,並且自動使用關聯函數建立關聯。
自動關聯提供下列二種機制:
Rules Correlation:在錄製過程中VuGen會根據訂定的規則,實時自動找出要關聯的值。規則來源有兩種:
內建(Built-in Correlation):
VuGen已經針對常用的一些應用系統,如AribaBuyer、BlueMartini、BroadVision、InterStage、mySAP、NetDynamics、Oracle、PeopleSoft、Siebel、SilverJRunner等,內建關聯規則,這些應用系統可能會有一種以上的關聯規則。您可以在【Recording Options】>【Internet Protocol】>【Correlation】中啓用關聯規則,則當錄製這些應用系統的腳本時,VuGen會在腳本中自動建立關聯。
您也可以在【Recording Options】>【Internet Protocol】>【Correlation】檢視每個關聯規則的定義。
使用者自訂(User-defined Rules Correlation):
除了內建的關聯規則之外,使用者也可以自訂關聯規則。您可以在【Recording Options】>【Internet Protocol】>【Correlation】建立新的關聯規則。
Correlation Studio:有別於Rules Correlation,Correlation Studio則是在執行腳本後纔會建立關聯,也就是說當錄製完腳本後,腳本至少須被執行過一次,Correlation Studio纔會作用。Correlation Studio會嘗試找出錄製時與執行時,服務器響應內容的差異部分,藉以找出需要關聯的數據,並建立關聯。
Rule Correlation
請依照以下步驟使用Rule Correlation:
啓用auto-correlation
點選VuGen的【Tools】>【Recording Options】,開啓【Recording Options】對話窗口,選取【Internet Protocol】>【Correlation】,勾選【Enable correlation during recording】,以啓用自動關聯。
假如錄製的應用系統屬於內建關聯規則的系統,如AribaBuyer、BlueMartini、BroadVision、InterStage、mySAP、NetDynamics、Oracle、PeopleSoft、Siebel、SilverJRunner等,請勾選相對應的應用系統。
或者也可以針對錄製的應用系統加入新的關聯規則,此即爲使用者自訂的關聯規則。
設定當VuGen偵測到符合關聯規則的數據時,要如何處理:
【Issue a pop-up message and let me decide online】:跳出一個訊息對話窗口,詢問您是否要建立關聯。
【Perform correlation in sceipt】:直接自動建立關聯
錄製腳本
開始錄製腳本,在錄製過程中,當VuGen偵測到符合關聯規則的數據時,會依照設定建立關聯,您會在腳本中看到類似以下的腳本,此爲BroadVision應用系統建立關聯的例子,在腳本批註部分可以看到關聯前的數據爲何。
執行腳本驗證關聯是OK的。
Correlation Studio
當錄製的應用系統不屬於VuGen預設支持的應用系統時,Rule Correlation可能既無法發揮作用,這時可以利用Correlation Studio來做關聯。
Correlation Studio會嘗試找出錄製時與執行時,服務器響應內容的差異部分,藉以找出需要關聯的數據,並建立關聯。
使用Correlation Studio的步驟如下:
錄製腳本並執行
執行完畢後,VuGen會跳出下面的【Scan Action for Correlation】窗口,詢問您是否要掃描腳本並建立關聯,按下【Yes】按鈕。
掃描完後,可以在腳本下方的【Correlation Results】中看到掃描的結果。
檢查一下掃瞄的結果後,選擇要做關聯的數據,然後按下【Correlate】按鈕,一筆一筆做,或是按下【Correlate All】讓VuGen一次就對所有的數據建立關聯。
注意:由於Correlation Studio會找出所有有變動的數據,但是並不是所有的數據都需要做關聯,所以不建議您直接用【Correlate All】。
一般來說,您必須一直重複步驟1~4直到所有需要做關聯的數據都找出來爲止。因爲有時前面的關聯還沒做好之前,將無法執行到後面需要做關聯的部份。
有可能有些需要做關聯的動態數據,連Correlation Studio都無法偵測出來,這時您就需要自行做手動關聯了。
2、手動關聯
手動關聯的執行過程大致如下:
使用相同的業務流程與數據,錄製二份腳本
使用WinDiff工具協助找出需要關聯的數據
使用web_reg_save_param函數手動建立關聯
將腳本中有用到關聯的數據,以參數取代
接下來將詳細的說明如何執行每個步驟
2.1使用相同的業務流程與數據,錄製二份腳本
先錄製一份腳本並存檔。
依照相同的操作步驟與數據錄製第二份腳本並存盤。注意,所有的步驟和輸入的數據一定都要一樣,這樣才能找出由服務器端產生的動態數據。
有時候會遇到真的無法使用相同的輸入數據,那您也要記住您使用的輸入數據,到時才能判斷是您輸入的數據,還是變動的數據。
2.2使用WinDiff工具協助找出需要關聯的數據
在第二份腳本中,點選VuGen的【Tools】>【Compare with Vuser…】,並選擇第一份腳本。
接着WinDiff會開啓,同時顯示二份腳本,並顯示有差異的地方。WinDiff會以一整行黃色標示有差異的腳本,並且以紅色的字體顯示真正差異的文字。(假如沒看到紅色字體,請點選【Options】>【View】>【Show Inline Differences】)。
逐一檢視二份腳本中差異的部份,每一個差異都可能是需要做關聯的地方。選取差異的腳本,然後複製。
在複製時,有時並不需要取整行腳本,可能只會選取腳本中的一部分。
注意:請忽略lr_thik_time的差異部份,因爲lr_thik_time是用來模擬每個步驟之間使用者思考延遲的時間。
接着要在Recording Log(單一protocol)或是Generation Log(多重protocol)中找這個值。將鼠標光標點到Recording Log的第一行開頭,按下Ctrl+F,開啓【Find】窗口,貼上剛剛複製的腳本,找出在Recording Log第一次出現的位置。
結果會有二種:
在Recording Log中找不到要找的數據,這時請先確認您找對了腳本,畢竟現在開啓了二個幾乎一樣的腳本,很容易弄錯。
在Recording Log中找到了要找的數據,這時要確認數據是從服務器端傳送過來的。首先可以先檢查數據的標頭,從標頭的Receiving response可以知道數據是從服務器端傳送到client端的。假如此數據第一次出現是在Sending request中,則表示此數據是由client端產生,不需要做關聯,但是有可能需要做參數化(parameterized)。
您要找的標頭格式如下:
*** [tid=b9 Action1 2] Receiving response from host astra.merc-int.com:80 ( 25/11/2002 12:04:00 )
現在您已經找到錄製二次都不一樣,而且是由服務器所產生的動態數據了,而此數據極有可能需要做關聯。
2.3使用web_reg_save_param函數手動建立關聯
在找到是由服務器所產生的動態數據之後,接下來要做的就是找出適當的位置,使用web_reg_save_param函數,將這個動態數據擷取到某個參數中。
要在哪裏使用web_reg_save_param函數?
在之前的步驟,我們已經在Execution Log找到可能需要關聯的動態數據。在Execution Log中選取動態數據前的文字然後複製,我們將會利用這段文字,來幫助我們找出要關聯的動態數據。
不過在這之前我們要先找出使用web_reg_save_param函數的正確位置,所以我們要再重新執行一遍腳本,而且這次會開啓所有的Log。
在VuGen中點選【Vuser】>【Run-Time Settings】。
點選【General】>【Log】。
勾選【Enable logging】、【Always sends messages】、【Extended log】,以及【Extended log】下的所有選項。
按下【OK】就可以執行腳本了。
執行完腳本之後,在Execution Log中搜尋剛剛複製的字符串。找到字符串後,在字符串前面會有A.tion1.c(7),這個7就是到時候要插入web_reg_save_param函數的位置,也就是要插入到腳本的第7行。
在腳本的第7行前插入一行空白行,然後輸入
web_reg_save_param(“UserSession”,
“UserSession” 這個 “UserSession” 就是到時要使用的參數名稱,建議給個有意義的名字。
注意:到這裏整個web_reg_save_param函數還沒完成。
找出web_reg_save_param中要用到的邊界
web_reg_save_param函數主要是透過動態數據的前面和後面的固定字符串,來辨識要擷取的動態數據的,所以我們還需要找出動態數據的邊界字符串。
A、找出左邊界字符串
再回到Execution Log中,選取動態數據前的字符串並且複製它。
這時會有個問題,到底要選取多少字符串才足以唯一識別要找的動態數據呢?建議是越多越好,但是儘量不要包含到特殊字符。
在這邊我們選取「input type=hidden name=userSession value=」字符串。選好之後,還要再確認一次這段字符串真的是可以唯一識別的,所以我們在Execution Log中透過Ctrl+F的搜尋,找找看這段字符串是否可以找到要找的動態數據。假如找不到,web_reg_save_param函數還有個ORD參數可以使用,ORD參數可以設定出現在第幾次的字符串纔是要找的字符串。
將這個邊界字符串加到未完成的web_reg_save_param函數中:
web_reg_save_param(“UserSession”, “LB= input type=hidden name=userSession value=”,
B、找出右邊界字符串
接下來要找出動態數據的右邊界字符串,這個字符串就比較好找了,從動態數據的最後一個字符開始,通常就是我們要找的右邊界字符串了。
以這個例子來看,就是「>」,所以再把右邊界字符串加入,web_reg_save_param函數中,這時web_reg_save_param函數已經快完成了。最後再加上「LAST);」就完成整個web_reg_save_param函數了。
web_reg_save_param(“UserSession”, “LB= input type=hidden name=userSession value=”, “RB=>”, LAST);
2.4將腳本中有用到關聯的數據,以參數取代
當使用web_reg_save_param建立參數後,接下來就是用“UserSession”參數去取代腳本中寫死的(hard-coded)資料。
範例:
將“Name=userSession”, “Value=75893.0884568651DQADHfApHDHfcDtccpfAttcf”, ENDITEM,
換成“Name=userSession”, “Value={UserSession}”, ENDITEM,
到這裏您已經完成了一個關聯了,接下來就是執行腳本,是否能成功運行,假如還是有問題,就要檢查看看是否還需要再做另一個關聯。
關於 web_reg_save_param 函數
對於關聯(correlation)來說,web_reg_save_param是最重要的一個函數,其功能是在下載的網頁內容中,透過設定的邊界字符串,找出特定的數據並將其儲存在一個參數中,以供後續腳本使用。
接下來將針對web_reg_save_param做比較詳細的說明。
Service and registration type function
web_reg_save_param是一個Service function。service function主要是用來完成一些特殊的工作的,如關聯、設定proxy、提供認證信息等,當其作用時,不會對網頁的內容做任何的修改。
web_reg_save_param同時也是一個registration type function (只要函數名稱中包含_reg_的字眼,表示其爲registration type function)。registration type function意味着其真正作用的時機是在下一個action function完成時執行的。舉例來說,當某個web_url執行時所接收到的網頁內容中包含了要做關聯的動態數據,則必須將web_reg_save_param放在此web_url之前,則web_reg_save_param會在web_url執行完畢後,也就是網頁內容都下載完後,再執行web_reg_save_param找尋要做關聯的動態數據並建立參數。
所以要記住一點,要使用registration type function時,要注意其放置的位置必須在要作用的action function之前。
語法
int web_reg_save_param(const char *ParamName, <list of Attributes>, LAST);
參數說明
ParamName:存放動態數據的參數名稱
list of Attributes:其它屬性,包含 Notfound, LB, RB, RelFrameID, Search, ORD, SaveOffset, Convert, 以及 SaveLen。屬性值不分大小寫,例如 Search=all。以下將詳細說明每個屬性值的意義:
Notfound:指定當找不到要找的動態數據時該怎麼處置。
Notfound=error:當找不到動態數據時,發出一個錯誤訊息。假如沒設定此屬性,此爲LoadRunner的默認值。
Notfound=warning:當找不到動態數據時,不發出錯誤訊息,只發出警告,腳本也會繼續執行下去不會中斷。在對角本除錯時,可以使用此屬性值。
LB:動態數據的左邊界字符串。此屬性質是必須要有的,而且區分大小寫。
RB:動態數據的右邊界字符串。此屬性質是必須要有的,而且區分大小寫。
RelFrameID:相對於URL而言,欲搜尋的網頁的Frame。此屬性質可以是All或是數字,而且可有可無。
Search:搜尋的範圍。可以是Headers(只搜尋headers)、Body(只搜尋body部分,不搜尋header)、Noresource(只搜尋body部分,不搜尋header與resource)或是All(搜尋全部範圍,此爲默認值)。此屬性質可有可無。
ORD:指明從第幾次出現的左邊界開始纔是要擷取的數據。此屬性質可有可無,默認值是1。假如值爲All,則所有找到符合的數據會儲存在數組中。
SaveOffset:當找到符合的動態數據時,從第幾個字符開始纔開始儲存到參數中。此屬性質不可爲負數,其默認值爲0。
Convert:可能的值有二種:
HTML_TO_URL: 將HTML-encoded數據轉成URL-encoded數據格式
HTML_TO_TEXT:將HTML-encoded數據轉成純文字數據格式
SaveLen:從offect開始算起,到指定的長度內的字符串,才儲存到參數中。此參數可有可無,默認值是-1,表示儲存到結尾整個字符串。
範例
web_reg_save_param("A", "LB/ic=<a href=", "RB='>", "Ord=All", LAST);
nner會搜尋網頁中所有以 「<a href=」 開頭,且以 「’>」結束,當中包含的字符串,並且儲存在「A」參數中。
Tips and Tricks
以下提供一些關聯的常見問題:
如何打印出參數值?
lr_output_message這二個函數來做到。例如:
lr_output_message(“Value Captured = %s”, lr_eval_string(“{ParameterName}”));
lr_eval_string與lr_output_message函數的使用說明請參考LoadRunner Online Function Reference。
在腳本的data目錄下找不到路制時的快照(snapshot)
造成在腳本的data目錄下找不到路制時的快照(snapshot)的可能原因如下:
腳本是由VuGen 6.02或更早的版本所錄製的
匯入的Action不會包含快照(snapshot)的檔案
腳本是儲存在只讀的目錄下,早成VuGen無法儲存執行時擷取的快照(snapshot)
某些步驟並不會產生快照(snapshot),如瀏覽某個資源
快照(snapshot)功能被取消
【Tools】>【General options】>【Correlation】tab >【Save correlation information during replay】
開啓WinDiff時出現「File no longer available」的錯誤訊息
WinDiff這個工具有些限制,無法開啓包含空格符的目錄或是腳本,所以建議命名時不要使用空格符,並且儘可能將名稱取短一點。
錄製時突然跳出【Correlation warning】對話窗口
當你有勾選自動關聯的【Issue a popup message and let me decide online】選項,當VuGen發現有可能要做關聯的數據時,就會跳出【Correlation warning】的窗口,詢問你要做關聯(Correlation in script)還是要忽略(Ignore)。
另外你也可以勾選【Perform correlation in script】,讓VuGen自動作關聯,不會再跳出詢問窗口。
或是勾選【Disable correlation engine】,關閉自動關聯的功能。
如何手動啓動「Scan action for correlation」的功能
要手動啓動「Scan action for correlation」的功能,請先執行腳本一次後,點選【Vuser】>【Scan Action for Correlation】。
執行完腳本後並未出現【Scan Action for Correlation】窗口
要啓用【Scan Action for Correlation】功能,請點選【Tools】>【General options】>【Correlation】tab,勾選【Show Scan for correlation popup after replay of Vuser】選項。