Skip to main content


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

Activating applications in the Pega Process Fabric Hub

Updated on November 9, 2021

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

Before you begin: Ensure that the connection between your applications and the Pega Process Fabric Hub is secure. For more information, see Creating a secure connection with the Pega Process Fabric Hub by configuring OAuth 2.0 authentication.
  1. Log in to the Pega Process Fabric Hub as a configurator.
  2. In the navigation pane of the 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 on Pega Platform version 8.4 or later, or the system URL for applications that you host on Pega Platform version 8.3 or earlier.
      Use the https://domain/context-root/auth-servlet-path format.
      For example: Entering https://uplustelco.com/prweb/PRAuth/SSO.
      As part of the remote system URL, you can provide authentication servlet details. The 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 the Interwoven Worklist or Next Best Work in the 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 uplustelco.com 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:
    ChoicesActions
    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 the 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:
    ChoicesActions
    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.
    If the status is ActiveYour application is active in the Pega Process Fabric Hub. You can now manage work in your Interwoven Worklist.
    If 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 graphics.
    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 dispalys registered applications that have unique icons
Result: The Pega Process Fabric Hub now fetches assignments from your registered application.
For example:
What to do next:
  • Configure the priority of assignments that the 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 the 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 the Pega Process Fabric Hub.
    • Previous topic Creating a secure connection with the Pega Process Fabric Hub by configuring OAuth 2.0 authentication
    • Next topic Extensions to Pega Process Fabric worklists

    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.

    Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

    Close Deprecation Notice
    Contact us