Adeptia provides a intuitive interface to create an export package that contains the objects you want to migrate from one environment of Adeptia Connect to another. After you've created the export.zip file, you can import the objects using import.xml fileby using the Import Package option under Solution Promotion feature at the target environment. A successful import completes the migration process, and you'll be able to access all the objects in your new environment.
Tip |
---|
You may want to configure the solution promotion properties described in the Solution Promotion Configuration section on the Microservice Settings - Webrunner page before you begin the import operation. |
Prerequisite
- Make sure that you have the required permissions to view and use the Solution Promotion option on the Account menu feature. To have this permission, the role that you have been assigned must have Allow Solution Promotion to migrate objects checkbox selected in ithavethe required permissions on the Solution Import entity. To know more, refer to the documents Creating a Role and Permission model.
- Ensure that you have followed the migration prerequisites mentioned on this page.
You can create import the export package objects by following the steps given below.
- Click Account > Solution Tools > Solution Promotion
- On the left panel, select Export Import Packages.
Click CREATE Export Import Package.
On the Create Export Package Import Package screen,
In the Select Export Criteria field, select the criteria based on which you would like to export the objects.
Project Allows you to export all the selected projects and the activities associated with them. Service Type Allows you to export all the activities of selected services. Individual Activities Allows you to pick and export the activities of a selected Service Type. To further filter the activities to be exported based on their last modified date, use
Add Filter Condition checkbox for Project and Service Type export criteria.
Apply Filter field for Individual Activities export criteria.
If you have selected either of the checkboxes Export Files/Folders or Export Solution on the first screenTip Provide a name for the
import package.
Provide a description for the
import package.
In the Select Project field, select the project where you want to keep the
import package.
Select the Export Files/Folders checkbox if you want to select and export the additional files/folders on the screen that follows.
Select the Export Solution checkbox if you want to export data from database tables on the screen that follows.
Click Continue.
In the Override User field, select the user to whom you want to provide ownership of the activities.
In the Override Modified By User field, select the user who will be reflected in the Modified By field of every activity after the deployment.
- Select the Retain Activities checkbox if you want to retain the services at the target environment, and then click Browse to select the required Retain XML file.
- Select the Solution Database checkbox if you want to import data to the solution database to be specified in the next screen.
- If you have selected Solution Database checkbox, continue following the steps from step
- 6, else perform step
- 5.
- If you have not selected
- Click Save & Exit.
- Click Next.
- If you have selected the checkbox Export Files/Folders, follow the steps from 11 through 13.
Click Save & Exit.
If you have selected the checkbox Export Solution, follow the steps from 15 through 18.
Click Next.
- any of the checkboxes (Retain Activities or Solution Database), or selected only the Retain Activities checkbox, perform step 5, else perform the steps from step 6.
Click Save & Exit.
- Click Continue.
In the Database Info section, provide provide the following details of the database containing the tables that solution database to which you want to exportimport data.
Type Enter the type of database. For example MySQL, SQL, etc. Server Enter the hostname of the database server. Port Enter the port number of the database server. Name Enter the name of the database. Username Enter the username to access the database. Password Enter the password to access the database. In the Solution Tables section, you can further apply the conditions for exporting database tables.
Table Name Enter the name of the tables you want to export. Where Clause Write a conditional query to export selective data or leave it blank to export all the data from the table. Click Save & Exit.
In the Target Zip Location field, if you wish, you can change the name and location for the exported ZIP file which is created during migration.Info This field contains a predefined name and the location for the exported ZIP file.Click Export Metadata to download the Export XML file.Click Save & Exit.
This creates the import package that gets listed in the Import Packages mange page.Click More under ACTION against the package, and then click Import Package.
- On the Import Package screen, click Browse to select the Export ZIP file.
- Click Import.
This imports the objects to the target environment and also creates a corresponding Rollback ZIP that can be used to rollback the import operation. You can visit the Dashboard to view the details of the import operation.You can also perform the following actions on the package from its More menu under ACTION:
- Perform the rollback operation.
- Edit, delete, or view the import package.
Select Folder to export folders or sub folders within them, and provide the details as described in the following table.
Enter the comma-separated list of files you want to exclude from the folders/subfolders during export.
Select File to export the files, and provide the details as described in the following table.
Anchor | ||||
---|---|---|---|---|
|
If you decide upon rolling back the import operation, you need to follow the instructions given below.
- Download the Rollback ZIP file corresponding to the import package from the Dashboard by navigating as follows:
Dashboard > Solution Promotion > More > Rollback ZIP - Go to the Import Packages manage page by navigating as follows:
Account > Tools > Solution Promotion > Import Packages - Click More under ACTION against the import package, and then click Rollback.
- On the Rollback screen, click Browse to select the Rollback ZIP you have downloaded in step 1.
- Click Rollback.
This rolls back the import operation.
You can go to Dashboard > Solution Promotion to see the details of the rollback operation.
...