Chat now with support
Chat with Support

Foglight Transaction Recorder 5.6.13 - Recorder User Guide

Overview of Foglight synthetic monitoring Use the Foglight Transaction Recorder Create and upload Foglight Transaction Recorder scripts View Foglight Transaction Recorder results Settings How Do I... Appendix: Best practices Appendix: Troubleshoot the Foglight Transaction Recorder Appendix: API for FTR Timer Usage

Script launching and closing of the application

After the script launches the application, add the code to close the application.

To add code to the application:
1
Capture and save an image of the window buttons. Be sure to set the image click point on the close button using the Select click spot toolbar button.
2
In the script editor, add instructions to click on the close button. In the example below, a delay was added so the application would be visible for a few seconds before being closed.
Option Strict On
Option Explicit On
Module Script
Sub StartScript()
InitScript
'Launch IE to Foglight login page
returnStatus = AppStart ("""C:\Program Files\Internet
Explorer\iexplore.exe"" http://stlvmta01:8080", "FglLoginPg.bmp")
If returnStatus <> SUCCESS Then
AbortScriptEx (SCRIPT_FAIL)
Exit Sub
End If
'Maximize IE
returnStatus = ClickOnImage("MaximizeButton.bmp", LEFT_BUTTON, 1, STANDARD_TIMEOUT, "NONE")
If returnStatus <> SUCCESS Then
AbortScriptEx (SCRIPT_FAIL)
Exit Sub
End If
'Login to Foglight
returnStatus = ClickOnImage("UserName.bmp", LEFT_BUTTON, 1, STANDARD_TIMEOUT, "NONE")
If returnStatus <> SUCCESS Then
AbortScriptEx (SCRIPT_FAIL)
Exit Sub
End If
KeystrokeString ("foglight")
returnStatus = ClickOnImage("Password.bmp", LEFT_BUTTON, 1, STANDARD_TIMEOUT, "NONE")
If returnStatus <> SUCCESS Then
AbortScriptEx (SCRIPT_FAIL)
Exit Sub
End If
KeystrokeString ("foglight")
returnStatus = ClickOnImage("LoginButton.bmp", LEFT_BUTTON, 1, STANDARD_TIMEOUT, "NONE")
If returnStatus <> SUCCESS Then
AbortScriptEx (SCRIPT_FAIL)
Exit Sub
End If
'Click on the End User Overview link
returnStatus = ClickOnImage("EndUserOverview.bmp", LEFT_BUTTON, 1, STANDARD_TIMEOUT, "NONE")
If returnStatus <> SUCCESS Then
AbortScriptEx (SCRIPT_FAIL)
Exit Sub
End If
'Log out of Foglight
returnStatus = ClickOnImage("SignOut.bmp", LEFT_BUTTON, 1, STANDARD_TIMEOUT, "NONE")
If returnStatus <> SUCCESS Then
AbortScriptEx (SCRIPT_FAIL)
Exit Sub
End If
'Close IE
returnStatus = ClickOnImage("CloseButton.bmp", LEFT_BUTTON, 1, STANDARD_TIMEOUT, "NONE")
If returnStatus <> SUCCESS Then
AbortScriptEx (SCRIPT_FAIL)
Exit Sub
End If
End Sub
End Module

Alternately, close the application using the Alt+f or x hot keys. This eliminates the need to capture the window Close button, but does not confirm that the window closed.

Create and test FTR scripts containing the CitraTest script

Once this script is running in CitraTest®, create a new FTR script, and insert a CitraTest script using the FTR Insert Wizard.

To create a new FTR script:
1
Create a new FTR script.
2
Insert a CitraTest Script Instruction.
3
Set the CitraTest executable according to the directories used in CitraTest.
4
Run the FTR script.
5
Once this runs correctly:
a
Publish it to the Foglight server.
b
Configure the Service Model to include the new script.
c
Start the Transaction Player agent.
6
Once the basic script is deployed and running successfully, write the rest of the script and insert the timers.
7
When the script has been completed:
a
Replay the script in the Foglight Transaction Recorder.
b
Republish the script to the Foglight Management Server.
c
Stop and restart the Transaction Player to start monitoring the new script.

Use the Restore Desktop features of CitraTest and FTR

When a script fails, the application is left in an unknown state. To ensure a consistent launch point and avoid other problems such as multiple versions of the application running, Restore Desktop is advisable in many situations. CitraTest® and FTR each have the ability to restore the desktop to the state prior to script execution, and both should be set to ensure a consistent script startup state.

To use the CitraTest Restore Desktop feature:
1
In CitraTest, click Playback > Playback Options.
2
Select the Restore desktop to the script start time state check box. This closes any windows that were open when the script launched.
3
To enable FTR’s restore desktop feature, set the Restore Desktop option to True in the CitraTest instruction properties.

There are certain applications, such as Citrix clients, where closing the window or killing the process is detrimental to the system. For example, closing a Citrix client window leaves the session open on the server. A “LogOff” is required to properly shut down a Citrix client.

In such cases, the Restore Desktop property in the FTR instruction should be left at False. Logic should be added in CitraTest script to the AbortScript function and/or at the beginning of each script to ensure the application is shuts down properly. For example, at the beginning of the Citrix script, use the ImageExists function to check for the pre-existence of the Citrix client, and if it exists click the Start > Shut Down in the Citrix client window and execute a clean Log Off.

Run FTR scripts as a local administrator

When running the FTR scripts in the Foglight Transaction Recorder or through the agent, it is recommended to run with a user that has a local account with administrator rights.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating