Define Task Pane Actions for a Business Object
Use the Task Pane page in the Business Object Actions window (accessed from the Object Manager within the Blueprint Editor) to define actions that appear in the CSMDesktop Client Task pane for a particular Business Object (ex: Incident). Users can select these actions from a Business Object-specific Actions section in the CSMDesktop Client Task pane (example: Incident Actions) when working with records for a particular Business Object.
Good to Know:
- If you are configuring a Business Object that was previously applied as part of a Protected mApp™ Solution:
- You see a shield icon next to each content-protected action.
- You can add new actions and new print options and you can reorder actions in the list.
- Some actions are not available to users in the Structure area when a Business Object is content-protected: Delete Business Object, Delete Approvals, Convert to Group Object and Delete Group.
To add actions to a Business Object Task pane:
- Open the Business Object Actions window:
- In the CSM Administrator main window, select the Blueprints category, and then select the Create a New Blueprint task.
If working on a saved Blueprint, open the existing Blueprint.
The Blueprint Editor opens, showing the Object Manager in its Main Pane. The Object Manager lists the existing Business Objects.
- In the Object Manager, select a Business Object in the Object tree, and then select the Edit Actions task in the Structure area.
- In the CSM Administrator main window, select the Blueprints category, and then select the Create a New Blueprint task.
- Select the Task Pane page.
- Add actions to the Business Object Task pane:
Select Delete to remove a selected action from the list. Use the Up/Down arrows to change the order of the selected actions.
- Select Add Action.
- Select actions to add to the menu:
- Add One-Step Action Action: Opens the One-Step Action Manager, where you can select an existing One-Step Action or create a new one.
- Add Command Action: Opens the Command Manager, where you can select a command.
- Add Dashboard Action: Opens the Dashboard Manager, where you can select an existing dashboard or create a new one.
- Add Report Action: Opens the Report Manager, where you can select an existing report or create a new one.
- Add Calendar Action: Opens the Calendar Manager, where you can select an existing calendar or create a new one.
- Add Search Action: Opens the Search Manager, where you can select an existing saved search or create a new one.
- Add Visualization Action: Opens the Visualization Manager, where you can select an existing visualization or create a new one.
- Add Action Catalog Action: Opens the Widget Manager, where you can select an existing Action Catalog Widget or create a new one.
- Add Folder: Adds a folder so that you can organize actions into subcategories.
- Define general properties for each new action:
- Action: Displays the name of the action as it is recognized by CSM (example: Name of a dashboard).
Select the ellipsis to open the Action Manager and select a different action.
- Display text: Provide text to display on the action.
- Image button:
Select the image to open the Image Manager, and then select an existing image or import a new image to represent the item in the UI.
- Help text: Provide a tooltip to display when the cursor is on the action.
- Action: Displays the name of the action as it is recognized by CSM (example: Name of a dashboard).
- Optional: Define expressions for conditionally displaying and enabling the action:
- Visible: Select this check box to show/hide the action based on an expression. Then, select or define an expression, using either:
- Stored Expression: Select the ellipsis to open the Expression Manager, and then select an existing stored expression or create a new stored expression. Stored expressions can be reused in numerous places in CSM.
- Custom Expression: Select Custom Expression to open the Custom Expression Builder, and then create a custom expression specifically for this scenario.
- Enabled: Select this check box to enable/disable the action based on an expression. Then, select or define an expression, using either:
- Stored Expression: Select ellipsis button to open the Expression Manager, and then select an existing stored expression or create a new stored expression. Stored expressions can be reused in numerous places in CSM.
- Custom Expression: Select Custom Expression to open the Custom Expression Builder, and then create a custom expression specifically for this scenario.
- Visible: Select this check box to show/hide the action based on an expression. Then, select or define an expression, using either:
- Define additional options for the action:
- Begin Group: Select this check box to display a vertical line or space (depending on the user's selected style) before the toolbar item, separating it from other actions on the toolbar.
-
Select OK.
- Publish the Blueprint (File > Publish Blueprint) to commit the changes, or save the Blueprint (File > Save Blueprint) to continue making other changes.