Template:Zh GoogleMap Description Utility
In this section you can find different utilities
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
|published||optional||Placemark status, values 0 or 1|
|descriptionhtml||optional||Addition HTML text. All HTML formatted text in one line, line breaks are not allowed.|
|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
|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 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
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
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
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
Target placemark, to which category is not applied
Sorce placemark (in buffer) with correct category
Result imported placemark with correct category
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