Configuring Display Actions Settings

The Display Action Settings page provides an interface for selecting actions, applying styles, and reordering them. You can even create and use your own custom action.

In order to create custom actions, you must first create a custom label.

To create a custom label

Go to Setup > Create > Custom Labels and click New Custom Label.
Type a mandatory Short Description and type a mandatory Name.
In Categories, type comma-separated values that can be used in filter criteria when creating custom label list views. For example Pages, Label, Components, and more.
In Value, type mandatory text in the form of a brief description or copy and paste the field name from Step 1.
Click Save.

A custom label is created and saved.

To change a custom label

Go to Setup > Create > Custom Labels and search for Change” label with Installed Products Change Action as the short description.
Click the Change label. The system displays the Custom Label Detail page.
Click the button, New Local Translations/Overrides in the Local Translations/Overrides section. The system displays the New Translation page.
Select the appropriate language from the drop-down.
Enter the Translation Text as an Add-on in the text box.
Click Save.

The custom label is changed.

To customize display actions

If you want to create and use custom actions, you must have an existing custom label for the action.

Click (All tabs) and click Config Settings.
Click Display Action Settings.
From Display Type, select the page where you want to place the custom action.
From the Flow drop-down, select the flow you want to configure.
The Sequence column is system-generated and based on your Display Type selection in Step 3, the Display Type column displays the line item name. The Action and Action Label Name display the default actions.
You can create a custom Action button, where the Action column name is CustomAction <number> and in Action Label Name column, type the field name of the custom label you created. For example: Action = CustomAction1 and Action Label Name = Edit_Quote.

From the Display As column, select one of the following:


Value	Description
Action	Select this to set the action as an action button
Task	Select this to set the action as Task menu item in the Status bar.
Action and Task	Select this to set the action as both an action button and a Task menu item.
Sidebar Action	Select this to set the action as an action button on the sidebar of the Configuration page. You can define a maximum of 3 actions in the sidebar. Only the first 3 sidebar actions in the list are valid, CPQ does not display the remaining sidebar actions on the Configuration page at all.
Nav Link	Select this to set the action as a hyperlink in the Navigation bar.
Help	Select this to set the action as a Help menu icon.

For the new UI, the behavior is as follows:


Display As	Behavior
Action	Listed as a primary button. Depending on the sequence that you have defined, only one button is placed on the top and the rest of the buttons are placed in the drop-down list.
Task	Listed as a secondary button. A maximum of 4 secondary buttons are allowed on any page.

For example, on the catalog page displayed below, Go to Pricing, Installed Products, Save, and Compare Products have Display As = Task, whereas Abandon, Update Price, Quick Save and Finalize have Display As = Action.

From the Action Area column, select one of the followings to position the action:


Value	Description
Center	Select this for center alignment of the button
Left	Select this for left alignment of the button
Right	Select this for right alignment of the button
More	Select this to add the button as an item under the More action button

Note:

Note that the alignment settings are not applicable for Nova and Grid UI.

In the Action Style Class column, type one of the following available style class name for the action.


Style	Description
apt-selected-btn	Type this to display the button in the drop-down menu with a white background and black font color. This also indicates the step that an end-user is on.
apt-left-btn	Type this to display an arrow pointing left on the button.
apt-right-btn	Type this to display an arrow pointing right on the button.

Note:

If you want to use your own style, create a CSS file including all of the custom styles you want in the shopping cart and upload it as a static resource. Type the name of the CSS file in Config Settings > System Properties > CSS Override. This enables you to use the styles defined in the CSS file as opposed to out-of-the-box styles.

In the Action Page column, in Action Page, type the custom Visualforce page name and in Action Params, type the parameter that you want to pass for your custom page. For example: {!Apttus_QPProposal__ProposalID__c.ID} If you leave the Action Params field blank, by default, the system includes the ID, Business Object ID, and Config Request ID as the dynamic parameter. Example URL: .....CustomVFPage?id=a1Oe00000018DLUEA2&retId=a0ee0000003GUCfAAO&businessObjectId=a0ee0000003GUCfAAO&configRequestId=a1ie0000000kbjTAAQ
From the Behavior column, to specify the action page behavior, select one of the following:
- To open within the same window, select Self.
- To open in a new window, select New Window.
- To open in a dialog, select Dialog Window.
From the Action Type column, select one of the following:
- To redirect to another page using the custom button and not show the spinner, select Quick Redirect. This option ignores the unsaved changes made by the customer before clicking the custom button.
- The other options, such as Save, Quick Save, Submit for Approval, and Generate perform the same function as the out-of-the-box action buttons.
To enable or disable actions, select or clear the Is Enabled check box.

To enable permanent display of the action irrespective of the setting in Step 12, select Always Display check box.


Scenario	Display Action
Is Enabled = True and Always Display = True	Action is displayed.
Is Enabled = False and Always Display = True	Action is displayed but inactive. You cannot click the action.

Click Save to save the changes you made on this page.

The action is added to the list of actions to be displayed on the Visualforce pages. At any given time, if you want to disable the custom action, go to the Display Action Settings page and clear the Is Enabled check box.

Use Case

You can configure action buttons displayed on the Summary panel on the Configuration page. You can add a maximum of 3 buttons on the Summary panel. If you configure more than 3 buttons, only the first 3 buttons are displayed on the Summary panel. The following action buttons are displayed on the Summary panel by default:

Go to Pricing
Update Price
Validate

To configure action buttons on the Summary panel on the Configuration page

Go to All Tabs > Config Settings > Display Action Settings.
From the Display Type drop-down, select Attribute Page.

Note:
You can select Display Type as Bundle Page to configure actions on the sidebar for bundle page in case of sub-bundles.
From the Flow drop-down, select the flow you want to configure.

Find the buttons you want to display on the Summary panel and define the following fields as described:


Field	Value
Display As	Sidebar Action
Action Area	Center

Select the following checkboxes:
- Is Enabled
- Always Display
Click Save.

To hide default action buttons on the Configuration page

Go to All Tabs > Config Settings > Display Action Settings.
From the Display Type drop-down, select Attribute Page.
From the Flow drop-down, select the flow you want to configure
Find the buttons you want to hide and clear the following checkboxes:
- Is Enabled
- Always Display
Click Save.

Conga Product Documentation

Welcome to the new doc site. Some of your old bookmarks will no longer work. Please use the search bar to find your desired topic.