Achtergrondtaken

Sommig werk is te traag om u te laten zitten kijken. Een laag importeren, er een exporteren, een rapport over duizenden records draaien, een gescand plan op de kaart passen - elk daarvan wordt opgeschreven als een taak en uitgevoerd door een apart programma op de server. Het dialoogvenster waaruit u het startte mag dicht. Uw browser mag dicht. De taak gaat door.

Wat u terugkrijgt is een lijst. Elke taak heeft een nummer, een status en een geschiedenis, en de lijst is waar u kijkt hoe ver hij is, ophaalt wat hij heeft opgeleverd, of uitzoekt waarom hij is gestopt.

Wat een taak is

Drie programma's, één rij

Er zijn drie afzonderlijke stukken software bij betrokken, en weten welk welk is verklaart het meeste van wat de lijst doet.

1. De toepassing schrijft een rij. Die bevat wat u hebt gevraagd en de status Pending. Meer doet zij niet. Zij voert het werk niet uit.
2. Het werkprogramma draait op de server en heeft als enige taak: taken. Het zoekt wachtende rijen, claimt er een, zet hem op Busy, en gaat aan de slag.
3. De takenlijst die u open hebt, leest die rij om de paar seconden en tekent hem opnieuw.

De lijst sluiten stopt dus geen taak, en hem open laten maakt er geen sneller. Twee mensen die naar dezelfde taak kijken, zien dezelfde rij.

Een taak die op Pending blijft staan is niet traag, hij is onbeheerd

Het werkprogramma is een apart proces van de toepassing. Draait het niet, dan worden taken geschreven en nooit opgepakt: ze blijven onbeperkt op Pending staan, en niets in de lijst zegt waarom. Het teken is dat elke taak vastzit, die van u en die van iedereen, niet alleen die van u. Zeg het uw beheerder - dit is niets wat de lijst kan oplossen.

Een taak gaat niet verloren als het werkprogramma er middenin stopt. Terwijl een taak loopt wordt zijn rij ongeveer eens per minuut aangeraakt. Een rij die vijf minuten niet is aangeraakt, geldt als verlaten, gaat terug naar Pending en wordt opnieuw opgepakt, met de notitie Worker stopped heartbeating; job re-queued for processing.

De vier lijsten

Er is geen enkel Taken-scherm. Elk soort werk houdt zijn eigen lijst, en elke lijst opent daar waar dat werk wordt gestart.

Lijst	Waar hij opent	Het werk zelf
Import Jobs	Het kleine pijltje naast Import op de kaartwerkbalk	Lagen Importeren
Export Jobs	Het kleine pijltje naast Export	Lagen exporteren
Report Jobs	Het pijltje naast Reports, en de knop Jobs in de rapportenlijst en het rapportvoorbeeld	Rapporten
Georeference Jobs	De knop Georef Jobs in Bijlagen, en het georeferentiepaneel	Gegeorefereerde afbeeldingen

Imports en exports delen één dialoogvenster, dus die twee lijsten zijn dezelfde lijst met een paar kolommen verwisseld. Rapporttaken en georeferentietaken hebben elk hun eigen lijst, en ze verschillen op punten die het waard zijn om te weten - zie Rapporttaken en Georeferentietaken.

Elke lijst heeft twee tabbladen. Yours is wat u hebt gestart. All is dat van iedereen, en alleen sitebeheerders hebben het, op elke lijst. Het tabblad is niet louter verborgen voor de rest - de server controleert hetzelfde recht opnieuw voordat hij antwoordt, dus er valt niets te winnen door om het tabblad heen te gaan.

De lijst lezen

Hij ververst zichzelf, en zegt er niets over

De lijst ververst zichzelf zolang hij open is: de import- en exportlijsten elke twee seconden, rapporttaken elke vijf, georeferentietaken elke vier. Dat gebeurt bewust stil - geen draaitol, geen geflikker - zodat een status die verandert terwijl u leest, eenvoudigweg verandert. De knop Refresh is er om het af te dwingen, en die draait wel.

Er worden tien taken tegelijk getoond, de nieuwste eerst. De georeferentielijst toont er vijfentwintig.

De kolommen sorteren niet, en dat is bewust

De server geeft één pagina in één volgorde terug, de nieuwste eerst. Een sortering in de browser zou de tien rijen op het scherm herschikken terwijl het lijkt alsof ze allemaal gerangschikt zijn, wat erger is dan helemaal niet sorteren. Beperk in plaats daarvan de lijst.

Twee soorten beperking liggen op elkaar:

• De werkbalk bovenaan: een paar From date en To date, dat filtert op wanneer de taak is aangemaakt, en een vak Filter by user dat alleen op het tabblad All verschijnt. Alle drie worden gewist telkens als het dialoogvenster opent.
• De filterrij onder de kolomkoppen, op de import-, export- en rapportenlijsten. Elke kolom filtert op eigen voorwaarden en de aanvinklijst biedt de waarden die er werkelijk zijn. Zie Kolomfilters. De georeferentielijst heeft geen filterrij; die heeft een statuskeuzelijst en één zoekvak.

De twee zijn met opzet onafhankelijk. Clear filters in de werkbalk wist de eigen drie van de werkbalk en laat de kolomfilters staan; het gummetje in de filterrij doet het omgekeerde.

Een filter dat niet kon worden toegepast wordt gemeld, nooit ingeslikt

Als de server een van uw kolomfilters niet in een query kan vertalen, noemt een waarschuwing de kolommen die hij niet kon gebruiken, en die blijft op het scherm tot u hem wegklikt. Dat telt zwaarder dan het klinkt. Een filter dat stilzwijgend niets deed, zou u naar meer rijen laten kijken dan u had gevraagd, zonder dat de lijst er enig teken van geeft.

De kolom Progress op de import- en exportlijsten moet u met een korrel zout lezen. Bij een export is hij echt: hij komt van het conversiegereedschap terwijl dat het bestand schrijft. Bij een import is het een reeks mijlpalen - klaargezet, geladen, gepubliceerd - dus hij kan lang op één getal blijven staan en dan springen. Bij een mislukte taak wordt de balk helemaal gevuld in plaats van op 50% te blijven, zodat een mislukking er nooit uitziet als een taak die nog bezig is.

Bij een import die een bestaande laag bijwerkt, is Records het aantal records dat de import heeft gewijzigd - bijgewerkt, toegevoegd of verwijderd. Bij een export telt Downloads hoe vaak het bestand is gedownload.

Bericht als hij klaar is

Wat een melding aanbiedt hangt af van de taak, en van waar u bent

U hoeft geen lijst open te houden om te weten wanneer een taak klaar is. Als een import, export of rapport van u klaar is of mislukt, verschijnt er rechtsonder een kleine melding, op welke pagina van de toepassing u ook bent. Die noemt de taak en zegt hoe hij is afgelopen, met de eigen boodschap van de taak als die er is - waarom hij mislukte, of hoeveel regels een import weigerde. Hij blijft staan tot u hem met zijn ✕ sluit of hem beantwoordt, zodat een melding die kwam terwijl u niet achter het scherm zat er nog is als u terugkomt. Hooguit de drie nieuwste staan er tegelijk; de lijsten hieronder hebben elke taak.

De taak	Wat de melding aanbiedt
Een export of rapport, klaar	Download - hetzelfde bestand als de downloadknop van de lijst.
Een import, met de kaart open, en de laag niet in uw werkruimte	Add to workspace. De laag komt erin, ingeschakeld en bovenaan de lijst, getekend over uw andere lagen, alsof u hem vanuit de Lagenbibliotheek had toegevoegd en naar boven had gesleept; sla de werkruimte op om hem te houden. Is niets van zijn gegevens in beeld, dan gaat de kaart erheen.
Een import, met de kaart open, en de laag in uw werkruimte maar uitgeschakeld	Show on map, dat hem inschakelt.
Een import in een laag die al getoond wordt	Niets te vragen: de kaart heeft de laag al opnieuw getekend met de nieuwe records.
Een import, op een andere pagina	Alleen het nieuws. Open de kaart terwijl de melding er nog staat en de knop verschijnt.
Een mislukte taak	De reden. Los die op en start het werk opnieuw vanuit de wizard.

Not now legt de vraag weg. De melding komt alleen naar u, in elk tabblad waarin u de toepassing open hebt. Hij is voor het moment: een taak die klaar is terwijl u afgemeld bent, laat geen melding achter, maar de lijst en de e-mails hebben hem nog. Een import die in een ander account van u is gedaan, zegt dat hij klaar is maar biedt geen knop, omdat de laag bij dat account hoort. Georeferentietaken sturen geen melding.

Statussen

Status	Wat het betekent
Pending	Opgeschreven, wacht tot een werkprogramma hem claimt. Er is nog niets gebeurd.
Queued	Hetzelfde onder een andere naam, gebruikt door sommige soorten taken. Een werkprogramma zal hem claimen.
Busy	Een werkprogramma heeft hem en werkt er nu aan. Dit is de enige toestand waarin de voortgang beweegt.
Completed	Klaar. Exports kunt u hier downloaden, rapporten hebben hun bestanden, imports hebben de laag gewijzigd.
Completed with warnings	Klaar, met een melding: er is iets weggelaten. Zie Een taak kan klaar zijn en toch iets te melden hebben.
Failed	Hij is met een fout gestopt. View Details draagt het bericht.
Cancelled	U hebt hem gestopt. Alles wat hij had opgeleverd is weggegooid.
Pending deletion	Geen toestand van het werk maar van de rij: u hebt om verwijdering gevraagd en het opruimen is nog niet klaar. Zie Een taak verwijderen.

Running duikt hier en daar op in de interface, maar het is geen toestand die een taak werkelijk kan hebben. Werk in uitvoering is Busy.

Georeferentietaken gebruiken hun eigen woorden voor hetzelfde idee - Queued, Processing, Done, Failed - en voegen er een eigen aan toe, Missing Points, wat betekent dat de afbeelding minder dan de drie controlepunten heeft die een vervorming nodig heeft.

Wat u met een taak kunt doen

De knoppen links op elke rij verschijnen en verdwijnen naargelang wat de taak is. Niets wordt grijs gemaakt; het is er eenvoudigweg niet.

Knop	Wanneer hij er is, en wat hij doet
Download	Exporttaken, en rapporttaken (zie Rapporttaken), en pas als ze Completed zijn. Een export slaat het resultaat op als een zip die naar de titel van de taak is genoemd. Een import heeft niets te downloaden, dus die heeft deze knop nooit.
Cancel	Zolang de taak Pending of Busy is. Hij markeert de taak als geannuleerd en verwijdert de werkmap.
Delete	Zodra de taak Completed, Failed of Cancelled is, en alleen tot u al om verwijdering hebt gevraagd.
View Details	Altijd. Hij opent het volledige dossier van de taak: wat gevraagd was, wanneer hij begon en eindigde, hoe vaak het resultaat is gedownload, en elk bericht dat de taak heeft achtergelaten.
Delete all	De prullenbak rechts op de werkbalk. Hij wist het tabblad waar u naar kijkt - op het tabblad All, als beheerder, betekent dat de taken van elke gebruiker. Taken waar een werkprogramma mee bezig is blijven staan.

Een taak annuleren die al gestart is, is niet altijd meteen klaar

Iets annuleren dat nog Pending is, is netjes: het wordt nooit opgepakt. Iets annuleren dat al Busy is markeert de rij meteen, maar het werkprogramma kan al minuten bezig zijn met het schrijven van een bestand, en alleen rapportgeneratie kijkt halverwege werkelijk naar een annulering en gooit zijn uitvoer weg. Lees een geannuleerde export of import als "het resultaat is weg", niet als "de server stopte op die seconde".

Een taak verwijderen

Verwijderen is een verzoek, en het werkprogramma voert het uit

Verwijderen haalt de taak er niet ter plekke uit. Het markeert de rij, het statuslabel verandert in Pending deletion, en de verwijderknop verdwijnt zodat u niet twee keer kunt vragen. Het werkprogramma haalt dan de map van de taak van de server en verwijdert pas daarna de rij, dus de rij die uit uw lijst verdwijnt is het teken dat de bestanden werkelijk weg zijn.

Een taak verwijderen geeft nooit terug wat ze heeft gebruikt. De taak wordt alleen verborgen: ze telt nog steeds mee in de cijfers van deze maand op uw dashboard en voor het maandelijkse tegoed van uw abonnement, dus taken verwijderen en nieuwe starten laat de maand niet opnieuw beginnen.

Meestal duurt dat seconden. Draait het werkprogramma niet, dan kan een taak net zo lang op Pending deletion blijven staan als op Pending - dezelfde oorzaak, dezelfde oplossing.

Een taak waar een werkprogramma op dit moment Busy mee is, kan helemaal niet worden verwijderd. Annuleer hem eerst, of wacht.

Een taak kan klaar zijn en toch iets te melden hebben

Amber is een melding bij een taak die werkte. Rood is een mislukking

Een taak lukt niet alleen maar of breekt. Hij kan het meeste doen van wat u vroeg en melden wat hij niet kon, en het detailvenster laat dat verschil zien:

• Amber, met de kop Notice. De taak is Completed. Er is iets weggelaten, en dit zegt wat.
• Rood, met de kop Error. De taak is Failed en heeft niets opgeleverd.

In de lijst staat zo'n taak als Completed with warnings, in amber, in plaats van Completed. Beweeg de muis erover (op een telefoon: houd hem ingedrukt) om de melding te lezen, en open View Details voor de volledige tekst; het rapport per rij van een import komt per e-mail.

De twee meest voorkomende meldingen zijn het waard om te herkennen.

Een export naar een formaat dat maar één vorm tegelijk kan bevatten - een shapefile is de gebruikelijke - exporteert de records die bij het geometrietype van de laag horen en laat de rest weg. De melding zegt hoeveel, en een bestand met de naam excluded_records.csv in de download noemt ze een voor een, met de reden. Een formaat kiezen dat gemengde geometrie opslaat, zoals GeoPackage, GeoJSON of KML, vermijdt het probleem geheel.

Een import waarbij rijen zijn afgewezen wordt toch voltooid, en haalt alles binnen wat goed was. De melding zegt hoeveel rijen zijn geweigerd. Het rapport per rij zit helemaal niet in de toepassing - het is bij de afrondingsmail gevoegd, en dat is de enige kopie, want de voorbereidingsmap waar het uit kwam wordt gewist zodra de import slaagt. Wilt u de afgewezen rijen herstellen en opnieuw proberen, bewaar dan die mail.

De e-mails

Imports, exports en rapporten sturen u elk een e-mail wanneer ze beginnen en nog een wanneer ze klaar zijn, zodat u de lijst niet hoeft te bewaken. Georeferentietaken sturen niets.

De afrondingsmail van een export bevat een downloadlink die werkt zonder aan te melden. Dat maakt hem handig, en het is ook waarom die mail als het bestand zelf moet worden behandeld: iedereen aan wie u hem doorstuurt kan de gegevens ophalen.

Wanneer een taak mislukt

Het bericht bij een mislukte taak is voor u geschreven en niet voor de server. Paden, hostnamen, instellingen en stacktraces worden eruit gehaald voordat het wordt opgeslagen, dus wat overblijft zegt wat voor soort ding er misging zonder te zeggen waar. Het eindigt met het nummer van de taak, in de vorm (job #35 - details are in the services log).

Dat nummer is de kern. Het volledige verhaal van de mislukking staat op de server, en het taaknummer citeren is wat een beheerder in één stap laat vinden. Meldt u een mislukte taak, geef dan het nummer.

Veelvoorkomende oorzaken waar u zelf iets aan kunt doen:

• Een bestand dat de import niet kon lezen. Een niet-ondersteund formaat, een zip waarin een van de onderdelen ontbreekt die een shapefile nodig heeft, of tekst in een codering die de lezer niet verwachtte.
• Een formaat dat de gegevens niet kan bevatten. Zie de melding hierboven - al mislukt de export ronduit als er niets in de laag past, in plaats van te eindigen met een melding.
• Een maandlimiet. Exports tellen mee voor een quotum dat van uw abonnement afhangt. Daarboven wordt de taak geweigerd op het moment dat u hem start, met een bericht dat het quotum geeft en hoeveel u ervan hebt gebruikt, in plaats van later te mislukken.

Er is geen knop om een import of export opnieuw te proberen. Begin het werk opnieuw vanuit de eigen wizard. Georeferentietaken zijn de uitzondering: die hebben er een, hieronder beschreven.

Rapporttaken

De rapportenlijst is een ander dialoogvenster met dezelfde vorm, en twee verschillen die ertoe doen:

• Een rapporttaak levert altijd één bestand op, hoeveel records het ook beslaat. Zodra de taak Completed is, heeft de rij een eigen downloadknop, en het oog (View) opent de details van de taak, met het bestand en zijn grootte.
• Cancel verschijnt alleen zolang de taak Busy is. Een rapport dat nog wacht kan niet worden geannuleerd - verwijder het in plaats daarvan.

De kolommen beschrijven het rapport en niet een bestand: welk rapport is gedraaid, op welke laag, het gebruikte filter en de sorteervolgorde, en hoeveel records het besloeg.

Georeferentietaken

Georeferentie heeft een eigen lijst, geopend vanuit Bijlagen of vanuit het georeferentiepaneel. Het is de enige met een knop Re-queue, die een taak terug in de wachtrij zet om opnieuw vervormd te worden. Hij verschijnt wanneer de taak Done, Failed of Missing Points is en de afbeelding minstens drie controlepunten heeft - onder de drie is er niets om mee opnieuw te proberen, voeg dus eerst punten toe. Daarvoor is ook Allow op de laag van de taak nodig: met alleen Visible kunt u de lijst alleen lezen.

De kolom Error toont een foutbericht in de rij, ingekort, met het geheel in de tooltip. Hij wordt alleen getoond bij Failed en Missing Points: een geslaagde taak kan ook een notitie van de vervormingsstap dragen, en dat is een diagnose, geen fout.

Hier valt niets te downloaden. Wat een georeferentietaak oplevert is de gecorrigeerde afbeelding zelf, die op de kaart verschijnt. Zie Gegeorefereerde afbeeldingen.

Als er iets niet klopt

Wat u ziet	Wat het betekent
Elke taak blijft op Pending staan en er beweegt niets	Het werkprogramma dat de taken uitvoert draait niet. Dat treft iedereen, niet alleen u, en alleen een beheerder kan het starten.
Eén taak is al lang Busy	Grote of ingewikkelde gegevens. Let op de voortgangskolom; bij een import beweegt die met sprongen in plaats van vloeiend.
Een taak ging vanzelf van Busy terug naar Pending	Het werkprogramma dat hem behandelde is gestopt. De taak is teruggenomen en zal opnieuw draaien. Het bericht erbij zegt dat.
Geen knop Download bij een voltooide taak	Het is een import. Imports wijzigen een laag; er is geen bestand om op te halen.
Geen knop Delete bij een taak	Of een werkprogramma is ermee bezig, of u hebt al om verwijdering gevraagd en het label leest nu Pending deletion.
Een rij die Pending deletion leest en blijft staan	Het opruimen gebeurt in het werkprogramma. Draait dat niet, dan wachten verwijderingen met al het andere mee.
Completed with warnings	De taak lukte en er is iets weggelaten. Lees de melding - bij een export staat het detail in excluded_records.csv in de download, bij een import zit het bij de e-mail.
Een foutbericht dat geen bestand of server noemt	Bewust zo. Serverdetails worden eruit gehaald. Citeer het taaknummer in het bericht aan uw beheerder.
De export werd geweigerd zodra u hem startte	Het maandelijkse recordquotum van uw abonnement is op. Het bericht geeft de getallen.
Kolomkoppen die niet willen sorteren	In deze lijsten wordt niet gesorteerd. Gebruik de filterrij en het datumbereik.
Een waarschuwing die kolommen noemt die niet gefilterd konden worden	Die filters zijn niet toegepast. De rijen op het scherm zijn ruimer dan wat u vroeg - beperk ze op een andere manier.
De melding van een import bood geen Add to workspace	U was niet op de kaart, de laag stond al in uw werkruimte en werd getoond, of de import is in een ander account van u gedaan.
Geen tabblad All	Dat is er alleen voor sitebeheerders.

Zie ook

• Lagen Importeren - waar een importtaak vandaan komt
• Lagen exporteren - waar een exporttaak vandaan komt, en wat de formaten kunnen bevatten
• Rapporten - een rapport draaien, en het bestand waarin het terugkomt
• Gegeorefereerde afbeeldingen - controlepunten, vervorming, en het terugzetten in de wachtrij
• Kolomfilters - de filterrij onder de koppen