Skip to content
DevTest Solutions - 8.0.1
Documentation powered by DocOps

How to Document a Transaction for a Manual Test

Last update January 30, 2015

This scenario takes you through the steps of documenting a transaction for a manual test.

  1. Record Your Test Transactions
  2. Search for Recorded Test Transactions
  3. View and Analyze Recorded Test Transactions
  4. Compare Recordings
  5. Show Recording Difference View
  6. Create Documentation from Recorded Transactions

Record Your Test Transactions

You document the exceptions that occur in business transactions for a specific IP address using the recording feature.

Follow these steps:

  1. Select Application Insight, Document Transactions from the left navigation menu.
    The Document Transactions window opens.
  2. Click Create a Recording to start a new case recording.
    The Record Case dialog opens. By default, the IP address displays for the system that is using the browser to connect to the DevTest Server.
    You can change the IP address when you are running the browser that connects to the agent application from a remote system.
  3. (Optional) Select Auto Refresh to display the captured transactions automatically.
  4. (Required) Enter a name for the test case.
    Including the test identifier from your ALM in the name is recommended. This name appears in the list of the Points of Interest portlet from the Home page.
  5. Click Start.
    The Start button changes to an animated Recording... icon to indicate that the recording is in progress.
  6. Run the agent application in another browser window, either on the same or on a remote system.
  7. Perform the required work on the agent system that is being recorded.
    The frames that are recorded display in the Captured Frames pane.
    A blue pin is added to the frame of the IP address that is being recorded. The captured frames display automatically in the Captured Frames pane when Auto Refresh is selected. Otherwise, click Refresh.
  8. (Optional) To view the recorded transactions in a graphical view, click graphical view button.
  9. (Optional) To view the recorded transactions in a list view, click list view button.
  10. (Optional) Click Show Outline and move the map to view portions of large transactions at a time.
  11. Click Stop.
  12. To save the recording, click Save.
    The recordings that are saved are listed in the Recording pane of the Document Transactions window.
  13. To create documentation for your recorded transactions, click Create Document.

Search for Recorded Test Transactions

You can narrow the list of recordings to analyze using the search capability in the Document Transactions window.

Follow these steps:

  1. Select Application Insight, Document Transactions from the left navigation menu.
  2. Enter the text search criteria in the Enter Search Text field and click Search.

View and Analyze Recorded Test Transactions

The Recording pane of the Document Transactions window displays a list of all the recorded test transactions that were saved. From the Recordings list, you select a recording to display in graphical or list view from the Recording of: pane. You can also share a link or delete a recording. 

Follow these steps:

  1. Select Application Insight, Document Transactions from the left navigation menu.
  2. Select a saved test recording from the list in the Recording pane.
    The test transaction opens in the lower pane in graphical view by default.
  3. View the tooltip to display the transaction details.
  4. To view the transaction details dialog, click a frame in the Recordings of: pane.
    The transactions details dialog displays.
  5. To view the transaction details in list view, click List Graphic of List button above the Recording of: pane.
  6. To share the link to a recording, click Share Link Graphic of Share Link button in the Recording pane.
  7. To delete a recording, click Delete Recording Graphic of Delete Recording button in the Recording pane.

Compare Recordings

You can compare two recordings side-by-side in the Document Transactions window. Recordings display in a left and right pane in Show graphical differences view by default. You can change the view to display the recordings in Show text differences.

The following graphic displays a comparison of two recordings in Show graphical differences view. The recording named jh test 1 displays in the left pane and recording jh test 2 displays in the right pane:

The following graphic displays two recordings in Show text difference view:

In this view, expand the tree to display more information about the recordings.

This procedure assumes there are at least two saved recordings.

Follow these steps:

  1. From the Document Transactions window, click Compare Recordings.
    The Compare dialog displays.
  2. Enter Recording name (left) and Recording name (right) fields or drag the name from Saved Recordings list and drop the name into the field, then click OK.
  3. Analyze the comparison.
  4. (Optional) Click the legend to view information for the recordings.
  5. Click X to close.

Show Recording Difference View

When comparing two recordings, you can select options for viewing the differences of the recordings from Recording Diff View.

The following are the recording difference view options:

  • Show changed values only
  • Show response time difference
  • Show all details

Follow these steps:

  1. Complete and save at least two recordings.
  2. In the Document Transactions window, click Compare Recordings.
  3. Enter the Recording name fields for the recordings that will appear in the left and right panes and click OK.
    Alternatively, you can drag the names from the Saved Recordings list into the Recording name fields.
    The recordings display in a left and right pane in show graphical differences view by default.
  4. (Optional) Click Show text difference to display the differences in a tree view. 
  5. Click Recording Diff View and select an option.

Create Documentation from Recorded Transactions

You can create a report of the transactions that were recorded during a test from the Document Transactions window. The report contains information about each frame that was recorded. You can save and print the report.

Follow these steps:

  1. From the Document Transaction window, record and run your test.
  2. Click Create Document.
  3. Enter the title of the report and click OK.
    The report is generated and displays in a browser.

    Note: It may take a few minutes to generate the report depending on the number of transactions.
  4. To save the report, move the mouse to the bottom, right of the browser to display the task bar, click Save, and enter the fields.
  5. To print, click Print and enter the fields.
Was this helpful?

Please log in to post comments.