App Extensibility: Approve Requests

Use

You can extend the Approve Requests application according to your business needs for different aspects. For this purpose, the following extensibility options are available:

Change the list view (S2)
Change the detail view (S3)
Extend the application with additional views

Extension Points

To extend Approve Requests, you can use the following extension points:

View	Control ID	Use
S2.view.xml	CustomerExtensionForObjectListItem	Allows you to replace the list item template with your custom list item template on the list screen Make sure that the ID of your custom list template is the same as the ID of the standard list item template.
S3.view.xml	CustomerExtensionForObjectHeader	Allows you to replace the header of the detail screen with your custom header
S3.view.xml	CustomerExtensionForInfoTabContent	Allows you to define the content you want to display on the Info tab
S3.view.xml	CustomerExtensionForNoteTabContent	Allows you to define the content you want to display on the Note tab
S3.view.xml	CustomerExtensionForAttachmentTabContent	Allows you to define the content you want to display on the Attachment tab
S3.view.xml	CustomerExtensionForAdditionalTabs	Allows you to create additional tabs
S3.view.xml	CustomerExtensionForAdditionalDetails	Allows you to display additional information on the detail screen.

If there are additional fields available in the OData service, you can display these fields on the UI. For more information, see the extensibility documentation for the respective SAP NetWeaver release on your front-end server at http://help.sap.com/fiori_implementation Start of the navigation path Extensibility Information for SAP Fiori Next navigation step Extending the UI Layer UI Extensibility Workflow Checking the SAP-Enabled Extension Options Extension Points End of the navigation path .

UI Controller Hooks

To plug in and execute custom code, the following hooks are available in the controller code:

Controller	Hook	Use
S2.controller.js	extHookGetCustomFilter	Allows you to create custom filters that can be used for filtering the workflow tasks
S2.controller.js	extHookChangeFilterItems	Allows you to replace the standard filters with custom filters based on the filter key
S2.controller.js	extHookChangeSortConfig	Allows you to change those properties that can be used for sorting the workflow tasks
S2.controller.js	extHookChangeGroupConfig	Allows you to change those properties that can be used for grouping the workflow tasks
S3.controller.js	extHookConfigureAdditionalTabs	Allows you to add a new tab on the detail screen
S3.controller.js	extHookInitAdditionalTabs	Allows you to initialize the new tab
S3.controller.js	extHookChangeFooterButtons	Allows you to add, remove, and change the action buttons (for example, claim, release, and forward) on the detail screen
S3.controller.js	extHookGetEntitySetsToExpand	Allows you to retrieve additional entities from the back-end system
S3.controller.js	extHookOnDataLoaded	Allows you to perform additional requests and process the retrieved data

If there are additional UI controller hooks available in the controller code, you can add own code. For more information, see the extensibility documentation for the respective SAP NetWeaver release on your front-end server at http://help.sap.com/fiori_implementation Start of the navigation path Extensibility Information for SAP Fiori Next navigation step Extending the UI Layer UI Extensibility Workflow Checking the SAP-Enabled Extension Options UI Controller Hooks End of the navigation path .

UI Controls

The following UI controls can be hidden on the app UI.

View	Control ID	Use
S3.view.xml	ARNoteIconTabFilter	Allows you to hide the Note tab on the detail screen
S3.view.xml	ARAttachmentIconTabFilter	Allows you to hide the Attachment tab on the detail screen

For more information about hiding UI controls, see the extensibility documentation for the respective SAP NetWeaver release on your front-end server at http://help.sap.com/fiori_implementation Start of the navigation path Extensibility Information for SAP Fiori Next navigation step Extending the UI Layer UI Extensibility Workflow Checking the SAP-Enabled Extension Options Hiding UI Controls End of the navigation path .

Business Add-Ins (BAdIs)

To extend Approve Requests and add custom code in the Task Gateway Service, you can use the following Business Add-Ins:

BAdIs in the Back-End System

Before Update BAdI (/IWWRK/BADI_WF_BEFORE_UPD_IB)

You can use BAdI /IWWRK/BADI_WF_BEFORE_UPD_IB to handle decision runtime in the following cases:
- Step type for the workflow task is not User Decision.
- You want to execute an action before the work item is updated with the user decision.
For more information, see SAP Help Portal at http://help.sap.com Technology SAP Gateway SAP NetWeaver Gateway 2.0 Content Information Content Guide SAP NetWeaver Gateway Content Guide SAP NetWeaver Gateway Supported OData Channel Scenarios Workflow Services Workflow Task Service: Central Hub Deployment with IW_BEP Backend Installation Workflow User Exits .

BAdIs in the Gateway System

Task Gateway: Change subject in query (/IWPGW/BADI_TGW_TASK_QUERY)

You can use this BAdI to change the task title for all items on the list screen.
Task Gateway: Modify task data (/IWPGW/BADI_TGW_TASK_DATA)

You can use this BAdI to change the task title or task description on the detail screen.
Task Gateway: Provide User details (/IWPGW/BADI_TGW_USER_DETAIL)

You can use this BAdI to change the user details on the detail screen.

For more information, see SAP Help Portal at http://help.sap.com Start of the navigation path Technology Next navigation step SAP Gateway SAP NetWeaver Gateway 2.0 Content Information Content Guide SAP NetWeaver Gateway Content Guide SAP NetWeaver Gateway Supported OData Channel Scenarios Task Gateway Task Gateway Developer Task Gateway User Exits End of the navigation path .

More Information

For a general description of the extensibility options and procedures of SAP Fiori apps, see http://help.sap.com/fiori_implementation Start of the navigation path Extensibility Information for SAP Fiori End of the navigation path .