bea.com | products | dev2dev | support | askBEA

Download Docs | Site Map | Glossary
Search

B2B Samples

JSP Tag Reference

A Java Server Pages (JSP) tag library is provided for trading partner zeroweight clients. It uses a wrapper to address the WebLogic Integration Messaging API. Error handling uses standard Java exception and error handling via WebLogic Integration Messaging API classes and JSP pages delivered to the zeroweight client.

This section provides reference information for the following JSP tags:

- SendmsgTag

- ChecknewmsgTag

- CheckallmsgTag

- ReadmsgTag

- DeletemsgTag

- DeleteallmsgTag

- CreatemboxTag

- RemovemboxTag

Note: The WebLogic Integration Messaging API and the JSP tag library for it are both deprecated as of this release of WebLogic Integration. For information about the features that are replacing WebLogic Integration Messaging API and its JSP tag library, see BEA WebLogic Integration Release Notes.

SendmsgTag

Passes a business message to a mailbox for outgoing mail; provides message persistence for reliability.

Syntax

SendMsgTag (String mboxName, String sender, String message, String URL, String security)

Returns

Returns Message has been sent successfully if the message was successfully sent to the JSP page in which SendMsgTag is embedded.

Variables

Variable | Description
--- | ---
String mboxName | Name of the mailbox. To run the sample, use one of the following names for the appropriate mailbox: For incoming mail: trading_partner_name_Inbox For outgoing mail: trading_partner_name_Outbox
String message | Message content.
String sender | Mailbox address for the sender. This may be an e-mail address or an FTP server address.
String URL | URL for the hosting trading partner.
String security | Value may be ON or OFF.

Example

sendmsg mboxname="<%=outboxName_browserTP1%>" sender="<%=SENDER%>" message="<%=domAsStr%>" url="<%=url%>" security="ON"/>

ChecknewmsgTag

Checks for new messages in the mailboxes for incoming and outgoing mail. Does not check for stored messages (see CheckallmsgTag).

Syntax

ChecknewmsgTag (String mboxName)

Returns

If the mailbox is empty, returns No new message found in mailbox. If the mailbox contains one or more new messages, the messages are displayed in HTML format.

Variables

Variable | Description
--- | ---
mboxName | Name of the mailbox. To run the sample, use one of the following names for the appropriate mailbox: For incoming mail: trading_partner_name_Inbox For outgoing mail: trading_partner_name_Outbox

CheckallmsgTag

Checks all messages in the mailbox, including stored messages.

Syntax

CheckallmsgTag (String mboxName)

Returns

If there are messages in the mailbox, they are displayed in HTML format. If the mailbox is empty, returns No message found in mailbox.

Variables

Variable | Description
--- | ---
mboxName | Name of the mailbox. To run the sample, use one of the following names for the appropriate mailbox: For incoming mail: trading_partner_name_Inbox For outgoing mail: trading_partner_name_Outbox

ReadmsgTag

Gets details about a specific message from the mailbox.

Syntax

ReadmsgTag (String mboxName, String msgId)

Returns

Message details are displayed in HTML format.

Variables

Variable | Description
--- | ---
mboxName | Name of the mailbox. To run the sample, use one of the following names for the appropriate mailbox: For incoming mail: trading_partner_name_Inbox For outgoing mail: trading_partner_name_Outbox
msgID | Unique message identifier.

DeletemsgTag

Deletes a specified message from the mailbox.

Syntax

DeletemsgTag (String mboxName, String msgID)

Returns

Returns Message with messageID msgID deleted successfully.

Variables

Variable | Description
--- | ---
mboxName | Name of the mailbox. To run the sample, use one of the following names for the appropriate mailbox: For incoming mail: trading_partner_name_Inbox For outgoing mail: trading_partner_name_Outbox
msgID | Unique message identifier.

DeleteallmsgTag

Deletes all messages from the mailbox.

Syntax

DeleteallmsgTag (String mboxName)

Returns

Returns All messages were deleted successfully when successful.

Variables

Variable | Description
--- | ---
mboxName | Name of the mailbox. To run the sample, use one of the following names for the appropriate mailbox: For incoming mail: trading_partner_name_Inbox For outgoing mail: trading_partner_name_Outbox

CreatemboxTag

Creates a mailbox.

Syntax

CreatemboxTag (String mboxName)

Returns

Returns no message.

Variable

Variable | Description
--- | ---
mboxName | Name of the mailbox. To run the sample, use one of the following names for the appropriate mailbox: For incoming mail: trading_partner_name_Inbox For outgoing mail: trading_partner_name_Outbox

RemovemboxTag

Removes a specific mailbox.

Syntax

RemovemboxTag (String mboxName)

Returns

Returns Mailbox removed successfully.

Variables

Variable | Description
--- | ---
mboxName | Name of the mailbox. To run the sample, use one of the following names for the appropriate mailbox: For incoming mail: trading_partner_name_Inbox For outgoing mail: trading_partner_name_Outbox