Template:Zh GoogleMap Description Utility

From Documentation
Jump to: navigation, search

Utilities

In this section you can find different utilities

GM-Map-Utilities.png


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

GM-Map-ImportCSV.png

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

GM-Map-ImportCSV-UploadCSV.png

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

GM-Map-ImportCSV-UploadCSV-Result.png


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

GM-Map-ImportCSV-UploadCSV-Result-Errors.png


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

GM-Map-ImportCSV-UploadCSV-Result-NoDefinition.png


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

GM-Map-ImportCSV-UploadCSV-Result-WrongColumn.png


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.

GM-Map-ImportCSV-Import.png


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 Skiped. 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

GM-Map-ImportCSV-Import-Result.png


Imported placemarks in buffer change status to Processed

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 do

  • 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

GM-Map-ImportCSV-Import-Result-NoData.png


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

GM-Map-ImportCSV-Import-Log.png


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. Check images below.

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) with wrong value for category

GM-Map-ImportCSV-Import-Log-Source.png


Target placemark, to which category is not applied

GM-Map-ImportCSV-Import-Log-Target.png


Categories

GM-Map-ImportCSV-Import-Categories.png


Sorce placemark (in buffer) with correct category

GM-Map-ImportCSV-Import-CorrectCategory.png


Result imported placemark with correct category

GM-Map-ImportCSV-Import-Log-TargetCategory.png


My test file is


title;description;latitude;longitude;catid;descriptionhtml
Hello;Some my text;59.91790658791312;30.394283583638412;778;<b>Hello</b> world<br />Here some HTML text
HHH;;59.92354196553846;30.38381223964427;45