Skip to main content

Exporting an application

2 Tasks

10 mins

Visible to: All users
Intermediate
Pega Platform '24.2
System Administration
Installation and Deployment
English

Scenario

Development of the HRApps application is complete. You are asked to migrate the application to a testing system. Quality assurance (QA testers) requires that you provide them with an application archive of the HRApps application. The QA testers will import the application archive on the testing system to test the application ahead of application delivery. Your application contains a Ruleset for delegating Rules in a production environment, which must be kept unlocked.

Use the Application Packaging wizard to create a product Rule for the current version of the HRApps application. Include the product Rule in an unlocked application Ruleset. The product Rule includes:

  • All of the associated data types and data instances for the HRApps and HRFW applications (not the Theme-Cosmos application).
  • All of the developer documentation added in the Rule History tabs.

Modify the product Rule so that the delegated production Ruleset is included in the archive. Then, verify that the contents of the product Rule are complete before creating the archive. Finally, use the product Rule to create and save the application archive to your system.

The following table provides the credentials you need to complete the challenge.

Role User name Password
Senior System Architect SSA@TGB pega123!
Note: Your practice environment may support the completion of multiple challenges. As a result, the configuration shown in the challenge walkthrough may not match your environment exactly.

You must initiate your own Pega instance to complete this Challenge.

Initialization may take up to 5 minutes so please be patient.

Challenge Walkthrough

Detailed Tasks

1 Create the product Rule

  1. In the Pega instance for the challenge, enter the following credentials:
    1. In the User name field, enter SSA@TGB.
    2. In the Password field, enter pega123!.
  2. In Dev Studio, from the Configure menu, select Application > Distribution > Package to open the Application Packaging wizard.
  3. In the Application step, select the highest version of the HRApps application, and select the highest unlocked version of the HRApps Ruleset. Click Next to continue.

  4. In step 2, uncheck "Theme-Cosmos 05.01" to omit the standard Cosmos application from the product archive. The system automatically unchecks CEBase, you do not need to re-select it. Click Next to continue.

  5. In the Application Packaging wizard, there are no changes to steps 3-12. Click Next to continue.

  6. Click Finish to display the verification landing page.

2 Modify the product Rule

  1. Click Modify to open the product Rule.
    modify-preview
  2. Select the Custom/Production Rulesets check box for the HRApps application to add the delegated Ruleset to the application archive.
    hrapps_layer
  3. Retain the other default settings to ensure that the data associated with the application Rulesets, Rule history instances, and the application's data types are added to the archive.
  4. OPTIONAL: To avoid overhead maintenance, delete any individual data instances.  
  5. At the bottom of the form, in the File details section, select Allow unlocked Ruleset versions? to ensure that an error does not occur when you attempt to create the archive, as the delegated Ruleset must remain unlocked.

Confirm your work

  1. In the product Rule, in the File details section, click Preview product file to verify the selected Rules, data, and other objects are correct and ready to be packaged in the application archive. 

  2. In the Instances column, click the number to view the details of each class instance. Your results may vary depending on how you completed the exercises.
    Tip: Expand the class names to display the clickable instances.
    The System data information from the Product Preview window.
  3. Click Submit to close the dialog box.
  4. Return to the Application:Distribution form.
  5. On the Export tab, click Export to start the archive process. The number of records may vary depending on how you completed the exercises.
    export-by-application

    When the progress dialog reaches 100%, the archive is available to download.

    Note: You can also export the archive file by clicking on the export option in the newly created product file.
  6. Click Download to access the archive file for import into the QA system.

This Challenge is to practice what you learned in the following Module:


Available in the following mission:

If you are having problems with your training, please review the Pega Academy Support FAQs.

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 Academy has detected you are using a browser which may prevent you from experiencing the site as intended. To improve your experience, please update your browser.

Close Deprecation Notice