Overzicht: een plug-in registreren met het registratiehulpprogramma plug-ins

Artikel
03/04/2017

Gepubliceerd: januari 2017

Is van toepassing op: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Deze analyse laat zien hoe u een plug-in registreert met behulp van het Plug-in Registration hulpprogramma in de SDK. De te registreren plug-in is de FollowupPlugin van het onderwerp Voorbeeld: een basisinvoegtoepassing maken.

De plug-in moet worden geregistreerd op de entiteit account, CreateRequest bericht, na de gebeurtenis, en in de sandbox. De plug-in kan worden geregistreerd op elke Microsoft Dynamics 365 (online en on-premises) installatie waar uw gebruikersaccount de rol Systeemaanpasser of Systeembeheerder heeft.

Er moet worden voldaan aan de volgende vereisten voordat u dit overzicht start:

Open het PluginRegistration.exe hulpprogramma in de map Tools\PluginRegistration van de SDK.Download het Microsoft Dynamics CRM SDK-pakket.
Een systeemgebruikersaccount verkrijgen op een Microsoft Dynamics 365 server.
Uw gebruikersaccount moet de rol Systeemaanpasser of Systeembeheerder hebben. Zie Hoe op rollen gebaseerde beveiliging kan worden gebruikt om toegang tot entiteiten te beheren in Microsoft Dynamics 365.

Verbinding maken met de Microsoft Dynamics 365 Server

Voer het hulpmiddel Plug-in Registration uit.
Klik op NIEUWE VERBINDING MAKEN.
In het dialoogvenster Aanmelden, selecteert u het keuzerondje dat overeenkomt met de Microsoft Dynamics 365 server waarmee u plug-ins wilt registreren. Het keuzerondje On-premises bevat een IFD-implementatie, de knop Online is voor de Windows Live provider van Microsoft Dynamics 365 (online), en de knop Office 365 button is voor de Microsoft Online Services provider van Microsoft Dynamics 365 (online).

Aanmeldingsvenster voor online implementatie

Aanmeldingsvensterr voor on-premises implementatie
Als u Beschikbare organisaties altijd weergeveninschakelt, krijgt u een lijst met organisaties te zien waar u lid van bent nadat u klikt op Aanmelden. Hierdoor kunt u de organisatie waarmee u de plug-in wilt registreren. Anders wordt de standaardorganisatie gebruikt.
Voer vervolgens de weergegeven informatie over de server en aanmeldingsnaamaccount in, en klik op Aanmelden.

U moet een samgevouwen lijst zien van een geregistreerde plug-in of aangepaste workflowactiviteitassemblies en service-eindpunten. De activiteitsfeeds en Microsoft.Crm.ObjectModel-assemblies zijn nodig om Microsoft Dynamics 365 goed te laten functioneren zodat het hulpprogramma voorkomt dat u deze aanpast. Een item selecteren in de lijst leidt ertoe dat de tabbladen Eigenschappen en Details informatie over dat item weergeven.

Het hoofdvenster van de toepassing

Een plug-in assembly registreren

Selecteer een organisatietabblad om deze actief te maken.
Klik op de werkbalk van het tabblad Registreren en vervolgens op Nieuw assembly registreren.
Klik in het dialoogvenster Nieuwe Assembly registreren op de beletseltekenknop […] rechts van het veld Step#1.
Ga in het dialoogvenster Openen naar de locatie van de gecompileerde SamplePlugin.dll assembly. De standaardlocatie is SDK\SampleCode\CS\Plug-ins\bin\Debug. Selecteer de assembly en klik vervolgens op Openen.
Vouw in de sectie Step#2 de assembly SamplePlugins uit om alle invoegtoepassingen in die assembly weer te geven. Selecteer (selectievakje) alleen de plug-in Microsoft.Crm.Sdk.Samples.FollowupPlugin.
Selecteer in de sectie Step#3 de optie Sandbox.
Selecteer in de sectie Step#4 de optie Database.

Dialoogvenster voor het registreren van een assembly
Klik op Meld geselecteerde plug-ins. U kunt eventuele open dialoogvensters sluiten.

Een geregistreerde plug-in die in de structuurweergave wordt weergegeven

Tip

Ziet u een fout in het gebied Logboek en bevat het logboek het volgende bericht?

<Message>Action failed for assembly 'SamplePlugins, Version=0.0.0.0, Culture=neutral, PublicKeyToken=829f574d80e89132': Deployment/Scalegroup does not allow running external code.</Message>

Als dat zo is, moet u aangepaste code inschakelen op de server en opnieuw proberen. Raadpleeg Uitvoeren van aangepaste code in- of uitschakelen voor meer informatie.

De SamplePlugins.dll assembly en FollowupPlugin plug-in zijn nu op de server geregistreerd en geïmplementeerd Als u het hulpprogramma gebruikte om een aangepaste workflowactiviteitassembly te registreren, geldt de volgende sectie voor het registreren van een stap niet.

Registreer een plug-instap voor een gebeurtenis

Vouw in de Geregistreerde plug-ins en Aangepaste Workflowactiviteiten structuurweergave het knooppunt (Assembly) uit en selecteer een geregistreerde plug-in.
Ga naar het menu Registreren in de werkbalk en tik of klik op Nieuwe stap registreren.

Notitie

Plug-ins worden vastgelegd om uit te voeren wanneer een gebeurtenis in de pipeline van de uitvoering van de gebeurtenis wordt verwerkt. Elke gebeurtenis bevat een fasenaam en een nummer om de locatie in de pijplijn aan te geven voor of na de kernplatformbewerking. Een stap verwijst naar de verwerkingsstapentiteit voor SDK-berichten die wordt gebruikt om te configureren wanneer en hoe de plug-in moet worden uitgevoerd.
Vul het dialoogvenster Nieuwe Stap registreren in zoals getoond in de volgende afbeelding.

Dialoogvenster voor het registreren van een nieuwe stap
Klik op Nieuwe stap registreren.
Vouw het knooppunt en de sub-knooppunten van (Assembly) SamplePlugins uit om de plug-in en stapknooppunten te zien die u hebt gemaakt. U kunt nu het programma afsluiten, maar u kunt het beter open houden tot u de plug-in hebt getest en de registratie van de assembly ongedaan hebt gemaakt.

Notitie

Als u de registratie van een stap, plug-in of assembly ongedaan wilt maken, selecteert u het knooppunt ervan in de structuur en klikt u op Registratie ongedaan maken op de werkbalk. Om een assembly of stapregistratie aan te passen, dubbelklikt u op de assembly of het stapknooppunt in de structuurweergave. U kunt ook het knooppunt selecteren en op Bijwerken klikken op de werkbalk.

De plug-in is nu geregistreerd om te worden uitgevoerd in de sandbox, om een account aan te maken, en nadat de kernbewerking is uitgevoerd. U hebt de invoegtoepassing geregistreerd om asynchroon te worden uitgevoerd aangezien het maken van de opvolgtaakactiviteit niet tijdsafhankelijk is. Wanneer een account wordt gemaakt, wordt de plug-in uitgevoerd de volgende keer dat de asynchrone service zijn wachtrij verwerkt.

Test de plug-in

Nadat u de plug-in registreert, kunt u optioneel de uitvoering testen met de onderstaande procedure.

Open de webtoepassing van Microsoft Dynamics 365 voor dezelfde organisatie waaronder u de plug-in assembly hebt vastgelegd.
Ga naar de werkplek, selecteer Accounts en klik vervolgens op Nieuw.
Typ in het vak Accountnaam een accountname, bijvoorbeeld, Adventure Works Cycle en klik op Opslaan en sluiten.
Dubbelklik op de formuliernaam in het raster Accounts om het formulier te openen.
Klik op Activiteiten om een lijst met gerelateerde activiteiten weer te geven voor het account. U moet de activiteit zien met de naam “Send email to the new customer“ die de plug-in maakte.
Als u de plug-in registreerde om asynchroon uit te voeren en u selecteerde de optie AsyncOperation verwijderen als StatusCode = Geslaagd niet op het formulier Nieuwe stap registreren, komt er een nieuwe systeemjob met de naam “FollowupPlugin: Create of account”. Als u de verwante systeemtaak wilt zien, klikt u op Instellingen en klikt u vervolgens op Systeemtaken. Dubbelklik op de eerder vermelde systeemtaak.

U kunt nu de registratie van de stap, de plug-in en de assembly ongedaan maken als u wilt. Mogelijk wilt u ook de systeemtaak en het account dat u maakte, verwijderen.

Zie ook

Ontwikkeling van plug-ins
Overzicht: Configureer assemblybeveiliging voor een offline plug-in
Plug-ins registreren en inzetten
Pipeline voor gebeurtenisuitvoering
Isolatie, trusts en statistieken van invoegtoepassingen
Ondersteunde berichten en entiteiten voor invoegtoepassingen

Microsoft Dynamics 365

Delen via