Skip to main content
Version: Adeptia Suite

Generating XML for Retained Objects in the Target System

While promoting the objects, you may want to retain a few objects at the target end. For the objects that are specific to an environment or configuration objects such as User ID, you may not want to promote and overwrite at the target end. For example, when promoting data from the Development environment to the Production environment, the Database Info objects may vary. The objects are the same, but their connection parameters are different. You do not want to overwrite the connection parameters at the target end. The Adeptia migration utility allows you to retain the objects by creating an XML of the objects.

  1. Click Generate Retain XML on the Select Retain XML Location screen to select the objects to be retained. This displays the process in the running state.

    Generate Retain List Process 

  2. Once the process is complete, the Retain List is generated.

    Retain List

  3. This list displays all the objects of the Adeptia Server in a tree-like structure. It has two levels:

    • Service Level
    • Field Level

You can retain objects at both the Service and Field Levels but at a time you can retain object either at service label or field label.

Retaining Objects at Service Level
You can retain an entire service from being transferred. For example, you may want to retain all objects of the Mail Target service. So, instead of individually retaining each object, you can retain the entire Mail Target service. This implies that when the data is transferred, the Mail Target service at the source end will be ignored, and not transferred.

**Steps to retain objects at Service level
**

  1. Select the checkbox against the service that you want to retain.

    You can expand the service by clicking [+] against the service. All fields associated with the activity are displayed. However, they are de-active and cannot be selected.

  2. To retain a specific activity of the service, right-click the service and select Specific Activity option.

    Select Specific Activity Option

  3. This displays the Retain Activity Query Builder screen.

    Retain Activity Query Builder

  4. Specify the criteria on the basis of which the service will be ignored, by entering the activity name and ID in their respective fields.

    You can either enter values in both the Activity Name and Activity ID fields, or in one field only. However, it is mandatory to enter a value in one field.
    If you do not remember the ID of an activity, you can refer to the Production environment or go to the Manage section of the Adeptia Ser

  5. Click Insert. This displays the activity name and ID in the Query Information field.

    Activity Name Displayed in the Query Information Field

    You can specify one or more activities in this screen. All the specified activities are listed as comma separated values in the Query Information field.
    You can remove an activity listed in this field, by selecting the activity and pressing <Delete> on the keyboard.

  6. Click Done to complete the query and return to the previous screen.

  7. Click Generate Retain XML. This generates the XML file for the retained service. This implies that when transferring data, the selected service for the specified activities will be ignored at the source end and not overwritten at the target end.

Retaining Objects at Field Level

At times, you may want to retain values of a specific field only. For example, while transferring data, you want to retain the UserID and Password values of the Mail Target activity. You can retain these fields using the Migration tool. Thus, when data is transferred, values in the UserID and Password fields will be ignored at the source end and not overwritten at the target end.
 

Steps to retain objects at Field level

  1. Click [+] to expand the activity whose field you want to retain. A list of all fields associated with the service is displayed.

    Fields associated with a Service

  2. Select the checkbox of the field that you want to retain. This will retain the field for all objects of the selected service.

    Select Field

  3. To retain the field for a specific service, right-click the field and select Select Activity option. This displays the Retain Activity Query Builder screen.

  4. Specify the criteria on the basis of which the activity will be ignored, by entering the activity name and ID in their respective fields.

    You can either enter values in both the Activity Name and Activity ID fields, or in one field only. However, it is mandatory to enter a value in one field.
    If you do not remember the ID of an activity, you can refer to the Production environment or go to the Manage section of the Adeptia Server.

  5. Click Insert. This displays the activity name and ID in the Query Information field (refer to Figure 34).

    You can specify one or more activities in this screen. All the specified activities are listed as comma separated values in the Query Information field.
    You can remove an activity listed in this field, by selecting the activity and pressing <Delete> on the keyboard.

  6. Click Done to complete the query and return to the previous screen (refer to Figure 32).

  7. Click Generate Retain XML. This generates the XML file for the retained activity. This implies that when transferring data, the field values of the specified activity will be ignored at the source end and not overwritten at the target end.

    The objects that are changed at the Field level are displayed in the Compare Objects screen with the legend. And if you want to retain this value of the target side, the changed value is extracted from the target and transferred to the source, thus implying that the values are same at the source and target end. For example, if the File Path field of the File Source service is changed, then the updated value is extracted from the target end and transferred to the source end of the File Path field. This field is now displayed in the Compare Objects screen with the legend.