Handleiding Adres Validator

1. Inleiding

Bijgaand document geeft een beschrijving van installatie, configuratie en werkwijze van deze Adresvalidator App.
Als eerste worden in de inleiding enkele uitgangspunten opgesomd waarna de voorwaarden worden benoemd om te gaan werken met deze App.

De Adresvalidator App is geschikt voor zowel Dynamics 365 / CRM omgevingen als voor Dataverse / Power Apps omgevingen.
In dit verdere document wordt voor zowel de Dynamics 365 / CRM omgeving als de Dataverse / Power Apps omgeving gesproken over “Microsoft CRM”.

1.1 Uitgangspunten

Multi-language
Alle functionaliteit ondersteund de multi-language functionaliteit van Microsoft CRM. Momenteel is de functionaliteit in twee talen; te weten Nederlands en Engels.

Versie Microsoft CRM
De ondersteunde versie is altijd de laatste en voorlaatste versie (wave) van Microsoft CRM.

Online vs. on-premise
Alleen de online versie wordt ondersteund.

1.2 Voorwaarden

Vereist kennisniveau
Er wordt uitgegaan van basisvaardigheden inzake installatie van Solutions binnen Microsoft CRM.

Garanties
Wij kunnen vooraf geen garanties geven voor werking van de Solutions in alle mogelijke Microsoft CRM omgevingen. Zeker bij “complexere” infrastructuren dient dit nader te worden onderzocht of getest.

Browsers
Standaard geteste en ondersteunde browsers zijn Chrome (onder Windows) en Edge.

Gebruik test- of OTAP-omgeving
Wij willen er expliciet op wijzen dat de beschreven stappen altijd eerst via een test- of OTAP-omgeving worden uitgevoerd. Na correcte werking kunt u het e.e.a. nogmaals uitvoeren in de productieomgeving. In bepaalde situatie / inrichtingen worden formulieren aangepast en b.v. auditing uitgezet.

2. Functionaliteit adresvalidator

De onderstaande beschrijving somt de stappen op om een adres snel in te voeren en te valideren.
Voor Nederlandse adressen is het makkelijkst om postcode / huisnummer in te voeren:

Middels een enter of het loopje wordt het adres volledig ingevoerd:

De mogelijkheden voor het invoeren van adressen zijn als volgt:

Er wordt altijd een voorbeeld App meegeleverd met voorbeelden van meerdere mogelijkheden op account en contactpersoon om de Adresvalidator te gebruiken.

Bijlage 1: installatie

De installatie verloopt via de Appsource van Microsoft en de upgrade verloopt via het Powerplatform.
Hieronder wordt uitgelegd hoe dit dient te worden uitgevoerd.

Installatie van de App via Appsource

De installatie bestaat uit het inlezen van drie Solutions (Common, Nederlandse bedrijfsgegevens, Update Service) via de App op de Appsource:

Deze kan worden gevonden middels de volgende URL: Microsoft AppSource – Adres Validator

Volg hierbij de standaard stappen en voer dit altijd als eerste uit in een DEV of ACC/TEST-omgeving.

Upgrade van een Solution via Powerplatform

Binnen het PowerPlatform is inzichtelijk van welke Solutions een update beschikbaar is:

Volg hierbij de standaard stappen en voer dit altijd als eerste uit in een DEV of ACC/TEST-omgeving.

Bijlage 2: Configuratie

Om de configuratie uit te voeren dient een gebruiker voldoende rechten te hebben.

Autorisatie

Gebruikers kunnen worden geautoriseerd voor de diverse modules van de Webservices.nl App door ze bepaalde gebruikersrollen te geven. LET OP: ook een systeembeheerder zal zonder genoemde rollen de modules niet kunnen gebruiken!

Aanmaken algemene instellingen (Common)

Voor het aanmaken van de algemene instellingen, ga naar de App DQS Configuraties:

Vul vervolgens bij onderstaande de Gebruikersnaam en het Wachtwoord in welke via de leverancier / partner te verkrijgen zijn en sla deze op.
Indien nog geen gebruikersnaam aanwezig is kan een proeftegoed geautomatiseerd worden aangevraagd via het tabblad dat verschijnt naast het tabblad “Ik heb al een account”:

Aanmaken adresvalidatie instellingen

De adresvalidator is een zogeheten PCF (component) welke op ieder scherm en entiteit 1 of meerdere keren kan worden geplaatst.

Ga hiertoe naar de formulier editor en configureer het veld waarop de PCF wordt geplaatst:

 

Voer vervolgens de mapping in van de velden:

 

Bijlage 3: Beheer landentabel

Er wordt een landentabel meegeleverd welke wordt gebruikt voor het zoeken van adressen in andere landen.  Indien landen worden gedeactiveerd dan zijn deze niet meer inzichtelijk bij de landenlijst.

Bij een update van de App worden de landen overgeschreven dus indien andere namen worden gebruikt dan dienen deze los te worden toegevoegd.