Skip to main content

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

Exporting an application, product rule, or ruleset to an archive or repository by using the Export wizard

Updated on July 8, 2022

Export rules from a Pega Platform system into an product rule, archive file, or repository by using the export wizard. An archive is useful for sharing rulesets between instances of Pega Platform.

Do not create an archive when any rule that you want to export is checked out. If a rule is checked out, the original version of the rule is included in the archive, but the checked-out version of the rule is not included. An error message lists the checked-out rules.

When creating an archive file name, consider the following:

  • Use a file name that is valid for both the destination server and the current server.
  • The ".zip" suffix is optional.
  • You cannot include spaces or an equal sign character (=) in the file name.
  1. In the header of Dev Studio, click ConfigureApplicationDistributionExport.
  2. Select an export mode to determine the scope of the contents of the .zip file.
    • By Application – Create an archive file that contains all rules and data in an application.
    • By RuleSet/Version – Create an archive file that contains all rules in a ruleset and version (or all versions).
      Note: If you have one or more rulesets that use Application Validation (AV) mode, select only one application to associate with the AV ruleset.
    • By Product – Create an archive file that contains rules and data that are defined by an existing product rule ( Rule-Admin-Product rule type).
    • By Patch – Create an archive file that contains rules and data that are defined by an existing product patch rule ( Rule-Admin-Product-Patch rule type).
    • Archive On Server – Download a copy of any archive file that is already in the ServiceExport directory of an application to your workstation or another directory on your local area network. Click a .zip file from the list to download.
      Note: If you have direct access to the file system on your server, you can copy the .zip file using File Transfer Protocol (FTP) rather than using this option.
  3. Click Perform export.
  4. Save the archive to your file system or export it to a repository.
    1. To save the archive to your local file system, click the Download link.
    2. To export the archive to a repository, enter the Repository name and click Export.
  5. To display error messages (if any), click the Total Errors link in the lower right corner of the display form.
What to do next: Use the Import wizard to import the files to another system.

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