Template:Zh GoogleMap Description Utility

Utilities

In this section you can find different utilities

Import CSV

Select Import CSV to upload placemark definition by CSV file.

Each line of file - one placemark definition.

First line of file - column name list.

Keep in mind - values can't contain delimiter. For example, if your placemark HTML description can contain colon, use semicolon as delimiter (and don't use it in this description).

Main process screen

You can see table of placemark buffer.

All import process has next steps

• upload CSV file in buffer
• check data, edit it
• import data to placemark table
• analyze log
• correct processed placemarks with warnings
• delete processed data in from buffer

You can see buttons in toolbar

• Upload File - upload CSV file
• Import All - import data
• Log - show process log
• Clear Log - delete data from process log
• New - create simple placemark definition (for example, for test purposes)
• Edit - edit record in buffer (for example, for fixing errors and upload again)
• Publish and Unpublish - you can change buffer placemark status
• Delete - delete record from buffer
• Delete All - delete all records from buffer
• Delete Processed - delete all records from buffer in state Processed

When you upload file all records have state New

Press Upload File

Select file to upload.

Check and if you need - change Delimiter

You can set some defaults - if in file there is no value (not defined or empty value), you can apply default.

After loading you'll get upload log, it is not stored, only showed

Records can be rejected, if you not define required values. You can see record number (to edit line and upload it)

Records will not be uploaded if your first line doesn't contain column definition.

If you enter wrong colunm name, this column will not processed.

Next column names can be used

title	required	Placemark title
latitude	required	Latitude
longitude	required	Longitude
published	optional	Placemark status, values 0 or 1
addresstext	optional	Text address
icontype	optional	Icon Type
iconofsetx	optional	Icon X-offset
iconofsety	optional	Icon Y-offset
description	optional	Description
descriptionhtml	optional	Addition HTML text. All HTML formatted text in one line, line breaks are not allowed.
hrefimage	optional	URL Image
catid	optional	Category ID
markergroup	optional	Placemark Group ID
createdbyuser	optional	User ID, which associate with placemark
showuser	optional	Show user prompts, one integer value Type of view user information 0 - No 1 - Text 2 - Icon 3 - No prompts
showgps	optional	Show GPS information
preparecontent	optional	Prepare the content with the Joomla Content Plugins, values 0 or 1

You can enter columns in any order, ie order of column names define order of placemark properties

If you want to import placemarks with definite status, you can change it in list or by buttons Publish or Unpublish.

By pressing Import All you start to import placemarks into working table.

You have to select map, to whic imported placemarks will be belong.

And press Import button.

In this case process log will be cleared and import process will start.

All placemarks with New state will be taken to process.

If some required values is not defined - will be rejected and state will be set to Error

In case of processing placemark has the same title with the other placemark, belonging the destination map, this processing placemark will not be imported, and state of it will be set to Skip. You can't import placemark with same title. Change title, change status to New and process again. Or import to the other map.

The process result screen

For demo purposes I uploaded placemark data with incorrect category ID, ie I set category ID which is not exists in categories.

In this case you can't see in buffer list category value, but it exists. The same for group ID.

If you will edit placemark in buffer - incorrect values will be set to 0 and data will be imported without category.

But if you enter into CSV file categories (or groups), which are not exists, and try to import - you'll get warnings and imported placemarks will be without it.

In future this checks will be available not only on import stage.

In case of warnings - if you need to have placemarks belonging to category or group you can delete imported placemarks and

• • recreate file with correct IDs, upload it
  • remove incorrect ID and upload it with defaults
  • remove incorrect column with values and upload it with defaults

After that import again

If there is no any placemarks in buffer with state New and you try to process it (to import placemarks), you'll get message that no data to process

When you processed buffer you can delete processed placemarks by pressing Delete Processed

You can also can delete records by applying filters, selecting records and pressing Delete button.

You can delete all records from buffer by button Delete All

When you got warnings, you can analyze it by checking process log. It is stored in database until next import, therefore you can analyze it any times.

As described above, one record was imported with warnings, lets check this warning to understand log

Press Log

There are 6 columns with common title

• ID - record log ID, just sequence
• Import object - what object is processed, in our case it is Placemark
• Error type - type of error, in my case I tried to load wrong category, value is Category not found
• Target ID - it is ID of my imported object (placemark). In my case new imported placemark has ID 6248. Check images below.
• Source ID - it is ID of object in buffer (placemark). In my case placemark in buffer has ID 374. Check images below.
• Source Reference Object ID - it is ID of object, which is not assigned due to is doesn't exist. In my case I tried to set placemark category ID to 778

In other words, I tries to import placemark with category ID=778. But category with this ID is not exist. Therefore placemark was imported without category.

Source placemark to import (in buffer) has ID=374

New imported placemark has ID=6248

Images for log description

Source placemark (in buffer)

Target placemark, to which category is not applied

Categories