Table of Contents | ||
---|---|---|
|
Inleiding
Uit bevragingen van zowel de burger als de lokale besturen blijkt dat de afvalophalingskalender één van de meest gewenste functionaliteiten is voor de Mijn Burgerprofiel app. Daarom
Voor steden en gemeenten binnen het werkingsgebied van limburg.net was deze functionaliteit al beschikbaar. Nu hebben we het nu mogelijk gemaakt om de afvalophalingskalender aan te bieden in de de rest van Vlaanderen. Zo kunnen we via de Mijn Burgerprofiel app en en gemeente-app(s) burgers aan de afvalophalingen te helpen herinneren met behulp van pushnotificaties.
...
De gegevens zullen in deze pilootfase door het MBP app team worden geïmporteerd.
Doelstellingen pilootfase
De afvalkalender in een beperkte selectie van lokale MBP apps aanbieden, voor een kleine groep steden en gemeenten.
De afvalkalender uitrollen op een gecontroleerde manier en op kleine schaal.
Samen nagaan met de afvalintercommunales of we alles uit de interviews goed vertaald hebben naar functionaliteit.
Feedback verzamelen over de opzet en inhoud zodat we verder kunnen optimaliseren waar nodig en daarna breder kunnen uitrollen.
Overzicht verloop pilootfase
View file | ||
---|---|---|
|
Afvaldata in Mijn Burgerprofiel app
We delen het model achter de afvaldata binnen Mijn Burgerprofiel op in 3 grote peilers:
Deze 3 peilers worden verder in dit document meer in detail toegelicht. Er wordt bij het importeren een stabiele link gelegd tussen deze 3 peilers onderling om de burger de kalender te kunnen tonen in Mijn Burgerprofiel.
...
Hieronder wordt meer in detail uitgelegd wat elke peiler inhoudt.
AfvalkalenderTypes
AfvalkalenderTypes zijn alle items, alle blokken, die een afvalintercommunale op de afvalkalender wil kunnen tonen.
...
afvalkalenderTypes in MBP app, getoond in de lijstweergave |
---|
Groepen
Een groep bestaat uit een lijst van adressen (straat, huisnummer(s), postcode en naam gemeente). Een groep komt bijgevolg overeen met één ophaalronde van een afvalintercommunale.
...
Een adres mag in meerdere groepen voorkomen: stel dat een adres voor alle ophalingen een vast stramien volgt maar voor GFT-ophalingen een ander specifieker ritme, dan moet dit adres zowel voorkomen in het importbestand met de reguliere ophalingen als in het importbestand met de GFT-ophalingen.
Het importsysteem verwacht vandaag één lijn (rij in een importbestand) per postcode. Een straat die doorheen meerdere gemeenten in het grondgebied loopt, moet ontdubbeld worden.
Huisnummers kunnen toegevoegd worden volgens volgende definities:
Even huisnummers van een straat
Oneven huisnummers van een straat
Beide (alle) huisnummers van een straat
Exhaustieve lijst van huisnummers van een straat (even en onever in een aparte cel)
Afvalkalenders
Dit is de laatste peiler in het model van de afvaldata. Hierbij wordt voor een bepaalde groep (adressenlijst, ophaalronde) afvalkalenderTypes ingepland op een kalender. De kalender kan voor een periode van een jaar of half jaar geïmporteerd worden. De kalender hoeft niet noodzakelijk te starten bij een nieuw kalenderjaar.
...
Note |
---|
Algemene richtlijn: lever bij voorkeur de bronbestanden uit Recycle rechtstreeks aan. Elke manuele interventie kan de foutgevoeligheid verhogen. Voor de import van Groepen en Kalenders volgen we het Recycle-formaat. Groepen: er zijn evenveel importbestanden nodig voor de groepen als er groepen (ophaalrondes) zijn in een gemeente of stad. Is een gemeente ingedeeld in 2 zones, dan hebben we 2 importbestanden nodig om de groepen op te maken. Kalenders: er zullen even veel kalenders nodig zijn als er groepen of ophaalrondes bestaan in een gemeente of stad. Een kalender correspondeert één-op-één met een groep. AfvalkalenderTypes: in tegenstelling tot de andere importbestanden is er voor de afvalkalenderTypes slechts één importbestand per gemeente nodig. Zorg ervoor dat de afvalkalenderTypes exact benoemd zijn in dit importbestand zoals in het kalender-importbestand. |
Sjablonen importbestanden
Lege sjablonen
AfvalkalenderTypes | Groep | Afvalkalender | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
Ingevulde voorbeeldbestanden
AfvalkalenderTypes | Groep | Kalender | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
|
Notificaties
De app gebruiker kan notificaties ontvangen vanuit de MBP app als de burger de push notificaties voor de afvalkalender heeft ingeschakeld.
...
Stappen | Schermen |
---|---|
Notificaties moeten door de gebruiker geactiveerd worden. Dit kan tijdens de onboarding flow of nadien via het Profiel in de app. | |
Een push notificatie wordt uitgestuurd de dag voordien of de dag zelf. Eén of meerdere afvalkalenderTypes worden hierbij getoond in de notificatie. |
Foutcorrectie in de afvaldata
Wanneer u een fout ontdekt in de afvaldata (afvalkalenderTypes, Groepen of Kalenders) kunnen die in deze fase enkel door Digitaal Vlaanderen gecorrigeerd worden.
...
In de toekomst zullen afvalintercommunales hiervoor zelf kunnen aanmelden op een portaal om de nodige aanpassingen zelf door te kunnen voeren via een grafische interface.
Steekproeven en validatie afvaldata in de pilootfase
We bieden de mogelijkheid aan voor afvalintercommunales om de geïmporteerde afvaldata zelf te valideren. Hiervoor is het mogelijk om toegang te krijgen tot onze demo app.
Stel hiervoor één contactpersoon die toegang zal krijgen tot onze demo app. Enkel deze persoon kan dan de validatie doen. Idealiter beperken we ons tot een iOS-gebruiker.
FAQ
Hoe lever ik de importbestanden aan?
Status | ||||
---|---|---|---|---|
|
De ingevulde importbestanden mogen doorgestuurd worden naar Daan De Ridder.
Ga gestructureerd tewerk en splits alles op per gemeente:
Lever alle benodigde importbestanden in één zip-bestand per gemeente aan
Steek de afvalkalenderTypes in de root folder
Maak telkens één folder waarin één groep en corresponderende kalender samenzitten en geef deze folder een unieke naam (bvb. Zone 1A - Groep en kalender).
Pas een gestandaardiseerde naamgeving toe per gemeente en per importbestand. Zorg voor een duidelijk interpreteerbare naamgeving. Enkele voorbeelden:
AfvalkalenderTypes_Herentals_20241206
Groep1A_Herentals_20241206, Maandagronde_Herentals_20241206, ZoneA_Herentals_20241206, …
Kalender1A_Herentals_20241206, KalenderMaandagronde_Herentals_20241206, KalenderZoneA_Herentals_20241206, …
Bij de import worden stabiele links gelegd tussen de importbestanden onderling. Exacte schrijfwijze in de importbestanden en unieke naamgeving zijn dus essentieel om dit te doen werken zoals bedoeld.
Hoe afvalkalenderTypes benoemen?
Status | ||||
---|---|---|---|---|
|
Lever een lijst aan van de Types zoals die ook op de papieren kalender benoemd zijn.
Zet geen tijdsaanduiding in de naamgeving van een afvalkalenderType zoals “Morgen” of “Vandaag”. Dit maakt de bewoording in de notificaties onduidelijk voor een gebruiker.
Enkele voorbeelden van afvalkalenderTypes:
PMD
GFT
Restafval
Snoeihout
KGA
Repair café
Recyclagepark gesloten
Feestdag: geen ophaling
Paasmaandag: geen ophaling
Zorg er steeds voor dat de afvalkalenderTypes exact dezelfde naamgeving hebben zoals gebruikt in het importbestand(en) van de corresponderende kalender.
Staat er een kolom in het kalender-importbestand waarvoor geen afvalkalenderType beschikbaar is (bvb. PMD staat op de kalender maar werd niet opgenomen in het bestand met de afvalkalenderTypes), dan zal de import falen en moet er een correctie gebeuren in de importbestanden. Na correctie doen we de import opnieuw.
Achtergrondkleur bij de iconen voor afvalkalenderTypes
Het achtergrondkleur van de iconen kan vrij gekozen worden door de afvalintercommunale. Dit achtergrondkleur wordt ingevuld als hexadecimale code (bijvoorbeeld #008430) in het importbestand van de afvalkalenderTypes.
...
Icoon + achtergrondkleur | Naam icoon | HEX-code achtergrondkleur |
---|---|---|
banden | #687483 | |
batterijen | #7E9E00 | |
gft | #009E47 | |
glas | #D53D5E | |
grofvuil | #9F5804 | |
kerstboom | #007A37 | |
kga | #B32535 | |
metaal | #16465B | |
ophaling | #333332 | |
ophaling-afwijking | #E67300 | |
papier | #E67300 | |
placeholder | #16465B | |
pmd | #149CD7 | |
recyclagepark | #009E47 | |
recyclagepark-gesloten | #D2373C | |
repair-cafe | #0546A5 | |
restafval | #8695A8 | |
snoeihout | #009E47 | |
textiel | #E67300 | |
tuinafval | #009E47 |
Hoe vul ik het sjabloon voor de groepen in?
Status | ||||
---|---|---|---|---|
|
Start vanaf een export uit Recycle.
Valideer of de kolommen en de volgorde overeenkomen met het sjabloon voor Groepen.
Even - Oneven - Beide - Straatnaam - Postcode - Gemeente
Hoe vul ik het sjabloon voor de kalender in?
Status | ||||
---|---|---|---|---|
|
Start vanaf een export uit Recycle:
Wij importeren bij voorkeur steeds rechtstreeks de CSV-export uit Recycle.
De kolommen moeten exact overeenkomen met de ingevoerde afvalkalenderTypes in het sjabloon met de afvalkalenderTypes.
Staat er een kolom in het kalender-importbestand waarvoor geen afvalkalenderType beschikbaar is (bvb. PMD staat op de kalender maar werd niet opgenomen in het bestand met de afvalkalenderTypes), dan zal de import falen en moet er een correctie gebeuren in de importbestanden. Na correctie doen we de import opnieuw.
De eerste kolom toont de datums voor de komende ophaalperiode. We hanteren het volgende formaat (ISO-norm 8601): YYYY-MM-DD
Om een ophaling aan te duiden, vullen we een “x” in voor een bepaalde datum en corresponderend afvalkalenderType.
Foutje gespot in een importbestand of in de MBP app?
Status | ||||
---|---|---|---|---|
|
Corrigeer het bestand en lever ons een nieuwe versie aan. Wij doen de import opnieuw.
...
Als een afvalkalenderType wordt gebruikt in de afvalkalender, maar niet aanwezig was in het importbestand met de afvalkalenderTypes, dan zal de import falen. Na correctie in de importbestanden doen we de import opnieuw.
Waarom ontvang ik als burger geen notificaties?
Status | ||||
---|---|---|---|---|
|
Het kan voorkomen dat een burger geen notificaties ontvangt vanuit de MBP app. Controleer dan achtereenvolgens deze zaken om te voorkomen dat u notificaties mist:
Stap | Screenshot |
---|---|
Open hiervoor de lokale Mijn Burgerprofiel app en ga naar Profiel > Notificaties. Activeer noticaties voor afvalophalingen en stel een tijdstip in. | |
Voor iOS:
Voor Android:
| |
Een gebruiker kan instellen om de dag voor een ophaling of de dag van de ophaling zelf een notificatie te ontvangen. Na activatie van de notificaties moet ook een tijdstip gekozen worden. | |
Het gebruik van de batterijbesparende modus of de modus “Niet storen” kan de prestaties van apps en het apparaat beïnvloeden. Sommige taken en functies doen er langer over om te voltooien of bij te werken. Daarnaast ontvangen apps die op de achtergrond draaien mogelijk geen updates of meldingen wanneer de energiebesparende stand of “Niet storen” modus is ingeschakeld. | |
Via deze iOS-functionaliteit worden notificaties van de dag gebundeld en op een bepaald tijdstip getoond aan de app-gebruiker. |
Digitaal Vlaanderen contacteren ivm de afvalkalender
Tijdens de pilootfase zal alle opvolging via Daan De Ridder verlopen.
...