JIRA 4.0 : Importing Data From FogBugz
This page last changed on Oct 01, 2009 by alui.
On this page: OverviewThe FogBugz importer allows you to import your bugs from an existing FogBugz installation. Alternatively, you may like to compare JIRA and FogBugz here. Importing from a FogBugz file is a two step process. First, you will need to create a mapping file by running the FogBugz import wizard. (The mapping file is a plain text properties file that you can also manually edit. It will map your CSV fields to fields in JIRA.) Then, to perform the import, simply enter the connection details and the location of your configuration file.
Notes about the FogBugz Importer
Step 1. Running the Import Configuration WizardThe wizard allows you to choose projects, custom fields and issue links to import. Once this is completed, you can save the file on the server and use it in the import process.
To run the FogBugz Import Wizard:
Project ConfigurationThe first step is to choose which projects are to be imported. Choose a valid project key for each project you want to import, and leave blank if you do not wish to import the project. You can also choose a project category that the project should be created in. This will only apply if the project key does not exist and a new project is created.
Issue Field MappingsThe second step is to decide which of the optional FogBugz fields you wish to import. Most of the fields in FogBugz are automatically mapped to appropriate JIRA fields. You can choose to map the fields ixBug (internal FogBugz issue id), sCustomerEmail (e-mail address of the issue if created by e-mail) and sComputer (custom field) to any existing global JIRA custom field.
Value MappingsValue mappings are how values from your FogBugz importer can be 'transformed' during import. The fields sPriority, sFullName, sComputer and sCategory can have their values mapped. The first screen allows you to choose which fields you would like to map values. On the next screen, all unique values for each field you selected to be mapped have been displayed. You can now map any of these values to a new value. Leave the field blank if you wish to import the value as-is. If you want to clear a field, enter the keyword <<blank>>. For sPriority and sCategory you will get a select list with the available values in JIRA. sFullName refers to the usernames that will be created in JIRA. If you don't specify any particular mappings, the user name will be created from the first letter of the first name and the last name, all in lowercase.
Issue LinksFogBugz has two types of links, Duplicates and BugRelations. On this screen, you can map the links to existing JIRA link types. Leave as none to not import the links.
Saving the configuration fileThe final step of the Wizard is to save the file on your server. Please ensure you enter a valid path. You can also choose to continue on with the import without saving the file. You can also see a preview of the mapping file that will be saved. Step 2. Importing the FogBugz fileOnce you have your configuration file, you can now import the FogBugz file into JIRA.
The 'Settings' page gives you precise control over what will be imported on each import run. Once the import has begun you'll be able to follow live progress of the import, with the screen refreshing at around every 10 seconds. You can change this value by updating the field at the bottom of the page. The importer also give you stats about what objects have been imported and time elapsed so you can have an idea as approximately how long the import will take. You can also choose to Abort the import, which will cease importing after the current issue is done. ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() |
![]() |
Document generated by Confluence on Oct 06, 2009 00:25 |