Navigation:  Importing >

Locations

Print this Topic Previous pageReturn to chapter overviewNext page

Importing a list of locations into the locator is a simple process.  Preparing your list for the correct format can be challenging in some cases.  We'll help you get your list in order with the following tutorial...

 

In order to import your list into the locator, you'll need to create a comma separated values (CSV) file.  A CSV file is a simple text files with one record per line, and each field is separated by a comma.  Much like this...

Bob Smith,123 Main Street,Dallas,Texas
Jane Doe,775 Euclid Drive,Phoenix,Arizona

See how each record above is on it's own line and each field is separated by a comma.

 

Question: Can I import my list from a MS Excel file?

Answer: No.  Not your Excel (xls) file.  But, you can save your Excel file as a .csv file that will import just fine.  Use 'File' - 'Save As' to export into a CSV file.

 

If you have a list of locations in MS Excel, you are half way home.  You can easily modify your excel list into the correct format by adding the extra column fields needed.  Each record must consist of all 33 fields.

 


Record Fields:
Each record in your import file must contain all 33 fields.  Here are the names of each field...

 

Name

Description

Example Data

 

id

Record ID

122

Can be blank for auto number

name

Location Name

Cycle world

- Required

address1

Address 1

677 Eastchase Pkwy

Optional - But recommended

address2

Address 2

Suite 202

Optional - But recommended

city

City

Dallas

Optional - But recommended

state

State Code

TX

2-Letter Code Optional - But recommended

country

Country Code

US

2-Letter Code Optional - But recommended

zip

Zip code

75202

- Required

telephone

Telephone

214-555-1212

optional

fax

Fax

214-555-3434

optional

email

Email

info@cycles.com

optional

website

Website URL

www.cycles.com

no http:// needed - Optional

user1

User 1 Field

Sale every Wednesday

Anything you want - Optional

user2

User 2 Field

 

Anything you want - Optional

user3

User 3 Field

 

Anything you want - Optional

user4

User 4 Field

 

Anything you want - Optional

user5

User 5 Field

 

Anything you want - Optional

pref

Rank

2

1 through 4 - Required

hide

Disable Record

0

0=no, 1=yes - Required

hits

No. of Hits

167

Number of hits received, set to 0 first time - Required

aprove

Needs Approval

0

0=no, 1=yes - Required

visitorname

Name

Admin

Name of person who submitted the record - Optional

visitoremail

Email

 

Email of person who submitted the record - Optional

visitordate

Date

2007-22-05

Date record was submitted - Optional

user6

User 6 Field

 

Anything you want - Optional

user7

User 7 Field

 

Anything you want - Optional

user8

User 8 Field

 

Anything you want - Optional

user9

User 9 Field

 

Anything you want - Optional

user10

User 10 Field

 

Anything you want - Optional

is_online

Online Store

0

0=no, 1=yes - Optional

image

Image

image.gif

image filename - Optional

icon

Icon

icon.gif

icon filename - Optional

url_text

Text for Link

Click to View

Text that gets printed on website link - Optional

 

You can download a sample MS Excel and CSV file.  You can use these sample files to start your own list correctly!

 


Steps to Importing

 

On the Admin Panel navigation menu, click on the link under 'Records' that says "Import Records'.  Once you get to the Import Records screen, you'll see a few options.  They are...

1.  Select File
       You have the option to selecting a file that is already on the server inside the /dbackup directory

or

2.  Upload a New File
       Click the 'browse' button to select a file that is on your computer

 

If you have a large import file (over 2MB) then you should FTP your file to your server, in the /locator/dbackup folder, give it a name that starts with Locations, then select it from this list.

 

 

 

Once you have chosen your csv file that you wish to import, you can choose which action you want to perform while importing.  Your choices are.

Append - which will add all locations on the import list to the current list in the database. Nothing gets erased.

Overwrite - which will erase all current locations in the database first (deleting all records), then import the locations from your list into the database as a new/fresh database of locations.

 

 

After the Import Routine has completed,  you'll get a confirmation screen that will inform you on how many records successfully imported and how many records were invalid and didn't import.

 

 

 

Special Note:

It is very important that your import file has all fields necessary to populate the locations table.  A quick scan is performed during an import and the number of fields is verified.  If your import has more than or less than the correct number of fields (which is 33), import will skip those records and they will not get imported.  See the top of this page for the layout of fields necessary to import.

 

Attn: MAC Users:

If you are using a MAC computer, and are planning on importing your locations from a file, there is one step you must do before your import will work correctly.  If you have a list of locations in MS excel and then save the file as a CSV file, you must also choose the "Windows Text" option.  Your text file must be saved with Windows ANSI file formatting.  Choosing the Windows Text option should do this for you.

 


Page url: http://www.helpandmanual.com/help/index.html?locations.htm