Connection Import/Match (Water District Match Import)

Modified on Thu, 17 Jan 2019 08:48 by Freddy Donovan — Categorized as: Address Book, Import- Export Manager, Tapping and Inspection, Task Management, Time and Material, Water and Wastewater Services


General Information

Default Menu Location: Transaction >> Importers/Exporters >> Tasks and Time Billing >> Connection Import/Match

Screen Name: WATERMATCH2

Function: Imports or updates service address/connection information for addresses within a district based on an excel spreadsheet.

The following Organization Attributes need to exist in the Organization Attributes (ATT_ENT) rule before creating Districts, Builders, Subdivisions, and Connections:


If you are using the Tapping application, the Tap Sizes (TAPS) rule must be set up prior to importing connection records.



Key Data Fields



Keep in mind that the customer number field only allows for 10 characters max. So, if you district number is long, or you have thousands of connections to import, you may run into auto-numbering issues since the system can't create a customer number over 10 digits.



Connection Import/Match screen

Connection Import/Match screen


Import Screen Fields/Filters

File Name/Browse: Use the Browse button to locate and select the completed Connection Import template file (in XLS format).

Export Template: Generates a blank Connection Import template file

Map Fields: Fields must be mapped prior to importing. If no changes have been made to the column headings, the mapping screen should show all green, and you can click OK to continue. If any of the Input Field Name columns on the left are red, single-click on the line on the left column, and then double-click the desired mapped field in the right column to complete the mapping. Repeat for any red lines on the left that should be mapped. If there are additional columns in the source file that should NOT be mapped, they can be left unmapped (displayed in red). Mandatory fields will require that they be mapped before clicking OK.

Add All: Select the Add All box to bypass the matching logic and add all connections as new organizations

Add if No Match: Select Add if No Match to use the 'Match X Characters in the Street Name' value to update matched records, and add unmatched records

Use UB Acct# as Org ID: If checked, and the Account column is empty, the import will use the UB/AVR Acct# value in the file as the connection customer number

Create Subdiv/Builders: If checked, the import process will assign the SUBDIV and BUILDER attributes to the organization records, and create the required parent links to the associated Districts

Match X Characters in Street Name: Set the number of characters the matching logic should use to scan for matches in the street address value. Exact matches are automatically processed as a match. Otherwise, the system will scan X characters to present a grid of possible matches, where you can select the appropriate matched record, or choose No Match.

Address Matching screen

Address Matching screen




Connection Import/Match File Definitions

Required fields are indicated with an *

*f1 - DCustNo - District customer number. Must be a valid Adjutant Organization ID up with the SOLDTO attribute (usually relabeled as District)

f2 - Account - Connection customer number. Can be filled in with a 10 digit number, or the system can autonumber each connection in the format DDDD-###, where DDDD is the district number and ### is a sequential number.

f3 - Name - Contact name associated with the service connection. A Contact record is also created for this name, associated with the connection Organization.

f4 - Phone - Primary phone number associated with the service connection

f5 - Tract - Tract number in the Connections jump screen (numeric, 7 characters max)

f6 - Meter SN - Current meter serial number (alphanumeric, 20 characters max, some special characters allowed)

f7 - Builder - Home builder Organization ID. Must be a valid Organization in Adjutant. The 'Create Subdiv/Builders' checkbox on the import screen can assign the Builder attribute and automatically create the parent link to the district record.

f8 - Tap Size - Tap size for the service connection in the Connections jump screen. Must match the text1 value from the Tap Sizes (TAPS) rule exactly.

f9 - HSCode - This field is not in use at this time

f10 - Install Date - Install date in the Connections jump screen (MM/DD/YY format)

f11 - Sewer Date Pass - Sewer inspection date in the Connections jump screen (MM/DD/YY format)

f12 - CSI Date Pass - Customer Service Inspection date in the Connections jump screen (MM/DD/YY format)

f13 - Subdivision - Subdivision name Organization ID. Must be a valid Organization in Adjutant. The 'Create Subdiv/Builders' checkbox on the import screen can assign the Subdiv attribute and automatically create the parent link to the district record.

f14 - Section - Section number in the Connections jump screen (alphanumeric, 50 characters max)

f15 - Block - Block number in the Connections jump screen (alphanumeric, 50 characters max)

f16 - Lot - Lot number in the Connections jump screen (alphanumeric, 50 characters max)

*f17 - Service Address - Service connection street address. This value is set as the Organization company name as well as the Address value.

f18 - Email - Primary email address associated with the service connection

f19 - Address2 - Address 2 information for the service connection address

f20 - Address3 - Address 3 information for the service connection address

f21 - City - City for the service connection address

f22 - State - State for the service connection address

f23 - ZipCode - Zip Code for the service connection address

f24 - MAddress1 - Mailing Address information for the service connection address

f25 - MAddress2 - Mailing Address 2 information for the service connection address

f26 - MCity - Mailing City for the service connection address

f27 - MState - Mailing State for the service connection address

f28 - MZipCode - Mailing Zip Code for the service connection address

f29 - AVR Acct# - AVR Acct # or UB Acct# (depending on field label) in the Connections jump screen (alphanumeric, 20 characters max, some special characters allowed)

f30 - Key Map Pg# - Key Map # in the SHIPTO screen for the service connection address (alphanumeric, 20 characters max)

f31 - Cross Street - Cross Street in the SHIPTO screen for the service connection address

f32 - Latitude - Latitude value in the SHIPTO screen for the service connection address (numeric, up to 5 decimals, allows '-' sign)

f33 - Longitude - Longitude value in the SHIPTO screen for the service connection address (numeric, up to 5 decimals, allows '-' sign)