Referentie · Eigen app voor Business Central
Business Central vult plaats en provincie zelf in zodra iemand een postcode typt, maar alleen als de postcodetabel gevuld is. Voor onze eigen administratie begon het met een vaste lijst Nederlandse en Belgische postcodes. Daaruit groeide Postcode Atlas: een app met officiële data voor 121 landen, waarin de beheerder per land kiest wat er geladen wordt.
De app dekt 121 landen met ruim vier miljoen postcodes. Dit zijn de Europese, het gebied waar de klanten van deze app zaken doen.
Overal de volledige postcode, met twee uitzonderingen: Ierland levert alleen routeringssleutels en Malta alleen de beginletters. Bosnië en Herzegovina, Griekenland, Kosovo en Montenegro ontbreken, want de bronnen hebben daar geen postcodes voor. In de app staat per land hoeveel er zijn en hoe volledig de dekking is.
In een nieuwe Business Central-administratie is de postcodetabel leeg. Iedereen die een klant of leverancier aanmaakt, typt de plaatsnaam dan zelf, en dat is terug te zien in de klantenlijst: 's-Gravenpolder, s Gravenpolder, Gravenpolder.
Bij het inrichten van onze eigen administratie loste ik dat op met een kleine extensie: een vaste lijst Nederlandse en Belgische postcodes. Dat werkte, maar alleen voor ons. De vraag werd of het ook voor andere bedrijven kon, met elk land waar zij zaken mee doen, officiële data met een nette bronvermelding, en te installeren vanuit AppSource.
Drie schermen uit de app, gemaakt in een sandbox met de demogegevens van Microsoft.
Per land het aantal beschikbare postcodes, de dekking en de bron. De laatste drie kolommen gaan over deze administratie: staan er postcodes van dit land, hoeveel, en heeft deze app ze geladen. In de demo-administratie staan er zes per land, van Microsoft; de app claimt die niet.
Laden vervangt. De app telt daarom eerst wat er al staat en vraagt of dat weg mag, inclusief postcodes die iemand met de hand heeft ingevoerd. Dit is de vraag die er na de audit bij kwam; daarvoor verdween het zonder waarschuwing.
Geen eigen scherm en geen eigen tabel: de postcodes komen in de tabel Post Codes van Business Central, waar plaats en provincie vandaan komen zodra iemand een postcode typt. Hier Nederland, 468.791 zescijferige codes met BAG-plaatsnamen.
Eén lijst in Business Central, Postcodelanden, en daarachter alles wat nodig is om de postcodetabel betrouwbaar te vullen.
De beheerder ziet 121 landen, met per land het aantal postcodes, de dekking en de bron. Alleen wat de administratie nodig heeft wordt geladen: 1,7 miljoen Britse postcodes laadt niemand voor één Britse klant.
Het laden loopt via de taakwachtrij, zodat niemand zit te wachten. Daarna vult Business Central plaats en provincie zelf in bij elke klant, leverancier, contactpersoon en elk adres.
Laden vervangt de postcodes die er voor dat land staan, ook die iemand met de hand heeft ingevoerd. De app vraagt daarom eerst om bevestiging en noemt om hoeveel postcodes het gaat.
De app houdt bij welke postcodes zij zelf heeft geladen en welke er al stonden. Verwijderen waarschuwt apart als het om postcodes gaat die niet uit de app komen, want die kan de app niet terugzetten.
De data komt van GeoNames en Ordnance Survey, onder licenties die hergebruik toestaan als de bron genoemd wordt. Die vermelding staat per land in de app zelf, niet alleen op een website.
De app is in het Engels geschreven, met een volledige Nederlandse vertaling. De landnamen komen uit dezelfde bron als de postcodes, zodat een Engelstalige gebruiker geen Nederlandse namen in een Engels scherm leest.
Bronnen gekozen op hun licentie: GeoNames voor alle landen en de Nederlandse zescijferige codes met BAG-plaatsnamen, Code-Point Open van Ordnance Survey voor de Britse units. Een script maakt er per land een bestand van en is bij elke nieuwe release opnieuw te draaien. In de Britse data zit geen enkele Noord-Ierse postcode, dus het land heet in de app Great Britain en niet United Kingdom.
De compiler accepteert hooguit 128 MB aan meegeleverde bestanden, en de data was 133 MB. De bestanden gaan daarom gecomprimeerd mee, 16 MB in totaal, en worden bij het laden uitgepakt. Plaatsnamen passen in de dertig tekens van de standaardtabel zonder dat er een woord doormidden gaat.
Na de eerste versie heb ik de code regel voor regel gelezen. Twee dingen gingen om: laden vroeg niet om bevestiging, en een veld zei dat een land geladen was zodra er postcodes stonden, waar die ook vandaan kwamen. Allebei aangepast.
AppSourceCop, Microsofts eigen controle voor AppSource-apps, meldt alleen nog de koppeling voor telemetrie, die bij de indiening wordt ingevuld. Er is een testapp die bij elke wijziging draait, een controle op de naamgeving, en de handleiding, licentievoorwaarden en privacyverklaring staan op deze site.
Postcode Atlas is inhoudelijk af: de data zit erin, de tests zijn groen en de pagina's die Microsoft bij de indiening controleert staan online. Wat rest zijn de aanvragen voor de vermelding op AppSource, waaronder het objectbereik dat Microsoft aan de app toekent.
Voor wie Business Central inricht is het een klein ding met een groot effect: vanaf de eerste klant die wordt aangemaakt volgen plaats en provincie uit de postcode, in plaats van uit het geheugen van degene die typt.
Alleen standaard Business Central. Geen externe dienst en geen API-sleutel: de data zit in de app zelf.
Vertel me wat er ontbreekt. Dan zeg ik eerlijk of een eigen extensie de moeite waard is, of dat er op AppSource al iets bestaat dat volstaat.