Delen via

Een aangepaste werkstroomactiviteit maken

  • Artikel

 

Gepubliceerd: november 2016

Is van toepassing op: Dynamics CRM 2015

In dit onderwerp wordt beschreven hoe u een aangepaste werkstroomactiviteit kunt maken en deze kunt registreren voor gebruik in Microsoft Dynamics CRM 2015 en Microsoft Dynamics CRM Online 2015 Update. Voor Microsoft Dynamics CRM Online, kunnen de aangepaste werkstroomactiviteiten alleen worden geregistreerd voor uitvoering in de sandbox (gedeeltelijk vertrouwen). Voor meer informatie over de sandbox en gedeeltelijk vertrouwen, raadpleegt u Isolatie, trusts en statistieken van invoegtoepassingen.

In dit onderwerp

Vereiste software en assembly's

Gebruik de werkstroombasisklasse CodeActivity

Geef de naam en de groepsnaam voor een aangepaste werkstroomactiviteit op

Vereiste software en assembly's

Om Windows Workflow Foundation 4 aangepaste activiteiten voor Dynamics CRM te ontwikkelen, moet u ze ontwikkelen op Microsoft .NET Framework 4.5.2. De volgende assembly's moeten als referenties in uw project worden toegevoegd. Ze kunnen worden gevonden in de SDK\Bin map van de Microsoft Dynamics CRM SDK.Download het Microsoft Dynamics CRM SDK-pakket.

  • Microsoft.Xrm.Sdk.dll

  • Microsoft.Xrm.Sdk.Workflow.dll

Gebruik de werkstroombasisklasse CodeActivity

Om een aangepaste werkstroomactiviteit te maken, maakt u een klasse die de CodeActivity van de werkstroombasis neemt. Deze klasse is beschikbaar in de naamruimte System.Activities. De activiteiten die van de CodeActivity klasse nemen, kunnen de Execute methode negeren om aangepaste functionaliteit te maken.

  1. Start Microsoft Visual Studio.

  2. In het menu Bestand, klik op Nieuw, en klik vervolgens op Project.

  3. In het dialoogvenster Nieuw Project, selecteer Werkstroom onder Visual C# in het deelvenster Geïnstalleerde Sjablonen, en selecteer vervolgens Activiteitbibliotheek.

  4. Geef een naam en beschrijving voor de nieuwe oplossing op en klik op OK.

  5. Ga naar het menu Project en selecteer Eigenschappen. Op het tabblad Toepassing, geef .NET Framework 4.5.2 als doel-framework.

  6. Voeg referenties toe aan de assembly's Microsoft.Xrm.Sdk.dll en Microsoft.Xrm.Workflow.dll.

  7. Verwijder het Activity1.xaml-bestand in het project.

  8. Voeg een klassebestand (.cs) toe aan het project. In de oplossingenverkenner klikt op met recht op het project en selecteert u Toevoegen, en vervolgens klikt u op Klasse. In het dialoogvenster Nieuwe item toevoegen, voert u de naam voor de klasse in en klikt u op Toevoegen.

  9. Open het klassebestand, en voeg de volgende richtlijnen toe:

    using System.Activities;using Microsoft.Xrm.Sdk;using Microsoft.Xrm.Sdk.Workflow;

  10. Zorg ervoor dat de klasse overneemt van de klasse CodeActivity en geef deze een openbare toegangsbepaling zoals hier wordt weergegeven:

    public class SampleCustomActivity : CodeActivity

  11. Voeg functionaliteit toe aan de klasse door de methode Uitvoeren toe te voegen:

    protected override void Execute(CodeActivityContext context){    //Activity code}

    Zie Metagegevens toevoegen aan een aangepaste werkstroomactiviteit voor meer informatie.

  12. Geef invoer- en uitvoerparameters op. Zie Metagegevens toevoegen aan een aangepaste werkstroomactiviteit voor meer informatie.

  13. In de projecteigenschappen, onder het tabblad Ondertekening, selecteert u De assembly ondertekenen en geeft u een belangrijke bestandsnaam op. Aangepaste workflowactiviteit (en invoegtoepassing) assemblys moeten worden ondertekend.

  14. Compileer het project om een assembly te maken (.dll).

Om een voorbeeldcode weer te geven die aangeeft hoe een aangepaste werkstroomactiviteit moet maken, raadpleegt u Voorbeeld: Een aangepaste werkstroomactiviteit maken.

Belangrijk

Voor betere prestaties slaat Microsoft Dynamics 365 de aangepaste werkstroomactiviteiten op. De methode Execute van de invoegtoepassing moet stateless worden geschreven omdat de constructor niet voor elke aanroep van de invoegtoepassing wordt aangeroepen. Ook kunnen meerdere systeemthreads de invoegtoepassing tegelijkertijd uitvoeren. Alle aanvraaggegevens per aanroepingsstatus worden opgeslagen in de context, dus wordt het aanbevolen om globale variabelen of lidvariabelen te gebruiken om gegevens van een aanroeping naar volgende in te voeren.

Geef de naam en de groepsnaam voor een aangepaste werkstroomactiviteit op

Als u een aangepaste werkstroomactiviteitassembly registreert, geef dan de naam en groepnaam op. De naameigenschap hiermee specificeert de naam van de werkstroomactiviteit. De groepsnaameigenschap specificeert de naam van het submenu dat wordt toevoegd aan het hoofdmenu in de Microsoft Dynamics 365 procesontwerper. Deze eigenschappen koppelen de aangepaste workflowactiviteit met de Microsoft Dynamics 365 procesontwerper, zodat de aangepaste activiteitnaam in de gebruikersinterface wordt weergegeven.

Om de naam en de groepsnaam voor voor een aangepaste werkstroomactiviteit op te geven, kunt u de kenmerken PluginType.Name en PluginType.WorkflowActivityGroupName gebruiken als u de aangepaste workflowactiviteitassembly registreert. Voor meer informatie over het registreren van aangepaste workflowactiviteiten, raadpleegt u Een aangepaste werkstroomactiviteitassembly registreren en gebruiken. Als de kenmerken PluginType.Name en PluginType.WorkflowActivityGroupName op null zijn ingesteld, wordt de aangepaste activiteit verborgen voor de Microsoft Dynamics 365-werkstroomontwerper en is deze alleen toegankelijk vanuit XAML-werkstromen.

Als u het Hulpprogramma Voor Invoegtoepassingsregistratie gebruikt om een aangepaste workflowactiviteitassembly te registreren, kunt u de juiste waarden in de vakken Naam en Werkstroomactiviteitgroepnaam, en Bewerken opgeven de bewerkbare gebieden. Voor meer informatie over het gebruik van het Hulpprogramma Voor Invoegtoepassingsregistratie, raadpleegt u Overzicht: een plug-in registreren met het registratiehulpprogramma plug-ins.

De groepsnaam en naam opgeven tijdens het registreren

Nadat deze aangepaste workflowactiviteit is geregistreerd, kunt u het vanuit de Microsoft Dynamics 365 procesontwerpe voor werkstromen of dialoogvensters gebruiken. Zie Een aangepaste werkstroomactiviteitassembly registreren en gebruiken voor meer informatie.

Zie ook

Aangepaste workflowactiviteiten (workflowassemblies)
Metagegevens toevoegen aan een aangepaste werkstroomactiviteit
De IOrganization-webservice gebruiken in een aangepaste werkstroomactiviteit
Voorbeeld: Een aangepaste werkstroomactiviteit maken
Voorbeeld: Azure-bewuste aangepaste werkstroomactiviteit
Windows Workflow Foundation 4 Basisactiviteitsklassen

© 2017 Microsoft. Alle rechten voorbehouden. Auteursrecht