Registering and activating a wrapper application in Pega Process Fabric Hub
Process work from your remote Salesforce Platform in a unified interface by activating your wrapper application in Pega Process Fabric Hub. After you register and activate your wrapper application, you can take advantage of features such as Interwoven Worklist or Pega Process Fabric Hub Insights, to analyze and process Salesforce entities.
- Log in to Pega Process Fabric Hub.
- In the navigation pane of Pega Process Fabric Hub, click Registered applications.
- In the header of the Registered applications section, click Register application.
- In the Register application dialog box, in the Platform list, select Salesforce.
- In the System URL field, enter the URL of your
Salesforce Platform.Pega Process Fabric Hub uses the system URL for redirecting purposes.
- In the Connector hosted on section, determine where you
want to host your wrapper application with the connector:
Choices Actions The same Pega Process Fabric Hub instance Select Local hub instance. An independent remote system - Select Remote Pega instance.
- In the Connector URL field, enter the URL of your wrapper application that you host on Pega Platform.
- In the Client ID field, enter the
OAuth 2.0 client registration ID that you generate when
creating the OAuth 2.0 client registration.For more information, see Securing a connection between Pega Process Fabric Hub and a wrapper application.
- In the Client Secret field, enter
the client secret that you generate when creating the OAuth
2.0 client registration.For more information, see Securing a connection between Pega Process Fabric Hub and a wrapper application.
- Click Continue.
For example: The following figure shows sample data that the system requires for a wrapper application registration that is hosted in your local hub instance: Registering a wrapper application that is hosted locally 
The following figure shows sample data that the system requires for a wrapper application registration that is hosted in an independent remote system:
Registering a wrapper application that is hosted remotely 
- Continue the process depending on the registration status:
Choices Actions Application registration is successful - In the Register application dialog
box, in the Application list, select
an application that you want to register, and then click
Create, as shown in the following
figure:
Selecting an application 
Result: The landing page of your application opens. Your application has the Pending-Activation status. - Activate your application by performing the actions in step 9.
Application registration fails Analyze and troubleshoot issues that cause registration failure. For more information, see Troubleshooting application registration errors.
- In the Register application dialog
box, in the Application list, select
an application that you want to register, and then click
Create, as shown in the following
figure:
- On the landing page of your application, click Activate
connection, as shown in the following figures:
Activating a wrapper application that is hosted locally 
Activating a wrapper application that is hosted remotely 
Result: Your application has the Sync in progress status, as shown in the following figure: Syncing a wrapper application 
- View the activation result by clicking , and then verify the activation status:
Choices Actions The status is Sync-InProgress The synchronization process is still in progress. Wait until the synchronization is complete and the activation automatically changes the status to Active. The status is Active Your application is active in Pega Process Fabric Hub. You can now manage work in your Interwoven Worklist. The status is Activation-Failure Determine and eliminate the cause of the activation failure: - Analyze the activation error message.For more information, see Troubleshooting application registration errors.
- Fix the issue as necessary.
- In the Activation details section, click Activate connection, and then refresh the page.
- Analyze the activation error message.
- Optional: To use an application icon that corresponds with your business requirements, in
the Application details section, click Change
icon, and then in the icons list, select a new graphic.
For example: For a loan requests application, select an icon with a stack of banknotes, as in the following example: A sample icon to associate with an application 
Result: A list of your registered applications displays icons that are distinguishable and relevant for your applications, as in the following figure: Registered applications list with distinguishable icons 
Previous topic Configuring a Pega Platform wrapper application Next topic Managing applications in Pega Process Fabric Hub