Import a Package of Business Administrative Changes
The Import Changes tab in the Business Administrative Change utility provides the ability to import business administrative changes package on a target Windchill system.
Before importing a package into the target system,
• export the business administrative changes package from the source system
• set com.ptc.windchill.bac.ignoreGUIDList property to All in the target system
To import business administrative changes package, perform the following steps in the target system:
1. Go to the Import Changes tab and click on the Browse button. The file explorer opens.
2. In the file explorer, browse to the location of the package folder that you previously exported from the source system and select it.
Alternatively, you can drag and drop the package folder into the Package box.
3. Select the following options.
The below options allow you to determine if the conflict resolution and attribute mapping choices defined in the target system (integration system) must be carried forward when importing the package into the target system (testing or production system).
◦ Use bundled conflict resolutions — applies the conflict resolutions that are included within the package being imported. For more information, see
Use Bundled Conflict Resolutions.
◦ Use bundled mapping — uses the attribute mappings that are defined within the package during export for the import process. For more information, see
Use Bundled Mapping.
If no option is selected, the import process will never consider any conflict resolution and attribute mapping choices defined in the target system (integration system).
4. Click Import Changes to initiate the import process.
On completion of the import process, the Package Import Status table lists the imported packages along with the import status. The package ID is the unique identifier of the package. This ID can be used later while resolving conflicts to filter the relevant conflicts associated with the package.
Based on the import status of the package, you can perform the following actions on each package:
Status: Succeeded
• Download Report: Downloads import reports locally. The reports contain details of the contents of the package and any associated conflicts, mapping definitions, and conflict resolutions used to import the package.
• Download Zip: Downloads the package ZIP file locally. If new mappings or conflict resolutions were used to successfully import the package, re-downloading the package will generate a new version of the package which contains the latest mappings and conflict resolutions. This is the version of the package to be used for any subsequent downstream imports.
Status: Failed with conflicts
• Download Report: Downloads import report locally.
• Resolve Conflicts and Retry: Launches the Event Management utility to address conflicts and attempts the import again.
• Map Attributes: Opens the Import Mappings tab to map attribute values from the package to the attribute values in the target system.
The
Business Administrative Change framework raises conflicts during import when either data integrity issue is identified or critical references to reconstruct an object are missing in the target system. All conflicts must be addressed to import a package successfully into the target system. For information on possible conflicts and associated resolutions, see
Import conflict and
Delete conflict.
If there are several conflicts listed in the
Event Management utility, enter the ID of the relevant package in the
Search in table box to filter out non-relevant conflicts. Select the
icon in the
Actions column to see the list of conflicts and possible retry options. Then, click
Retry to attempt to import again. For more information, see
Managing Conflicts.
Use the
action to delete the package from the system. Deleting a package from the system deletes the record of the package, but not the associated content.
Use Bundled Conflict Resolutions
Conflict Resolutions are predefined rules or actions set up to handle specific types of conflicts that might occur during the import process.
For example, if there is a conflict type called Container Not Found, and the conflict resolution for this type is set to SKIP, the import process will ignore this conflict and continue.
Use bundled conflict resolutions is an option that, when selected, applies the conflict resolutions that are included within the package being imported. This means the import process will use the conflict resolutions that were defined when downloading the package on the target system (integration system).
If a conflict (Container Not Found) arises during the import process that matches a conflict with a resolution in the Conflict Resolution file (ConflictResolution.xml) in the package, and Use bundled conflict resolutions is selected, the import process will follow the corresponding conflict resolution (SKIP).
As a result, the package will be imported successfully, provided any other object during import does not arise any new conflict.
In case, you do not select the Use Bundled Conflict Resolutions option while importing a package from the target system (integration system), the import fails due to the same conflict (Container Not Found).
Use Bundled Mapping
This refers to using the attribute mappings that are defined within the package for the import process.
For example, if Profile1 was created against OrgA, but the package contains mapping definitions which map OrgA to Demo Organization, selecting Use bundled mapping will result in Profile1 being created under Demo Organization in the target system (testing or production system).
If a conflict (OrgA – Context Not Found) arises during the import process that matches an attribute mapping in the Mapping file (Mapping.xsl) in the package, and Use bundled mapping is selected, the import process will follow the corresponding attribute mapping (Demo Organization).
| If the Use bundled mapping checkbox is selected, it will take precedence over the mapping values defined under the Import Mapping tab. This means that the system will prioritize the mappings included in the package over any mappings defined separately in the Import Mapping tab. |
From a sequencing perspective, attribute mappings take precedence over conflict resolutions. This means that if there is a conflict, the system will first try to resolve it based on the attribute mappings before applying any conflict resolution rules.
For example, when you map OrgA on the source system (integration system) with OrgB on the target system (testing or production system) in the Mapping file (Mapping.xsl), set the conflict resolution to SKIP for Container Not Found conflict, and import a package with two profiles - ProfileA associated with OrgA, and ProfileC associated with OrgC, the following will happen:
• ProfileA will be imported successfully and associated with OrgB as per the defined mapping.
• ProfileC will be skipped because a valid mapping is not defined for it. The conflict resolution rule (SKIP for Container Not Found) causes the system to skip importing the profile.