XrmToolBox: de onmisbare tool voor Dynamics 365-ontwikkelaars

Wat is XrmToolBox?

XrmToolBox is een gratis opensource-applicatie voor Windows die verbinding maakt met uw Dynamics 365- of Power Platform-omgeving en toegang geeft tot honderden tools en hulpprogramma's die door de community zijn gebouwd. Tanguy Touzard bracht de toolbox in 2012 uit, en sindsdien is ze wereldwijd een van de meest gebruikte toolsets voor Dynamics 365-ontwikkelaars, -beheerders en -consultants. Met meer dan 200 plugins, van metadatabeheer tot datamigratie, versnelt XrmToolBox ontwikkelwerk en probleemoplossing aanzienlijk.

De kracht van XrmToolBox zit in de uitbreidbaarheid: het is zowel een startpunt voor tools als een framework waarmee ontwikkelaars eigen plugins kunnen bouwen in C# met de Dynamics 365 SDK. Daardoor is er een levendige community ontstaan waarin ontwikkelaars hun tools delen, met een voortdurend groeiend ecosysteem van hulpprogramma's die echte problemen uit de praktijk oplossen.

Aan de slag met XrmToolBox

Installatie en configuratie

XrmToolBox vereist .NET Framework 4.6.2 of hoger (dat op recente Windows-systemen normaal al geïnstalleerd is). Download de nieuwste versie van de officiële website of installeer ze via de pakketbeheerder Chocolatey.

Installatiestappen:

1. Download XrmToolBox van xrmtoolbox.com
2. Pak het zip-bestand uit naar een vaste locatie (bijv. C:\Tools\XrmToolBox)
3. Voer XrmToolBox.exe uit (geen installatiewizard nodig)
4. Configureer bij de eerste start de verbinding met uw Dynamics 365-omgeving
5. Installeer plugins uit de Tool Library wanneer u ze nodig hebt

Verbinding maken met uw omgeving

Klik op "Create New Connection" en geef de URL van uw Dynamics 365-omgeving en uw aanmeldgegevens op. De tool ondersteunt authenticatie via Office 365, OAuth en on-premises Active Directory. In omgevingen met meervoudige verificatie doorloopt u de gewone aanmeldprocedure van Microsoft.

Best practices voor verbindingen:

• Maak aparte verbindingen voor DEV-, TEST- en PROD-omgevingen
• Gebruik serviceaccounts met passende rechten in plaats van persoonlijke accounts
• Schakel MFA in voor verbindingen met productieomgevingen
• Controleer en verwijder regelmatig ongebruikte verbindingen
• Geef verbindingen een kleurcode om omgevingen te onderscheiden (beschikbaar in de instellingen)

Essentiële plugins die elke ontwikkelaar moet kennen

1. FetchXML Builder

FetchXML Builder is wellicht de populairste plugin van XrmToolBox: een visuele querydesigner om FetchXML-query's te bouwen en te testen. Hij biedt IntelliSense, syntaxiskleuring, het uitvoeren van query's en rechtstreekse conversie naar C#-code of SQL.

Belangrijkste functies:

• Visuele querybouwer waarin u tabellen en kolommen met slepen en neerzetten selecteert
• Query's meteen uitvoeren, met een voorbeeld van de resultaten
• Converteer FetchXML naar QueryExpression, OData, SQL of het Power Automate-formaat
• Ondersteuning voor aggregatiequery's, groeperen en complexe filters
• Exporteer resultaten naar Excel, CSV of XML
• Integratie met andere XrmToolBox-plugins voor bulkbewerkingen

2. Metadata Browser

Met Metadata Browser verkent u de metadata van uw Dynamics 365-omgeving (tabellen, kolommen, relaties, keuzelijsten) in een interface die u kunt doorzoeken en filteren. Onmisbaar om datamodellen te begrijpen, schemanamen op te zoeken en aanpassingen te documenteren.

Veelvoorkomende toepassingen:

• Logische namen en schemanamen van tabellen en kolommen opzoeken
• Kolomtypes, maximale lengtes en validatieregels achterhalen
• Relaties tussen tabellen bekijken (1:N, N:1, N:N)
• Waarden van keuzelijsten en de bijbehorende gehele getallen opzoeken
• Systeemvelden en aangepaste velden van elkaar onderscheiden
• Metadatadocumentatie exporteren naar Excel

3. Plugin Trace Viewer

Plugin Trace Viewer haalt de plugin-tracelogs uit uw Dynamics 365-omgeving op en toont ze, met gedetailleerde uitvoeringsinformatie om plugins en aangepaste workflowactiviteiten te debuggen. Onmisbaar om fouten en prestatieproblemen in plugins op te sporen.

Mogelijkheden voor debugging:

• Filter traces op tabel, message, plugin of periode
• Bekijk gedetailleerde stacktraces van exceptions en foutmeldingen
• Analyseer de uitvoeringsduur van plugins en prestatieknelpunten
• Exporteer traces voor documentatie of om ze met teamleden te delen
• Verwijder oude traces om de databaseprestaties op peil te houden

4. Bulk Data Updater

Met Bulk Data Updater werkt u records massaal bij op basis van FetchXML-query's of weergaven. Dat gaat veel sneller dan handmatig bijwerken, en de tool biedt transactiecontrole, foutafhandeling en voortgangsopvolging.

Toepassingen:

• Projecten voor het opschonen en normaliseren van gegevens
• Velden massaal bijwerken op basis van bedrijfsregels
• Records massaal deactiveren of verwijderen
• Records bijwerken op basis van complexe querycriteria
• Testscenario's die grote datasets vereisen

5. Security Role Configurator (Role Updater)

Security Role Configurator biedt een visuele interface om beveiligingsrollen en rechten te beheren. U kunt rollen naast elkaar vergelijken, rechten massaal bijwerken en rollen klonen tussen omgevingen.

Functies voor beveiligingsbeheer:

• Vergelijk beveiligingsrollen tussen omgevingen
• Kloon rollen binnen of tussen omgevingen
• Werk rechten voor aangepaste tabellen massaal bij
• Exporteer roldefinities voor documentatie
• Spoor verschillen in rechten tussen vergelijkbare rollen op

Geavanceerde plugins voor gespecialiseerde taken

Tools voor het importeren en exporteren van solutions

• Solution Packager: Pak solutions uit en weer in voor integratie met broncodebeheer
• Solution Transfer: Kopieer solutions tussen omgevingen met afhankelijkheidscontrole
• Solution Component Mover: Verplaats componenten tussen solutions

Datamigratie en integratie

• Bulk Workflow Execution: Start workflows op meerdere records tegelijk
• User Settings Utility: Beheer gebruikersvoorkeuren en instellingen in bulk
• WebResources Manager: Upload, download en vergelijk webresources
• View Layout Replicator: Kopieer de lay-out van weergaven tussen tabellen

Ontwikkeling en testen

• Plugin Registration: Registreer plugins, stappen en aangepaste workflowactiviteiten
• Early Bound Generator: Genereer early-bound tabelklassen voor ontwikkeling
• Web Resources Manager: Rol JavaScript-, CSS- en HTML-bestanden uit
• Attribute Manager: Maak kolommen van tabellen aan, werk ze bij of verwijder ze

Productiviteitstips en best practices

Sneltoetsen en efficiëntie

• Gebruik Ctrl+O om snel plugins te openen vanaf het startscherm
• Maak eigen pluginverzamelingen voor tools die u vaak gebruikt
• Maak favoriete plugins vast op het startscherm, zodat u ze met één klik opent
• Gebruik de globale zoekfunctie (Ctrl+F) om plugins te vinden op naam of functionaliteit
• Schakel automatische updates in om nieuwe pluginversies automatisch te ontvangen

Omgevingsbeheer

• Geef verbindingen een kleurcode om onbedoelde wijzigingen in productie te voorkomen
• Maak waar mogelijk alleen-lezen verbindingen voor productieomgevingen
• Gebruik aparte XrmToolBox-installaties voor verschillende klantprojecten
• Documenteer uw verbindingsinstellingen en pluginversies
• Maak regelmatig een back-up van uw configuratiebestand MySettings.xml

Pluginbeheer

• Installeer alleen de plugins die u echt gebruikt, zodat XrmToolBox sneller opstart
• Kijk maandelijks na of er pluginupdates zijn (sommige plugins worden vaak verbeterd)
• Lees de documentatie van een plugin voordat u een onbekende tool gebruikt
• Test destructieve bewerkingen (massaal verwijderen of bijwerken) eerst in DEV
• Verwijder verouderde of ongebruikte plugins om XrmToolBox licht te houden

Eigen XrmToolBox-plugins ontwikkelen

Hebt u een repetitieve taak of een specifieke behoefte die bestaande plugins niet afdekken, overweeg dan om een eigen XrmToolBox-plugin te bouwen. Het framework biedt een stevige basis met ingebouwd verbindingsbeheer, UI-controls en integratie met de SDK.

Vereisten voor pluginontwikkeling

• Visual Studio 2019 of later
• .NET Framework 4.6.2 SDK
• XrmToolBox-pluginsjabloon (beschikbaar via NuGet)
• Basiskennis van Windows Forms of WPF
• Kennis van de Dynamics 365 SDK

Ontwikkelproces

1. Maak een nieuw Class Library-project voor .NET Framework 4.6.2
2. Installeer het NuGet-pakket XrmToolBox.PluginBase
3. Laat uw klasse erven van PluginBase of PluginControlBase
4. Implementeer de vereiste methoden en bouw de UI-controls
5. Build het project en kopieer de DLL naar de map Plugins van XrmToolBox
6. Test de functionaliteit van de plugin grondig
7. Publiceer de plugin in de XrmToolBox Plugin Store voor de community (optioneel)

Aandachtspunten voor beveiliging en compliance

XrmToolBox is bijzonder krachtig, maar u moet het verantwoord gebruiken, zeker in productieomgevingen. Volg altijd het beveiligingsbeleid en de procedures voor wijzigingsbeheer van uw organisatie.

Best practices voor beveiliging

• Minimale rechten: Gebruik serviceaccounts met de minimaal vereiste rechten
• Auditlogging: Schakel auditlogging in Dynamics 365 in voor wijzigingen via XrmToolBox
• Wijzigingsbeheer: Volg de CAB-procedures voor wijzigingen in productieomgevingen
• Plugins controleren: Bekijk de broncode van een plugin voordat u hem installeert (de meeste zijn opensource)
• Netwerkbeveiliging: Zorg dat XrmToolBox-verbindingen TLS 1.2 of hoger gebruiken
• Gegevensbescherming: Wees voorzichtig bij het exporteren van gegevens en houd u aan de AVG (GDPR) en andere privacyregelgeving

Veelvoorkomende problemen oplossen

Verbindingsfouten

Bij verbindingsproblemen controleert u uw aanmeldgegevens en de firewallinstellingen, gaat u na of TLS 1.2 ingeschakeld is en of uw account de nodige rechten heeft. Bij OAuth-problemen wist u de opgeslagen aanmeldgegevens in Windows Referentiebeheer.

Fouten bij het laden van plugins

Plugins die niet laden, hebben meestal te maken met ontbrekende afhankelijkheden of een verkeerde .NET Framework-versie. Kijk in het logbestand van XrmToolBox (onder Settings → Log) voor gedetailleerde foutmeldingen. Een herinstallatie van de plugin lost DLL-conflicten meestal op.

Prestatieproblemen

Trage prestaties wijzen doorgaans op te veel geïnstalleerde plugins, netwerklatentie of bewerkingen op grote datasets. Verwijder ongebruikte plugins, gebruik gefilterde query's om minder gegevens op te halen en draai XrmToolBox op een machine met een lage netwerklatentie naar uw Dynamics 365-instantie.

Conclusie

XrmToolBox heeft de manier waarop Dynamics 365-professionals werken grondig veranderd: de tools besparen talloze uren handwerk en maken dingen mogelijk waarvoor u anders maatwerk zou moeten ontwikkelen. Of u nu als ontwikkelaar plugins debugt, als beheerder beveiligingsrollen beheert of als consultant datamigraties uitvoert, XrmToolBox biedt essentiële hulpmiddelen die in de toolkit van elke Dynamics 365-professional thuishoren.

Wie XrmToolBox echt onder de knie wil krijgen, neemt de tijd om het uitgebreide plugin-ecosysteem te verkennen en integreert het in de dagelijkse werking. Begin met de essentiële plugins uit deze gids, breid geleidelijk uit naar gespecialiseerde tools wanneer u een specifieke behoefte hebt, en overweeg om zelf plugins bij te dragen zodat de community verder groeit.