Data Import/Contact Addresses
Contents
Overview
The contact address importer gives users the ability to import addresses against account and service contacts. While this is a standalone tool, this import was designed to be used after the contact address importer as second stage of a contact + address data set.
The system utilises the Bulk upload processing notification event to send a notification with the results of the bulk approval attempt. You must set up this event and enable it before you use this tool.
If the bulk import is successful, the email notification will advise you when the process is complete.
If the bulk approval is not successful, the email notification will send details of the records that failed to be approved and why.
Preparing your Data
To import contact addresses, you will need to create a CSV data file. You have multiple options to make a more efficient task:
- The Contact Import report used to review and validate a contact import was designed to help you build your address import file. This report can be found under Reports > List > Accounts. If you do not have this report, please contact Emersion.
- you can download the data file below.
media:Contact_address_import.csv
Enter the data into the import sheet. Leave no rows blank. You must ensure the data meets all validation requirements contained in the data definition table below. When you submit the data file for import, the system will parse the file looking for errors. If the system finds no errors, the system will import the notes into the system. The file needs to be error-free in order to import the data. In the event errors are found, no data will be imported into Emersion. Review the bulk upload processing notification email, correct the file and try again.
Importing your Data
To access the contact address import tool:
- Log into Cumulus.
- Nav: Admin > Bulk Import > Contact Address Import
- Click the Browse button and select the csv file containing the data you want to import.
- If you want the bulk upload processing notification email to be sent to a different email address than the address defined in the event template, tick the Override? checkbox and enter an alternative email address. This will only apply for this upload. To change the email address for all future imports, you will need to change the recipient defined in the event template.
- Press Submit
The system will validate the data and if no errors are found, the system will import the data. When the notification email is received, the process has been completed.
The system can parse for invalid data but it cannot check for data accuracy. Therefore it is strongly recommended that you check a few random records to ensure that the import was a success. If you find an problem, you cannot roll back the import.
You have two options should this occur:
- Manually correct the data.
- Request Emersion fix the errors for you. This can be submitted via work order ticket. Please include a note import file with the records that need to be corrected. Do not include details of any records that do not need correcting.
Access Controls
Users will need the Bulk import - contact addresses power to be enabled before they can access the tool.
Data Definition
This section contains a list of the required fields and a definition of what the system considers as valid data. A comprehensive data definition for accounts is located here. The definition table below will not repeat this information and includes supplemental information specific to the contact importer.
| Data field | Description |
| MODEL_TYPE | Free text field. Defines which object the address will link to. The valid entries are listed below and are case sensitive:
MANDATORY |
| MODEL_ID | Integer. The account ID or Service ID. MANDATORY |
| ADDRESS_NOW_PRIMARY | Boolean field. Defines if the address will replace the existing address for whether they wish to be phoned or not for marketing purposes.
OPTIONAL |
| ADDRESS_ADDRESS_TYPE | Enter one of the upper-case 3-letter codes to nominate your address type. MANDATORY
|
| ADDRESS_DISPLAY_TYPE | Free text field. This field affects what other address fields are displayed in the user interface, and also what fields must be completed in the import sheet. This field is case sensitive. Choose from the following options:
MANDATORY |
| ADDRESS_POSTAL_DELIVERY_TYPE | Free text field. This is mandatory for postal addresses. Enter one of the abbreviations below.
|
| ADDRESS_POSTAL_DELIVERY_NUMBER | Integer. This is mandatory for postal addresses. The number corresponding to the address_postal_delivery_type (Locked Bag 6, or GPO Box 123). |
| ADDRESS_COMPLEX_UNIT_TYPE | Free text field. Enter a valid industry code from this list -> Media:Contact_address_import_address_complex_unit_type.csv OPTIONAL |
| ADDRESS_COMPLEX_UNIT_NUMBER | Integer. This is required for complex addresses where the address_complex_unit_type field is populated. |
| ADDRESS_COMPLEX_LEVEL_TYPE | Free text field. Enter a valid code from the list below. OPTIONAL
|
| ADDRESS_COMPLEX_LEVEL_NUMBER | Integer. This is required for complex addresses where the address_complex_level_type field is populated. |
| ADDRESS_STREET_LOT_NUMBER | Integer. OPTIONAL |
| ADDRESS_STREET_NUMBER_START | Integer. MANDATORY |
| ADDRESS_STREET_NUMBER_END | Integer. OPTIONAL |
| ADDRESS_STREET_NAME | Free text field. MANDATORY |
| ADDRESS_STREET_TYPE | Free text field. Enter a valid name from this list -> Media:Contact_address_import_address_street_type.csv. MANDATORY |
| ADDRESS_STREET_SUFFIX | Free text field. Enter a valid name from the list below. This field is case sensitive. MANDATORY
|
| ADDRESS_SUBURB | Free text field. Enter a valid 3-letter code from the list below. This field is case sensitive. MANDATORY |
| ADDRESS_STATE |
|
| ADDRESS_POSTCODE | 4-digit integer. MANDATORY |
| ADDRESS_SITE_NAME | Free text field. OPTIONAL |
| ADDRESS_BUILDING | Free text field. OPTIONAL |
| ADDRESS_COUNTRY | Free text field. Enter a valid FIPS_CODE from this list -> Media:Contact_address_import_countries.csv. MANDATORY |
| EXISTING_ADDRESS_ID | Integer. By default, the importer will create a new physical address entry. To update an existing physical address entry, enter the address ID. OPTIONAL |
