Data Quality Solutions 12-4-2012 MicrosoftDatum: Dynamics CRM 2011 Versie 1.5
Versie 2.1 Datum: 01/06/2012
Inhoud 1.
Inleiding............................................................................................................................................ 3
2.
KVK-integratie .................................................................................................................................. 4
3.
Update service ................................................................................................................................. 5
4.
Leadgenerator .................................................................................................................................. 6
5.
Installatie.......................................................................................................................................... 8
6.
Configuratie ..................................................................................................................................... 9 Aanmaken Webservices.nl instellingen .......................................................................................................9 Instellingen: KvK Zoekscherm ......................................................................................................................9 KvK nummer.............................................................................................................................................. 10 SBI code..................................................................................................................................................... 10 Instellingen: KvK velden ............................................................................................................................ 10 Adres en huisnummer............................................................................................................................... 11 Instellingen: KvK extended velden ............................................................................................................ 11 Autorisatie................................................................................................................................................. 12 Beheer Webservices.nl instellingen .......................................................................................................... 12 Proxy instellingen ...................................................................................................................................... 12
Bijlage 1: KvK gegevens op het Account formulier ................................................................................ 13
Pag 2 van 13
1. Inleiding Inhoud document Bijgaande document geeft een beschrijving van drie functionele processen met bijhorende instructie ten behoeve van installatie en configuratie. Vereist kennisniveau Er wordt uitgegaan van basisvaardigheden inzake installatie van Solutions binnen Microsoft Dynamics CRM 2011. Testomgeving - liveomgeving Wij willen expliciet wijzen dat de beschreven stappen altijd eerst in een testomgeving worden uitgevoerd. Pas nadat u zelf heeft beoordeeld dat de solutions werken zoals gewenst kunt u ze overzetten naar de liveomgeving.
Pag 3 van 13
2. KVK-integratie Doel Invoer van een nieuw account is met de KvK-integratie snel en foutloos uitgevoerd. Werkwijze Voeg binnen CRM een nieuw account toe en zoek vervolgens in KvK.
Er kan gezocht worden op postcode + huisnr (+ evt. toevoeging), of wanneer deze niet bekend zijn op accountnaam, adres, plaats en telefoonnummer. De 1e zoekactie zoekt op exacte overeenkomsten. Hierna verschijnt een 2e zoekknop “Zoek uitgebreider” welke kan worden gebruikt om nogmaals te zoeken naar alles wat er op lijkt.
Middels overnemen worden de gegevens overgenomen naar Microsoft CRM.
Pag 4 van 13
3. Update service Doel Middels de update services kunnen updates van de KvK worden ontvangen waardoor het relatiebestand altijd up-to-date is. Werkwijze Selecteer binnen CRM
:
Haal alle updates op:
Selecteer relevante wijzigingen en voer deze door.
Pag 5 van 13
4. Leadgenerator Doel Middels de leadgenerator kan eenvoudig een doelgroep worden geselecteerd en in CRM worden ingelezen, hierbij wel rekening houdend met reeds bestaande accounts (op basis van KVK-nummer). Leads worden ingelezen als accounts. Werkwijze Selecteer binnen CRM :
Selecteer de branches, regio en kenmerken:
Ga naar het resultaat van de selectiecriteria en importeer de selectie.
Pag 6 van 13
Alleen de nieuwe accounts worden ingelezen:
Ga naar instellingen / extensies / lead imports voor het resultaat.
Pag 7 van 13
5. Installatie De installatie bestaat uit het importeren van twee zip-bestanden als zgn. Oplossing (“solution”). Hieronder wordt uitgelegd hoe dit dient te worden uitgevoerd. Er dienen twee “Solutions” te worden geïmporteerd in Microsoft Dynamics CRM; dit met de volgende volgorde: 1. wsnlWebservicesCommon.zip (algemene componenten) 2. wsnlWebservicesKvK.zip (KvK specifieke componenten) Werkwijze Ga naar Instellingen / Aanpassing / Oplossingen Klik op knop importeren Selecteer met knop bladeren het te importeren zipbestand Klik op knop volgende om informatie over de oplossing weer te geven Klik op knop volgende om import opties te zetten Vink de evt. getoonde optie aan en klik op knop volgende om de import te starten. Wanneer de import is afgelopen wordt een resultaatscherm getoond, klik op sluiten Herhaal dit voor het 2de importbestand.
Pag 8 van 13
6. Configuratie Aanmaken Webservices.nl instellingen Voor het aanmaken van de algemene instellingen, ga naar instellingen / extensies / webservices.nl configuratie.
Vul bij “Algemeen” het goede UserId en Password in. Deze zijn te verkrijgen bij webservices.nl.
Het ingevoerde userid en password kan direct op geldigheid worden getest met behulp van het knopje “Test verbinding” rechtsbovenin de Ribbon.
Instellingen: KvK Zoekscherm Het “KvK Zoekscherm” bevat een aantal configuratie opties voor het KvK zoekscherm.
Er zijn 3 opties voor het zoekscherm te configureren. 1. Direct zoeken bij openen: indien Ja, dan zal na het openen van het KvK zoekscherm automatisch direct aan de hand van de reeds ingevoerde gegevens in het accountscherm, worden gezocht. 2. Direct ophalen bij 1 zoekresultaat: indien Ja, dan zal wanneer “Zoeken” exact 1 resultaat oplevert deze automatisch worden geselecteerd en opgehaald 3. Alleen econ.actieven in uitgebreide zoekresultaten: indien Ja, dan zullen in de resultaten van “Uitgebreid zoeken” alleen bedrijven die in KvK als “Economisch Actief” zijn gekenmerkt worden getoond (dus geen financiële holdings, verenigingen etc.)
Pag 9 van 13
KvK nummer Een KvK nummer bestaat standaard uit 2 delen: Ondernemingsnummer Vestigingsnummer
Voor omnummeren van oude naar nieuwe KVK nummering kan contact worden opgenomen met webservices.nl.
SBI code De KvK velden voor SBI code en –omschrijving kunnen zodanig geconfigureerd worden dat deze overeenkomen met een lookup op het account formulier (standaard configuratie).
Voor ieder gevraagd veld kan een afwijkend, zelfgedefiniëerde entieit / veld worden opgegeven: SBI entiteit entiteit van de lookup SBI entiteit: code veld naam van code in de entiteit SBI entiteit: omschrijving veld naam van omschrijving in de entiteit De Addon zoekt de code van de SBI op in de aangegeven lookup entiteit. Wanneer deze niet wordt gevonden zal de SBI code automatisch als volgt worden toegevoegd: 1. Er wordt een nieuw record gecreëerd van de SBI lookup entiteit 2. SBI code wordt gezet in het zgn. “Code veld” 3. SBI code + SBI omschrijving worden samen gezet in het zgn. “Omschrijving veld” 4. De Guid (het “id” veld) van dit nieuwe record wordt gezet in het account als SBI code
Instellingen: KvK velden Op tabblad “KvK Velden” kan geconfigureerd worden welke KvK gegevens met welke CRM velden op het account formulier overeenkomen. Pag 10 van 13
Voor de standaard gebruikte velden zie ook bijlage. Voor ieder genoemd veld in dit scherm kan een afwijkend, zelf gedefinieerd veld (of standaard CRM veld) worden opgegeven. Wanneer een CRM veld niet op het accountformulier aanwezig is dan wordt het KvK gegeven genegeerd. Het is niet verplicht om alle velden op het accountformulier beschikbaar te hebben.
Adres en huisnummer Een KvK adres bestaat standaard uit 3 delen: Straatnaam Huisnummer Huisnummer extensie De Addon voegt Huisnummer en Huisnummer extensie altijd samen: Huisnummer: 8, Huisnummer extensie: b wordt: 8b Met het vinkje kan worden geconfigureerd of de Straatnaam en het Samengevoegde huisnummer samen in 1 veld komen (standaard: address_line1) of gescheiden in 2 velden (standaard: address_line1 en address_line2).
Instellingen: KvK extended velden Op tabblad “KvK Velden Account” kan geconfigureerd worden welke KvK gegevens met welke CRM velden op het account formulier overeenkomen.
Pag 11 van 13
Autorisatie Gebruikers kunnen worden geautoriseerd voor de diverse modules van de Webservices.nl Addon door ze bepaalde beveiligingsrollen te geven. LET OP: ook een systeembeheerder zal zonder genoemde rollen de modules niet kunnen gebruiken!
Beheer Webservices.nl instellingen Om de instellingen in de entiteit Webservices.nl instellingen te kunnen bewerken dient een gebruiker voldoende rechten hiertoe te bezitten op deze entiteit.
Proxy instellingen De CRM server dient toegang te hebben tot de volgende url: https://ws1.webservices.nl De Addon maakt op de CRM server gebruik van de proxy-instellingen zoals geconfigureerd binnen Internet Explorer op die server. Zorg ervoor dat de proxyserver OF de sandbox user van CRM toegang geeft tot bovengenoemde url OF de bovengenoemde url volledig toegang geeft (evt. op basis van ip-adres)
Pag 12 van 13
Bijlage 1: KvK gegevens op het Account formulier De KvK Addon levert voor een gevonden account 22 velden aan die eventueel kunnen worden overgenomen. Onderstaande tabel toont de gegevens die de KvK Addon levert met de overeenkomstige velden in CRM. Alle genoemde CRM attributen kunnen worden vervangen door andere zelfbepaalde attributen. Wanneer een CRM veld niet op het accountformulier aanwezig is dan wordt het KvK gegeven genegeerd. Gegeven KvK nummer Handelsnaam Bezoekadres straat Bezoekadres huisnr Bezoekadres huisnr-extensie
KvK Datatype char max 13 char max 132 char max 43 char max 5 char max 40
Bezoekadres postcode Bezoekadres plaats Postadres straat Postadres huisnr Postadres huisnr-extensie
char 7 char max 24 char max 43 char max 5 char max 40
Postadres postcode Postadres plaats SBI code primair SBI code 1 SBI code 2 Telefoon Website Organisatietype Rechtsvorm code Rechtsvorm omschrijving Personeel Economisch actief Non-mailing indicatie
char 7 char max 24 char max 6 char max 6 char max 6 char max 12 char max 100 char max 15 char max 2 char max 82 number bit bit
CRM Account entiteit Standaard attribuut (schemanaam) wsnl_kvkno name 1) address1_line1 Aan-elkaar, in: - address1_line1 (samen met straat) 1) - of address1_line2 (separaat) address1_postalcode address1_city 1) address2_line1 Aan-elkaar, in: - address2_line1 (samen met straat) 1) - of address2_line2 (separaat) address2_postalcode address2_city wsnl_sbicodeid wsnl_sbicodeid wsnl_sbicodeid telephone1 websiteurl wsnl_organizationtype wsnl_legalformcode wsnl_legalformcodeoms numberofemployees wsnl_econactive wsnl_kvknonmailing
Vestigingsnummer Hoofdkantoor Hoofdkantoor vestigingsnummer Wettelijke naam Contactpersoon Import actief Export actief Maatschappelijk kapitaal Gestort kapitaal Geplaatst kapitaal Datum oprichting Datum start activiteiten Datum wijziging rechtsvorm
char max 12 bit char max 12 char max 100 char max 100 bit Bit char max 20 char max 20 char max 20 Datetime Datetime datetime
wsnl_establishmentno wsnl_mainbranche wsnl_mainestablishmentno wsnl_legalname wsnl_contactperson wsnl_import_active wsnl_export_active wsnl_authorizedcapital wsnl_paidupcapital wsnl_issuedcapital wsnl_foundingdate wsnl_establishmentdate wsnl_continuationdate
datetime 1) 2)
2)
wsnl_kvklastupdated
2)
afhankelijk van configuratie de Addon legt de datum + tijd vast van de laatste verrijking van het account
Pag 13 van 13