Using WebLogic Integration - Business Connect
|
 |
 |
|
|
 |
 |
Tracker enables you to monitor your use of WebLogic Integration - Business Connect by providing runtime and archived views of database records of transactions and events. You also can use Tracker to search for and resend documents to your trading partners or resubmit them through the Server application to your translator or business application.
The following topics are provided.
Tracker provides runtime and archived views of records or logs that show your organization's inbound and outbound document traffic as well as alert messages of high importance. Runtime views display database records before they have been archived. Archive view shows database records that have been archived. You control the frequency of archiving in the Administrator Schedules information viewer.
Tracker has information viewers that display database records of inbound, outbound and rejected documents. You can switch between views of the runtime and database records by selecting Runtime or Archive from the Database table drop-down list at the top left. Click Refresh to make sure the latest records are displayed (see Refreshing the Tracker Display.)
The following provides an overview of the information viewers in Tracker.
You can view the date, time, partner ID or combined EDI qualifier and ID, contact name, and contact e-mail address for each alert or notification message. You can also view or print the text of the message.
You can view runtime and archive database records for inbound, outbound and rejected documents. There are three Traffic information viewers:
The Inbound Traffic and Outbound Traffic information viewers provide an audit trail for documents you received from or sent to your trading partners. The Rejected Traffic information viewer provides a list of inbound or outbound documents that WebLogic Integration - Business Connect could not process and routed to the rejected directory.
You can view a reverse chronological listing of each milestone event in the processing of in and outbound documents. For each transaction event, you can see the date, time, control ID, ID or combined EDI qualifier and ID, status, and any message associated with it.
To view the latest database records, click Refresh or select View
Tracker database information viewers refresh automatically the first time you display them. Automatic refreshing occurs when you start Tracker. It also occurs the first time you select another information viewer or change from a runtime to archive display or vice versa. Apart from that, you must manually refresh the displays.
When you click Refresh, the action refreshes records on the currently active information viewer, but not others. For example, say you click Refresh while viewing the Inbound Traffic information viewer. The viewer refreshes the record display. But if you switch to the Outbound Traffic information viewer, you must click Refresh again to also refresh the records displayed in that viewer.
If you want to see continuously updated records of document trading activity, open the server monitor page in a browser by selecting Tools
Tracker has filters that enable you to view many or few runtime or archive database records at a time in information viewers. The filter settings persist from one Tracker session to another until you change them. You set filters by information viewer by database view. For example, the filter settings for the runtime view of the Alerts information viewer apply only to that window.
Click Filter or select View
You can specify to view only records dated between certain dates or records dated within the last number of hours, days or months that you specify.
On filter windows with a maximum records field, you can leave the field blank, which displays all records, or you can type the number of records you want displayed on the information viewer.
On filter windows with a control ID field, you can use the following values to filter records.
You can print a list of the records in the currently active information viewer by selecting File
The application prints the data as displayed on the current information viewer, so maximizing the window size before you print yields longer horizontal printed records. Although the records print in landscape format, you might have to adjust the column widths or hide columns of data in the information viewers to print the columns you want. This is necessary to account for differences in fonts and printers.
You can adjust column widths by placing the cursor over the lines between the columns headings to make a double-arrow appear. Click and hold the left button to adjust the widths. You also can click and drag columns headings to change their locations. You can hide or show columns of data by selecting View
You can use Tracker to search for records of documents and, in the case of records of documents in the runtime database, you can submit such documents for reprocessing. Reprocessing involves resending documents to your trading partners or re-submitting documents through WebLogic Integration - Business Connect to your translator or business system. For procedure see Finding and Reprocessing Documents.
The following topics describe the various options for reprocessing documents:
When you reprocess a document, WebLogic Integration - Business Connect creates a new version of it with a new, unique file name. You can reprocess each file name only once. To reprocess a document more than once, you must select only the most recently processed document.
For example, you attempt to send to your partner a document with the control ID 100000000 and a file name of 56in. The document is rejected. You use Tracker to resubmit this document through WebLogic Integration - Business Connect to your translator. WebLogic Integration - Business Connect names the resubmitted document (control ID 100000000) to file name 68in. To resubmit the document (control ID 100000000) a second time, choose file name 68in in the Find window.
Note: Tracker cannot reprocess completed documents that have been archived. This includes inbound documents that have been placed in the EDI-in directory and outbound documents for which you have received an MDN.
For procedure see Finding and Reprocessing Documents.
When you send a document and you have selected the acknowledge documents option in the partner profile, your trading partner sends you an MDN, which acknowledges the receipt, successful decryption and verification of the document.
If your WebLogic Integration - Business Connect system does not receive an acknowledgment, it attempts to resend the transaction up to the limits in the Partner Profile window Preferences tab. If your system still does not receive an acknowledgment, WebLogic Integration - Business Connect generates and sends you an e-mail alert. You can then locate and resend the unacknowledged document.
From the document status drop-down list on the Find window, select Not Acknowledged to search for unacknowledged documents. When you find the documents you want, you can select them and click Reprocess. WebLogic Integration - Business Connect moves the selected documents to an outbound directory for reprocessing and retransmission to your trading partner.
For procedure see Finding and Reprocessing Documents.
You can resend rejected outbound documents to your trading partners and resubmit rejected inbound documents to your WebLogic Integration - Business Connect system for reprocessing.
From the document status drop-down list on the Find window, select Rejected to search for rejected documents. Based on the information about these documents, you should correct whatever condition caused the documents to be rejected before you attempt to reprocess them.
When you find the documents you want, you can select them and click Reprocess. Then the following occurs:
For procedure see Finding and Reprocessing Documents.
A control ID is the unique identifier assigned to a document by a company's translator application. When you locate a document this way, you can resend it to your trading partners or resubmit it to your WebLogic Integration - Business Connect system for reprocessing.
In the control ID field on the Find window, type the control ID for the document you need to find. The control ID is an alphanumeric ID that has a maximum length of 12 characters. You must include any leading zeros.
When you find the document you want, you can select it and click Reprocess. Then the following occurs:
For procedure see Finding and Reprocessing Documents.
You can search for documents you sent to or received from a certain partner. When you locate the documents, you can resend outbound documents to your trading partners or resubmit inbound documents to your WebLogic Integration - Business Connect system for reprocessing.
From the trading partner drop-down list on the Find window, select the partner associated with the documents you want to find. When you find the documents you want, you can select them and click Reprocess. Then the following occurs:
For procedure see Finding and Reprocessing Documents.
Use this procedure to start Tracker and log on.
Use this procedure to force the Server application to archive the runtime database records displayed in Tracker. Activating this feature forces archiving to occur now and overrides the archive schedule, which is accessed from Tools
The Server application must be running for immediate archiving to occur.
After archiving is completed, you can switch to the archive view in Tracker to review archived database records.
Use this procedure to clear the Tracker runtime or archive database records.
Note: If you clear the runtime database, you will permanently lose all records before they have been archived. Also, if you clear the archive database, you will permanently lose all archived records. Be careful when using these functions.
Use this procedure to find runtime and archive records of documents in Tracker. After you have found the documents you want, you can reprocess runtime documents, but not archived documents. Reprocessing involves resending documents to your trading partners or re-submitting documents through WebLogic Integration - Business Connect to your translator or business system. See Guidelines for Finding and Reprocessing.
The document search process enables you to search the Tracker database for one or more documents using a filter and then reprocess them. Searches you can perform include:
Tracker can find only those documents in the backup or rejected directories. Consequently, your ability to find and resend or resubmit documents depends on how often you elect to run the archive process.
You cannot reprocess a document that WebLogic Integration - Business Connect has successfully received from a partner. If you need to reprocess a document that already has been successfully received and processed, ask your partner to send the document to you again. Only MDNs that have been rejected can be reprocessed.
If you choose the do not back up option for inbound documents in your company profile preferences, you can use Tracker to access documents only in the rejected directory.
If you choose the back up and archive or the back up and delete option in your company profile preferences, the archive process deletes completed documents or moves them to the archive directory. A completed inbound document is one that has been placed in the inbound document directory. A completed outbound document is one for which you have received an MDN (if you requested one). After these completed documents have been moved or deleted, you can no longer search for them or reprocess them using Tracker.
If you want to reprocess an ebXML document for which you already have received an acknowledgment, be aware of the following. WebLogic Integration - Business Connect repackages documents that are selected for reprocessing. When you reprocess an ebXML document, your partner re-sends the original acknowledgment. This causes your system to generate a message integrity check (MIC) error upon receiving the acknowledgment, because the hash of the outbound reprocessed document does not match the hash of the inbound acknowledgment. This only occurs when an MCD is used and when a messageID element is present in the MCD.
The following are the steps for setting up a filtered search for documents. You do not have to use all the fields on the Find window to perform a search. The fields are available to help you perform a wide or narrow search.
You must type all digits of the control ID, including leading zeros. You cannot use wild cards or Boolean symbols in this field.
The following describes the fields on the Find window for documents that Tracker has found that meet your search criteria. For procedure see Steps.
The date and time WebLogic Integration - Business Connect processed the document. You can sort records in ascending or descending order by clicking the arrow in this column.
The document's control ID. For EDI documents, this is the number assigned by the translator.
Documents without control IDs might be binary or XML documents. Or, it is an inbound document that WebLogic Integration - Business Connect could not read and placed in the rejected directory.
Values that can appear in this field for inbound documents include:
Values that can appear in this field for outbound documents include:
|
You received an acknowledgment from the document's recipient. |
|
|
You did not receive an acknowledgment from the document's recipient, or you did not request that your partner send one. |
|
|
WebLogic Integration - Business Connect could not process this document and placed it in the rejected directory. |
|
|
WebLogic Integration - Business Connect successfully processed this document. |
The file name that your WebLogic Integration - Business Connect assigned to the document, either inbound or outbound.
The complete path to the directory where this document is stored. This path is to one of the following directories.
Use the Alerts information viewer to examine records for alerts and notifications.
Access the viewer by selecting Alerts on the Tracker bar.
WebLogic Integration - Business Connect continuously performs self-checks to ensure proper operation. When it detects a problem, WebLogic Integration - Business Connect generates an alert or notification that appears in the Alerts information viewer. Simultaneously, WebLogic Integration - Business Connect sends your point of contact an e-mail message that describes the problem in plain text. Such e-mails are sent if a contact person's e-mail address is provided in the alert or notify mail address fields on the Preferences tab of the Company Profile window.
You can view the text of alerts and notifications by placing the cursor over the record line in the Alerts information viewer, right-clicking and selecting View on the pop-up menu. This displays a pop-up window with the text of the message. You also can copy a message by right-clicking. You can paste copied messages into a text editor.
Figure 18-2 Right-Click a Record and Select View to Display the Message
Identified by the word alert in the e-mail subject line, alert messages are sent when WebLogic Integration - Business Connect detects a condition that halts document exchange and requires you to take action. An example is when WebLogic Integration - Business Connect cannot connect to the network or when there is a problem with the WebLogic Integration - Business Connect software.
Identified by the word notification in the e-mail subject line, notification messages are informational and do not require you to take action. Document exchange continues. WebLogic Integration - Business Connect sends a notification, for example, when it rejects a document or when it receives a binary (non-EDI) document from a partner for which it does not have a partner profile.
Figure 18-3 Alerts information Viewer
The following describes the fields on the Alerts information viewer.
The date and time of the message. You can sort records in ascending or descending order by clicking the arrow in this column.
The partner ID or combined EDI qualifier and ID for the document that caused or is related to this message.
The e-mail address, if any, to which the message was sent. This e-mail address is specified in the Company Profile window Preferences tab.
Use the Traffic information viewers to view runtime and archive database records for inbound, outbound and rejected documents. There are three Traffic information viewers:
Access each viewer by selecting the corresponding icon on the Tracker bar.
The Inbound Traffic and Outbound Traffic information viewers provide an audit trail for documents you received from or sent to your trading partners.
The Rejected Traffic information viewer provides a list of inbound or outbound documents that WebLogic Integration - Business Connect could not process and routed to the rejected directory.
You can reprocess documents whose records appear in the runtime database of the Inbound Traffic, Outbound Traffic and Rejected Traffic information viewers. You do this by selecting one or more records, right-clicking, and selecting Reprocess on the pop-up menu. Or, you can select one or more records and select Tools
Reprocessing does the following:
You can right-click records in the Traffic information viewers to view an inbound or rejected document or to copy or delete a record. The following describes what you can do in each viewer.
In the Inbound Traffic and Rejected Traffic information viewers you can:
In the Outbound Traffic information viewer you can:
In addition, in the Rejected Traffic information viewer you can double-click a record to view a dialog box with a plain text message about why the document was rejected.
In the Inbound Traffic and Rejected Traffic information viewers, you can display the document by right-clicking it and selecting View from the menu as follows:
.edi with a text editor such as Notepad. You can associate .xml documents with your Internet browser.+) key or the Enter key to page down; press the minus sign key (-) to page up. Press q to close the viewer.Figure 18-4 Inbound Traffic information Viewer
The following describes the fields on the Inbound Traffic and Outbound Traffic information viewers. The fields are on both viewers, except as noted.
The date and time the record was created of the inbound, outbound or rejected document. You can sort records in ascending or descending order by clicking the arrow in this column.
The acknowledgment status of the document. Possible values for inbound documents include:
|
You received the document, created an MDN and placed it in the queue to send. |
|
|
The acknowledgment status of the document cannot be determined because of an error condition in the database. |
The acknowledgment status of the document. Possible values for outbound documents include:
Indicates whether WebLogic Integration - Business Connect processed the inbound document. Possible values are:
|
WebLogic Integration - Business Connect has completed processing the inbound document. |
|
|
WebLogic Integration - Business Connect has not completed processing the inbound document. |
Indicates whether WebLogic Integration - Business Connect processed the outbound document. Possible values are:
The file name of the inbound or outbound document. This is the original name of the file as it originated on the sender's system.
The name of the MDN or ACK file in the backup directory, if you received an MDN or acknowledgment from a partner to acknowledge receiving a document from you. This serves to associate the MDN or ACK you received with the document you sent.
The following describes the fields on the Rejected Traffic information viewer.
The date and time the document was rejected. You can sort records in ascending or descending order by clicking the arrow in this column.
The unique name WebLogic Integration - Business Connect gives to the file. This is the name of the file as it appears in the Rejected directory.
Use the Transactions information viewer to view records about transaction activity. This viewer provides an audit trail for successfully processed and transmitted documents as they move through the system.
Access the viewer by selecting Transactions on the Tracker bar.
In the Transactions information viewer you can copy a record by right-clicking it and selecting Copy from the pop-up menu. You can then paste the record contents into a text editor.
Figure 18-5 Transactions Information Viewer
The following describes the fields on the Transactions information viewer.
The date and time of the event. You can sort records in ascending or descending order by clicking the arrow in this column.
|
|
|
