connect-sap-s-4hana-and-sap-task-center-143af9b.md

Connect SAP S/4HANA and SAP Task Center

Find information about the destination configuration that needs to be done for SAP Task Center in order to work with on-premise tasks from SAP S/4HANA on SAP BTP, Cloud Foundry environment.

Prerequisites

Tip:

See also the step-by-step mission for the setup of connection to SAP S/4HANA at Integrate Your SAP S/4HANA Tasks Into SAP Task Center.

• You have completed the initial setup of SAP Task Center. For more information, see Initial Setup. Make sure you have followed the SAP S/4HANA Integration Scenario.

• You have performed the steps in Prepare SAP Cloud Connector and SAP S/4HANA for the SAP Task Center Connection. Choose your SAP S/4HANA version from the dropdown menu next to the documentation title.

  Make sure you save the following information, as you need it for the SAP S/4HANA destination setup:

  • (Optional) Location ID from step Perform the initial configuration of the Cloud Connector and define location ID

    Note:

    Location ID is a mandatory property for the creation of the destination only if you have more than one Cloud Connectors in the subaccount.

  • Virtual Host and Virtual Port from step Configure access control in the Cloud Connector for your SAP S/4HANA back-end system

• Create a dedicated service instance for SAP Task Center in the Cloud Foundry subaccount, where your initial SAP Task Center instance was created. This enables task updates to be pushed from your ABAP system. Follow the steps in Create a Service Instance Using the SAP BTP Cockpit and create a service key for the service instance. Open the JSON file of the service key and get the following values:

  • endpoints > inbox_rest_url
  • uaa > url
  • uaa > clientid
  • uaa > clientsecret

• You have performed the steps in Integrating SAP Task Center and have a user name and password for granting access to the task pull service, as described in Create Service User for Task Pull Service.

  Use the prepared SAP Cloud Connector for the step Tunnel the request using, for example, the Cloud Connector in Configuring SAP Task Center Integration.

• You have the client number of your SAP S/4HANA system.

Note:

Do not configure more than one destination to the same SAP S/4HANA system for one SAP Task Center. This will result in having duplicate tasks for end users.

Procedure

1. Navigate to the Cloud Foundry subaccount, where your SAP Task Center instance was created, and select the Destinations tab from the navigation area on the left.

2. If you have executed the automatic setup (see Automatic Setup), you already have a sample destination called S4HANA. You can use the sample destination or clone it, and update the properties as described below.

   If you have followed the manual setup (see Manual Setup), you have to create a new destination and manually add the properties as described below.

3. Configure the properties of the destination as follows:

   Property	Description	Example or Value
   Name	Configure a destination name. It can be up to 16 characters long. Note: The name of the destination must not be longer than 16 characters, otherwise the status of the respective SAP Task Center connector will be set to Error.	Example: S4HANA
   Type	Choose the HTTP option from the dropdown menu.
   Description	(Optional) Add a description.
   URL	Create the URL by following the pattern <Virtual Host>:<Virtual Port>, using the values you've got when configuring the access control in the SAP Cloud Connector. For more information, see Prerequisites. Note: If you change the URL of an already configured destination, for which there are stored tasks in the Task Cache, the tasks in it will be repopulated.
   Proxy type	Choose the OnPremise option from the dropdown menu.
   Authentication	Choose the BasicAuthentication option from the dropdown menu.
   User	Add the service user for task pull service. For more information, see Prerequisites.
   Password	Add the password for the service user for task pull service. For more information, see Prerequisites.
   Location ID	(Optional) Provide the Location ID that you configured in the initial configuration of the SAP Cloud Connector. For more information, see Prerequisites.

   Additional Properties:

   Property	Description	Example or Value
   tc.enabled	Enables the SAP Task Center to connect to the configured task provider destination. Caution: If you are using the sample destinations created by the booster (see Automatic Setup), you must add the tc.enabled property manually. Without this property, the destination cannot be used by SAP Task Center. Note: Any value other than true (for example false) would have the following effects: The previously stored tasks are kept in the task cache. The tasks from this destination are not displayed in the SAP Task Center Web app. The Task Cache is not updated with tasks from this destination. If you want to delete the task cache and repopulate it for this destination, see Repopulate the Task Cache.	Value: true
   tc.clientId	This property is used to enable task updates to be pushed from SAP S/4HANA. The value of this property is the value of the uaa > clientid from the service key of the new service instance (see Prerequisites). Note: Set this property only when you have completed Integrating SAP Task Center from the Prerequisites section. If you haven't completed this step, you might not be able to receive tasks from SAP S/4HANA.	Value of clientid
   tc.notifications.enabled	(Optional) Enable this property to turn on the notifications for end users. Accepted values are true and false. The default value is false. If no value is provided, the property is set to false. Note: Any value other than true and false sets the connector in status Warning.	Example: true
   tc.provider_type	Type of the task provider.	S/4HANA
   tc.ui.group and tc.ui.group.[language_code]	(Optional) Provides grouping for the SAP Task Center Web app Filter Tabs. You can define a separate property for a filter tab translation for each of the supported languages (see Supported Languages), by appending the respective language code to the property. For example, add: the tc.ui.group property with the value <default_translation> for a default translation of the group name. the tc.ui.group.de-DE property with the value <German_translation> for a German translation of the group name. For more information, see Configure Filter Tabs in the SAP Task Center Web App.	Example: SAP S/4HANA
   tc.ui.label and tc.ui.label.[language_code]	(Optional) Provides additional information about the task. The value of the property is displayed in the Task column of the SAP Task Center Web app under the Task Title. You can define a separate property for a task label translation for each of the supported languages (see Supported Languages), by appending the respective language code to the property. For example, add: the tc.ui.label property with the value <default_translation> for a default translation of the label. the tc.ui.label.de-DE property with the value <German_translation> for a German translation of the label. For more information, see Configure Labels in SAP Task Center Web App.	Example for tc.ui.label: SAP S/4HANA Task Example for tc.ui.label.de-DE: SAP S/4HANA Aufgabe
   URL.queries.sap-client	The client number of the SAP S/4HANA system.	Example: 100

4. Save your configuration.

5. (Optional) To check the connectivity between the SAP Task Center service and SAP S/4HANA, use the monitoring functionality of SAP Task Center. For more information, see Monitoring.

   If you choose Check Connection in the destination configuration, you may not receive correct information about the connectivity between the SAP Task Center service and SAP S/4HANA.