Om de Dynamics CRM service te configureren zijn er verschillende stappen nodig. Volg onderstaande instructie om de service te activeren.
Stap 1: Een app registratie aanmaken
Ten eerste gaan we een app registratie aanmaken. Het kan zijn dat je hier zelf geen rechten toe hebt, in dit geval is het waarschijnlijk dat jouw IT-partij de app registratie voor je kan aanmaken. Volg deze stappen:
1. Log in op https://portal.azure.com
2. Ga naar Microsoft Entra ID
3. Ga naar app- registraties en kies voor '+nieuwe registratie'
4. Geef de registratie een logische naam, bijvoorbeeld 'Hix Dynamics koppeling'
5. Op de pagina 'Overzicht' zie je het toepassings-id (client-id) en de Map-id (tenant-id), bewaar deze. Deze heb je later nodig in Hix en Dynamics
6. Ga naar certificaten en geheimen en maak een nieuw clientgeheim aan
7. Stel de geldigheid in op 2 jaar (maximum) en sla de waarde op die in beeld komt. Deze verschijnt maar 1 keer, en heb je later ook nodig in Hix
8. Ga naar API-machtigingen
9. Voeg een nieuwe machtiging toe. Er opent nu een scherm waarin je kunt kiezen voor 'Dynamics CRM'. Voeg de permissie 'user_impersonation' toe.
10. Ga naar het Manifest, en zet allowPublicClient op 'True' (alleen voor AAD Graph-app-manifest, niet voor het nieuwe manifest)
Stap 2: Een application user aanmaken
Nu moeten we in Dynamics een zogeheten application user aanmaken. Volg deze stappen:
1. Log in op Dynamics en ga naar settings > security > users
2. Selecteer de systeem view en kies ervoor om een nieuwe application user aan te maken
3. Geef de gebruiker een logische naam.
4. Bij application id, vul je het toepassings-id welke je bij het maken van de app registratie hebt bewaard (zie stap 5 van het aanmaken van de app registratie).
Stap 3: Je Web API URL ophalen
Om de koppeling in Hix te maken, hebben we ook de Web API URL nodig, deze haal je eenmalig op via je Power Apps dashboard. Volg onderstaande stappen:
1. Login op je Power Apps dashboard: https://make.powerapps.com/
2. Ga naar 'environments' (of omgevingen) rechtsboven en selecteer je Dynamics omgeving
3. Klik op het settings icoon en ga naar 'developer resources'
4. Nu verschijnt je Web API endpoint. Bewaar deze voor de volgende stap.
Stap 4: De service instellen in Hix
Ten slotte kunnen we de koppeling maken in Hix. Volg deze stappen:
1. Login op je Hix omgeving en ga naar je beheerdersportaal
2. In het menu 'services' kies je voor 'service toevoegen'
3. Hier zoek je de Dynamics service op en klik je op installeer
4. Vul de gevraagde gegevens in die we in de vorige stappen hebben verzameld en klik op ´configueer´. Er verschijnt een groene melding als alle gegevens correct zijn.
Nu kun je mapping instellen voor de bedrijven en contactpersonen:
5. Kies het gebruikte formulier voor bedrijven en match de velden in Hix met de velden uit Dynamics
6. Kies het gebruikte formulier voor klantgebruikers en match de velden in Hix met de velden uit Dynamics
7. Indien gewenste, kies de gewenste juridische eenheid en project. Wanneer je deze velden leeg laat, wordt alles uit Dynamics gesynct.
8. Sla de instellingen op.