Skip to main content


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

Enabling Cosmos React applications for registration

Updated on November 9, 2021

Merge seamless work management and an innovative UI framework by enabling Cosmos React applications for registration with the Pega Process Fabric Hub. By default, Cosmos React applications are not compatible with the Pega Process Fabric Hub, but after you provide a correct data transform configuration, your applications can publish data to the Pega Process Fabric Hub for unified assignment management in your organization.

Before you begin: Install the Pega Process Fabric Hub connector component in your application. For more information, see Installing the Pega Process Fabric Hub connector component.
Note: Enabling Cosmos React applications applies only to applications that you build on Pega Platform version 8.6 by using Cosmos React. If you build your application on the UI Kit or Theme Cosmos, or an earlier version of Pega Platform, skip this procedure and continue the registration process. For more information, see Establishing communication between the Pega Process Fabric Hub and Pega Platform by editing dynamic system settings.

For more information, see User interface and Cosmos React (early adopter).

After you install the Pega Process Fabric Hub connector component, your application includes an empty Assign-.pyPF_SetRequest data transform. When you provide correct configuration for this data transform, you can register your Cosmos React application with the Pega Process Fabric Hub.

  1. In the navigation pane of Dev Studio, click Records.
  2. Expand the Data Model category, and then click Data Transform.
  3. In the list of data transform instances, open the Assign-.pyPF_SetRequest data transform, as in the following figure:
    Opening the Assign-.pyPF_SetRequest data transform
    A list of data transform instances with the .pyPF_SetRequest data transform that applies to Assign- class
  4. On the Definition tab, define the data transform by entering the following values:
    RowActionTargetRelationSource
    1WhenRequestPage.status != "Resolved"Not applicableNot applicable
    1.1RemoveRequestPage.actionsNot applicableNot applicable
    1.2Update PageRequestPage.actions(<APPEND>)Not applicableNot applicable
    1.2.1Set.IDequal to"redirect"
    1.2.2When!Application.pyIsConstellationAppNot applicableNot applicable
    1.2.2.1Comment"?"+@(Pega-RULES:Utilities).pzEncryptURLActionString(tools,"Global","pyActivity=pyMobileSnapStart&Action=openAssignment")+"&InsHandle="+Primary.pzInsKey+"&InsClass="+Primary.pxObjClass+"&pyShowFullPortal=true"Not applicableNot applicable
    1.2.2.2Set.hrefequal to"?"+@(Pega-RULES:Utilities).pzEncryptURLActionString(tools,"Global","pyActivity=pyMobileSnapStart&Action=openAssignment")+"&InsHandle="+Primary.pzInsKey+"&InsClass="+Primary.pxObjClass+"&pyShowFullPortal=true"
    1.2.3OtherwiseNot applicableNot applicable
    1.2.3.1Comment@pxIndexInPageListIgnoreCase(.pxRefObjectClass,"pyWorkTypeImplementationClassName",Application.pyWorkMetaData)Not applicableNot applicable
    1.2.3.2SetParam.WorkMetaIndexequal to@pxIndexInPageListIgnoreCase(.pxRefObjectClass,"pyWorkTypeImplementationClassName",Application.pyWorkMetaData)
    1.2.3.3WhenParam.WorkMetaIndex>-1Not applicableNot applicable
    1.2.3.3.1Comment"/"+@toLowerCase(Application.pyWorkMetaData(Param.WorkMetaIndex).pyWorkTypeName)+"s/"+@whatComesAfterLast(.pxRefObjectKey,' ')Not applicableNot applicable
    1.2.3.3.2Set.hrefequal to"/"+@toLowerCase(Application.pyWorkMetaData(Param.WorkMetaIndex).pyWorkTypeName)+"s/"+@whatComesAfterLast(.pxRefObjectKey,' ')
    1.2.4Set.titleequal to"Redirect and Open"
    1.2.5Set.typeequal to"Get"
    For example: The following figure shows a correctly completed data transform:
    Assign-.pyPF_SetRequest data transform
    Definition of the data transform to register a Cosmos React application with the Pega Process Fabric Hub
  5. On the Pages & Classes tab, define data pages that the data transform accesses by entering the following values:
    1. In the Page name field, enter RequestPage, and then, in the Class field, enter $NONE.
    2. Click Add item.
    3. In the Page name field, enter RequestPage.actions(), and then, in the Class field, enter $NONE.
  6. Click Save.
What to do next: Continue with registering your application. For more information, see Establishing communication between the Pega Process Fabric Hub and Pega Platform by editing dynamic system settings.
    • Previous topic Installing the Pega Process Fabric Hub connector component
    • Next topic Establishing communication between the Pega Process Fabric Hub and Pega Platform by editing dynamic system settings

    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