CustomApplicationComponent

Represents a custom console component (Visualforce page) assigned to a CustomApplication that is marked as a Salesforce console. Custom console components extend the capabilities of Salesforce console apps. See Customize a Console with Custom Components in Salesforce Classic in Salesforce Help.

This type extends Metadata and inherits its fields.

Custom application components have the suffix .customApplicationComponent and are stored in the customApplicationComponents folder.

Custom applications are available in API version 25.0 and later.

• Type: string
• Required: No
• Description: The address of a page that hosts an icon for the button.

• Type: string
• Required: No
• Description: The inline style used to define how the button looks.

• Type: string
• Required: No
• Description: The label on the button used to launch the custom console component.

• Type: int
• Required: No
• Description: The pixel width of the button displayed in the Salesforce console.

• Type: int
• Required: No
• Description: The pixel height of the window used to display the custom console component.

• Type: boolean
• Required: Yes
• Description: Required. Indicates whether users can change the custom console component height (false) or not (true).

• Type: boolean
• Required: Yes
• Description: Required. Indicates whether the custom console component is hidden from users (true) or not (false).

• Type: boolean
• Required: Yes
• Description: Required. Indicates whether users can change the component width (false) or not (true).

• Type: string
• Required: Yes
• Description: Required. Name of the Visualforce page that represents the custom console component.

• Type: int
• Required: No
• Description: The pixel width of the window used to display the custom console component.

The following is the definition of a custom application component:

1<?xml version="1.0" encoding="UTF-8"?>
2<CustomApplicationComponent xmlns="http://soap.sforce.com/2006/04/metadata">
3    <buttonIconUrl>https://salesforce.com</buttonIconUrl>
4    <buttonStyle>buttonStyleCSS</buttonStyle>
5    <buttonText>buttonText</buttonText>
6    <buttonWidth>200</buttonWidth>
7    <height>200</height>
8    <isHeightFixed>false</isHeightFixed>
9    <isHidden>false</isHidden>
10    <isWidthFixed>false</isWidthFixed>
11    <visualforcePage>MyVisualforcePage</visualforcePage>
12    <width>50</width>
13</CustomApplicationComponent>

This metadata type supports the wildcard character * (asterisk) in the package.xml manifest file. For information about using the manifest file, see Deploying and Retrieving Metadata with the Zip File.