Naar de hoofdinhoud

Configuratie - Jobs - Data providers

Meer dan 3 weken geleden bijgewerkt

Dataproviders maken het mogelijk om gegevens automatisch of handmatig te importeren vanuit externe bronnen, zoals FTP/SFTP-servers of e-mail. Ze vormen de koppeling tussen Zero Friction en externe datasystemen die bestanden aanleveren, bijvoorbeeld meterstanden of andere bulkdata.

U vindt dit onderdeel via Configuratie → Jobs → Dataproviders.

Een correcte configuratie van dataproviders is essentieel om:

  • meetdata automatisch en tijdig te ontvangen

  • importprocessen te automatiseren

  • handmatige uploads en fouten te verminderen


Wat toont dit onderdeel?


De pagina Dataproviders toont een overzicht van alle geconfigureerde dataproviders.

Per dataprovider ziet u:

  • Naam – De door u gekozen naam van de provider

  • Bestandsformaat – Het formaat dat gebruikt wordt om bestanden te lezen

  • Communicatietype – FTP, SFTP, FTPS of inkomende e-mail

  • Uitgeschakeld – Of de provider tijdelijk is gedeactiveerd

  • Automatische verwerking – Of importjobs automatisch worden verwerkt of handmatig moeten worden goedgekeurd

Wanneer er nog geen dataproviders bestaan, wordt een lege status getoond met de melding “Geen dataproviders gevonden” en een knop om een nieuwe provider aan te maken.


Indeling

Algemene gegevens

Bij het aanmaken of bewerken van een dataprovider configureert u:

  • Naam – Unieke en herkenbare naam (bijv. Hoofd FTP meterdata)

  • Bestandsformaat – Ingebouwd of aangepast formaat uit Configuratie → Jobs → Bestandsformaten


Communicatiemethode

U kiest één vaste manier waarop bestanden worden aangeleverd:

  • FTP – Standaard bestandsoverdracht

  • SFTP – Beveiligde overdracht via SSH

  • FTPS – FTP met SSL/TLS

  • Inkomende e-mail – Bestanden als e-mailbijlage

Het communicatietype kan na aanmaak niet worden gewijzigd. Voor een ander type moet een nieuwe dataprovider worden aangemaakt.


Verbindingsinstellingen (FTP / SFTP / FTPS)

Voor server-gebaseerde providers configureert u:

  • Host – Serveradres (bijv. ftp.example.com)

  • Poort – Standaard 21 (FTP), 22 (SFTP)

  • Gebruikersnaam

  • Wachtwoord – Veilig opgeslagen, nooit zichtbaar

  • Directory – Pad waar bestanden worden opgehaald


Planning (FTP / SFTP / FTPS)

U bepaalt hoe vaak Zero Friction controleert op nieuwe bestanden:

  • Herhaling (Recurrence):

    • Elke 5 minuten

    • Elke 30 minuten

    • Elk uur

    • Dagelijks

    • Geen (alleen handmatig)

  • Volgende verwerkingsdatum – Tijdstip van de eerstvolgende controle


Verwerkingsopties

  • Automatische verwerking

    • Ingeschakeld: importjobs worden direct verwerkt

    • Uitgeschakeld: importjobs wachten op handmatige goedkeuring

  • Uitgeschakeld

    • Tijdelijk pauzeren zonder verwijderen


Inkomende e-mailproviders

Voor e-mailproviders genereert het systeem automatisch een uniek e-mailadres, bijvoorbeeld:

Bestanden die als bijlage naar dit adres worden gestuurd:

  • worden automatisch ontvangen

  • leiden tot een importjob

  • worden verwerkt volgens de instelling Automatische verwerking


Acties

Gebruikers met de juiste rechten kunnen:

  • dataproviders aanmaken

  • bestaande providers wijzigen

  • providers tijdelijk uitschakelen

  • providers verwijderen (soft delete)

Verwijderde providers zijn standaard verborgen maar blijven bestaan voor historiek.


Gedragingen & Logica

Automatische verwerking

Wanneer een provider actief is en bestanden ontvangt:

  1. Bestanden worden gedownload of ontvangen

  2. Er wordt een importjob aangemaakt

  3. Afhankelijk van de instelling:

    • direct verwerkt, of

    • in wachtrij geplaatst voor handmatige goedkeuring

Importjobs zijn zichtbaar via Jobs → Import.


Planning en herhaling

  • Bij geplande providers controleert het systeem automatisch op nieuwe bestanden

  • Na een succesvolle controle wordt de volgende uitvoertijd berekend op basis van de ingestelde herhaling

Voorbeeld

  • Laatste run: 14:00

  • Herhaling: elk uur

  • Volgende run: 15:00


Wijzigingen

U kunt op elk moment:

  • verbindingsgegevens aanpassen

  • de planning wijzigen

  • automatische verwerking aan- of uitzetten

  • een ander bestandsformaat selecteren

Niet wijzigbaar:

  • het communicatietype (FTP/SFTP/FTPS/e-mail)


Gebruik in Jobs

Dataproviders worden gebruikt voor:

  • geautomatiseerde import van meterstanden

  • bulkimporten via geplande of handmatige jobs

  • e-mailgebaseerde datalevering

Belangrijk: Als het gebruikte bestandsformaat wordt verwijderd, wordt de dataprovider automatisch uitgeschakeld om fouten te voorkomen.



Waarom draait mijn geplande provider niet?
Controleer of de provider niet is uitgeschakeld, een herhaling heeft en de volgende uitvoertijd is bereikt.

Kan ik FTP wijzigen naar SFTP?
Nee. Maak een nieuwe provider aan met het gewenste type.

Wat gebeurt er als ik een bestandsformaat verwijder?
De provider wordt uitgeschakeld; u moet een nieuw formaat koppelen.

Hoe wijzig ik alleen het wachtwoord?
Laat het wachtwoordveld leeg bij bewerken om het bestaande wachtwoord te behouden.

Kan ik meerdere providers op dezelfde server gebruiken?
Ja, bijvoorbeeld met verschillende directories of bestandsformaten.

Welke herhalingen zijn beschikbaar?
Elke 5 minuten, 30 minuten, elk uur, dagelijks of geen (handmatig).


  • Dataprovider – Koppeling met een externe databron

  • Importjob – Registratie van een bestandsimport

  • Herhaling – Frequentie van automatische controles

  • Automatische verwerking – Direct verwerken zonder handmatige goedkeuring

  • Bestandsformaat – Regels voor het lezen van bestanden

  • Communicatietype – Manier van datalevering (FTP, SFTP, FTPS, e-mail)

  • Soft delete – Verwijderen zonder definitieve verwijdering

Was dit een antwoord op uw vraag?