O que é correlação?
Correlação, como o nome sugere, é um mecanismo de definição de um relacionamento entre duas variáveis ou entidades. Um Dicionário o define como “relação estatística entre duas ou mais variáveis, de forma que mudanças sistemáticas na outra acompanham mudanças sistemáticas no valor de uma variável”.
Neste tutorial, aprenderemos sobre
- Por que precisamos de correlação?
- Correlação automática
- Correlação manual
- Compreendendo a função Web_reg_save_param
Por que precisamos de correlação?
Vamos entender a co-relação com o seguinte cenário.
Considere que você está gravando um script usando o LoadRunner.
Comunicação Cliente-Servidor
- Durante a gravação, o cliente envia uma solicitação ao servidor para iniciar uma sessão
- Um servidor recebe a solicitação e aloca um novo ID de sessão ABC
- O cliente armazena o ID de sessão ABC no script.
- O cliente inicia a sessão com ID ABC e envia uma solicitação a um servidor para permitir que ele grave
- O servidor reconhece o ID ABC e permite que o cliente grave o script
- Agora, vamos estudar a comunicação cliente-servidor durante a reprodução
- Durante o Replay, um cliente envia uma solicitação ao servidor para iniciar uma sessão
- Um servidor recebe a solicitação e aloca um novo ID de sessão XYZ
- Um cliente inicia a sessão com a ID ABC da sessão previamente gravada e envia uma solicitação ao servidor para permitir a gravação
- Um servidor não consegue identificar o ID ABC porque esperava o ID XYZ que alocou e a sessão falhou.
Precisamos de uma solução para capturar, analisar o valor dinâmico enviado em tempo de execução e retornar esse valor de volta ao servidor. Esta é a aparência da comunicação cliente-servidor com esta solução
- Durante o Replay, um cliente envia uma solicitação ao servidor para iniciar uma sessão
- Um servidor recebe a solicitação e aloca um novo ID de sessão ZZZ
- Um cliente analisa este novo id de sessão ZZZ a partir da solicitação.
- Um cliente envia uma solicitação para iniciar a sessão com id ZZZ
- Um servidor reconhece o ID ZZZ e permite que o cliente reproduza o script
Isso nada mais é do que correlação .
Clique aqui se o vídeo não estiver acessível
No caso do VUGen, a correlação é uma relação de ligação entre uma resposta e qualquer solicitação anterior.
Existem várias situações em que um pedido é baseado em uma resposta recebida anteriormente do servidor, como um ID de sessão, data / hora do servidor que é obtido do servidor. Esses valores são diferentes sempre que você executa um aplicativo ou grava um script. Obviamente, se a execução do script depende de um valor retornado pelo servidor, isso significa que você precisa encontrar um mecanismo onde possa “capturar” a resposta do servidor e anexar às solicitações que o servidor espera. Isso normalmente é chamado de Correlação no LoadRunner.
Em palavras simples, a solução usando Correlação é:
- Capture o valor de saída de uma etapa
- Use o valor capturado acima para servir como entrada para todas as etapas subsequentes
A correlação é classificada em 2 categorias no VUGen / LoadRunner:
- Correlação automática
- Correlação manual
Correlação Automática
LoadRunner provides a mechanism to easily perform correlation in automatic fashion.
VUGen will require you to run a recorded script at least two times so it can internally compare the varying values in the server response.
Automatic correlation can be classified into 3 categories:
- Auto-Detect Correlation
- Rule-Based Correlation
- Correlating All Statements
Rule Name | When to Use |
Auto-detect Correlation | Detect and correlate dynamic data for application servers supported by HP LoadRunner |
Rule-Based | Used when working with a non-supported application server for which the context is known. |
Correlate All | Helps correlate all dynamic data in blind fashion. |
Though Automatic Correlation seems simpler, it can be error-prone and works in not more than 5% of the cases. It is always advisable to use manual correlation.
To configure automatic correlation at the time of recording, perform below configuration in Record Time Setting after a script has been recorded.
Click on Record =>Recording Options (or click Ctrl +F7),
>
Below window will open:
Click on Correlation =>Configuration - below window will open.
Here, you need to mark as checked against all applications (ASPNET) etc., which are used in your subject application. On the right-hand side, you can see the rules which will detect possible candidates for correlation e.g. _VIEWSTATE. You can also add more applications or custom rules by clicking on New Rule button.
You can also click on RULES, you will see as below:
In order for Automatic Correlation to work, you need to ensure Rules Scan is marked as checked. If you click on automatically correlate values found, VUGen will not prompt you with the choice once a correlation candidate is found, instead, it will just correlate them.
We will understand API used for correlation later. However, it is advisable to use HTML comparison instead of text comparison.
Once you’ve selected any rules, click on OK button to close the windows.
Click on from menu and VUGen will regenerate script (without having to record) with new configurations. VUGen will automatically add a required piece of code to handle correlation. We will look at the sample in more detail in Manual Correlation.
Please note, if you perform correlation manually or use automatic correlation, the piece of code will contain exactly same syntax and function.
Steps to auto-correlate a script:
- Record a script
- Replay script
- Identify the values to be correlated
- Select the values and click the auto-correlate button
- Verify the script by running again. A successful run means successful correlation.
Tip:
- Correlation helps run your script with different values
- Correlation also reduces the size of your script
Manual Correlation
Manual correlation is about writing code directly into your script to cater for ever-changing values. We can split it into below steps:
- Determine the value to capture
- Find the right and left text boundaries of the value to capture (WEB)
- Find which occurrence of the text boundaries should be used
- Add a web_reg_save_param function to the script, above the piece of code which requests the page with the value to capture
- Add a parameter name, left boundary, the right boundary, and occurrence to the function
- Parameterize the dynamic value in the script every time it occurs
- Verify correct execution
web_reg_save_param (" OracleAppJSESSIONID3","LB/IC=JSESSIONID=","RB/IC=;","Ord=l","Search=headers","RelFrameId=l",LAST);web_reg_save_param("Siebel_Analytic_ViewState2","LB/IC=ViewState\" value=\"","RB/IC=\"","Ord=1","Search=Body","RelFrameId=l",LAST);
Manual correlation can be done by VUser Comparison. Steps in VUser Comparison method of Correlation can be split as below:
- Identify Dynamic values that need to be correlated
- Find Servers response containing the Dynamic value
- Capture the Dynamic value in a parameter
- Replace every occurrence of the Dynamic value with the parameter
- Verify Changes
Understanding Web_reg_save_param function
VUGen provides multiple functions or APIs to correlate candidates, including:
- web_reg_save_param
- web_reg_save_param_ex
- web_reg_save_param_regexp
- web_reg_save_param_xpath
While a brief introduction is being provided here, for a detailed understanding of functions and their parameters, open VUGen, write function (or use Steps Toolbox), move a cursor on the function and click F1 - get yourself acquainted with VUGen help and make a habit. You will have to deal with it a lot when working in the industry.
Here we go with the function details:
web_reg_save_param(Parameter Name , Left Boundary , Right Boundary )
List of Attributes
Convert: The possible values are:
HTML_TO_URL: convert HTML-encoded data to a URL-encoded data format
HTML_TO_TEXT: convert HTML-encoded data to plain text format; this attribute is optional.
Ignore Redirections: If "Ignore Redirections=Yes" is specified and the server response is redirection information (HTTP status code 300-303, 307), the response is not searched. Instead, after receiving a redirection response, the GET request is sent to the redirected location, and the search is performed on the response from that location.
This attribute is optional. The default is "Ignore Redirections=No".
LB: The left boundary of the parameter or the dynamic data. If you do not specify an LB value, it uses all of the characters from the beginning of the data as a boundary. Boundary parameters are case-sensitive. To further customize the search text, use one or more text flags. This attribute is required. See the Boundary Arguments section.
NOTFOUND: The handling option when a boundary is not found, and an empty string is generated.
"Not found=error", the default value, causes an error to be raised when a boundary is not found.
"Not found=warning" ("Not found=empty" in earlier versions), does not issue an error. If the boundary is not found, it sets the parameter count to 0 and continues executing the script. The "warning" option is ideal if you want to see if the string was found, but you do not want the script to fail.
Note: If Continue on Error is enabled for the script, then even when NOTFOUND is set to "error", the script continues when the boundary is not found, but an error message is written to the extended log file.
This attribute is optional as well.
ORD: Indicates the ordinal position or instance of the match. The default instance is 1. If you specify "All," it saves the parameter values in an array. This attribute is optional.
Note: The use of Instance instead of ORD is supported for backward compatibility, but deprecated.
RB: The right boundary of the parameter or the dynamic data. If you do not specify an RB value, it uses all of the characters until the end of the data as a boundary. Boundary parameters are case-sensitive. To further customize the search text, use one or more text flags. This attribute is required. See the Boundary Arguments section.
RelFrameID: The hierarchy level of the HTML page relative to the requested URL. The possible values are ALL or a number. Click RelFrameID Attribute for a detailed description. This attribute is optional.
Note: RelFrameID is not supported in GUI level scripts.
SaveLen : O comprimento de uma subcadeia do valor encontrado, a partir do deslocamento especificado, para salvar no parâmetro. Este atributo é opcional. O padrão é -1, indicando salvar até o final da string.
SaveOffset : O deslocamento de uma subcadeia do valor encontrado, para salvar no parâmetro. O valor do deslocamento não deve ser negativo. O padrão é 0. Este atributo é opcional.
Pesquisar: O escopo da pesquisa - onde pesquisar os dados delimitados. Os valores possíveis são Headers (pesquisar apenas os cabeçalhos), Body (pesquisar apenas dados do corpo, não cabeçalhos), Nenhum recurso (pesquisar apenas o corpo HTML, excluindo todos os cabeçalhos e recursos) ou ALL (pesquisar corpo, cabeçalhos e recursos) . O valor padrão é ALL. Este atributo é opcional, mas geralmente preferido.