Converting a Recording to a Clip

Document created by Chris Sommerstad Employee on Jul 19, 2017
Version 1Show Document
  • View in full screen mode

Any HTTP or HTTPS recording may be used to create a clip. To convert a recording to a clip, open it from Central > HTTP(S) Message Recordings and follow these steps:

  1. The Recording page will display the HTTP or HTTPS traffic.
  2. Click Convert to a Clip in the upper right hand corner of the page. This will cause the Create a Clip From Recording Wizard to display.

Name

The first wizard screen allows you to name the clip, select its timing type, decide how much of the recording you wish to convert (based on filtering) and whether or not to use Auto-naming for messages in the converted test clip. The timing choices are:

      1. Enter a clip name and select a timing type.
        • Sequenced. Messages are sent in sequence. Message 2 is sent as soon as Message 1 receives a response, and so forth.
        • Manually Timed. Messages are sent at their specified times (or as close to the specified time as possible). For generated clips, the message timing will be determined from the recorded messages.
        • Evenly Timed. Messages are sent at a specified interval (default is one message per second).
      2. Determine whether to accept auto-naming or to uncheck the Auto-naming box.

The Auto-name messages feature will name the messages created during recording-to-clip conversion using the end portion of their respective relative URLs. Unchecking this box will result in messages that are named by number instead (e.g. Message 1, Message2).

Bursts and Think Times

  1. The second screen deals with Think Times. Think times apply to Sequenced and Manually timed clips. If you wish to apply think times, click the checkbox labeled Insert think times and set the threshold values. Pauses will automatically be inserted into the generated clip according to these settings to simulate user think times.

  1. If you selected a Manually Timed clip this screen is presented with additional bursting options. Bursts are available for Manually Timed clips only. Bursts are on by default. You may uncheck the checkbox labeled Detect and insert bursts if you wish to disable bursting. If you wish to include bursts, you can change the bursting thresholds. Messages within the threshold are sent as a burst. Messages in a burst are sent as close to simultaneously as possible during execution. Click Next to continue.

Match Targets

  1. The Match Targets screen shows matched targets for the generated clip. Any existing target that matches messages in the recording is included in the Selected Targets list on the right. Click Next to continue.

Create New Targets

    1. The Create New Targets screen shows new targets for those messages that had no corresponding existing target.

When No New Targets Detected

When no new targets are detected, the New Targets list displays the message "No new targets to create". In the Potential SOAP Targets list, the message "No potential SOAP targets" is displayed when no SOAP targets are detected. The Create New Targets page of the Convert Recording to Clip Wizard now displays the complete target URL when the mouse hovers over a given target in the New Targets list.

Un-checking the box for a new target means that the corresponding messages will not be added to the final test clip. Click Next to continue.

The middle table, Potential SOAP Targets, shows targets that are possibly SOAP, but are not yet resolved (no WSDL target has yet been defined for them). For Targets that appear in this list—an HTTP target will be created if a SOAP target is not provided.

The Binary SOAP Endpoints table shows binary SOAP targets that must be resolved before the Next button is made active. Adding a WSDL URL using the bottom box (and then clicking Apply) will create such a target based on the given WSDL. Once Applys is clicked the lists above are reloaded to detect targets based on the change.

When New Targets Detected

When new targets are detected, the Create New Targets page of the Convert Recording to Clip Wizard now displays the complete target URL when the mouse hovers over a given target in the New Targets list. when New Targets are detected, they are listed as shown on the right. Similarly, potential SOAP Targets are shown, if detected.

  1. Check the “Automatically create groups of Page requests and include the following static resources in them:” box to create pages for this test clip.
  2. Optionally, add or subtract static page resources from the Content Types: and Extensions: entry fields by editing the listed resources per field.

Create New Pages

The Create Pages step provides the ability to tightly organize the new test clip and its elements by the page to which they correspond.

  1. Check the “Automatically create groups of Page requests and include the following static resources in them:” box to create pages for this test clip.
  2. Check Mark the first message in the page to dynamically retrieve its resources to create a dynamic page that will retrieve its resources at runtime. This will mark the page to process its HTML Document’s resources dynamically and static resources in the resulting page will be disabled.
  3. Optionally, check Remove the "static" resources from the page to entirely omit static page resources from the resulting pages. Using this option will delete static resources for the purpose of creating tests of only the dynamic resources on a page. This is useful for frequently changed pages.

Dynamic mode uses the target “HTML Document” to request the page’s resources. The correct URL for each resource at the time the test is run is used, regardless of what the target says. The connection pool and configuration settings of the target are shared by all of the resource retrievals. See the Connection Options section of the Target Editor for the relevant target to inspect these settings.

TIP: Use the “URL for Reporting” widget to track the actual URLs used in your test. This chart will provide more accurate statistics than widgets segmented by target, although target-based widgets will remain available.

Note: CloudTest will not recursively retrieve nested resources in frames or iframes in the response. Frames or iframes will be represented in the clip by their own pages.

  1. Click Next when ready.

The Create Clip page appears. This page includes information about enabled pages. In the screenshot on the rights, Pages are enabled with included resources. When Next is clicked, the clip is created and the status of that operation is displayed as shown.

  1. Click Next. The Summary page appears.

Summary

  • The Summary screen appears. If the test clip information on this screen is correct, click Next to continue. Otherwise, click Back to correct your settings.

Next Steps

  1. The test clip is created. When clip generation is complete, the Summary information appears again in the top section. In the lower section, two continue buttons are presented. You can continue to the composition editor to play the clip, or continue to the clip editor to perform additional editing, or simply click Finish to exit the process.

Attachments

    Outcomes