Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Activating applications in Pega Process Fabric Hub

Updated on August 26, 2022

Start processing assignments from multiple applications within one window by activating your applications in Pega Process Fabric Hub. After you register and activate your application, you can process Interwoven Worklist that includes tasks from different applications, without logging in and out between the applications.

  1. Log in to Pega Process Fabric Hub as a configurator.
  2. In the navigation pane of Pega Process Fabric Hub, click Registered applications.
  3. In the header of the Registered applications section, click Register application.
  4. In the Register application dialog box, enter the details of the application that you want to add:
    1. In the Platform list, select the platform that stores your application.
      The default option is Pega.
    2. In the System URL field, enter the application alias URL for applications that you host in Pega Platform version 8.4 or later, or the system URL for applications that you host in Pega Platform version 8.3 or earlier.
      Use the https://domain/context-root/auth-servlet-path format.
      For example: Enter
      As part of the remote system URL, you can provide authentication servlet details. Pega Process Fabric Hub uses authentication information during launching the URL to render remote assignments. If you have single sing on (SSO) configured for your application, providing the authentication servlet details ensures that the process involves the correct servlet and users that are already authenticated do not need to perform any additional authentication. As a result, your application uses SSO when a user opens an assignment by using Interwoven Worklist or Next Best Work in Pega Process Fabric Hub.
    3. In the Client ID field, enter the OAuth 2.0 client registration ID that you generate when creating the OAuth 2.0 client registration.
    4. In the Client Secret field, enter the client secret that you generate when creating the OAuth 2.0 client registration.
    5. Click Continue.For example: The following figure shows sample data that an application registration requires:
      Registering an application
      A dialog box that contains information required to register an application.
      In the System URL field, the is a domain name, prweb is a root context, and PRAuth/SSO is the authentication servlet.
  5. Continue the process depending on the registration status:
    Application registration is successful
    1. In the Register application dialog box, in the Application list, select an application that you want to register, and then click Create, as in the following figure:
      Selecting an application
      A dialog box with a list of applications available for registration.
      Result: The landing page of your application opens. Your application has the Pending-Activation status.
    2. Activate your application by performing actions from step 6.
    Application registration failsAnalyze and troubleshoot issues that cause registration failure.

    For more information, see Troubleshooting application registration errors.

  6. On the landing page of your application, click Activate connection, as in the following figure:
    Activating a new application
    A button to activate an application registered to Pega Process Fabric Hub.
    Result: Your application has the Sync in progress status, as shown in the following figure:
    Activating a newly registered application
    A landing page that lists an activation status and details of a newly registered application.
  7. View the activation result by clicking ActionsRefresh, and then verify the activation status:
    The status is Sync-InProgressThe synchronization process is still in progress. Wait until the synchronization is complete and the activation automatically changes the status to Active.
    The status is ActiveYour application is active in Pega Process Fabric Hub. You can now manage work in your Interwoven Worklist.
    The status is Activation-FailureDetermine and eliminate the cause of the activation failure:
    1. Analyze the activation error message.
    2. Fix the issue as necessary.
    3. In the Activation details section, click Activate connection, and then refresh the page.
  8. 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
    An icon with banknotes that corresponds with a banking 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
    A list that displays registered applications that have unique icons.
Result: Pega Process Fabric Hub now fetches assignments from your registered application.For example:
What to do next:
  • Configure the priority of assignments that Pega Process Fabric Hub fetches from your registered application by assigning appropriate weighting. For more information, see Setting the weighting for your applications.
  • Ensure that Pega Process Fabric Hub reflects the latest settings of your application, for example, after you edit work queues, and matches your current business needs by managing application life cycle. For more information, see Managing applications in Pega Process Fabric Hub.
  • Previous topic Creating a secure connection with Pega Process Fabric Hub by configuring OAuth 2.0 authentication
  • Next topic Modification of the default access groups with administrative privileges

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us