Siebel Developer's Reference > Siebel Web Engine Tags >

swe:error

When a server-side error occurs on submitting a form, SWE shows the same page again with the error message displayed within the page. For errors that occur outside of a form submission, SWE continues to use the application's Error Page.

This error message display is intended for showing error messages within a form.

To display the error message within a form, place the following tags inside the swe:form tag:

<swe:error>

<swe:this property = "FormattedHtml"/>

</swe:error>

The error messages are shown in plain text, but each error message is a new paragraph. It is the responsibility of the enclosing HTML tags to modify the font and style of the error message. Sometimes, the error message may not be visible; this is because the font uses the same color as the background.

If the application developer does not use error tags in the swt files, the code automatically generates an error node (a CSSSWEErrorSWX instance). This automatically-generated error node is inserted as the first child of the enclosing page/form node.

Syntax

The syntax of the swe:error tag is as follows:

swe:error

Usage

<swe:error property="FormattedHtml" />

or

<swe:error>

<swe:this property="FormattedHtml" />

<swe:error/>

Use this tag within all swe:form tags.

NOTE:  Use the swe:error tag inside a swe:form tag in an applet template only in standard interactivity applications. In high interactivity applications, these errors are shown using a pop-up window.

Also, use the swe:error tag instead of the swe:pageitem tag mapped to the _SWEErrMsg item in the application's Error Page. The use of the _SWEErrMsg item is no longer supported.

An example of the use of the swe:error tag is:

<swe:form>

<swe:error>

<b> <font color="red"> <swe:this property="FormattedHtml"/> </font> </b>

</swe:error>

.....

</swe:form>

When the form is being rendered when there are no errors, the contents of the swe:error tag are skipped.