Importtaken maken het mogelijk om bestanden te uploaden en data in het systeem te laden. Je kan onder andere klanten, locaties, meters, facturen, banktransacties en contracten importeren. Elke importtaak volgt het volledige verwerkingsproces, toont de voortgang en registreert meldingen en fouten.
Je vindt importtaken via:
Hoofdnavigatie → Jobs → Import
Overzicht – Wat toont het overzicht?
Een importtaak vertegenwoordigt één geüpload bestand en de verwerking ervan. In de lijst worden onder andere getoond:
Bestandsnaam
Klikbaar om de detailpagina te openenStatus
Huidige verwerkingsfase, zoals opgeslagen, valideren, verwerken of afgerondOmgezette waarden
Totaal aantal datawaarden dat uit het bestand werd gehaaldVoortgang
Percentage dat aangeeft hoe ver de huidige stap gevorderd isBron
Oorsprong van de importDataprovider
De ingestelde importconfiguratieBestandsformaat
Bijvoorbeeld CSV of XML, inclusief importtype
Wanneer een taak actief verwerkt wordt, verschijnt er een laadindicator naast de bestandsnaam.
Indeling
Detailpagina van een importtaak
De detailpagina toont kaarten met:
Detail informatie over de import
de huidige status en voortgang
tabbladen per entiteittype dat werd geïmporteerd (in voorbeeld is dit 'aangepaste eigenschap')
een Berichten-sectie met informatieve meldingen, waarschuwingen en fouten
Voor elk entiteittype zie je:
hoeveel records succesvol zijn verwerkt
hoeveel records fouten bevatten
We leggen elke kaart in detail uit in een apart artikel.
Acties
Gebruikers met de juiste rechten kunnen:
nieuwe importtaken aanmaken door bestanden te uploaden
importtaken handmatig valideren
importtaken handmatig verwerken
importtaken verwijderen
het originele bestand downloaden na upload
Niet mogelijk:
een lopende verwerking annuleren
een mislukte taak opnieuw starten zonder nieuw bestand te uploaden
Hoe je net een import job kan uploaden, leggen we in een ander artikel uit.
Gedragingen & Logica
Het importproces
Een importtaak doorloopt verschillende fasen:
Aanmaken en uploaden
Na upload wordt een importtaak aangemaakt met status created.
Lezen en opslaan
Het systeem leest het bestand, extraheert de data en slaat deze tijdelijk op. Status evolueert via reading en storing naar stored.
Validatie
Gegevens worden gecontroleerd op fouten en consistentie. Status wordt validating en daarna validated of invalid bij fouten.
Verwerking
Gevalideerde data wordt definitief opgeslagen. Status wordt processing, daarna processed en uiteindelijk finished.
Naverwerking
Optionele bijkomende stappen kunnen volgen. Status blijft finished zodra alles is afgerond.
Bij fouten kan de status failed worden.
Voortgangsberekening
De voortgang wordt berekend op basis van de actieve stap:
Opslaan
Verwerkte bestanden ÷ geüploade bestandenValidatie
Gevalideerde waarden ÷ totaal aantal waardenVerwerking
Verwerkte waarden ÷ gevalideerde waardenNaverwerking
Uitgevoerde acties ÷ gevraagde acties
Automatisch versus handmatig verwerken
Bij upload kan gekozen worden tussen:
Automatische verwerking
Validatie en verwerking starten automatischHandmatige verwerking
Gebruiker start validatie en verwerking via knoppen
Beschikbare knoppen zijn afhankelijk van:
het type import
de huidige status van de taak
Situatie | Gedrag |
Voortgang 100% maar niet afgerond | Volgende stap moet nog starten |
Status ongeldig | Validatiefouten zijn gevonden |
Status mislukt | Verwerking is mislukt |
Geen entiteitstabbladen | Bestand bevat geen herkende data |
Veel fouten | Controleer bronbestand en regels |
Lange verwerkingstijd | Grote bestanden of hoge systeembelasting |
Waarom blijft mijn importtaak lang bezig?
Grote bestanden, complexe validaties of hoge systeembelasting kunnen de verwerking vertragen.
Waarom toont de voortgang 100% maar is de taak niet klaar?
De huidige stap is voltooid, maar een volgende stap moet nog starten.
Kan ik een importtaak stoppen?
Nee, lopende taken kunnen niet geannuleerd worden.
Waarom zijn sommige waarden ongeldig?
Veelvoorkomende oorzaken zijn ontbrekende verplichte velden, foutieve formaten of ontbrekende referenties.
Hoe kan ik een mislukte import herstellen?
Corrigeer het bronbestand en upload een nieuwe importtaak.
Wat gebeurt er met het geüploade bestand?
Na succesvolle verwerking wordt het bestand gearchiveerd en blijft het downloadbaar via de detailpagina.
Waarom zie ik geen verwerk-knop?
De knop verschijnt alleen in specifieke statussen, afhankelijk van het importtype.
Importtaak
Registratie van een bestand en het volledige importproces.Status
Huidige fase van de importverwerking.Voortgang
Percentage dat de voortgang van de actieve stap aangeeft.Validatie
Controle van data op fouten en naleving van regels.Verwerking
Opslaan van gevalideerde data in het systeem.Dataprovider
Configuratie die bepaalt hoe een import wordt behandeld.Bestandsformaat
Structuur van het importbestand, zoals CSV of XML.Entiteittype
Soort data dat geïmporteerd wordt, zoals klant of meter.Overgedragen waarden
Aantal datawaarden dat uit het bestand werd gelezen.Messages
Logmeldingen die informatie, waarschuwingen en fouten tonen tijdens de import.