Data Import/Carrier Site Availability
Contents
Overview
The Carrier Location Availability import tool gives users the ability to import addresses and carrier site availability information that will be used in an address-based SQ.
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
You will need to create a CSV data file comprising the data to be imported. For a sample of the data file, log into Cumulus and follow the steps below:
Nav: Services > Address
- Click on the Export Address List - If you have no addresses, this is fine. The export will generate a CSV file with only the headers that you will need.
- Confirm you want to export all addresses.
- Nav to Reports > Generated Reports
- When your Carrier site availability - Export report is complete press the Download button.
Note the greater number of addresses, the longer the system will need to collate them into a report format. Refresh the tab to view the status for that point in time.
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 Carrier Location Availability import tool:
- Log into Cumulus.
- Nav: Admin > Bulk Import > Contact 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.
Access Controls
This tool is provided to users of service providers with the Infrastructure module enabled. No modules or powers control access to the tool once it has been enabled.
Data Dictionary
Data field | Description |
EMERSION_ID | OPTIONAL. Integer. The ID of the address to be updated. If you are creating a new addresses, leave this field blank. |
GNAF PID | MANDATORY. Free text. The GNAF Identifier. This is required to be unique within the import sheet. The GNAF PID is an external reference for the address. Please populate with an identifier. If the address is your own, use your own reference. |
Unit Number | OPTIONAL. Free text. This is the unit number of the address, if applicable. |
Unit Type Code | OPTIONAL. Free text. Applicable values for physical address data (i.e. Street/Level/Unit reference data) is available from the Physical Address Reference Data report in Cumulus. Users can locate this report under Reports > List > Reference tab. The report name is Physical Address Reference Data. |
Level Number | OPTIONAL. Free text. This is the level number of the address, if applicable. |
Level Type Code | OPTIONAL. Free text. Applicable values for physical address data (i.e. Street/Level/Unit reference data) is available from the Physical Address Reference Data report in Cumulus. Users can locate this report under Reports > List > Reference tab. The report name is Physical Address Reference Data. |
Address Site Name | OPTIONAL. Free text. A name for the site. |
Road Number 1 | MANDATORY. Free text. The street number. If the address spans multiple street numbers, this is the first number. For example if the address was 26-29 Wandering Road, the value entered in this field would be 26. |
Road Number 2 | OPTIONAL. Free text. If the address spans multiple street numbers, this is the second number. For example if the address was 26-29 Wandering Road, the value entered in this field would be 29. |
Lot Number | OPTIONAL. Free text. This is the lot number of the address, if applicable. |
Plan Number | OPTIONAL. Free text. This is the plan number of the address, if applicable. |
Road Name | MANDATORY. Free text. Name of the street/road name. |
Road Suffix Code | OPTIONAL. Free text. Applicable values for physical address data (i.e. Street/Level/Unit reference data) is available from the Physical Address Reference Data report in Cumulus. Users can locate this report under Reports > List > Reference tab. The report name is Physical Address Reference Data. In the data and in Cumulus, this field is called 'Street Suffix' |
Road Type Code | MANDATORY. Free text. Free text. Applicable values for physical address data (i.e. Street/Level/Unit reference data) is available from the Physical Address Reference Data report in Cumulus. Users can locate this report under Reports > List > Reference tab. The report name is Physical Address Reference Data. In the data and in Cumulus, this field is called 'Street Type' |
Locality Name | MANDATORY. Free text. This is the locality name of the address, if applicable. |
State Territory Code | MANDATORY. Free text. Standard code representing the state.
|
Qas Mailing Address1 | MANDATORY. Free text. Enter a fully formatted address that would be a suitable 1st address line. I.e. "26-29 Wandering Road" or "Unit 3, Level 12". |
Qas Mailing Address2 | OPTIONAL. Free text. Enter a fully formatted address that would be a suitable 2nd address line. I.e. "123 Collins Street". |
Qas Mailing Suburb | OPTIONAL. Free text. Enter the suburb. |
Qas Mailing State | OPTIONAL. Free text. Enter the state. |
Qas Mailing Postcode | MANDATORY. Free text. Enter the postcode. |
Qas Bsp | OPTIONAL. Free text. The Barcode Sort Plan (BSP) number for the address. |
Qas Barcode | OPTIONAL. Free text. The barcode number for the address. |
Qas Dpid | OPTIONAL. Free text. The DPID is the Australia Post, Delivery Point Identifier. This is an 8 digit number that is unique to every address in Australia, generated by validating against Australia Post's PAF (Postal Address File). |
Qas Business Residential | OPTIONAL. Used to define if the address is a residential or business Address. Applicable values are:
|
Carrier Location Avail Id | OPTIONAL. Integer. Enter the description ID of the Carrier Location Availability. This field defines if the service is available at the address. |
Gnaf Carrier Locn Profile Id | OPTIONAL. Integer. Enter the Carrier Location Profile ID for the address. In Cumulus this can be found under Services > Infrastructure > GNAF Carrier Location Profiles |
Carrier Location Ident | This is a 9 digit number that is unique to every address in Australia. It is prefixed with 'LOC'. E.g. LOC0000123456. |
Service Availability Desc Id | Defines to what level the service is available based on the service availability matrix. |
Address Update Status | OPTIONAL. Free text. |