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 August 26, 2022

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

Note: Enabling Cosmos React applications applies only to applications that you build in Pega Platform version 8.6 by using Cosmos React. If you build your application in the Theme 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 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 and an empty Work-.pyPF_SetCaseRequest data transform. When you provide correct configuration for the data transforms, you can register your Cosmos React application with 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. Click Save as, and then save the rule in your application ruleset.
  5. 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 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/ or es/ or ies/>"+@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 Pega Process Fabric Hub.
  6. 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.
  7. Click Save.
  8. In the navigation pane of Dev Studio, click Records.
  9. Expand the Data Model category, and then click Data Transform.
  10. In the list of data transform instances, open the pyPF_SetCaseRequest data transform, as in the following figure:
    Opening the Work-.pyPF_SetCaseRequest data transform
    A list of data transform instances with the pyPF_SetCaseRequest data transform that applies to Work- class.
  11. Click Save as, and then save the rule in your application ruleset and corresponding case type class.
  12. On the Definition tab, define the data transform by entering the following values:
    RowActionTargetRelationSource
    1RemoveRequestPage.actionsNot applicableNot applicable
    2Update PageRequestPage.actions(<APPEND>)Not applicableNot applicable
    2.1Set.IDequal to"redirect
    2.2When!Application.pyIsConstellationAppNot applicableNot applicable
    2.2.1Comment"?"+@(Pega-RULES:Utilities).pzEncryptURLActionString(tools,"Global","pyActivity=pyMobileSnapStart&Action=openWorkByHandle&InsHandle="+Primary.pzInsKey+"&pyShowFullPortal=true&ThreadName="+Primary.pyID)Not applicableNot applicable
    2.2.2Set.hrefequal to"?"+@(Pega-RULES:Utilities).pzEncryptURLActionString(tools,"Global","pyActivity=pyMobileSnapStart&Action=openWorkByHandle&InsHandle="+Primary.pzInsKey+"&pyShowFullPortal=true&ThreadName="+Primary.pyID)
    2.3OtherwiseNot applicableNot applicableNot applicable
    2.3.1Comment@pxIndexInPageListIgnoreCase(.pxObjClass,"pyWorkTypeImplementationClassName",Application.pyWorkMetaData)Not applicableNot applicable
    2.3.2SetParam.WorkMetaIndexequal to@pxIndexInPageListIgnoreCase(.pxObjClass,"pyWorkTypeImplementationClassName",Application.pyWorkMetaData)
    2.3.3WhenParam.WorkMetaIndex>-1Not applicableNot applicable
    2.3.3.1Comment"/"+@toLowerCase(Application.pyWorkMetaData(Param.WorkMetaIndex).pyWorkTypeName)+"s/"+@whatComesAfterLast(.pzInsKey," ")Not applicableNot applicable
    2.3.3.2Set.hrefequal to"/"+@toLowerCase(Application.pyWorkMetaData(Param.WorkMetaIndex).pyWorkTypeName)+"s/"+@whatComesAfterLast(.pzInsKey,' ')
    2.4Set.titleequal to"Redirect and Open"
    2.5Set.typeequal to"Get"
    For example: The following figure shows a correctly completed data transform:
    Work-.pyPF_SetCaseRequest data transform
    Definition of the data transform to register a Cosmos React application with Pega Process Fabric Hub.
  13. On the Pages & Classes tab, define the data pages that the data transform accesses:
    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.
    4. Click Save.
What to do next: Continue with registering your application. For more information, see Establishing communication between 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 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