Macro GetNewestCaches, versie 2.5 Auteur: Thex Doel Deze macro zal voor Nederland, Belgie en of Luxemburg (en iedere combi hiervan) de nieuwste caches ophalen. Hiertoe wordt gebruik gemaakt van het menu "Geocaching.com Access => Get Geocaches". Er wordt gebruik gemaakt van je live-api tegoed (en hierop gecontroleerd) voor het Full live-api format. De macro onthoudt na gebruik de laatste instelling en controleert alle stappen. Nadelen van Get Geocaches voor ophalen van de nieuwste caches De volgende nadelen dien je goed in de gaten te houden. Zij hangen samen met de manier waarop GS de live-api heeft ingericht: Nadeel 1: de live api is beperkt qua tijd-periode waarin caches opgevraagd kunnen worden. Dit is een periode van maximaal 30 dagen. De macro gebruikt 29 dagen (-14 tot +14 dagen periode, of 0-29 dagen periode). Echter door herhaald aanroepen kun je achterstallig onderhoud rechttrekken, maar over het correct gebruiken hiervan verderop meer info. Nadeel 2: de creatiedatum van een event (event, mega event, cito) en daarmee inherent ook de publicatiedatum ligt in de toekomst. Zo heeft GS dit geïmplementeerd. Als een event datum niet binnen de 29 dagen ophaal periode valt, wordt hij dus niet gezien en (nog) niet meegenomen. Een PQ kan helpen ter completering. Nadeel 3: caches die in het archief gaan en later weer tot leven worden geroepen, worden meestal niet gezien (als deze eerder liggen dan de opgegeven periode). Het blijft dus nodig af en toe volledige sets PQ's te draaien wil je alles compleet hebben. Ik kan verzekeren dat dit regelmatig voorkomt. Nadeel 4: de macro haalt alle caches op in de opgegeven periode. Dit kunnen er teveel zijn omdat je de meeste al hebt. In gebruik name Voor de macro in gebruik genomen kan worden dien je een "GPX laad setting" onder de naam macronew aan te maken (menu File => Load GPX, je persoonlijke keuzes aanpassen en dan opslaan als macronew). Hier kun je eigen settings die voor jou van toepassing zijn invoeren. De enige vaste regel is dat het vinkje bij Userflag aangezet moet worden. De macro checked op aanwezigheid van macronew en het vinkje. De Userflag wordt gebruikt om een overzicht te genereren, en een filter met geladen caches op te zetten. Zorg ervoor dat de PQ download folder bestaat anders volgt alsnog een foutmelding tijdens gebruik (dit zal zeker gebeuren als je via een backup van een XP naar een Windows 7 machine overgaat). Je kunt bv zelf aangeven of de PQ's verwijderd dienen te worden, de
hoogte, county (Y bij county), state (S bij State) aanpassen, en velden uitsluiten of een post macro mee laten lopen. Figuur 1, Instelscherm GPX Load De macro kan op een lege database draaien als het moet. Figuur 2, Opstart scherm, versie 2.4 De macro kent naast keuze voor 1 of meer van de drie genoemde landen 1 van de volgende gebruiksinstellingen voor de startdatum van de 29 dagen periode: De in GSAK bekende laatste publicatie datum (de placed kolom). Dit is eigenlijk de creatie datum van de cache op GS en ligt vaak ver voor de werkelijke publicatie datum. Deze startdatum voor opvragen is eigenlijk niet aan te bevelen, omdat hier haken en ogen aan
zitten, hoewel op het eerste gezicht dit een aantrekkelijk alternatief lijkt te zijn. Tendens is dat je caches gaat missen. Gezien het karakter van een event worden events niet in de bepaling van de in de macro voorgestelde publicatiedatum meegenomen. Vanaf een datum welke je zelf kunt invoeren. Vanaf de datum 14 dagen terug. Op deze wijze zal je onherroepelijk caches gaan overschrijven die je al hebt, maar is wel eenvoudig in gebruik, veilig dus, edoch duur in liveapi gebruik. Vanaf de datum van laatste gebruik van deze macro. Deze optie is prima als je regelmatig (dus binnen 29 dagen) de macro draait, anders mis je ook caches. Vanaf de meest recent gevonden werkelijke publicatie datum van caches in de database (dus niet zoals GSAK die via placed datum ziet). Hiervoor wordt gekeken naar de reviewer logs in de database. Deze methode is verreweg het beste en kun je bij langere tijd waarbij je de macro niet gebruikt, de macro veilig en zonder bezwaar herhalen tot je alles compleet binnen hebt. Deze methode is niet sluitend in de zin dat je je database kunt purgen (wissen van oude logs), en dan is de Reviewer Publish Log waarschijnlijk ook weg. Aan de andere kant, dit gebeurt alleen als een cache al een langere tijd bestaat en al veel loggers heeft en doet de datum zo wie zo niet mee en hoef je de cache ook niet op te vragen. Daarnaast kun je aanvinken dat eigen founds niet geladen wordt. Indien specifiekere instellingen gewenst zijn kan in het oranje blok het vinkje gezet worden en een instelling worden geselecteerd. Deze instellingen kun je maken op het "Get Geocaches" menu. Onderhands wordt vóór de aanroep van de api nog wel de datum opties aangepast, macronew aangezet, en het api download budget geregeld. Ter aanvulling: De macro controleert je live api tegoed en zal niet meer vragen aan GS dan dit beschikbare tegoed. Is er geen tegoed meer, wordt de live-api niet aangeroepen (melding verschijnt). De macro controleert macronew. De macro haalt de meest recente publicatiedatum op, als deze aanwezig is. De macro zet een filter op van alle geladen caches, en maakt een HTML rapport aan. De macro onthoudt de laatst gebruikte instelling. De macro wijst de gebruiker op onvolkomenheden (start schermpje) en op het maken van de macronew instelling. Indien geen land is ingesteld zal de macro automatisch Nederland kiezen. De macro laat zien welke periode gebruikt wordt gedurende de live-api aanroep. Instellingen worden opgeslagen in bestand GetNewestCaches.xml (in de macro folder). Ook op een extreem grote database met miljoenen logs is de bepaling van de publicatie en creatiedatum zeer snel. De kolom Publicatie datum in GSAK is eigenlijk de Creatiedatum bij GS. Dit is erg verwarrend. Instellingen in rood zijn default ingevuld en eigenlijk niet beschikbaar (bv laatste datum van macro run bij een eerste run). Heeft de macro gelopen, dan kun je zien welke instellingen gebruikt zijn onder het GSAK menu "Get Geocaches" door de instelling "ldgpx" te laden.
Advanced: Batch gebruik Voor gebruikers (zoals ik) die onderhoud volautomatisch en zonder gebruikers tussenkomst wil uitvoeren is er een nogui mode. In deze mode wordt er geen dialoog met de gebruiker aangegaan. Dit kan alleen per individueel land. Omdat instellingen per land kunnen en zullen verschillen (zoals datum laatste gebruik), wordt er per land een eigen xml bestand aangemaakt. Hiervoor wordt de eerste keer de bestaande standaard instelling gebruikt en vervolgens het juiste land ingevuld. Dit betekent dus dat de macro eerst eenmalig moet draaien met correcte instellingen. Er wordt WEL een Userflag filter opgebouwd. Deze is achteraf uit te zetten met: CancelFilter macroflag type=clear range=all De aanroep vanuit een andere macro is: Luxemburg: MACRO File="GetNewestCaches.gsk?NoGui,lux" VarScope="local" Belgie: MACRO File="GetNewestCaches.gsk?NoGui,bel" VarScope="local" Nederland: MACRO File="GetNewestCaches.gsk?NoGui,nl" VarScope="local" Voorbeeld voor script uitvoering op recentste publicatie datum De volgende tabel laat zien wat er gedownload wordt op verschillende momenten indien de macro gedraaid wordt op basis van recentste publicatiedatum. Cache publicatie op dag gisteren vandaag in de ochtend vandaag in de middag morgen Eergisteren Gisteren Vandaag ochtend Vandaag middag Morgen 12 caches 8 caches 2 caches 3 caches Nog onbekend Totaal in download (live api verbruik) 12 caches 8 caches nvt nvt nvt 20+ events na eergisteren binnen 29 dagen 0 caches 8 caches 2 caches nvt nvt 10+ events na gisteren binnen 29 dagen 0 caches 8 caches 2 caches 0 caches 0 caches 2 caches Legenda: 5 caches Deze dag is de dag met de recentste publicatiedatum 3 caches nvt 13+ events na gisteren binnen 29 dagen 3 caches X caches 5+X+ events na vandaag binnen 29 dagen
Gegeven de recentste datum voor aanroep van de macro en voor de recentste publicatiedatum geven de datum opties de bovenstaande zoekperioden zoals in de blauwe balken is weergegeven (gegeven dat vandaag (dag 16) een nieuwe cache uitkomt en de recentste Publish Log op dag 10 aangetroffen is).