Note : Before you proceed with the following instructions, back up the database. If your organization integrates multiple Blackbaud products, refer to the Additional Requirements section of the backup article. Carefully read all of the instructions listed below before proceeding. If you are new to importing, also refer to How to import - the basics of importing (BB58904).

  1. Create a data file or use an existing file.

    View a sample data file (7AddrAttribute.csv) which imports a new attribute on Mia Patras's home address and updates the attribute on Christopher Young's vacation home address in the sample database. You may need to widen the columns to view all of the information in a column. The sample file was tested in version 7.71.936. Other versions may vary slightly in the available fields.

    You can save the file in any delimited format or in fixed length. However, this example and the sample data file are in CSV format

  2. Include the following fields in your import data file (for a sample file, which includes all of these fields, refer to step 1 above). The fields in bold italics are required by The Raiser's Edge. Refer to the notes below the list of fields for additional information. 
    • Headers*
      , CADAttrImpID, CADAttrCat, CADAttrDesc, CADAttrDate, CADAttrCom* Although headers are not required in The Raiser's Edge 7, we recommend using them. Otherwise, you must manually map the fields in the data file to the corresponding fields in The Raiser's Edge.
    • Corresponding Field Names
      Constituent Address Attribute Address Import ID, Constituent Address Attribute Import ID, Constituent Address Attribute Category, Constituent Address Attribute Description, Constituent Address Attribute Date, Constituent Address Attribute Comments Note: The Constituent Address Attribute Address Import ID field in the data file must be populated with the Address Import ID for the address to which the attribute is being added or updated. If this field is not included in the data file, refer to BB54664 for information on how to add it to the file. 

      Note: Each attribute must be in a separate row as in the sample file from step 1. The Constituent Address Attribute Import ID is required to be in the data file for the import. However, it only needs to be populated when updating an existing address attribute.

      In Excel, use Text as the column type for any field with leading zeroes. Otherwise, Excel drops the leading zeros.

      Refer to the Constituent Address Attribute Fields section of the Import Guide (PDF) for a list of available fields (layout table) and for what each is used. In versions 7.5 and above, you can also access the layout table from the Fields tab in the import parameters.
  3. In Import, select Constituent Address Attribute from the Constituent node. Click New and select the following parameters. For more information on what these parameters mean, refer to How to import in The Raiser's Edge 7 - The Basics of Importing (BB58904).

    General Tab:
    • What do you want to do? Update Existing records
    • Options Import records not found as new records
    • What file to you wish to import? Browse to the import file
    • How do you want the system to identify existing constituents? Use the Import ID**
    • What is the format of this import file? Delimited
    File Layout Tab:
    • Field Separators and Text Qualifiers: Comma, Quotation
    • Import Field Names: Field names are on the first line of the import file
    • Sample Import Format: Verify the first few rows of the import file  
    Fields Tab:
    In the Import Fields frame, verify that all rows in the Field to Import column are correctly mapped to the corresponding field in the Raiser's Edge Field column.

    Summary Tab:
    We recommend marking all available checkboxes. At the very least, mark the Create control report option.