Configuring Siebel Business Applications > About Business Objects >

Guidelines for Creating a Business Object

You only rarely need to create a new business object. The following situations might require you to create a business object:

• You require a new screen that groups several new business components together.
• You require a group of predefined business components that a predefined business object does not already support.

If you create a business object, then use the following guidelines:

• You can include a business component only one time in each business object.
• You can link a business component to only one other business component in the business object. For more information, see Siebel CRM Can Link An Applet Only to One Other Applet in a View.
• If you create a new business component to support an administration or system activity, then you do not need to create a new business object. Make sure the new business component is part of the predefined business object that Siebel CRM uses to support administration views, then assign the view to the Marketing Administration or System Administration screen.
• Delete any custom business object that Siebel CRM does not use and that does not reference any other object definition, such as a view.
• Other objects might reference an unused business object. Do not delete, deactivate, or rename any predefined business object that Siebel CRM does not use.

Guidelines for Defining the Link Property of a Business Object Component

If any of the following situations exist, then you can define the Link property of a business object component:

• If Siebel CRM can link the business component to more than one business component in the business object. For example, in the Opportunity business object, Siebel CRM can link the Action business component to the Opportunity, Account, or Contact business component.
• If the relationship between the parent business component and the child business component is a many-to-many relationship and where either business component can be the parent. For example, in the Opportunity business object, a relationship exists between the Opportunity business component and the Contact business component. Either business component can be the parent, so you can define the configuration so that Siebel CRM uses the Opportunity/Contact link. This configuration makes sure the Opportunity business object is the parent.

If you do not define the Link property, then Siebel Tools uses the Parent Business Component/Child Business Component link as a default. Siebel Tools sets the following properties for this link:

• The Parent Business Component property is the name of the source business object.
• The Child Business Component property is the value of the destination business component property.

If Siebel Tools cannot find a suitable link, then it displays the business component without a link to any other business component in the parent business object. In this situation, Siebel CRM displays all records that satisfy the search specification of the business component that are independent of the parent business component. This situation could create a problem because the user might not realize that the values in the child business component are not directly related to the parent business component. In reality, these values represent all data for the child business component. If you must display records that possess a parent-child relationship, then you must enter a value for all links. For more information, see Options to Filter Data That Siebel CRM Displays In an Applet.

Siebel CRM Can Link An Applet Only to One Other Applet in a View

Siebel CRM can link a business component to only one other business component in the business object, and it can link an applet to only one other applet in a view. Except for the Home dialog box view, each view includes a parent applet that gets data from the parent business component in the business object. This parent applet can include related applets that get data from other business components. These applets are always child applets of the parent applet. A business component in the business object is the parent business component for the business object or it includes data that is related to the parent business component. For example:

• To display contacts that Siebel CRM relates to an opportunity, it must define a business object component that references the Contact business component. It must define this business object component on the Opportunity business object.
• To display the contacts that Siebel CRM relates to an account, it must define a business object component that references the Contact business component. It must define this business object component on the Account business object.

For more information, see Guidelines for Naming an Object.