Siebel CRM Desktop for Microsoft Outlook Administration Guide > XML Files Reference > XML Code to Customize Toolbars >

Toolbars Tag of the toolbars.xml File

The toolbars tag is the root tag of the toolbars.xml file. It describes the toolbar that Siebel CRM Desktop adds to a native Microsoft Outlook form or Microsoft Outlook window.

The caption attribute of the toolbars tag defines the caption of the toolbar.

The toolbars tag includes the following tags:

• for. Determines if Siebel CRM Desktop displays this tag in a Microsoft Outlook window or Microsoft Outlook form, depending on if the value of the for tag is explorer or inspector.
• button. A description of a button on a toolbar. For more information, see Button Tag of the Toolbars Tag of the toolbars.xml File.

Button Tag of the Toolbars Tag of the toolbars.xml File

The button tag includes the following attributes:

• name. The caption for the button.
• small_image. The resource ID of the icon that Siebel CRM Desktop uses as the small icon for this button.
• large_image. The resource ID of the icon that Siebel CRM Desktop uses as a large icon for this button. The large_image attribute is valid for Microsoft Outlook 2007 but is ignored for Microsoft Outlook 2003.
• begin_group. Determines if Siebel CRM Desktop displays the separator of the toolbar button for this button. It is useful if you must group toolbar buttons.

Action Tag of the Button Tag

The button tag includes the action tag, which defines the action that Siebel CRM Desktop calls if the user clicks the button. You can use a predefined action or write a custom action. You must set this action in the class attribute of the action tag.

The action tag includes the class attribute. The class attribute can include the following values:

• create_attachment. Opens the Select Attachment dialog box to allow the user to choose a file to attach to the current object. To define which object can contain an attachment, use the accept_type attribute. The accept_type attribute defines the visibility of the button, depending on which object type is currently chosen. The value of the accept_type attribute must be the object type for which you must make this button visible.
• create_linking_item. Creates a new object and associates it with the current object. You can also define the object types for which this button is visible. These object types must be described by type tags that reside in a types tag.

The action tag includes the attachment tag. To define attachment settings, you must define the following attributes of the attachment tag:

• type. The type of the attachment object.
• name_field. The name of the field of the attachment object where Siebel CRM Desktop stores the name of the file.
• body_field. The name of the field of the attachment object where Siebel CRM Desktop stores the body of the file.
• linking_field. The name of the field of the attachment object where Siebel CRM Desktop stores the reference to the parent object.

Example Code of the Action Tag of the Scriptable Action

Siebel CRM Desktop supports the scriptable action class. The action tag of the scriptable action includes the id attribute. You can use the id attribute in a script to specify the action to perform. The following example specifies a button with a scriptable action:

<button id="new_account" name="#btn_new_account">

<action class="scriptable" id="new_account"/>

</button>

In this example, Siebel CRM Desktop passes the value for the new_account attribute to the script when it handles the click event of the button. The script includes predefined logic that the new_account attribute starts.