27Reference Materials for Configuring Siebel Business Applications

Reference Materials for Configuring Siebel Business Applications

Properties of Object Types

This topic describes some of the properties that Siebel CRM frequently uses with various objects that you can configure. It includes the following information:

For a complete list of properties of objects, see Siebel Object Types Reference.

Properties of a Siebel Table

The following table describes properties that Siebel CRM commonly uses with a Siebel table.

Table Properties That Siebel CRM Commonly Uses with a Siebel Table

Property Description

Name

The name of the table in the RDBMS.

Type

The table type. For more information, see the table in Type Property of a Table Column.

Base Table

The base table if the table is an extension table. If the table is a base table, then this property is empty. An extension table always identifies a base table.

User Name

A longer, descriptive name that helps you identify the table.

Comments

A text description of the table, such as the type of data that Siebel CRM stores in the table.

Status

The current status of a table. Indicates if Siebel CRM can use, in the most recent version of Siebel CRM, a table from a previous version of Siebel CRM.

Properties of a Table Column

The following table describes properties that Siebel CRM commonly uses with a table column.

Table Properties That Siebel CRM Commonly Uses with a Table Column

Property Description

Default

Stores a default value when Siebel CRM adds new table rows.

Foreign Key Table

Stores the table that this column references a foreign key. Siebel Enterprise Integration Manager (EIM) uses this information. For more information, see Mapping a Custom Table to an Interface Table.

LOV Bounded

Stores import behavior for EIM. If LOV Bounded is TRUE, then, during import, EIM checks the values against the values contained in a list defined in the LOV Type property. In that situation, LOV data must be imported first into the S_LST_OF_VAL table, and the LOV Type property must be defined. This property is read-only for a predefined column in Siebel CRM but you can edit it for a custom extension column.

LOV Type

Stores the list of values domain that the Siebel schema uses to validate this column. Siebel CRM uses it in conjunction with the LOV Bounded property. You define a list of values domain in the Administration - Data screen, List of Values view in the Siebel client. This property is read-only for a predefined column in Siebel CRM but you can edit it for a custom extension column.

Name

Stores the name of the database column in the database table.

Nullable

Indicates if the Siebel database can or cannot store NULL in this column. If TRUE, then Siebel CRM can store NULL.

Physical Type

For more information, see Physical Type Property of a Table Column.

Precision

Stores the maximum number of digits in a number column. For a noninteger column, the precision is 22. For an integer column, the precision is 10.

Primary Key

Stores the primary key for the table. If TRUE, then this column is the primary key for the table. With minor exceptions, the ROW_ID column in a table is the primary key, and it contains a TRUE value for this property.

Scale

Stores the maximum number of digits after the decimal point. For a noninteger column, the scale is 7. For an integer column, the scale is 0.

Type

For more information, see Type Property of a Table Column.

User Key Sequence

Stores the sequence in the user key where this column fits.

Physical Type Property of a Table Column

The following table describes the physical types that Siebel CRM supports. The Physical Type property identifies the physical type of the column in the Siebel database.

Table Physical Types That Siebel CRM Supports in the Physical Type Property of a Table Column

Physical Type Description

Character

Stores text that is fixed in length. Also used for a Boolean column, which is a character column that contains a length of 1. You cannot use Char greater than 1, by default.

To modify the default setting in Siebel Tools, you can click the View menu, Options, and then click the Database tab. Make sure the following option contains a check mark:

Allow to create column of type ‘Character’ being greater than 1

If you define a Column as a Char column, and if the data that Siebel CRM stores in the column varies in length, then it pads the data with empty spaces in the Siebel database. It is recommend that you use the Varchar data type for all but Boolean columns that Siebel CRM defines as CHAR(1).

Character Large Object (CLOB)

For more information, see Extensive Code Examples That This Book Uses.

Date

Stores the date only, without time.

Date Time

Stores combined date and time in the same column.

Long

Stores long text. You can store approximately 16 KB of data in a Long column.

Number

Stores any numeric data. Typical numeric columns in Siebel CRM are 22,7 for typical numbers, and 10,0 for integers. For more information, see Physical Type Property of a Table Column.

Time

Stores time only, without the date.

UTC Date Time

Stores the date and time. Siebel CRM saves time in Greenwich Mean Time (GMT).

Varchar

Stores text that varies in length. Used for most alphanumeric columns in the data objects layer, including ROW_ID, foreign key, list of values, and other free form text columns.

Character Large Object (CLOB) Physical Type

The Character Large Object (CLOB) physical type stores a large, variable amount of text. Siebel CRM version 8.0 and higher supports this text. CLOB is similar to Long, but it can contain much more data. In an Oracle database, the maximum size is (4 GB minus 1 byte) multiplied by the value in DB_BLOCK_SIZE.

Note the following requirements:

  • A column in a Siebel table is limited to 128 KB of data. You cannot define a column of type CLOB that is greater than 128 KB.

  • Siebel CRM allows no more than three CLOB columns for each table.

  • In Siebel Tools, you can only set the physical type to CLOB when you define a column. You cannot modify a predefined column, such as a Long column, to a CLOB column.

  • Siebel Tools displays the CLOB Physical Type as L (Long) in the Properties window.

  • Microsoft SQL Server does not define a CLOB type. It treats a CLOB as a varchar(max) or nvarchar(max) object.

  • To query on a DTYPE_CLOB field, you must use at least one wildcard in the search expression. You use an asterisk (*) to express a wildcard. For example, use TEST*. Do not use an equal sign (=) in the query. For example, do not use =TEST. If you use an equal sign, then Siebel CRM creates an error.

Maximum Number of Digits for a Numeric Physical Type

If the Physical Type property of a table column is Numeric, then the table column can contain up to 16 digits. Note the following for the numeric physical type:

  • As Siebel CRM increases the number of digits it uses before the decimal point, the number of usable digits after the decimal point decreases by an equal amount.

  • Data is limited to 16 digits without a decimal point.

  • If you use a decimal point, then data is limited to 15 digits before the decimal point.

  • You cannot use more than 7 digits after the decimal point.

  • You cannot modify precision or scale properties to modify this support.

  • Some rounding errors can occur with a 16 or 15 digit number.

Type Property of a Table Column

The type property specifies the type of column. Siebel CRM commonly uses the following values for the Type property of a table column:

The following table describes possible values for the Type property of a Siebel table.

Table Values for the Type Property of a Siebel Table

Type Description

Data (Public)

Contains data that Siebel CRM makes available through business components. To configure a public data table, you can use an extension table and extension column. It is among the predefined set of tables.

Data (Private)

Similar to a public data table, except it cannot contain an extension column.

Data (Intersection)

Defines a many-to-many relationship between two data tables.

Extension

Provides more columns that you can use to store data. Contains an implicit one-to-one relationship to the parent base table, which is the table that an extension table logically extends.

A table with an implicit one-to-many relationship to a base table is also known as an extension table. The Type property for this type of table is Data (Public), and not Extension.

Interface

Siebel Enterprise Integration Manager (EIM) uses the Interface type to enter values in one or more base tables and subsequently to perform periodic batch updates between Siebel CRM and other enterprise applications. The suffix in the name of an interface table is _IF or _XMIF.

Database View

Reserved for Oracle internal use.

Dictionary

Reserved for Oracle internal use.

Journal

Reserved for Oracle internal use.

Log

Reserved for Oracle internal use.

Repository

Reserved for Oracle internal use.

Virtual Table

Reserved for Oracle internal use.

Warehouse Types

Reserved for Oracle internal use.

Extension (Siebel)

Reserved for Oracle internal use. An Extension (Siebel) table is typically an extension of the S_PARTY table.

Properties of an Index of a Siebel Table

The following table describes some of the properties that Siebel CRM commonly uses with an index.

Table Properties That Siebel CRM Commonly Uses with an Index

Property Description

Name

Stores the name of the database index.

Unique

TRUE indicates that Siebel CRM does not allow multiple rows with the same value.

You must not define a custom unique index without assistance. For more information, see Getting Help From Oracle.

Type

Indicates the type of index. Siebel CRM commonly uses the following types:

  • Primary Key. An index that Siebel CRM indexes on the ROW_ID column.

  • User Key. A custom index that you define. You specify the set of index columns. It must consist of a unique combination of columns.

  • Extension. An extension index that Siebel Tools creates by default if you add an index. Siebel CRM specifies the set of index columns.

  • System. A predefined index. You must not modify a predefined index.

Properties of an Index Column

The following table describes some of the properties that Siebel CRM commonly uses with an index column.

Table Properties That Siebel CRM Commonly Uses with an Index Column

Property Description

Column Name

Stores the name of the column where the parent index does an operation, such as a sort operation.

Sequence

An integer value that stores the order of the column in the index relative to other columns. You must define the Sequence property even if only one index column is defined for an index.

Sort Order

Stores the sort order of the index column. The order is one of the following:

  • Asc (ascending)

  • Desc (descending)

Properties of a Business Component

The following table describes some of the properties that Siebel CRM commonly uses with a business component.

Table Properties That Siebel CRM Commonly Uses with a Business Component

Property Description

Class

The C++ class that defines the functionality of the business component. For more information, see Class Property of a Business Component.

Name

A name that must be unique among all business components that reside in the Siebel runtime repository. Siebel CRM uses the name to reference a business component.

No Delete

No Insert

No Update

If set to TRUE, then the user cannot perform the defined data manipulation operation. For example, if No Delete is TRUE, then the user cannot delete a record that is associated with this business component. The default value is FALSE.

Search Specification

A conditional expression that Siebel CRM uses to restrict the records that it gets. Defining the search specification on a business component is very similar to defining the search specification on an applet. For more information, see Options to Filter Data That Siebel CRM Displays in an Applet.

Sort Specification

A sort specification that Siebel CRM uses to order the records returned. For more information, see Determining How a Business Component Sorts Records.

Table

The name of the SQL table where Siebel CRM gets the records that it uses to update most fields in the business component.

Type Property of a Business Component Field

The following table describes the data types that Siebel CRM includes in the Type property of a business component field. Siebel CRM prefaces all field data types with the following text: DTYPE_.

Table Type Property of a Business Component Field

Field Data Type Physical Type Maximum Length Description

DTYPE_BOOL

Character

1

Describes data as Y or N. Siebel Tools often displays this type in the following ways:

  • TRUE or FALSE

  • checked or unchecked

DTYPE_CURRENCY

Number

22

Describes data as currency.

You can use the Windows Control Panel to control the appearance of currency values that Siebel CRM displays in a screen.

To define an explicit format mask in the Display Format property, you can use the following symbols:

  • Dollar sign ($). Specifies the position for the currency symbol.

  • Trailing period (.). Specifies the default precision for the currency.

  • All valid symbols described for DTYPE_NUMBER.

DTYPE_DATE

Date

7

Describes data as a date. When Siebel CRM returns the date, it ignores other information, such as time. For more information, see Formats for the Date Physical Type.

DTYPE_DATETIME

Date Time

7

Describes data as a date and time. You can use the Windows Control Panel to set the appearance of time and date values. You can use a combination of DTYPE_DATE and DTYPE_TIME to configure an explicit date format.

Alternatively, you can use one of the following properties. Each of these properties use the format configured in the Windows Control Panel:

  • Date. Displays only the date portion of the value.

  • Time. Displays only the time portion of the value.

  • TimeNoSec. Displays only the hour and minute portion of the value.

DTYPE_UTCDATETIME

UTC Date Time

30

Describes data as date information that includes a date and a time component that Siebel CRM stores in the Siebel database in UTC time. UTC is the equivalent of Greenwich Mean Time without any adjustments for daylight savings time.

A field of this type must correspond to a database column of type U. The default time zone that is configured in the user preferences determines how Siebel CRM converts the display value for this field to or from UTC time.

DTYPE_ID

Varchar

15

Describes data as the primary key that Siebel CRM creates.

A field mapped to an extension column with a physical type of Varchar(15) defaults to a DTYPE_ID data type.

DTYPE_INTEGER

Number

22*

Describes data as a whole number ranging in value from negative 2147483648 to 2147483647.

DTYPE_NOTE

Long

16 KB

Describes data as a long string that is less than or equal to 16 KB, or 16383 bytes. If the length is not explicitly defined, then the default is 16 KB. If used with the Pop-up Edit property in a control or list column, then the DTYPE_NOTE data type indicates to the Siebel client to use a multiline edit box.

The user cannot query on a DTYPE_NOTE field.

DTYPE_NUMBER

Number

22

Describes data as a number. For more information, see Formats for a DTYPE_NUMBER Business Component Field.

DTYPE_PHONE

Number

40

Describes data as a phone number. Siebel CRM ignores the DisplayFormat property for DTYPE_PHONE values.

DTYPE_TEXT

Varchar

2 KB

Describes data as a string that is less than or equal to 4000 bytes. The default value is 255. Siebel CRM ignores the DisplayFormat property for DTYPE_TEXT values.

DTYPE_TIME

Time

7

Describes data as a time.

When Siebel CRM gets the time, it ignores other information. You can set the appearance of time values through the Windows Control Panel, or you can use the following symbols to specify an explicit time:

  • HH. Hour according to a 24-hour clock without a leading zero.

  • H. Hour according to a 24-hour clock with a leading zero.

  • hh. Hour according to a 12-hour clock without a leading zero.

  • h. Hour according to a 12-hour clock with a leading zero.

  • mm. Minute without a leading zero.

  • m. Minute with a leading zero.

  • ss. Second without a leading zero.

  • s. Second with a leading zero.

  • Colon (:). The position of the time separator. You specify the character in the Windows Control Panel.

Formats for the Date Physical Type

You can use the Windows Control Panel to control the appearance of date values that Siebel CRM displays in a screen.

To define an explicit date format, you can use the following symbols:

  • YY. Two-digit year without a leading zero.

  • Y. Two-digit year with a leading zero.

  • YYYY. Four-digit year without a leading zero.

  • YYY. Four-digit year with a leading zero.

  • MM. Month without a leading zero.

  • M. Month with a leading zero.

  • DD. Day without a leading zero.

For more information, see How Siebel CRM Handles Certain Date Formats.

Formats for a DTYPE_NUMBER Business Component Field

You can use the Windows Control Panel to control the appearance of numeric values, or you can use the following symbols to specify an explicit format mask:

  • Zero (0). Specifies the position of a mandatory digit.

  • Pound sign (#). Specifies the position of an optional digit.

  • Comma (,). Specifies the position of the thousands separator. You specify the character in the Windows Control Panel.

  • Period (.). Specifies the position of the decimal separator. You specify the character in the Windows Control Panel.

  • Trailing period (.). Specifies default display precision.

  • Plus sign (+). Specifies the position and appearance of the positive value indicator.

  • Minus sign (-). Specifies the position and appearance of the negative value indicator.

Restrictions exist regarding the number of digits you can use with a business component field whose Type property is DTYPE_NUMBER. For more information, see Physical Type Property of a Table Column.

Display Format Property of a Control or List Column

The following table describes values for the Display Format property of a control or list column.

Table Values for the Display Format Property of a Control or List Column

Property Description

DTYPE_NUMBER

Can include the following values:

  • 0 (zero)

  • # (pound sign)

  • + (plus sign)

  • - (minus sign)

  • , (comma)

  • . (period)

If empty, then to determine the appearance of numeric values, Siebel CRM uses the Regional Settings section of the Windows Control Panel.

DTYPE_CURRENCY

Uses the same symbols as with the DTYPE_NUMBER property, in addition to the dollar sign.

To control how Siebel CRM displays currency, in the Siebel client, you navigate to the Application Administration screen, choose the Currencies view, and then modify the Scale field.

DTYPE_DATETIME

Stores one of the following values in the Display Format property:

  • Date

  • DateTime

  • DateTimeNoSec

  • TimeNoSec

DTYPE_DATE

Uses a combination of the following values:

  • MM/DD/YY

where:

  • MM is the month.

  • DD is the day.

  • YY is the year.

If empty, then to determine the appearance of date values, Siebel CRM uses the Regional Settings section of the Windows Control Panel. For more information, see How Siebel CRM Handles Certain Date Formats.

DTYPE_TIME

You can use one of the following formats:

  • Specify TimeNoSec.

  • Specify a format mask using a combination of the following values:

    • HH:hh:mm:ss

    where:

    • HH is the hours.

    • hh is the hours.

    • mm is the minutes.

    • ss is the seconds.

If empty, then to determine the appearance of time values, Siebel CRM uses the Regional Settings section of the Windows Control Panel.

DTYPE_PHONE

If empty, then to determine the appearance of phone values, Siebel CRM uses the Regional Settings section of the Windows Control Panel.

How Siebel CRM Handles Certain Date Formats

If you set DDD, DD/MM/YYYY as the display format on a date list column, then Siebel CRM displays the date with the expected format but you cannot update the date. If you attempt to update the date, then it displays an error that is similar to the following:

Can't convert formatted string to its internal representation. Please check if your 
data is in correct format.

The same situation occurs if you use the DDD/MM/YYYY format.

Properties of a Screen View

The following table describes some of the properties that Siebel CRM commonly uses with a screen view.

Table Properties That Siebel CRM Commonly Uses with a Screen View

Property Description

Category Default View

Defines the default view for a screen view as an Aggregate Category or Detail Category.

It is recommended that you define the Category Default View property. If this property is empty, then Siebel CRM lists views alphabetically.

If the category for the screen view is Aggregate View or Detail View, then the Category Default View property is read-only.

Category Name

Name of the Aggregate Category or Detail Category. This property must be unique in each screen.

If the category for the screen view is Aggregate View or Detail View, then the Category Name property is read-only.

Display in Page

If Siebel CRM must display the screen view in the page, then you must set the Display in Page property to TRUE.

If the category for the screen view is Aggregate Category or Detail Category, then you must set the Display in Page property to TRUE.

If no views in the category are included, then Siebel CRM does not display the screen view.

Display in Site Map

If Siebel CRM must display the screen view on the Site Map, then the Display in Site Map property must be TRUE.

Menu Text

Text that Siebel CRM displays in the Site Map. To modify the text style that it displays in the Site Map, you can use HTML tags in the Menu Text property. For more information, see Modifying the Text Style of a Control or List Columnin an Applet.

Name

Calculated field.

Parent Category

If the Type property is Aggregate Category, then the Parent Category property is empty because no parent exists.

If the Type property is Aggregate View, then the Parent Category property might or might not be empty.

If the Type property is Detail View or Detail Category, then the Parent Category property must contain a value.

Type

Can be one of the following values:

  • Aggregate Category

  • Aggregate View

  • Detail Category

  • Detail View

For more information, see About Screen Views.

View

If the Type property of the screen view is Aggregate View or Detail View, then you must define the view property. The View property associates the view with the screen view. The View property is read only for Aggregate Category and Detail Category.

Properties of an Application

The following table describes properties of the Application object type.

Table Properties of the Application Object Type

Property Description

Acknowledgement Web Page

The Web page that Siebel CRM displays after the user successfully logs in. If a login occurs after a timeout, then it displays the view that the user attempted to access when the timeout occurred.

Acknowledgement Web View

The view that Siebel CRM displays after the user successfully logs in, except in the following situations:

  • Timeout. If the user logs in after a timeout, then Siebel CRM displays the view that the user attempted to access when the timeout occurred.

  • Explicit login required. Assume the following occurs:

    • An anonymous user logs in to a customer application.

    • The Explicit Login property is set to TRUE for the view that the user attempts to access.

    • The user successfully enters the login credentials.

    In this situation, Siebel CRM displays the view that the user was attempting to access. It does not display the view defined in the Acknowledgement Web View property.

Container Web Page

A Web page that defines the structure of the Siebel application. This page can contain the common user interface components, such as screen bars, view bars, logos, and so on. You can use this page to define the HTML Frame definition document for the Siebel application. Siebel CRM displays all views and, as an option, all pages in the context of the container page. For more information, see About the Container Page.

Error Web Page

The page Siebel CRM displays if an error occurs in the Siebel application.

Login Web Page

The page Siebel CRM displays as the login page.

Logoff Acknowledgement Web Page

The page Siebel CRM displays when the user logs out of the Siebel application.

Sort Web Page

The page Siebel CRM uses to create a dialog to perform an advanced sort on list applet columns.

Properties of Objects You Use with a Menu or Toolbar

This topic describes some of the properties of objects that you use with a menu or toolbar.

Properties of a Command

The following table describes some of the properties that Siebel CRM commonly uses with a command.

Table Properties That Siebel CRM Commonly Uses with a Command

Property Description

Business Service

Specifies the business service that handles the method. The service is browser or server depending on the Target property. Note the following:

  • If the Business Service property is empty, then Siebel CRM targets the browser or server infrastructure rather than a specific service.

  • If the Business Service property is not empty, then the business service that is defined must handle CanInvokeMethod and InvokeMethod for the method that is defined in the Method property.

HTML Bitmap

Specifies that the Command object uses a bitmap.

HTML Popup Dimensions

If the Show Popup property contains a check mark, then the HTML Popup Dimensions property specifies the dimensions of the pop-up window, in pixels. For example, you can specify a popup with a dimension of 640x480. Do include the x between the dimensions. Do not include spaces.

Method

Specifies the name of the method that Siebel CRM calls if the user clicks the menu item or clicks the toolbar icon. This is a required property. For more information, see About the Method, Business Service, and Target Properties of the Command Object.

Method Argument

Allows you to send an argument to the method defined in the Method property. For example, assume a command item opens a new window and navigates to a URL in that window. This command can use the Method Argument property to define the GotoURL method in the Method property and the URL to navigate to.

Show Popup

Note the following:

  • If the Show Popup property contains a check mark, then Siebel CRM opens a new browser window before it calls the method.

  • If the Show Popup property does not contain a check mark, then Siebel CRM does not open a new browser window before it calls the method.

Target

Specifies the entity that handles the method that the command calls. The following options are available:

  • Browser. Specifies the method handler as a JavaScript service on the browser or the JavaScript application, depending on if a service is defined or not defined in the Business Service property.

  • Server. Specifies the method handler and object manager service on the Siebel Server or the object manager infrastructure, depending on if a service is defined or not defined in the Business Service property.

    The object manager infrastructure is the Siebel Web Engine UDF loader or the model.

  • Browser Applet.

For more information, see About the Method, Business Service, and Target Properties of the Command Object.

Tooltip Text

The tooltip text that Siebel CRM displays if the user positions the cursor over a toolbar icon. For a predefined method, leave the Tooltip Text property empty. If the Tooltip Text property is empty, then the method dynamically supplies the text, and language localization takes place as a part of this process. If you define the method, then you must enter literal text. If you define literal text, then Siebel CRM does not use language localization for this tooltip text. For more information, see Localizing Siebel Business Applications

Properties of a Toolbar

The following table describes some of the properties that Siebel CRM commonly uses with a toolbar.

Table Properties That Siebel CRM Commonly Uses with a Toolbar

Property Description

Class

Note the following:

  • For an HTML toolbar, leave the Class property empty.

  • For a Java toolbar, enter the name of the Java class that implements the toolbar.

Display Name

Siebel CRM uses this property for the History button and to display or hide toolbars by name.

Name

Referenced by other object definitions and by the <div od-type="toolbar> tag in the name clause.

Properties of a Menu Item

The following table describes some of the properties that Siebel CRM commonly uses with a menu item.

Table Properties That Siebel CRM Commonly Uses with a Menu Item

Property Description

Caption

The text that Siebel CRM displays in the menu or menu item.

Command

Name of the Command object definition that provides the method and target for the menu item.

Name

Uniquely identifies the menu or menu item.

Position

Determines the order of menu items and the parent-child relationships. For example, a menu item with a Position of 150 is a parent to menu items with Position values of 150.10, 150.20, and so on. Note the following:

  • If the parent menu item is active, then Siebel CRM displays the child menu items.

  • If the parent menu item is not active, then Siebel CRM does not display the child menu items.

Properties of a Toolbar Item

The following table describes some of the properties that Siebel CRM commonly uses with a toolbar item.

Table Properties That Siebel CRM Commonly Uses with a Toolbar Item

Property Description

Command

Name of the Command object definition that provides the bitmap, method, and target for the toolbar item. To configure Siebel CRM to insert a separator between icons, you can define one or more hyphens instead of the name of a Command object.

HTML Type

Identifies the type of control that Siebel CRM displays in the toolbar in the browser. You can specify one of the following types:

  • ComboBox

  • Button

  • Edit

  • Label

  • Hyperlink

  • MiniButton

  • Timer

Name

Name of the toolbar item. Siebel Tools uses this property for internal use only. The Name property must be unique in the toolbar.

Position

Determines the order of toolbar items and the parent-child relationships. For example, a Toolbar item with a Position of 150 is a parent to Toolbar items with Position values of 150.10, 150.20, and so on. Note the following:

  • If the parent toolbar item is active, then Siebel CRM displays the child toolbar items.

  • If the parent toolbar item is not active, then Siebel CRM does not display the child toolbar items.

Properties of an Applet Method Menu Item

The following table describes some of the properties that Siebel CRM commonly uses with an applet method menu item.

Table Properties that Siebel CRM Commonly Uses with an Applet Method Menu Item

Property Description

Command

Name of the command that provides the bitmap, method, and target for the applet method menu item.

Use Browser as the target of the Command object for a menu item that Siebel CRM displays on an applet menu.

Menu Text

The text that Siebel CRM displays in the menu item.

Position

The sequence of the menu item in the list of menu items.

Suppress Menu Item

If the Suppress Menu Item property contains a check mark, then Siebel CRM removes the class-level menu item of the defined name from the applet menu in the applet where this property is defined.

Properties of a Class Method Menu Item

The following table describes some of the properties that Siebel CRM commonly uses with a class method menu item.

Table Properties That Siebel CRM Commonly Uses with a Class Method Menu Item

Property Description

Business Service

Note the following:

  • If defined, then this property identifies the business service that contains the method that Siebel CRM calls.

  • If not defined, then Siebel CRM calls the method in the applet class on the browser or server, as defined in the Target property. If not handled, then Siebel CRM does a subsequent retargeting.

Menu Text

The text that Siebel CRM displays in the menu item.

Method

The method that Siebel CRM calls if the user clicks the item.

Position

The sequence of the menu item in the list of menu items.

Suppress Menu Item

If the Suppress Menu Item property contains a check mark, then Siebel CRM removes the applet menu items of the defined name from the applet menu in all applets that it gets from this class and subclasses.

Target

Specifies the entity that handles the method that is defined in the Method property. The following options are available:

  • Browser. Specifies that the method handler is a JavaScript service on the browser, or the JavaScript applet class on the browser, depending on if a service is defined or not defined in the Business Service property. The JavaScript applet class is the JavaScript business component class.

  • Server. Specifies that the method handler is an object manager service on the Siebel Server or the applet and business component and their superclasses, depending on if a service is defined or not defined in the Business Service property.

Types of Applet Controls and List Columns

This topic describes some of the applet controls and list columns that Siebel CRM commonly uses. For more information, see Siebel Object Types Reference.

The following table describes some of the applet controls and list columns that Siebel CRM commonly uses, as defined in the HTML Type property of the control or list column.

Table Applet Controls and List Columns That Siebel CRM Commonly Uses

HTML Type Property Description

Button

Displays in an applet as a button with three dimensions. It starts an action if clicked. You rarely use the button control or list column. You more commonly use the minibutton. For more information, see MiniButton Control and MiniButton List Column and Calling a Method from a Button in an Applet.

CheckBox

Represents a TRUE or FALSE situation:

  • If the user clicks an empty check box, then Siebel CRM displays a check mark in the check box.

  • If the user clicks a check box that is checked, then Siebel CRM removes the check mark.

To view an example of a check box control, open a Siebel application, such as Call Center. Navigate to the Service Request list, drilldown on the SR # column, and then click the More Info tab. In the Categorization section, locate the Alert Me check box.

ComboBox

Defines one of the following special-purpose lists:

  • In a chart applet, it defines the Show and By combo boxes.

  • In a calendar applet, it defines the user name combo box.

  • In a pick applet, it defines the Find combo box.

The ComboBox control includes a field with a button that displays with a down arrow. If the user clicks this button, then Siebel CRM displays a list. If the user chooses an item from this list, then Siebel CRM replaces the previous value in the box. A list provides the list of values.

A combo box displays and behaves almost identically to a static list, except the user interacts with a combo box control or list column rather than a text control or list column. For more information, see About Static Lists.

DrillDownTitle

Includes a drilldown on the title of an applet. If the user clicks the title, then Siebel CRM displays the target view. Applets on the home page use this control. To view an example of a DrillDownTitle control in a Siebel application, such as Call Center, navigate to the Home screen, and then note the My Activities title.

Field

Displays text in a rectangular box. Includes a native HTML type of Text. For more information, see Text Control and Text List Column.

FieldLabel

Displays a field label for a list applet.

File

Allows the user to attach a file.

Hidden

Not visible in the Web page but you can access it through a script.

FormSection

A label that helps to group related fields in an applet. The FormSection label expands to fit the region where it is placed. To set it apart, Siebel CRM displays the label against the FormSection color that is defined in the cascading style sheet.

To view an example of a check box control in a Siebel application, such as Call Center, you can navigate to the Service Request list, drilldown on the SR # column, and then click the More Info tab. Siebel CRM creates the Categorization section through a FormSection control.

If a form applet does not use a grid, then the FormSection control cannot expand to fit in the layout editor. The FormSection control does display correctly in the Siebel client.

ImageButton

A minibutton that references an image. For more information, see MiniButton Control and MiniButton List Column.

InkData

For tablet PC computers. Do not use in a list applet.

JavaApplet

Siebel CRM does not support specialized applet classes for a custom configuration. For more information, see Caution About Using Specialized Classes.

Label

Provides a visual aid. It is not tied to a business component field, it does not display data, and it does not provide any data entry capability. If you must place a text label in a form applet, then use a label control.

If a caption includes any HTML reserved character, then you must encode the HTML with &amp;, &lt;, &gt;, &quot;, and so on. Example HTML reserved characters include the ampersand (&), less than symbol (<), greater than symbol (>), period (.), and so on.

Link

Creates an HTML link that calls a method when activated. Siebel CRM uses it with a control or list column where an InvokeMethod is defined, which can include a method that comes predefined with Siebel CRM.

To view an example of a link control, open a Siebel application, such as Call Center. Navigate to the Home screen, and then note the My Activities link that calls the GoToView method.

Mailto

Siebel CRM displays the value of this control or list column as a link. If the user clicks this control or list column, then Siebel CRM opens the default email program for the user, and then enters the value of this control or list column into the email address.

Password

Allows the user to enter a password. Siebel CRM uses asterisks (*) to mask characters that the user enters in this control or list column.

PositionOnRow

Displays the currently chosen record in a list.

RTC

The following RTC (Rich Text Component) controls define the dimensions and font qualities of a container that includes a rich text component:

  • RTCEmbedded. An embedded text editor. Siebel CRM supports the following HTML tags:

    • Bold < STRONG>

    • italic <EM>

    • Underline <U>

    • Ordered list <OL>

    • Unordered list <UL>

    • List items <LI>

    • <P>

    • <FONT>

    • <BLOCKQUOTE >

  • RTCEmbeddedLinkField. Displays graphics and links in the RTCEmbedded object.

  • RTCPopup. Displays graphics and links in a popup object.

  • RTC_IO. Display graphics and links in an IO object.

You cannot use an RTC control in a list applet, list, or a multi-value group applet.

RadioButton

Displays a radio button.

RecNavNxt

Displays the next set of records.

RecNavPrv

Displays the previous set of records.

SSNxt

Displays the next question in a SmartScript.

SSPrv

Displays the previous question in a SmartScript.

TextArea

Allows the user to enter text in multiple lines. The HTML Height property of the control or list column determines the number of rows of text Siebel CRM displays in the text area.

To view an example of a TextArea control in a Siebel application, open a Siebel application, such as Call Center. Navigate to the Opportunities list, and then note the Sales Objective TextArea control in the opportunity form.

For more information, see Text Control and Text List Column.

URL

Displays as a link. If the user clicks this control, then Siebel CRM opens the specified URL.

Objects You Use with Enterprise Integration Manager

This topic describes properties of objects that Siebel CRM uses with EIM. For more information, see Siebel Enterprise Integration Manager Administration Guide.

Properties of the EIM Interface Table

The following table describes properties of the EIM interface table.

Table Properties of the EIM Interface Table

Property Value

Target Table

Chosen by the developer

EIM Delete Proc Column

T_DELETED_ROW_ID

EIM Export Proc Column

T_EXPORTED_ROW_ID

EIM Merge Proc Column

T_MERGED_ROW_ID

System Columns of the EIM Interface Table

The following information lists system columns of the EIM interface table.

Table System Columns of the EIM Interface Table

Name Physical Type Length Type EIM Processing Column

CONFLICT_ID

Varchar

15

System

FALSE

CREATED

Date Time

7

System

FALSE

CREATED_BY

Varchar

15

System

FALSE

IF_ROW_BATCH_NUM

Number

22

System

FALSE

IF_ROW_MERGE_ID

Varchar

15

System

FALSE

IF_ROW_STAT

Varchar

30

System

FALSE

IF_ROW_STAT_NUM

Number

22

System

FALSE

LAST_UPD

Date Time

7

System

FALSE

LAST_UPD_BY

Varchar

15

System

FALSE

MODIFICATION_NUM

Number

22

System

FALSE

ROW_ID

Varchar

15

System

FALSE

EIM Interface Table Columns to Facilitate EIM Processing

The following table describes the generic EIM interface table columns to facilitate EIM processing for each EIM table interface. You cannot modify the values of these columns.

Table EIM Interface Table Columns to Facilitate EIM Processing

Name Physical Type Length Type User Name EIM Processing Column

T_DELETED_ROW_ID

Varchar

15

Data (Private)

Deleted ROW_ID from base table

TRUE

T_EXPORTED_ROW_ID

Varchar

15

Data (Private)

Exported ROW_ID from target table

TRUE

T_MERGED_ROW_ID

Varchar

15

Data (Private)

Merged into ROW_ID from target table

TRUE

EIM Interface Table Columns for Processing a Mapping to a Defined Table

The following table describes EIM interface table columns for processing a mapping to a defined table.

Table EIM Interface Table Columns for Processing a Mapping to a Defined Table

Column Value

Name

Derived from the name of the target table using the following format:

T_PART ONE_PROCESS SUFFIX

where:

  • PART ONE is the EIM Table Mapping Name without the CX_ prefix.

Physical Type

Depends on the process that Siebel CRM uses with the column.

Length

Type

User Name

Name of the EIM Table Mapping object that Siebel CRM creates for the column.

EIM Processing Column

TRUE

The following table describes an example of the columns that Siebel Tools creates and the default properties. For example, if the target table is CX_SEC_LEV, then Siebel Tools creates an EIM table mapping.

Table Example of EIM Interface Table Columns for Processing a Mapping to a Defined Table

Name Physical Type Length Type User Name EIM Processing Column

T_SEC_LEV_EXS

Character

1

IFMGR: Exists

CX_SEC_LEV

TRUE

T_SEC_LEV_RID

Varchar

15

IFMGR: ROW_ID

CX_SEC_LEV

TRUE

T_SEC_LEV_STA

Number

22

IFMGR: Status

CX_SEC_LEV

TRUE

T_SEC_LEV_UNQ

Character

1

IFMGR: Unique

CX_SEC_LEV

TRUE

EIM Interface Table Columns for Processing a Foreign Key

The following table describes the columns that EIM creates for each foreign key on the target EIM table mapping.

Table EIM Interface Table Columns for Processing a Foreign Key

Column Value

Name

Derived from the target table name and the corresponding foreign key column on the target table using the following format:

PART ONE FOREIGN KEY COLUMN OF THE TARGET TABLE

where:

  • PART ONE is the target table name with the CX_ prefix replaced with T_.

Type

Set to IFMGR: Fkey

Physical Type

Physical type of foreign key column of the target table, which is typically Varchar.

Length

Length of foreign key column of the target table, which is typically 15.

User Name

Derived using the following format:

TARGET TABLE NAME or EIM TABLE MAPPING NAME.FOREIGN KEY COLUMN NAME

The following table describes the EIM table columns that EIM creates if the CX_SEC_LEV table contains the following foreign key column mappings:

  • The OPTY_ID foreign key column mapping references the S_OPTY table

  • The ACCNT_ID foreign key column mapping references the S_ORG_EXT table

Table Example of EIM Interface Table Columns for Processing a Foreign Key

Name Physical Type Length Type User Name

T_SEC_LEV_OPTY_ID

Varchar

15

IFMGR: Fkey

CX_SEC_LEV.OPTY_ID

T_SEC_LEV_ACCNT_ID

Varchar

15

IFMGR: Fkey

CX_SEC_LEV.ACCNT_ID

EIM Interface Table Columns for Foreign Keys

The following table describes the properties of EIM interface table columns for foreign keys. EIM creates a separate foreign key column for each U1 user key column on the foreign key tables.

Table EIM Interface Table Columns for Foreign Keys

Column Value

Name

Derived using the following format:

PART ONE_NAME OF THE FOREIGN KEY COLUMN IN THE TARGET TABLE

where:

  • PART ONE is the first four letters of the foreign key table name without the S_ prefix, and trimmed to remove any trailing underscore (_) characters.

Physical Type

Physical type of the user key column on the target table, which is typically Varchar.

Length

Corresponds to the length of user key columns that the column references, which is typically 15.

Type

Data (Public)

The following table describes properties of interface table columns for foreign keys using CX_SEC_LEV as an example. EIM creates the corresponding EIM columns depending on the base column type.

Table Example of Interface Table Columns for Foreign Keys

Name Physical Type Type

OPTY_BU_ID

Varchar

Data (Public)

OPTY_NAME

Varchar

Data (Public)

OPTY_PR_DEPT_OU_ID

Varchar

Data (Public)

ORG_BU_ID

Varchar

Data (Public)

ORG_NAME

Varchar

Data (Public)

ORG_LOC

Varchar

Data (Public)

EIM Interface Table Columns for Attributes on the Target Table

The following table describes properties of EIM interface table columns for attribute columns on the target table. The EIM interface table column includes the following qualities:

  • Physical Type property is Data (Public)

  • Foreign Key Table property is empty

Table EIM Interface Table Column for Attributes on the Target Table

Column Value

Name

Derived using the following format:

PREFIX_NAME OF THE CORRESPONDING COLUMN IN THE TARGET TABLE

CON and ACCNT are example prefixes.

Physical Type

Data (Public)

Length

Length of corresponding column in the target table.

User Name

Name of corresponding column in the target table.

The following table describes the interface table columns that EIM creates if you enter a prefix of SECL with the following attribute columns in the CX_SEC_LEV table:

  • NAME (Varchar 100)

  • DESC_TEXT (Varchar 250)

  • AUTO_UPDATE (Char 1)

Table Example of EIM Interface Table Columns Attributes on the Target Table

Name Physical Type Length Type User Name

SECL_NAME

Varchar

100

Data (Public)

Security Level Name

SECL_DESC_TEXT

Varchar

250

Data (Public)

Security Level Description

SECL_AUTO_UPDATE

Char

1

Data (Public)

Auto Update Flag

EIM Table Mappings That Reference the Target Table

The following table describes examples of how EIM sets the name and destination columns to the name of the target table. The column properties correspond to the values that EIM creates.

Table Example of EIM Table Mappings That Reference the Target Table

Column Value

Name

CX_SEC_LEV

Destination Table

CS_SEC_LEV

EIM Exists Proc Column

T_SEC_LEV_EXS

EIM Row Id Proc Column

T_SEC_LEV_RID

EIM Status Proc Column

T_SEC_LEV_STA

EIM Unique Proc Column

T_SEC_LEV_UNQ

Attribute Mapping Properties of EIM Interface Columns That EIM Creates

The following table describes properties of the attribute mappings for each EIM interface column that EIM creates.

Table Attribute Mapping Properties of EIM Interface Columns That EIM Creates

Property Value

Name

Attribute column on the target table.

Interface Table Data Column

Name of corresponding EIM interface table column created. For more information, see EIM Interface Table Columns for Attributes on the Target Table.

Base Table Attribute Column

Name of the attribute column on the target table.

Foreign Key Mapping Properties of Foreign Key Columns on the Target Table

The following table describes the properties of each foreign key mapping that EIM creates for each foreign key mapping column on the target table.

Table Foreign Key Mapping Properties of Foreign Key Columns on the Target Table

Property Value

Name

Name of the user key column.

Foreign Key Column

Name of the user key column.

User Key

Name of the U1 user key of the foreign key table.

EIM Foreign Key Proc Column

Corresponding EIM interface table column for foreign key processing derived from the following format:

T_PART ONE_NAME OF THE USER KEY COLUMN

where:

  • PART ONE is the name of the target table without the CX_ prefix.

The following table describes the foreign key mapping, using the CX_SEC_LEV table as an example.

Table Example of Foreign Key Mapping Properties of Foreign Key Columns on the Target Table

Name Foreign Key Column User Key EIM Foreign Key Proc Column

OPTY_ID

OPTY_ID

S_OPTY_U1

T_SEC_LEV_OPTY_ID

ACCNT_ID

ACCNT_ID

S_ORG_EXT_U1

T_SEC_LEV_ACCNT_ID

Foreign Key Mapping Columns for Foreign Key Mappings

The following table describes the properties that EIM sets for each foreign key mapping column. EIM creates a separate foreign key mapping column for each user key column in the user key that is defined for the parent foreign key mapping object in the first table in Foreign Key Mapping Properties of Foreign Key Columns on the Target Table.

Table Foreign Key Mapping Columns for Foreign Key Mappings

Column Value

Name

Name of the foreign key mapping column.

Interface Data Column

EIM interface table column that EIM maps to the user key column on the target table.

EIM creates this EIM interface table column according to the specifications in the table in EIM Interface Table Columns for Foreign Keys.

User Key Attribute

Name of the user key column that is part of the user key defined in the first table in Foreign Key Mapping Properties of Foreign Key Columns on the Target Table.

The following table describes the foreign key mapping, using the CX_SEC_LEV table as an example.

Table Example of Foreign Key Mapping Columns for Foreign Key Mappings

Name Interface Data Column User Key Attribute

OPTY_BU_ID

OPTY_BU_ID

BU_ID

OPTY_NAME

OPTY_NAME

NAME

OPTY_PR_DEPT_OU_ID

OPTY_PR_DEPT_OU_ID

PR_DEPT_OU_ID

ORG_BU_ID

ORG_BU_ID

BU_ID

ORG_NAME

ORG_NAME

NAME

ORG_LOC

ORG_LOC

LOC

Types of Tables and Columns That CIAI Query Supports

The following information lists the types of tables that CIAI query supports.

Table Types of Tables That CIAI Query Supports

Table Type Supported for a CIAI Query

Data (Intersection)

Yes

Data (Private)

Yes

Data (Public)

Yes

Database View

No

Dictionary

No

Extension

Yes

Extension (Siebel)

Yes

External

No

Interface

No

Log

No

Repository

No

The following table lists the types of columns that CIAI query supports.

Table Types of Columns That CIAI Query Supports

Column Type Supported for a CIAI Query

Data (Private)

Yes

Data (Public)

Yes

Denormalized

Yes

Extension

Yes

External

No

IFMGR: Exists

No

IFMGR: FKey

No

IFMGR: Status

No

IFMGR: ROW_ID

No

System

No

The following table lists the physical types of columns that CIAI query supports.

Table Physical Types of Columns That CIAI Query Supports

Physical Type
DB Value Type Supported for a CIAI Query

C

Char

Yes

D

Date

No

L

Long

Yes

L

CLOB

Yes

N

Number

No

S

Time Stamp

No

T

Date Time

No

U

UTC Date Time

No

V

Varchar

Yes

X

Text

Yes

Extensive Code Examples That This Book Uses

This topic includes extensive code examples that this book uses.

Script for the Query Method for Configuring the Hierarchical List Applet

The code in this topic creates test data for the query result. To get data from an external system, the query script you use must contain code that is specific to your requirements. To get the data, you must define your own custom algorithm. For more information about using a virtual business component, see Integration Platform Technologies: Siebel Enterprise Application Integration. For more information about this example, see Configuring a Hierarchical List Applet to Use External Data. For the example in this book, use the following script for the Query of the Hierarchical List Service business service:

function Query( Inputs, Outputs )
{
  var row;

  row = TheApplication().NewPropertySet();

  row.SetProperty("Id", "1");
  row.SetProperty("Description", "Haus");
  row.SetProperty("Amount", "740000");
  row.SetProperty ("Parent Row Id", "");
  row.SetProperty("Has Children", "Y");
  row.SetProperty("Is Expanded", "Y");
  row.SetProperty("Outline Number", "1");
  row.SetProperty("Last Child Info", "1");
  Outputs.AddChild( row );

  row = TheApplication().NewPropertySet();
  row.SetProperty("Id", "1.1");
  row.SetProperty("Description", "T1");
  row.SetProperty("Amount", "240000");
  row.SetProperty("Parent Row Id", "1");
  row.SetProperty("Has Children", "Y");
  row.SetProperty("Is Expanded", "Y");
  row.SetProperty("Outline Number", "1.1");
  row.SetProperty("Last Child Info", "10");
  Outputs.AddChild( row );

  row = TheApplication().NewPropertySet();
  row.SetProperty("Id", "1.1.1");
  row.SetProperty("Description", "Kurant");
  row.SetProperty("Amount", "200000");
  row.SetProperty("Parent Row Id", "1.1");
  row.SetProperty("Has Children", "N");
  row.SetProperty("Is Expanded", "N");
  row.SetProperty("Outline Number", "1.1.1");
  row.SetProperty("Last Child Info", "100");
  Outputs.AddChild( row );

  row = TheApplication().NewPropertySet();
  row.SetProperty("Id", "1.1.2");
  row.SetProperty("Description", "Blanko");
  row.SetProperty("Amount", "40000");
  row.SetProperty("Parent Row Id", "1.1");
  row.SetProperty("Has Children", "N");
  row.SetProperty("Is Expanded", "N");
  row.SetProperty("Outline Number", "1.1.2");
  row.SetProperty("Last Child Info", "101");
  Outputs.AddChild( row );

  row = TheApplication().NewPropertySet();
  row.SetProperty("Id", "1.2");
  row.SetProperty("Description", "T3");
  row.SetProperty("Amount", "500000");
  row.SetProperty("Parent Row Id", "1");
  row.SetProperty("Has Children", "Y");
  row.SetProperty("Is Expanded", "N");
  row.SetProperty("Outline Number", "1.2");
  row.SetProperty("Last Child Info", "11");
  Outputs.AddChild( row );

  row = TheApplication().NewPropertySet();
  row.SetProperty("Id", "1.2.1");
  row.SetProperty("Description", "Kurant");
  row.SetProperty("Amount", "500000");
  row.SetProperty("Parent Row Id", "1.2");
  row.SetProperty("Has Children", "N");
  row.SetProperty("Is Expanded", "N");
  row.SetProperty("Outline Number", "1.2.1");
  row.SetProperty("Last Child Info", "111");
  Outputs.AddChild( row );

  row = TheApplication().NewPropertySet();
  row.SetProperty("Id", "2");
  row.SetProperty("Description", "Auto");
  row.SetProperty("Amount", "13500");
  row.SetProperty ("Parent Row Id", "");
  row.SetProperty("Has Children", "Y");
  row.SetProperty("Is Expanded", "N");
  row.SetProperty("Outline Number", "2");
  row.SetProperty("Last Child Info", "1");
  Outputs.AddChild( row );

  row = TheApplication().NewPropertySet();
  row.SetProperty("Id", "2.1");
  row.SetProperty("Description", "T4");
  row.SetProperty("Amount", "240000");
  row.SetProperty("Parent Row Id", "2");
  row.SetProperty("Has Children", "Y");
  row.SetProperty("Is Expanded", "N");
  row.SetProperty("Outline Number", "2.1");
  row.SetProperty("Last Child Info", "10");
  Outputs.AddChild( row );

  row = TheApplication().NewPropertySet();
  row.SetProperty("Id", "2.1.1");
  row.SetProperty("Description", "Blanko");
  row.SetProperty("Amount", "40000");
  row.SetProperty("Parent Row Id", "2.1");
  row.SetProperty("Has Children", "N");
  row.SetProperty("Is Expanded", "N");
  row.SetProperty("Outline Number", "2.1.1");
  row.SetProperty("Last Child Info", "101");
  Outputs.AddChild( row );

  row = TheApplication().NewPropertySet();
  row.SetProperty("Id", "3");
  row.SetProperty("Description", "Nieren");
  row.SetProperty("Amount", "8000");
  row.SetProperty ("Parent Row Id", "");
  row.SetProperty("Has Children", "Y");
  row.SetProperty("Is Expanded", "N");
  row.SetProperty("Outline Number", "3");
  row.SetProperty("Last Child Info", "1");
  Outputs.AddChild( row );

  row = TheApplication().NewPropertySet();
  row.SetProperty("Id", "3.1");
  row.SetProperty("Description", "T1");
  row.SetProperty("Amount", "8000");
  row.SetProperty("Parent Row Id", "3");
  row.SetProperty("Has Children", "N");
  row.SetProperty("Is Expanded", "N");
  row.SetProperty("Outline Number", "3.1");
  row.SetProperty("Last Child Info", "11");
  Outputs.AddChild( row );

  row = TheApplication().NewPropertySet();
  row.SetProperty("Id", "3.1.1");
  row.SetProperty("Description", "Kurant");
  row.SetProperty("Amount", "8000");
  row.SetProperty("Parent Row Id", "3.1");
  row.SetProperty("Has Children", "");
  row.SetProperty("Is Expanded", "N");
  row.SetProperty("Outline Number", "");
  row.SetProperty("Last Child Info", "");
  Outputs.AddChild( row );

  return( CancelOperation );
}