Chat now with support

Live-Hilfe anfordern
Registrierung abschließen

Anmelden

Preisinformationen anfragen

Vertrieb kontaktieren

FREE TRIALS

Foglight Transaction Recorder 5.6.13 - Recorder User Guide

Inhaltsnavigation

Overview of Foglight synthetic monitoring Use the Foglight Transaction Recorder

Script window Properties window

Root instructions Browser instructions

Navigate Open Browser Close Browser Browser Refresh Browser Back Browser Forward

HTML Element instructions

Set Value: = (Checkbox) Click Input(0) (Click Instruction) **| Set Value: =*** (Input Password) ab| Set Value: = (Input Text) Java Script Set Value: = (Radio Button) Set Value: = (Select)

External Scripting instructions

CitraTest Script FTR Script Generic Command Line Windows Script

Special instructions

Credential Delay - 00:00:00.10 Folder Internet Settings Keyboard Message Transaction

Network Diagnostics

Name Lookup Ping Trace

Properties and Instruction descriptions

Common Properties Instruction Properties HTML Element Properties

Main window Results window

Output Results Error

Favorites window Create, publish scripts, and publish to Foglight

Record scripts Configure scripts (Insert transactions and validations)

Insert transactions Insert validations

Script playback

Analyze script results Publish scripts to Foglight

Publish Script dialog box

Create and upload Foglight Transaction Recorder scripts

Record scripts Configure scripts (Insert transactions and validations)

Insert transactions Insert validations

Script playback

Analyze script results

Publish scripts to Foglight

View Foglight Transaction Recorder results

Summary Network Details Network Chart Timing Charts Size Charts Timing vs. Size Chart

General settings

General Defaults

Recorder settings

Delays Environment HTML

Publish settings Windows Server 2003 security settings Recorder types

Import Dialog Interceptor Settings into the Foglight Transaction Recorder graphic user interface Use Error Overrides Insert validation rules Insert Transactions Rebaseline a script Use Sync Points Change source of text for Form Inputs

Text Value Value Script Using the Custom Value Source Set Values

Use cookies Use the Dialog Interceptor Settings Set up the Foglight Transaction Recorder to run with the FxM

Turn on Tag and Follow before the recording process begins Insert an Internet Instruction and turn on Tag and Follow after a script is recorded

Scale Foglight Transaction Player client machines Set the Recording Method dialog Set the delay Use cache management

How cache management works How Foglight Transaction Recorder cache settings interact with Internet Explorer cache settings Cache management locations and settings

Foglight Transaction Recorder cache management Foglight Transaction Player cache management

Set Empty Temporary Internet Files in Internet Explorer

Appendix: Best practices

FTR Advanced/CitraTest best practices

Verify the Foglight environment Create and Run scripts on the same machine Captured images should be as small as possible Manually create the CitraTest scripts Use the AppStart function to start applications Maximize applications after AppStart Script launching and closing of the application Create and test FTR scripts containing the CitraTest script Use the Restore Desktop features of CitraTest and FTR

Run FTR scripts as a local administrator Gather network statistics when using Windows Vista or a later version Scale Foglight Transaction Player Agents

Maximum number of concurrent scripts Determining maximum concurrent scripts Assigning worker processes

Appendix: Troubleshoot the Foglight Transaction Recorder

Use the script properties Verify the Foglight environment Remote Desktop Verify script playback Ensure users are logged out before running a script Run as a user FTR Advanced best practices Duplicate the steps in Internet Explorer TPRunscript Contact Support and collect support documentation

Appendix: API for FTR Timer Usage

Three main classes Samples code Enums Sample of usage

Trace

A trace instruction traces the route a packet takes from the agent to another host. It utilizes the IP protocol `time to live' field to elicit an Internet Control Message Protocol TIME_EXCEEDED response from each gateway (RFC 1812) along the path to the target host. The instruction attempts to trace the route by sending probe packets for up to 30 hops. After completion of the instruction, information messages are issued with both the address of and the time it took to trace each hop. The behavior of this instruction is similar to issuing a tracert <hostname> command from the Windows command line instruction.

Figure 31. Trace instruction

Refer to the following for additional information about property descriptions and values:

•

Common Properties

•

Instruction Properties

Properties and Instruction descriptions

The Properties Window is where individual instruction and script properties are displayed and edited. The properties in the Properties Window are grouped by Browser Instructions, HTML Elements, External Scripting, Special, and Network Diagnostics. Properties found in the Common properties are common to all instructions and scripts. Instruction properties are common to all instructions. HTML Element properties are common to all instruction properties that require an HTML element to act against, such as a click instruction or set input instruction.

The Foglight Transaction Recorder provides the following instruction properties:

•

Common Properties

•

Instruction Properties

•

HTML Element Properties

Common Properties

Common properties provides generic naming and descriptions fields for all instructions.

Table 1. Common Properties: Naming and description fields
Property Name	Value	Description	Editable
Description	Text field	An editable comment explaining what the script item accomplishes.	Yes. Click inside the property value to edit.
Enabled	True or False	Enables or disables instructions in the Foglight Transaction Recorder script. When disabled, the instruction is not executed during playback.	Yes. Click inside to display the True/False drop-down. When enabled is set to true, the instruction is enabled. When set to false, the instruction is disabled and a small red circle appears over the instruction.
Name	Text field	The logical name given to an instruction during the recording process.	Yes. Click inside the property value to edit. The exceptions are credential, delays, attach, and messages.

Instruction Properties

Instruction Properties displays instruction-specific editable fields that allow you to monitor and change scripts.

Table 2. Instruction Properties: Instruction-specific editable fields

Instruction Property

The type of instruction to be executed during playback.

Additional Parameters

Sets additional parameters, during the running of a CitraTest®, credential, or window script instruction.

Yes. Click inside to edit.

Automatically detects proxy configuration.

Yes. Click inside the property value to display a drop-down and select: false (do not detect proxy configuration), true (detect proxy configuration).

The time, in seconds, the browser waits on a page to ensure that navigation to another page is not triggered.

Click inside to edit.

The ID (instance) assigned during the recording process. The first instance assigned is a zero. As the browser creates a new popup window, the ID is increased by one.

If a popup window is closed, the ID does not recycle. For example, if you open windows zero, one, two, and three, then close window one. When the next instruction opens a new window, its ID is assigned four.

Yes. Click inside to display a spinner and select the desired ID.

State of a checkbox input element during Play or Fast Forward.

Click inside the property value to display a drop-down and select: false (unchecked), true (checked), or toggle (the opposite of the current value).

Configuration URL

The URL that automatically configures the script.

Click inside the property value to enter the desired URL.

Automatically configures the proxy connection with script.

Yes. Click inside the property value to display a drop-down to select true (autoscript configuration on) or false (autoscript configuration off).

Custom Value Param

Allows you to read data from an external source.

Click inside to add text.

Custom Value ProgID

Allows you to set the ID for the custom data.

Click inside to add text.

Path to directory containing data.

Sets the directory with the required files to run the command line instruction. All of these files and subdirectories are packaged in the script.

Click to display the Browse for Folder dialog.

The delay time is displayed in seconds.

Click inside to edit the time.

Instructions Desktop Configuration

Configuration settings and values

Displays the desktop configuration (resolution, colors, etc.).

Click to display the configuration.

Dialog Interceptor Settings

Allows you to specify which dialogs are intercepted during playback.

Click inside the property value to display the Dialog Interceptor Settings dialog.

Sets a single or double-click for an instruction.

Yes. Click inside the property value to display a drop-down to select true (double-click) or false (single click).

Empty Internet Cache

Setting this property to true empties the cache on completion of a page being viewed. Note: Internet Explorer settings provide the “Empty Temporary Internet Files folder when the browser is closed” setting. To access this setting in Internet Explorer, select Tools > Internet Options > Advanced. Scroll down to Security. By default, IE does not select this option. If turned on, this setting overrides the Foglight Transaction Recorder. When recording with the Foglight Transaction Recorder, do not select this setting.

Yes. Click inside the property value to display a drop-down to select True or False.

Enforce Desktop Configuration

Warns the user if the desktop configuration saved at record time does not match the playback configuration.

Yes. Click inside the property value to display a drop-down. Select true (enforce) or false (do not enforce).

Error value and severity

Set on the root item of the script and override the handling of errors when they occur during playback. For more information, see Import Dialog Interceptor Settings into the Foglight Transaction Recorder graphic user interface.

Click to display the Error Overrides dialog to add or delete errors.

Specifies the CitraTest® executable script.

Click to display the Open dialog window.

Allows you to edit the expected times of a script.

Click to display the Expected Times dialog.

Allows you to define the proxy server.

Click inside the property value to display a drop-down to select true (allow user to define proxy server) or false (does not allow user to define a proxy server).

Fire Click Event

Determines if a mouse click will be performed on a web element in addition to setting its value during playback.

Click inside the property value to display a drop-down. Select true (fires the click event) or false (does not fire the click event).

Fire Click Event After

Determines if a mouse click will be performed on a web element after setting its value during playback.

Click inside the property value to display a drop-down. Select true (fires the click event) or false (does not fire the click event).

Ignore Script Errors

Sets whether or not the client-side scripts errors are ignored.

Yes. Click inside the property value to display a drop-down.

Text inserted into a script.

Click inside the property to add text.

Internet Cache Settings

•

•

Every browser restart

•

•

How often the browser should retrieve new versions of Web pages.

Click inside the property value to display a drop-down to select the desired setting.

Allows you to edit JavaScript.

Yes. Click inside the property value to display the JavaScript Editor.

•

•

•

The state of special keys (ALT, CTRL, SHIFT).

Click inside the property value to display a drop-down list of keyboard states.

•

•

•

•

•

The match criteria used to identify an element. Changing Match Criteria allows you to change how the HTML element is located on the page. For example, if you use the text referenced as Reference ID, it will use the value in the Reference ID field.

Yes. Click inside to edit.

Maximum Cache Size

The maximum size of the cache to be stored in the Temporary Internet Files folder.

The minimum size is 10 MB.

Yes. Click inside to edit.

A property comment, warning, or error message to be displayed in the error log during play or fast forward.

Yes. Click inside to edit.

The severity of the message displayed in the error log during playback or fast forward.

Click inside the property value to display a drop-down and select the appropriate message type.

Left or right click of the mouse buttons.

Sets a left or right click for the mouse button action used to click the element.

Yes. Click inside the property value to display a drop-down. Select the appropriate (left or right) button value.

How large the ping packet should be. The range is from zero to 65,500.

Yes. Click inside to display a spinner and select the desired packet size.

The password of an account being accessed.

Yes. Click inside the property value to enter a password.

The URLs that do not use the proxy server.

Yes. Click inside the property value to enter the appropriate Proxy Server address.

The proxy password.

Yes. Click inside the property value to enter the appropriate password.

Restore Desktop

Restores the desktop to its condition when the script first ran. This action closes any windows that are open after script execution.

Click inside the property value to display a drop-down.

Makes script visible or not visible when running.

Click inside the property value to display a drop-down.

Sets the script the target program will run.

Click to display the open dialog window.

Inserts headers into the network packets sent by the agent.

Click inside the property value to display a drop-down. Select True or False.

The host name to be resolved.

Yes. Click inside the property value to enter the desired target.

The Browser frame to perform the instruction on.

Click inside the property value to edit.

Target Window Alias

The name of the attached window instruction corresponding to the target window.

Yes. Click inside the property value to display a spinner to select the target window alias.

The web input text value.

Click inside the property value to display the editor.

Time Out (secs)

The time, in seconds, the Foglight Transaction Recorder waits for something to happen. If the transaction time exceeds this value, the server is considered down and a critical error is flagged. The default time- out setting is 60 seconds.

Yes. Click inside the property value to edit.

The Browser frame to perform the instruction on.

Click inside the property value to edit.

Ttl (time to live)

How long the ping packet lives. The range is from one to 255.

Yes. Click inside the property value to display a spinner to select the packet size.

The URL of a web page loaded during playback.

Click inside the property value to enter the appropriate URL.

The login name of an account being accessed.

Click inside the property value to enter a user name.

Allows you to enter Java Script.

Click to display the Java Script Editor.

Allows you to enter custom value sources.

Clicking the drop-down displays the following options:

•

•

•

Virtual Key Code

The key to simulate pressing during playback.

Click inside the property value to display a drop-down list of virtual key codes.

Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen