Using the BO Inspector view

If you use business object tracing, Integrated Test Environment gathers information about a business object while the system processes the business object. Integrated Test Environment captures an image of the business object after it has been processed by a map and after it has been processed by a collaboration.

For example, if you are testing an interface in which a connector sends a business object request to a collaboration object which sends it to a destination connector, which processes it and then returns a response, then Integrated Test Environment captures the following business object data:

Figure 72 shows a BO Inspector view that has captured three input business objects, two result business objects, and an exception message.

Figure 72. Business object inspector view

This section describes how to use business object tracing and BO Inspector views.

Business object trace behavior

The following statements describe the behavior related to BO Markers in the Test Unit editor and BO Inspector views as a business object is processed by an interface:

Showing and closing BO Inspector views

The following sections describe the numerous ways you can show and close BO Inspector views.

The "Default interface position" column in Table 25 lists the views whose default positions in the interface are overlaid with the BO Inspector views in the "BO Viewer number" column.
 
 

Table 25. Default BO Inspector view positions
BO Viewer number Default interface position
BO Viewer 1 Outline
BO Viewer 2 Properties
BO Viewer 3 Dependency

Showing BO Inspector views

Use one of the following techniques to show BO Inspector views.
Using the Test Unit view
Follow the instructions in Showing BO Inspector views to show a BO Inspector view in the Test Unit view.
Using the Integrated Test Environment menu
Select Integrated Test Environment > Show All BO Views from the menu bar to show all three BO Inspector views.
Using the Perspective menu
Select Perspective > Show View > x:BO Inspector from the menu bar to launch a specific BO Inspector view, where x is the number of the BO Inspector view instance you want to show.

Closing BO Inspector views

Use one of the following techniques to close BO Inspector views.
Using the Integrated Test Environment menu
Select Integrated Test Environment > Close All BO Views from the menu bar to close all open BO Inspector views.
Using the BO Inspector view
Either click the Close button in the right-hand side of the BO Inspector view title bar, or right-click the BO Inspector view title bar and select Close from the context menu.

Refreshing business object data

As the components of an interface process a business object, the counters of the BO Markers in the Test Unit editor get updated. This indicates that you can update the business object data in the BO Inspector view associated with that BO Marker to view the most recently produced business object.

Do one of the following to update the business object data in a BO Inspector view:

After the business object data is refreshed, you can select the most current business object instance from the drop-down menu in the upper-left-hand corner of the BO Inspector view.

Refreshing business object markers

For information on refreshing BO Markers in the Server Context Overlay, see Refreshing BO Markers.

BO Inspector view styles

There are several view styles you can use with the BO Inspector view.

Using the Table view style

The Table view style presents the business object data in a table, as it appears in the Input Pane of the Connector Agent view or in the "Response BO" window.

Figure 72 shows the BO Inspector view with the Table view style.

Do one of the following to use the Table view style:

Using the Text view style

The Text view style presents the business object data in the text markup format in which it is stored when exported from the Connector Agent view or "Response BO" window.

Figure 73 shows the BO Inspector view with the Text view style.

Figure 73. BO Inspector view with business object data in text view style

To view an exception message in a BO Inspector view, you must change it to the Text view style; the BO Inspector view cannot display an exception message in the Table view style.

Figure 74 shows an exception message in the BO Inspector view with the Text view style.

Figure 74. BO Inspector view with exception information in text view style

Do one of the following to use the Text view style:

Arranging the views vertically

You can arrange a BO Inspector view so that it displays the Text view beneath the Table view at the same time.

To arrange the BO Inspector view panes vertically, click the down arrow in the right-hand corner of the title bar of the BO Inspector view and select Arrange Vertical from the menu.

Figure 75 shows the BO Inspector view panes when they have been arranged vertically.

Figure 75. BO Inspector view panes arranged vertically

Arranging the views horizontally

You can arrange a BO Inspector view so that it displays the Text view to the right of the Table view at the same time.

To arrange the BO Inspector view panes horizontally, click the down arrow in the right-hand corner of the title bar of the BO Inspector view and select Arrange Horizontal from the menu.

Figure 76 shows the BO Inspector view panes when they have been arranged horizontally.

Figure 76. BO Inspector view panes arranged horizontally

Saving test data from a BO Inspector view

Although there is no built-in mechanism for saving test data in a BO Inspector view, you can use the following workaround:
  1. Switch the BO Inspector view to the Text view style as described in Using the Text view style.
  2. Select all of the text in the Text view pane.
  3. Use the keyboard shortcut Ctrl+C to copy the text.
  4. Paste the copied text into a text file and save it with a .bo extension.

  5. You can use the saved text file in Map Designer Express, Visual Test Connector, and Integrated Test Environment.

Configuring business object tracing preferences

Business object tracing can be a very resource intensive task. By default it is configured to turn off after two hours, though you can change this timeout value. Furthermore, you can configure Integrated Test Environment so that it does not automatically update the counters of BO Markers as business objects are processed, which can be a resource-intensive task in high-volume transactions. Do the following to configure preferences related to business object tracing:
  1. Select Window > Preferences from the menu bar.
  2. Select Integrated Test Environment.
  3. Configure the properties of the "Test Server" and "Test Connector / Access Client" panes according to the instructions in Setting the RMI port in the Integrated Test Environment preferences.
  4. Do the following in the "BO Trace" pane to configure your business object tracing preferences:
    1. Type the number of minutes after which you want business object tracing to turn off in the BO trace timeout field.
    2. To have Integrated Test Environment automatically update the counters of BO Markers as business objects are processed, leave the Enable auto update checkbox enabled.
  5. Click OK.

[ Top of Page | Table of Contents ]

Copyright IBM Corp. 1997, 2003