Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents
stylenone

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
nameOverzicht verloop pilootfase.pdf

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

image-20241118-135154.png

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

View file
nameImportsjabloon_AfvalkalenderTypes.xlsx

View file
nameimportsjabloon_GroepRecycle.xlsx

View file
nameImportsjabloon_KalenderRecycle.xlsx

Ingevulde voorbeeldbestanden

AfvalkalenderTypes

Groep

Kalender

View file
nameANZEGEM_AfvalkalenderTypes.xlsx

View file
nameANZEGEM_Zone1_Groep.xlsx

View file
nameANZEGEM_Zone1_Kalender.xlsx

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.

image-20241210-134248.pngimage-20241210-134321.png

Een push notificatie wordt uitgestuurd de dag voordien of de dag zelf.

Eén of meerdere afvalkalenderTypes worden hierbij getoond in de notificatie.

image-20241119-122754.pngimage-20241119-122816.png

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
colourYellow
titleAfvalintercommunale

  • 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
colourYellow
titleAfvalintercommunale

  • 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

Afvalicoon wit 20.png

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
colourYellow
titleAfvalintercommunale

  • 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
colourYellow
titleAfvalintercommunale

  • 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
colourYellow
titleAfvalintercommunale

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
colourGreen
titleBurger

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

  1. Werden de notificaties geactiveerd in de MBP app zelf?

Open hiervoor de lokale Mijn Burgerprofiel app en ga naar Profiel > Notificaties.

Activeer noticaties voor afvalophalingen en stel een tijdstip in.

IMG_5C56F5C749B7-1.jpeg

  1. Werden notificaties geactiveerd in de instellingen van het toestel van de gebruiker?

Voor iOS:

  • Instellingen > Meldingen > Burgerprofiel of naam van de lokale app

Voor Android:

  • Instellingen > Meldingen > App meldingen > Burgerprofiel of naam van de lokale app

IMG_A65C25B3C4CE-1.jpeg

image (25).png

  1. Werd het tijdstip waarop de gebruiker de notificatie wenst te ontvangen al bereikt?

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.

IMG_5C56F5C749B7-1.jpeg
  1. Staat de modus voor batterijbesparing uitgeschakeld? Staat de “Niet storen” modus uitgeschakeld?

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.

  1. Enkel iOS: staat “Gepland overzicht” uitgeschakeld om een samenvatting van de dagelijkse notificaties te krijgen?

Via deze iOS-functionaliteit worden notificaties van de dag gebundeld en op een bepaald tijdstip getoond aan de app-gebruiker.

IMG_6162.jpg

IMG_6163.jpg

Digitaal Vlaanderen contacteren ivm de afvalkalender

Tijdens de pilootfase zal alle opvolging via Daan De Ridder verlopen.

...