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:
-
The generic business object produced by the map that is called by the source
connector when sending the business object request to InterChange Server Express.
-
The generic business object supplied as input to the map that is called
by the destination connector.
-
The generic business object produced by the map that is called by the destination
connector when returning the business object response to InterChange Server Express.
-
Exception messages related to failed flows.
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:
-
When you send a business object request from a source connector, the BO
Marker attached to the connector icon in the Test Unit editor is filled
with green and the number 1 is displayed above the magnifying glass illustration
in the BO Marker. This indicates that it has processed one business object.
You can show the BO Inspector view for this BO Marker at this point
and see the generic business object produced by the inbound map. It is
identified with a prefix of "in" in the drop-down menu in the upper-left
of the BO Inspector view.
-
The business object is processed by subsequent components in the interface
(such as the collaboration object) and if there are no errors then it is
processed by the outbound map associated with the destination connector
in the interface.
When this occurs the BO Marker attached to the destination connector
icon in the Server Context Overlay is filled with green and the number
1 is displayed above the magnifying glass illustration in the BO Marker,
indicating that it, too, has processed the business object.
You can show the BO Inspector view for this BO Marker at this point
and see the generic business object that was processed by the outbound
map. It is identified with a prefix of "out" in the drop-down menu in the
upper-left of the BO Inspector view.
-
If you reply to the request business object in the destination connector
at this point the interface completes its processing. The number 1 is displayed
below the magnifying glass illustration in the BO Marker, indicating that
the generic object produced by the inbound map of the destination connector
has been processed.
At this point you can view the generic business object in the first
BO Inspector view. It is identified with a prefix of "result" in the drop-down
menu in the upper-left of the BO Inspector view. Because the same BO Inspector
view also contains data for the "in" business object instance, you must
select the "result" instance from the drop-down menu.
-
If an error occurs during the execution of the interface a red circle is
drawn around the magnifying glass of the BO Marker. You can select the
error--identified with a prefix of "exception"--in the BO Inspector view
associated with the BO Marker. You must change the BO Inspector view to
Text View in order to view the error text.
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:
-
Click the Refresh BO data button in the toolbar of the BO Inspector
view.
-
Click the down arrow in the right-hand corner of the title bar of the BO
Inspector view and select Refresh.
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:
-
Click the Show table view button in the toolbar of the BO Inspector
view.
-
Click the down arrow in the right-hand side of the title bar of the BO
Inspector view and select Show Table View.
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:
-
Click the Show text view button in the toolbar of the BO Inspector
view.
-
Click the down arrow in the right-hand side of the title bar of the BO
Inspector view and select Show Text View.
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:
-
Switch the BO Inspector view to the Text view style as described in Using
the Text view style.
-
Select all of the text in the Text view pane.
-
Use the keyboard shortcut Ctrl+C to copy the text.
-
Paste the copied text into a text file and save it with a
.bo
extension.
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:
-
Select Window > Preferences from the menu bar.
-
Select Integrated Test Environment.
-
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.
-
Do the following in the "BO Trace" pane to configure your business object
tracing preferences:
-
Type the number of minutes after which you want business object tracing
to turn off in the BO trace timeout field.
-
To have Integrated Test Environment automatically update the counters of
BO Markers as business objects are processed, leave the Enable auto
update checkbox enabled.
-
Click OK.
[ Top of Page | Table
of Contents ]
