Data Import/Carrier Site Availability

From Emersion
Revision as of 09:12, 19 April 2017 by Scarpenter (talk) (Data Dictionary)
Jump to: navigation, search

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

  1. 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.
  2. Confirm you want to export all addresses.
  3. Nav to Reports > Generated Reports
  4. 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:

  1. Log into Cumulus.
  2. Nav: Admin > Bulk Import > Contact Import
  3. Click the Browse button and select the CSV file containing the data you want to import.
  4. 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.
  5. 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

Carrier Location Availability Data Definition table
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.
  • VIC = Victoria
  • SA = South Australia
  • NSW = New South Wales
  • QLD = Queensland
  • NT = Northern Territory
  • ACT = Australian Capital Territory
  • WA = Western Australia
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:
  • R = Residential
  • B = Business
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 MANDATORY 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.