com.atlassian.jira.imports.project

Class DefaultProjectImportManager

java.lang.Object

com.atlassian.jira.imports.project.DefaultProjectImportManager

All Implemented Interfaces:

ProjectImportManager

public class DefaultProjectImportManager
extends Object
implements ProjectImportManager

Since:

v3.13

Constructor Summary

Constructors

Constructor and Description

DefaultProjectImportManager(BackupXmlParser backupXmlParser, org.ofbiz.core.entity.DelegatorInterface genericDelegator, ApplicationProperties applicationProperties, IssueManager issueManager, IssueLinkManager issueLinkManager, CustomFieldManager customFieldManager, AutomaticDataMapper automaticDataMapper, ProjectImportValidators projectImportValidators, ProjectImportPersister projectImportPersister, UserUtil userUtil, GroupManager groupManager, ProjectRoleManager projectRoleManager, ProjectManager projectManager, ProjectRoleAndActorStore projectRoleAndActorStore, AttachmentStore attachmentStore, com.atlassian.plugin.PluginAccessor pluginAccessor, java.time.Clock clock)

Method Summary

Modifier and Type	Method and Description
void	autoMapAndValidateCustomFields(ProjectImportData projectImportData, MappingResult mappingResult, BackupProject backupProject, I18nHelper i18nBean) Performs an automatic mapping of the custom fields from the backup system to the current systems custom field's and validates that all mappings are possible.
void	autoMapAndValidateIssueTypes(ProjectImportData projectImportData, MappingResult mappingResult, BackupProject backupProject, I18nHelper i18nBean) Performs an automatic mapping of the IssueTypes from the backup system to the current systems issue types and validates that all mappings are possible.
void	autoMapCustomFieldOptions(ProjectImportData projectImportData, BackupProject backupProject) Performs an automatic mapping of the custom field options from the backup system to the current systems values.
void	autoMapProjectRoles(ProjectImportData projectImportData) Performs an automatic mapping of the project roles from the backup system to the current systems values.
void	autoMapSystemFields(ProjectImportData projectImportData, BackupProject backupProject) Performs an automatic mapping of the system fields from the backup system to the current systems system field values The fields that are mapped are: Priority Resolution Status IssueLinkTypes Projects IssueSecurityLevels
void	createMissingUsers(UserMapper userMapper, ProjectImportResults projectImportResults, TaskProgressInterval taskProgressInterval) Creates all the Missing users that we have details for.
void	doImport(ProjectImportOptions projectImportOptions, ProjectImportData projectImportData, BackupProject backupProject, BackupSystemInformation backupSystemInformation, ProjectImportResults projectImportResults, TaskProgressInterval taskProgressInterval, I18nHelper i18n, ApplicationUser importAuthor) This will perform the project import based on the mappings provided.
List<ValidationMessage>	doPluginValidation(BackupProject backupProject, TaskProgressInterval sysFieldSubInterval, I18nHelper i18n) Call any plugin handlers that have registered to do validation
BackupOverview	getBackupOverview(String pathToBackupXml, TaskProgressSink taskProgressSink, I18nHelper i18n) Parses through the provided JIRA XML backup file and creates a BackupOverview.
ProjectImportData	getProjectImportData(ProjectImportOptions projectImportOptions, BackupProject backupProject, BackupSystemInformation backupSystemInformation, TaskProgressProcessor taskProgressProcessor) Parses through the provided JIRA XML backup file and creates a MappingResult.
void	importProject(ProjectImportOptions projectImportOptions, ProjectImportMapper projectImportMapper, BackupProject backupProject, ProjectImportResults projectImportResults, TaskProgressInterval taskProgressInterval) This will create or update a project and all its versions, components, and project role membership.
void	importProjectRoleMembers(Project project, ProjectImportMapper projectImportMapper, ProjectImportResults projectImportResults, TaskProgressInterval taskProgressInterval)
void	validateCustomFieldValues(ProjectImportData projectImportData, MappingResult mappingResult, BackupProject backupProject, TaskProgressProcessor taskProgressProcessor, I18nHelper i18n) Parses the partitioned custom field value XML and gets the custom fields to validate that they can handle the values.
void	validateFileAttachments(ProjectImportOptions projectImportOptions, ProjectImportData projectImportData, MappingResult mappingResult, BackupProject backupProject, BackupSystemInformation backupSystemInformation, TaskProgressProcessor taskProgressProcessor, I18nHelper i18n) Parses the partitioned file attachment XML and validates that the referenced file attachment exists in the user provided attachment directory.
void	validateSystemFields(ProjectImportData projectImportData, MappingResult mappingResult, ProjectImportOptions projectImportOptions, BackupProject backupProject, TaskProgressInterval taskProgressInterval, I18nHelper i18nBean) Validates that all mappings are possible.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultProjectImportManager

public DefaultProjectImportManager(BackupXmlParser backupXmlParser,
                                   org.ofbiz.core.entity.DelegatorInterface genericDelegator,
                                   ApplicationProperties applicationProperties,
                                   IssueManager issueManager,
                                   IssueLinkManager issueLinkManager,
                                   CustomFieldManager customFieldManager,
                                   AutomaticDataMapper automaticDataMapper,
                                   ProjectImportValidators projectImportValidators,
                                   ProjectImportPersister projectImportPersister,
                                   UserUtil userUtil,
                                   GroupManager groupManager,
                                   ProjectRoleManager projectRoleManager,
                                   ProjectManager projectManager,
                                   ProjectRoleAndActorStore projectRoleAndActorStore,
                                   AttachmentStore attachmentStore,
                                   com.atlassian.plugin.PluginAccessor pluginAccessor,
                                   java.time.Clock clock)

Method Detail

getBackupOverview

public BackupOverview getBackupOverview(String pathToBackupXml,
                                        TaskProgressSink taskProgressSink,
                                        I18nHelper i18n)
                                 throws IOException,
                                        SAXException

Description copied from interface: ProjectImportManager

Parses through the provided JIRA XML backup file and creates a BackupOverview.

If the optional parameter taskProgressSink is provided, then it is used to send information about the progress of this operation. This is used for the "Long Running Task" progress bar.

Specified by:

getBackupOverview in interface ProjectImportManager

Parameters:

pathToBackupXml - must be a valid path, on disk, to a valid JIRA XML backup file.

taskProgressSink - Used to provide progress feedback, can be null.

i18n - used to internationalize the error messages

Returns:

a BackupOverview populated with the information gleaned from the JIRA XML backup.

Throws:

IOException - if there is a problem reading/finding the file

SAXException - if something goes wrong with processing the XML

getProjectImportData

public ProjectImportData getProjectImportData(ProjectImportOptions projectImportOptions,
                                              BackupProject backupProject,
                                              BackupSystemInformation backupSystemInformation,
                                              TaskProgressProcessor taskProgressProcessor)
                                       throws IOException,
                                              SAXException

Description copied from interface: ProjectImportManager

Parses through the provided JIRA XML backup file and creates a MappingResult. The result will contain an initialProjectImportMapper and the paths to the partitioned XML files (created for the provided BackupProject).

Specified by:

getProjectImportData in interface ProjectImportManager

Parameters:

projectImportOptions - User options for the project import, including the pathToBackupXML, attachmentPath, and "overwriteProjectDetails" flag.

backupProject - is the selected project that is used to inform creation of a mapper and a subset of XML data files.

backupSystemInformation - system-wide info from the backup file.

taskProgressProcessor - Used to provide progress feedback, can be null.

Returns:

ProjectImportData which holds the initial projectImportMapper and the partitioned XML file paths for the project XML data that was partitioned from the main XML backup.

Throws:

IOException - if something goes wrong handling the backup or partitioned XML files

SAXException - if something goes wrong with processing the XML

createMissingUsers

public void createMissingUsers(UserMapper userMapper,
                               ProjectImportResults projectImportResults,
                               TaskProgressInterval taskProgressInterval)
                        throws AbortImportException

Description copied from interface: ProjectImportManager

Creates all the Missing users that we have details for. This

Specified by:

createMissingUsers in interface ProjectImportManager

Parameters:

userMapper - The UserMapper which is used to determine missing users.

projectImportResults - used to collect the statistics of what was created during the import, if it was a success, and any errors that may have occurred.

taskProgressInterval - used to show task progress to the user while this long running task is happening.

Throws:

AbortImportException - if the import is aborted due to too many errors.

importProjectRoleMembers

public void importProjectRoleMembers(Project project,
                                     ProjectImportMapper projectImportMapper,
                                     ProjectImportResults projectImportResults,
                                     TaskProgressInterval taskProgressInterval)
                              throws AbortImportException

Throws:

AbortImportException

importProject

public void importProject(ProjectImportOptions projectImportOptions,
                          ProjectImportMapper projectImportMapper,
                          BackupProject backupProject,
                          ProjectImportResults projectImportResults,
                          TaskProgressInterval taskProgressInterval)
                   throws AbortImportException

Description copied from interface: ProjectImportManager

This will create or update a project and all its versions, components, and project role membership.

If the project does not exist then it will be created with default schemes and the details from the ExternalProject from the backup file.

If the project exists then the details will be updated to match that of the ExternalProject.

This will also have the side-effect of populating the ProjectImportMapper.getProjectMapper() and the ProjectImportMapper.getVersionMapper() and ProjectImportMapper.getComponentMapper().

Specified by:

importProject in interface ProjectImportManager

Parameters:

projectImportOptions - Contains user inputted options related to the project import.

projectImportMapper - contains the project, version, and component mappers. If the external projects id is not mapped then this method will try to create the project.

backupProject - contains the project details used to clobber an existing project or as the details for the new project

projectImportResults - used to collect the statistics of what was created during the import, if it was a success, and any errors that may have occurred.

taskProgressInterval - used to show task progress to the user while this long running task is happening.

Throws:

AbortImportException - if the import is aborted due to errors.

doImport

public void doImport(ProjectImportOptions projectImportOptions,
                     ProjectImportData projectImportData,
                     BackupProject backupProject,
                     BackupSystemInformation backupSystemInformation,
                     ProjectImportResults projectImportResults,
                     TaskProgressInterval taskProgressInterval,
                     I18nHelper i18n,
                     ApplicationUser importAuthor)
              throws IOException,
                     SAXException,
                     IndexException

Description copied from interface: ProjectImportManager

This will perform the project import based on the mappings provided. Calling this method will create a projects issues and all issue related data.

Specified by:

doImport in interface ProjectImportManager

Parameters:

projectImportOptions - User options for the project import, including the pathToBackupXML, attachmentPath, and "overwriteProjectDetails" flag.

projectImportData - contains a projectImportMapper that has been through the automatic mapping and validation process and the paths, on disk, to the partitioned xml files.

backupProject - contains the import project details.

backupSystemInformation - system-wide info from the backup file.

projectImportResults - used to collect the statistics of what was created during the import, if it was a success, and any errors that may have occurred.

taskProgressInterval - used to show task progress to the user while this long running task is happening.

i18n - used to internationalize the error messages

importAuthor - the user who is performing the project import, this is used as the author of the change item marker for created issues @throws IOException if something goes wrong handling the partitioned XML files @throws SAXException if something goes wrong with processing the XML @throws IOException if something goes wrong handling the backup or partitioned XML files

Throws:

IOException - IOException

SAXException - if something goes wrong with processing the XML

IndexException - if there is a problem re-indexing JIRA.

validateCustomFieldValues

public void validateCustomFieldValues(ProjectImportData projectImportData,
                                      MappingResult mappingResult,
                                      BackupProject backupProject,
                                      TaskProgressProcessor taskProgressProcessor,
                                      I18nHelper i18n)
                               throws IOException,
                                      SAXException

Description copied from interface: ProjectImportManager

Parses the partitioned custom field value XML and gets the custom fields to validate that they can handle the values. Sets the map of custom field MessageSets in the MappingResult. This will also use the custom field options validator to validate the values of the custom fields that use the built in options.

Specified by:

validateCustomFieldValues in interface ProjectImportManager

Parameters:

projectImportData - which holds the initial projectImportMapper and the partitioned XML file paths for the project XML data that was partitioned from the main XML backup.

mappingResult - this was the result containing the path to the partitioned XML files and the ProjectImportMapper

backupProject - the selected project to import

taskProgressProcessor - Used to provide progress feedback, can be null.

i18n - used to internationalize the error messages

Throws:

IOException - if something goes wrong handling the partitioned XML files

SAXException - if something goes wrong with processing the XML

validateFileAttachments

public void validateFileAttachments(ProjectImportOptions projectImportOptions,
                                    ProjectImportData projectImportData,
                                    MappingResult mappingResult,
                                    BackupProject backupProject,
                                    BackupSystemInformation backupSystemInformation,
                                    TaskProgressProcessor taskProgressProcessor,
                                    I18nHelper i18n)
                             throws IOException,
                                    SAXException

Description copied from interface: ProjectImportManager

Parses the partitioned file attachment XML and validates that the referenced file attachment exists in the user provided attachment directory.

If any files do not exist a warning will be added to the file attachment message set in the mapping result.

NOTE: this validation only happens if ProjectImportOptions.getAttachmentPath() is non-null meaning that the user wants to restore attachments.

Specified by:

validateFileAttachments in interface ProjectImportManager

Parameters:

projectImportOptions - User options for the project import, including the pathToBackupXML, attachmentPath, and "overwriteProjectDetails" flag.

projectImportData - which holds the initial projectImportMapper and the partitioned XML file paths for the project XML data that was partitioned from the main XML backup.

mappingResult - this was the result containing the path to the partitioned XML files and the ProjectImportMapper

backupProject - the selected project to import

backupSystemInformation - system-wide info from the backup file.

taskProgressProcessor - Used to provide progress feedback, can be null.

i18n - used to internationalize the error messages

Throws:

IOException - if something goes wrong handling the partitioned XML files

SAXException - if something goes wrong with processing the XML

autoMapAndValidateIssueTypes

public void autoMapAndValidateIssueTypes(ProjectImportData projectImportData,
                                         MappingResult mappingResult,
                                         BackupProject backupProject,
                                         I18nHelper i18nBean)

Description copied from interface: ProjectImportManager

Performs an automatic mapping of the IssueTypes from the backup system to the current systems issue types and validates that all mappings are possible. Any errors or warninigs will be reported through MappingResult.getIssueTypeMessageSet().

Specified by:

autoMapAndValidateIssueTypes in interface ProjectImportManager

Parameters:

projectImportData - which holds the initial projectImportMapper and the partitioned XML file paths for the project XML data that was partitioned from the main XML backup.

mappingResult - this was the result containing the path to the partitioned XML files,the ProjectImportMapper, and the MessageSets

backupProject - the selected project to import

i18nBean - used to internationalize the error messages

autoMapAndValidateCustomFields

public void autoMapAndValidateCustomFields(ProjectImportData projectImportData,
                                           MappingResult mappingResult,
                                           BackupProject backupProject,
                                           I18nHelper i18nBean)

Description copied from interface: ProjectImportManager

Performs an automatic mapping of the custom fields from the backup system to the current systems custom field's and validates that all mappings are possible. Any errors or warnings will be reported through the MappingResult.getCustomFieldMessageSet().

Specified by:

autoMapAndValidateCustomFields in interface ProjectImportManager

Parameters:

projectImportData - which holds the initial projectImportMapper and the partitioned XML file paths for the project XML data that was partitioned from the main XML backup.

mappingResult - this was the result containing the path to the partitioned XML files,the ProjectImportMapper, and the MessageSets

backupProject - the selected project to import

i18nBean - used to internationalize the error messages

autoMapCustomFieldOptions

public void autoMapCustomFieldOptions(ProjectImportData projectImportData,
                                      BackupProject backupProject)

Description copied from interface: ProjectImportManager

Performs an automatic mapping of the custom field options from the backup system to the current systems values. This should only ever happen if the custom fields have been mapped and validated.

Specified by:

autoMapCustomFieldOptions in interface ProjectImportManager

Parameters:

projectImportData - which holds the initial projectImportMapper and the partitioned XML file paths for the project XML data that was partitioned from the main XML backup.

backupProject - the selected project to import

autoMapProjectRoles

public void autoMapProjectRoles(ProjectImportData projectImportData)

Description copied from interface: ProjectImportManager

Performs an automatic mapping of the project roles from the backup system to the current systems values.

Specified by:

autoMapProjectRoles in interface ProjectImportManager

Parameters:

projectImportData - which holds the initial projectImportMapper and the partitioned XML file paths for the project XML data that was partitioned from the main XML backup.

autoMapSystemFields

public void autoMapSystemFields(ProjectImportData projectImportData,
                                BackupProject backupProject)

Description copied from interface: ProjectImportManager

Performs an automatic mapping of the system fields from the backup system to the current systems system field values The fields that are mapped are:

• Priority
• Resolution
• Status
• IssueLinkTypes
• Projects
• IssueSecurityLevels

Specified by:

autoMapSystemFields in interface ProjectImportManager

Parameters:

projectImportData - which holds the initial projectImportMapper and the partitioned XML file paths for the project XML data that was partitioned from the main XML backup.

backupProject - the selected project to import

validateSystemFields

public void validateSystemFields(ProjectImportData projectImportData,
                                 MappingResult mappingResult,
                                 ProjectImportOptions projectImportOptions,
                                 BackupProject backupProject,
                                 TaskProgressInterval taskProgressInterval,
                                 I18nHelper i18nBean)

Description copied from interface: ProjectImportManager

Validates that all mappings are possible. Any errors or warnings will be reported through the field's MessageSet on the MappingResult. The fields that are validated are:

• Priority
• Resolution
• Status
• Project Roles
• Project Roles Membership
• Groups
• IssueLinkTypes
• Users
• Description, Environment and Comment length

Specified by:

validateSystemFields in interface ProjectImportManager

Parameters:

projectImportData - which holds the initial projectImportMapper and the partitioned XML file paths for the project XML data that was partitioned from the main XML backup.

mappingResult - this was the result containing the path to the partitioned XML files,the ProjectImportMapper, and the MessageSets

projectImportOptions - Contains user inputted options related to the project import.

backupProject - the selected project to import

taskProgressInterval - Used to provide progress feedback, can be null.

i18nBean - used to internationalize the error messages

doPluginValidation

public List<ValidationMessage> doPluginValidation(BackupProject backupProject,
                                                  TaskProgressInterval sysFieldSubInterval,
                                                  I18nHelper i18n)

Description copied from interface: ProjectImportManager

Call any plugin handlers that have registered to do validation

Specified by:

doPluginValidation in interface ProjectImportManager

Parameters:

backupProject - the selected project to import

sysFieldSubInterval - Used to provide progress feedback, can be null.

i18n - used to internationalize the error messages

Returns:

A Set of Messages