Handleiding bij de broncodepreview · 0.1.0

Jobs volgen tot een bevestigde uitkomst

Lees echte voortgang, onderscheid wachten van falen en verzoen annulering, herpogingen en onzekere opdrachten zonder dubbel werk.

De API-referentie is in het Engels.

Open de taak die het werk bezit

Scans, Advisor-beoordelingen en scanneronderhoud draaien als jobs. Open Jobs in de werkbank, zoek de gestarte taak en gebruik haar voortgang, resultaatlink en beschikbare acties. Controleer soort, project of operatie en jobidentiteit voordat je annuleert of opnieuw probeert.

Het compacte overzicht groepeert totaalaantallen naar status en soort. Zoeken en filters beperken de lijst zonder die totalen te veranderen. Zo vind je een taak zonder de gefilterde lijst voor de volledige installatiegeschiedenis aan te zien.

Bij de eerste laadactie toont de weergave Loading job history en streepjes voor onbeschikbare aantallen. No jobs yet en nullen verschijnen alleen na een geslaagde lege leesactie. History unavailable betekent dat lezen mislukte. Na geslaagd laden bewaart een later mislukte verversing de geschiedenis met een foutmelding; gebruik Refresh om haar met de opgeslagen toestand te verzoenen.

Lees status vóór verstreken tijd

Een afgeronde scanjob impliceert geen geslaagde beleidsgate. Een afgeronde cache-uitkomstcontrole maakt de oorspronkelijke mislukte voorbereiding niet succesvol. Volg de resultaatlink naar de betreffende scan, provider of scannergegevensstatus.

Een herpoging kan de eerste starttijd van een eerdere poging behouden. Getoonde tijd kan eerdere pogingen en tussentijds wachten omvatten. Een herpoging in de wachtrij wacht op een worker, ook als een oudere heartbeat of activiteit zichtbaar is.

Interpreteer daadwerkelijke voortgang

Scannergegevensjobs tonen updaterfase, component en positie, laatste activiteit en bytevoortgang als de bron een totaal levert. Verificatie en activering hebben niet altijd meetbare totalen. Een onbepaalde indicator betekent actief werk zonder betrouwbaar totaalpercentage of eindtijdschatting.

Fasen zoals downloaden, kandidaatdata verifiëren, activeren en het ontvangstbewijs opslaan zijn onderdelen van één voorbereiding. Ze krijgen niet elk een nieuwe totale deadline. Herladen, een worker herstarten of uitgegeven werk opnieuw proberen reset het opgeslagen voorbereidingsbudget niet.

Bij Work processing unavailable blijven jobs duurzaam in de wachtrij. Gebruik vanuit de productcheckout de ondersteunde opstartopdracht:

make up

Wacht op workergezondheid en vernieuw de bestaande job. Inspecteer veilige jobdetails en de productuitvoer van make logs bij blijvend oude activiteit. Verwijder geen scanner en maak de database niet opnieuw aan om een voortgangsindicator gezond te laten lijken.

Vraag annulering aan en wacht op opruimen

Gebruik Cancel op de exacte job wanneer beschikbaar. Het product slaat eerst het verzoek op en wacht vervolgens op procesopruiming en het eindontvangstbewijs. Browser, voortgangspaneel of editor sluiten voert deze actie niet uit.

Annulering kan met voltooiing wedijveren. Bij scannervoorbereiding wordt ze onbeschikbaar aan de activerings- of commitgrens en kan ze een al geactiveerde geverifieerde generatie niet ongedaan maken. Bij externe Advisor-opdrachten kan ze ontvangen inhoud niet terughalen. Lees eindresultaat en actuele resourcestatus in plaats van te veronderstellen dat alle effecten zijn teruggedraaid.

Bij een editorbatch met meerdere bronmappen laat annulering van de huidige job latere bronmappen ongestart. Elke reeds gestarte bronmap behoudt haar eigen resultaat. Een onzekere jobuitkomst stopt ook latere indieningen, zodat de batch niet verderloopt zonder bekend resultaat.

Probeer alleen opnieuw als de job dat aanbiedt

Gebruik Retry uitsluitend op een geschikte job in een eindtoestand die deze actie toont. Een fout kan een blokkadereden of een andere hersteloperatie hebben. Dien hetzelfde werk niet opnieuw in terwijl de oorspronkelijke job wacht, draait of wordt geannuleerd.

Een voorbereiding met verlopen deadline krijgt geen extra tijd door dezelfde opdracht te herhalen. Inspecteer de uitkomst en start een nieuwe expliciete voorbereiding wanneer de workflow dat biedt. Retry verification controleert een ongewijzigd cachedoel; het downloadt geen vervangende bytes en repareert geen ongeldige gegevens.

Een onzekere scannerpublicatie kan Check cache outcome aanbieden. Dit start een afzonderlijke alleen-lezen job met een eigen grens van vijftien minuten. Hij kan geen gegevens downloaden, activeren, terugrollen of opruimen. De oorspronkelijke voorbereiding blijft mislukt, ook als de controle succesvolle publicatie vaststelt. Actuele scannergereedheid blijft bepalen of een scan mag starten.

Sluit opnieuw aan na verbindingsverlies

Bewaar exacte job- en opdrachtidentiteiten wanneer de UI ze levert. Open Jobs opnieuw en vernieuw na herverbinden dezelfde resource. Een ontbrekende actieve rij, clienttimeout of HTTP 202 bewijst geen einduitkomst: 202 betekent dat de opdracht is geaccepteerd.

API-clients moeten ook de idempotentiesleutel bewaren waar de operatie die vereist. Geldige sleutels bevatten 8 tot 160 ASCII-letters, cijfers, punten, underscores, dubbele punten of koppeltekens en beginnen met een letter of cijfer. Eén sleutel bindt één exacte opdracht; hergebruik met gewijzigde inhoud kan een conflict geven.

Verzoen na een timeout de oorspronkelijke opdracht voordat je een nieuwe sleutel maakt. De header is vereist op aangewezen opdrachtroutes, niet bij elke POST. Bulkbevindingenacties vereisen hem voor triage, niet voor alle levenscycluswijzigingen. Raadpleeg de exacte operatiepagina voordat je een verzoek opstelt.

Ga naar herstel bij onzekere uitkomsten, scannervoorbereiding voor gereedheid of jobs- en bewijsarchitectuur voor de relatie tussen toelating, workeruitvoering en gepubliceerd bewijs.