Siebel Business Process Framework: Task UI Guide > Developing a Task UI > Developing a Task UI That Uses Transient Data >

Creating a Transient Business Component

If your task UI requires transient data, then you must create a transient business component. It is strongly recommended that you use the Transient Business Component Wizard to create a transient business component. For more information, see Overview of Transient Data.

To create a transient business component

1. Determine if your task UI must use a transient business component. If your task UI does not require a transient business component, then quit this procedure.

   For more information, see Determining if You Must Use a Transient Business Component.

2. In Siebel Tools, choose the File menu, and then the New Object menu item.
3. In the New Object Wizards dialog box, choose the Task tab.
4. Choose the Transient BusComp icon, and then click OK.
5. In the New Business Component Wizard, define properties in the New Business Component dialog box using values from the following table.

   Property	Description
   Project	Choose a value from the drop down list. The wizard only lists projects that are locked.
   Name	Enter a text string that describes the task UI.
   MultiRecord TBC checkbox	Optional. If you are creating a multirecord transient business component, then make sure the MultiRecord TBC option includes a check mark. For more information, see About the Multirecord Transient Business Component.

6. Click Finish.

   The wizard automatically does the following work:

   • Assigns the transient business component to the S_TU_LOG table.
   • Sets the Type property of the business component to Transient.
   • Displays a new record for the transient business component in the Business Components list.
7. In the Object Explorer, expand the Business Component tree, and then click Field.
8. In the Fields list, create a new field for the transient business component.
9. Define values for the following properties of the field you created in Step 8:
   • Name
   • Type
   • Text Length

     CAUTION:  The Type property is a required property. The Text Length property is not a required property. However, it is recommended that you define a value for the Text Length property so that Siebel CRM can accurately determine the size of the Column property. If a field of type DTYPE_TEXT includes an undefined text length, then Siebel CRM uses a length of 255 characters. If the actual length is shorter than 255 characters, and if you do not define the Text Length property, then Siebel CRM might create an unnecessary join to an extension table, or even fail to map the field to the correct corresponding column.

     Note the following:

   • Siebel Tools automatically enters data in the Column property.
   • The Column and Join properties are read only.
   • You cannot define a multivalue field.
   • Siebel Tools allows a calculated field. It does not assign a column to a calculated field.
10. Repeat Step 8 and Step 9 for each additional field you must define.

Setting the Type Property of a Business Component

Note the following:

• The Type property for a business component is Nontransient.
• The Type property for a transient business component is Transient.

If you set the Type property for a business component to Transient or Nontransient, then you cannot modify it, even through a copy operation.

Creating a Transient Business Component Manually

You can use the Business Components list to manually create a transient business component. However, it is recommended that you use the Transient Business Component Wizard to create a transient business component instead of using the Business Components list. Siebel Tools automatically defines the Column property and the Join property and sets them to read only. Make sure you set the following properties to exactly the same values that the Transient Business Component Wizard uses:

• Class
• Table
• Type

It is strongly recommended that you use the Transient Business Component Wizard to make sure that you correctly define the CSSBCTaskTransient class and the CSSBCTaskTransientBase class. For more information, see Classes That Siebel CRM Uses with a Transient Business Components.