Plugin slouží k importu bodů, zejména tzv. waypointů, ze souboru ve formátu CSV (Comma Separated Values). Plugin převede zadaný CSV soubor do GPX souboru, který pak importuje do databáze.
Plugin to import points, especially waypoints, from a CSV file (Comma Separated Values). Plugin converts the specified CSV file to GPX file and then imports it into the database.
Pokud se Vám doplněk líbí, kliknutím na tlačítko Donate můžete přispět na jeho vývoj.
Nekamarádíte se s PayPalem? Napište mi email a domluvíme se na jiném způsobu, třeba převodu na účet.
![]() |
Instalaci doplňku spustíte kliknutím na tlačítko vlevo. Následně budete v prostředí GeoGetu provedeni instalačním procesem. Pro zajištění této funkce je třeba mít na počítači již
nainstalovaný a
spuštěný program GeoGet
.
|
Diskuze o tomto skriptu je k dispozici na Geocaching.cz.
Plugin vstupní CSV soubor zpracovává v několika krocích:
Plugin automaticky rozeznává
Poznámky:
Plugin dokáže ze souboru importovat následující hodnoty:
1) Pokud nejsou hodnoty načteny ze souboru, plugin použije implicitní hodnoty, které může uživatel nastavit v konfiguraci.
Jestliže při importu není rodičovský bod v databázi nalezen a je konfigurací nastaveno, aby byl vytvořen pomocí GPX, pak mohou být importovány také některé další hodnoty náležející k rodičovskému bodu:
Uvedený výčet je maximum, co může být importováno. V CSV souboru nemusí být žádná z uvedených hodnot, pak budou použity hodnoty implicitní, bude-li to potřeba.
Pokud již rodičovský bod v databázi je nebo není nastaveno, aby byl bod přidán pomocí GPX, není možné importovat informace, které patří ke keši a ne k waypointu - viz ToDo část.
V souladu s kroky, z kterých se zpracování CSV souboru skládá, uživatel:
Důsledkem chybně nastaveného kódování vstupního souboru může být až nemožnost uložit keše do GPS, věnujte mu tedy pozornost.
Po analýze prvního řádku je možné změnit výsledek automatické analýzy a pak pustit Převod. Rovněž je možné korigovat automatické použití uvozovek a pak třeba spustit automatickou analýzu znovu nebo změnit režim.
Výsledek převodu z CSV souboru do GPX. Chybný řádek s keškou GC18YCX opravit nedokážeme, takže můžeme kliknout na Import. Vše kromě této keše bude importováno. Chyba zobrazená na posledních třech řádcích je způsobena tím, že soubor obsahoval na konci prázdný řádek.
Bývá obvyklé, že obsah sloupců v CSV souboru je obalen uvozovkami, ale pro práci pluginu to není nezbytné. Plugin se pokusí sám zjistit přítomnost tohoto obalení podle prvního znaku souboru. Je tedy potřeba, aby všechny řádky používaly nebo nepoužívaly uvozovky stejně.
Pro správný import není potřeba pevné pořadí sloupců ve vstupním CSV souboru. Plugin se pokusí sám najít importovatelné sloupce a ostatní bude ignorovat. Obsah sloupců je rozlišován pomocí jména sloupce (první řádek CSV souboru). Možná pojmenování jednotlivých sloupců jsou v konfiguračním souboru (položky COL_xxx=…) a uživatel si je může snadno doplnit.
Jestliže soubor neobsahuje v prvním řádku jména sloupců, pokusí se plugin podle obsahu sloupců vyhledat alespoň sloupec s ID keše, který je nezbytný k analýze režimu, a sloupce se souřadnicemi.
Sloupce s nerozpoznaným pojmenováním bude plugin při převodu do GPX ignorovat. Obsahují-li důležité informace, musí uživatel ručně doplnit obsah sloupců ve správném pořadí, jak jsou v řádku použity.
CSV soubor může obsahovat informace organizované dvěma způsoby. Podle toho jsou rozlišovány dva režimy zpracovaní řádků:
Plugin se pokouší během analýzy souboru zjistit, jak je vstupní soubor organizován. Výsledek odhadu pochopitelně nemusí být stoprocentní. Uživatel by měl vědět, co vlastně chce importovat, proto má možnost režim po analýze změnit. Při odhadu režimu se plugin rozhoduje podle
Pozor na nastavení souřadnic. Pokud z analýzy vyjde Souřadnice WP, plugin nastaví smíšený
režim a pak musíte režim přepnout na samostatný
. Pokud nastavení nezměníte, budou keše bez souřadnic a každé keši bude přidán Final WP s příslušnými souřadnicemi.
Při vlastním převodu je kontrolován kód keše. Ten musí být formálně platný a navíc pro import waypointu musí být keš v databázi. Pokud kód keše platný není, je hlášena chyba. Jestliže keš v databázi není, může být v závislosti na konfiguraci hlášena chyba, keš vytvořena nebo importována pomocí GClive (import přes GeoJarry není podporován). Vytvořená keš bude mít vlastnosti zadané v CSV souboru nebo, pokud v něm nejsou uvedeny, budou použity přednastavené vlastnosti a ostatní informace o ní nebudou. O neplatnosti kódu keše, vytvoření keše v databázi a případném importu keše je uživatel informován v protokolu.
Prefix waypointu musí být v rámci keše (rodičovského bodu) jedinečný. Plugin se pokusí prefix načíst z importovaného souboru. Pokud jej v souboru nezíská, použije implicitní hodnotu. Jestliže již waypoint s takto získaným prefixem existuje, plugin automaticky najde jedinečný prefix a o jeho změně informuje v protokolu.
Z výše uvedeného popisu kontrol vyplývá, že pluginem nelze měnit hodnoty uložené v databázi. Waypoint je vždy vytvořen nový a přidán, keš je přidávána jen v případě, že v databázi ještě neexistuje. (Od verze 1.2.4 je sice možné importem přepisovat v databázi existující WP, ale parametry rodičovských bodů měnit stále nelze.)
V nastavení je možné definovat:
Vysvětlení některých položek v konfiguraci
Konstant | Význam |
---|---|
SHOW_MESSAGE_LEVEL | Nastavuje nejnižší úroveň zobrazovaných zpráv. Možnosti jsou INFO, WARN, ERR . |
PARENT_PREFIX | Obsahuje prefix pro rodičovský bod k vytvářeným waypointům a pro kontrolu jeho existence v databázi. Hodnota GC znamená kešku z geocaching.com. |
MISSING_GCCODE | Definuje akci, která se provede v případě, kdy ID keše v databázi není. Možnosti jsou ERR (bude hlášena chyba, k importu nedojde), CREATE (vytvoří rodičovský bod (kešku) v GPX souboru, importem pak dojde k vytvoření rodičovského bodu v databázi), IMPORT (napřed importuje kešku pomocí GC.Live funkce Aktualizace stavu keše) |
DEFAULT_CSVFILE | Obsahuje cestu a jméno vstupního souboru. Normálně je hodnota prázdná a uživatel si soubor vybírá interaktivně ve formuláři. |
DEFAULT_ID_TYPE | Obsahuje předdefinovaný typ keše, který bude použit při jejím doplnění, pokud je MISSING_GCCODE=CREATE a ve vstupním souboru není typ keše zadán. |
DEFAULT_WP_TYPE | Obsahuje předdefinovanou hodnotu typu importovaného waypointu použitou v případě, kdy typ není zadán ve vstupním souboru. Možnosti jsou Final Location , Parking Area , Question to Answer , Stage of Multicache . |
DEFAULT_WP_PREFIX | Obsahuje předdefinovanou hodnotu prefixu importovaného waypointu, pokud není prefix zadán ve vstupním souboru. V každém případě se při konverzi CSV do GPX kontroluje, zda prefix je jedinečný a pokud ne, plugin se automaticky pokusí najít jedinečný prefix. |
DEFAULT_WP_FLAG | Definuje předdefinovanou hodnotu Flagu; tj. příznaku ručně upraveného waypointu. Hodnota určuje jak bude s waypointem zacházeno při následujícím případném importu z GC.com a jak bude waypoint obsluhován filtry a exportními makry, resp. funkcí wpt.IsUserWaypoint(). Možné hodnoty jsou 0 (WP se chová jako ručně upravený uživatelem, je chráněn proti přepsání importem a IsUserWaypoint() jej podle toho indikuje), 1 (WP bude importem z gc.com přepsán a wpt.IsUserWaypoint() jej nerozpozná), 2 (WP se chová jako ručně upravený na GC.com, bude importem z GC.com přepsán, tedy je možné jej takto aktualizovat, funkce IsUserWaypoint() jej indikuje) |
WAYPOINTS_OVERWRITE | Řídí možnost přepisu existujícího WP. Pokud je ve zdrojovém souboru zadán prefix WP a v databázi již takový existuje, bude tento bod přepsán ('1') nebo bude vytvořen nový WP ('0') s jedinečným prefixem |
COL_* | Obsahuje čárkou oddělené texty, podle kterých plugin v prvním řádku vstupního souboru rozpoznává obsah příslušného sloupce. |
ID; Jmeno; Coord; WP type ; WP prefix; WP comment GC38GN3; Prazske legendy – O studance Puca; N50°4.555' E014°25.999'; Final Location; FC; komentar;
Analýzu
a zkontrolujeme jestli správně vyhodnotil hodnoty ve sloupcíchProzatím není možné importovat informace, které jsou součástí keše, v případě, kdy keš je již v databázi nebo když tam sice není, ale není nastaveno její doplnění přes GPX - viz ToDo část.
GC
) doplňování k jiným rodičovským bodům (např. Opencaching=OC
)CsvUniImport.gpx
, který obsahuje data importovaná GeoGetemStáhnout aktuální verzi: csvuniimport-1.2.5.gip
Filename | Filesize | Last modified |
---|---|---|
csvuniimport-1.2.5.gip | 27.8 KiB | 2015/01/13 00:00 |
csvuniimport-1.2.4.gip | 24.3 KiB | 2013/07/15 00:00 |
1.2.5 (4.2.2014) do resetu poctu staženi 29.8.2014 staženo 259 x
Zobrazit změny ve starších verzích
Skrýt změny ve starších verzích
1.2.4 (15.7.2013, počet stažení: 231)
1.1.3 (30.8.2012, počet stažení: 289)
1.0.0.2 (15.5.2012, počet stažení: 77)
1.0.0.1 (14.5.2012 staženo 19 x)
1.0.0.0 (14.5.2012)