Administrative Utilities → About Data Import → Best Practices for Importing Data
If you are importing new issues into a project, take advantage of SBM's automatic Item ID assignment. If you do not map to the SBM Item ID field, the system will generate Item IDs based on numbering properties for the project you are importing into.
For best results, include a column in the spreadsheet for item types (Requests, for example) and map this column to the system Item Type field. Each spreadsheet row can contain either the Item Type value, such as Request, or a prefix, such as REQ. SBM will match spreadsheet values to Item Type prefixes and values specified in SBM Composer.
If your spreadsheet contains columns that will be mapped to User or Group fields, verify that imported data corresponds to existing login IDs, user, or group names. For example, if data in a row is not matched to user accounts, the row is skipped. New users are not created.
If accounts do not exist for imported items, use the Import Users feature to import users before you import associated data. This enables you to import users as a copy of an existing user, which saves manual configuration later.
For Multi- fields that support group and user names, if you are importing a value that happens to be both a user name and a group name, the import process considers the user name as primary—the import will attempt to match the value to a user name first, and then attempt to match a group name if a user name is not found. If neither match is found, the record is skipped.
Values for selection fields, such as Single/Multi-Selection, Single/Multi-Relational, and User/Multi-User fields, must exist in your system before you can import items that include these values. Spreadsheet rows that contain invalid values for these field types are skipped.
To prevent errors on import, review the guidelines in Field Mapping Considerations and verify that existing values are available before you import data.
You do not need to provide data for required fields in order to import them, but users will need to provide valid values for required fields before they can work with imported items.
If you choose not to import values for required fields during the import process, verify that required fields are visible to users who might update or transition imported items, and that they have permissions to modify required fields.
You can set Multi-Group, auxiliary Multi-Relational, Multi-Selection, auxiliary Single Relational, Single Selection, and User fields to have "None" values after import. This can be useful if you are re-importing data and want to clear previously imported values for fields.
To do so, clear data from spreadsheet rows mapped to applicable fields before the import and be sure to clear the Set default values for empty cells check box in the Field Mapping area.
For best results, use the Import User feature to establish items in the system Contacts table. This ensures that spreadsheet data is correctly mapped to Contacts fields. For details, refer to Spreadsheet Import Options and Mapping Attributes to SBM Fields.
After you establish Contacts records through the Import User feature, you can use the Import Data feature to update additional data for Contacts records as needed.
Copyright © 2007–2015 Serena Software, Inc. All rights reserved.