Import rules and data instances from your file system or repository into your Pega Platform instance by using the Import wizard. Rules, data, and other artifacts in the imported file are added to the rules that are already in this system. Use the Import wizard to upload archives up to 1 GB in size; for larger files, use File Transfer Protocol (FTP) or another means to place the file into the ServiceExport directory.

• Ensuring that users migrate applications with a pipeline by restricting the Import wizard

  You can restrict access to the Import wizard so that users migrate applications between environments by using a deployment pipeline instead of by importing applications through the wizard. By creating a deployment pipeline, you can use a standardized process to migrate applications.

• Importing custom XML files for input streams

  Use custom XML files for use as an input stream by importing the XML files as a Java archive (JAR) and extracting the files using an activity.

• Importing custom Java archives and classes

  Incorporate third-party Java functionality into Pega Platform™ by importing a Java archive (JAR) file or class.

• Pre-import and post-import collections

  Add steps to the pre-import and post-import collections to take specific actions based on archive metadata. Pre-import steps run before every archive import attempt. Post-import steps run after every successful archive import.

• Selecting a file to import

  Select an archive file of rules and data instances to import.

• Setting advanced mode and reviewing the archive contents

  Optionally use advanced mode to review and select the archive contents before you import the archive. You can also set additional import options for schema and rule changes.

• Updating dependent applications

  You can select the built-on applications for which you want to update dependent applications. If a dependent application is built on an application for which there is a later version, it is automatically updated to use the latest version of the built-on application after you import the archive.

• Viewing and applying schema changes

  Review the list of schema changes to determine whether to proceed with the import and either automatically apply the schema changes, or download a SQL DDL script that defines the changes and manually apply the DDL to the database.

• Inserting new instances by importing an archive

  Specify which new instances in the archive are added to the target system.

• Addressing older instances in an import archive

  If your target system includes instances that are newer than the instances in the archive, specify which instance to keep.

• Automatically populating new columns in existing tables

  If an import adds columns to existing tables, use advanced mode to automatically expose and populate the new columns after the import.

• Scheduling indexes for population

  If the archive you import includes new indexes, schedule a post-import job to add and populate the new indexes.

• Resolving pre-existing rule conflicts

  If your import archive includes rule instances that are already present in the target system, resolve the conflict before you continue the import.

• Changing the built-on version of an application to the current version

  If you imported an application that was built on an earlier major version of Pega Platform and did not automatically update dependent applications to be built on the latest version of the application, edit the application definition to include the current version.

• Using restore points to enable error recovery
• Pre-import and post-import collections
• Temporary files