Del via

Oprette en brugerdefineret arbejdsprocesaktivitet

  • Artikel

 

Udgivet: januar 2017

Gælder for: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Dette emne beskriver, hvordan du opretter en brugerdefineret arbejdsprocesaktivitet og registrere den til brug i Microsoft Dynamics 365 (online og i det lokale miljø). For Microsoft Dynamics 365 (online) kan brugerdefinerede arbejdsprocesaktiviteter kun blive registreret i sandkassen (delvis tillid). Yderligere oplysninger om sandkassetilstand og delvis tillid finder du i Plug-in-isolation, -tillidsforhold og -statistik.

Dette emne indeholder

Nødvendig software og assemblyer

Brug CodeActivity-arbejdsprocesbasisklassen

Angive navnet og gruppenavnet på en brugerdefineret arbejdsprocesaktivitet

Nødvendig software og assemblyer

For at udvikle Windows Workflow Foundation 4-brugerdefinerede aktiviteter til Dynamics 365 skal du udvikle dem på Microsoft .NET Framework 4.5.2. Følgende assemblyer skal tilføjes som henvisninger i projektet. De kan findes i mappen SDK\Bin i Microsoft Dynamics 365-SDK.Hent SDK-pakken til Microsoft Dynamics CRM.

  • Microsoft.Xrm.Sdk.dll

  • Microsoft.Xrm.Sdk.Workflow.dll

Brug CodeActivity-arbejdsprocesbasisklassen

Hvis du vil oprette en brugerdefineret arbejdsprocesaktivitet, skal du oprette en klasse, der nedarver fra CodeActivity-arbejdsprocesbasisklassen. Denne klasse er tilgængelig i navneområdet System.Activities. Aktiviteter, der nedarver fra klassen CodeActivity, kan tilsidesætte metoden Execute til at oprette brugerdefinerede funktioner.

  1. Start Microsoft Visual Studio.

  2. På menuen Fil skal du klikke på Ny og derefter klikke på Projekt.

  3. I dialogboksen Nyt projekt skal du vælge Arbejdsproces under Visual C# i ruden Installerede skabeloner og derefter vælge Aktivitetsbibliotek.

  4. Angiv et navn til og en placering for løsningen, og klik derefter på OK.

  5. Naviger til menuen Projekt, og vælg Egenskaber. På fanen Program skal du angive .NET Framework 4.5.2 som målstrukturen.

  6. Føj referencer til assemblyen Microsoft.Xrm.Sdk.dll og Microsoft.Xrm.Workflow.dll.

  7. Slet filen Activity1.xaml i projektet.

  8. Du kan føje en klassefil (.cs) til projektet. I Løsningsoversigt skal du højreklikke på projektet, vælge Tilføj og derefter klikke på Klasse. I dialogboksen Tilføj nyt element skal du skrive et navn til klassen og derefter klikke på Tilføj.

  9. Åbn klassefilen, og tilføj følgende ved hjælp af direktiver:

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

  10. Kontrollér, at klassen nedarver fra klassen CodeActivity, og giv den en modifikator for offentlig adgang som vist her:

    public class SampleCustomActivity : CodeActivity

  11. Føj funktioner til klassen ved at tilføje en Udfør-metode:

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

    Du kan finde flere oplysninger under Føj metadata til en brugerdefineret arbejdsprocesaktivitet.

  12. Angiv input- og output-parametre. Du kan finde flere oplysninger under Føj metadata til en brugerdefineret arbejdsprocesaktivitet.

  13. I Projektegenskaber skal du under fanen Signerer vælge Signer assemblyen og angive et navn til nøglefilen. Brugerdefinerede assemblyer for arbejdsprocesaktivitet (og plug-in) skal signeres.

  14. Kompiler projektet for at oprette en assembly (.dll).

Hvis du vil se et eksempel på kode, der demonstrerer, hvordan du opretter en brugerdefineret arbejdsprocesaktivitet, skal du se Eksempel: Opret en brugerdefineret arbejdsprocesaktivitet.

Vigtigt

For at opnå forbedret ydeevne cachelagrer Microsoft Dynamics 365 forekomster af brugerdefinerede arbejdsprocesaktiviteter. Den brugerdefinerede arbejdsprocesaktivitets Udfør-metode skal skrives for at være uden tilstand, fordi konstruktøren ikke kaldes for hver aktivering af den brugerdefinerede arbejdsprocesaktivitet. Desuden kunne flere tråde i systemet udføre den brugerdefinerede arbejdsprocesaktivitet på samme tid. Alle tilstandsoplysninger om pr. aktivering gemmes i konteksten, så det kan ikke anbefales at bruge globale variabler eller medlemsvariabler til at overføre data fra et enkelt kald til det næste.

Angive navnet og gruppenavnet på en brugerdefineret arbejdsprocesaktivitet

Når du registrerer en assembly for en brugerdefineret arbejdsprocesaktivitet, skal du angive navnet og gruppenavnet. Navneegenskaben angiver navnet på arbejdsprocesaktiviteten. Gruppenavneegenskaben angiver navnet på den undermenu, der er føjet til hovedmenuen i Microsoft Dynamics 365-procesdesigner. Disse egenskaber kæder brugerdefinerede arbejdsprocesaktiviteten med Microsoft Dynamics 365-procesdesigner, så det brugerdefinerede aktivitetsnavn vises i brugergrænsefladen.

Hvis du vil angive navnet og gruppenavnet på en brugerdefineret arbejdsprocesaktivitet, skal du bruge attributterne PluginType.Name og PluginType.WorkflowActivityGroupName, når du registrerer assemblyen for den brugerdefinerede arbejdsprocesaktivitet. Du kan finde flere oplysninger om registrering af brugerdefinerede arbejdsprocesaktiviteter i Registrer og brug en assembly for brugerdefinerede arbejdsprocesaktiviter. Hvis attributterne PluginType.Name og PluginType.WorkflowActivityGroupName er angivet til null, er den brugerdefinerede aktivitet skjult fra Microsoft Dynamics 365-arbejdsprocesdesigneren og er kun tilgængelig fra XAML-arbejdsprocesser.

Hvis du bruger værktøjet til registrering af plug-ins til at registrere assemblyen for den brugerdefinerede arbejdsprocesaktivitet, kan du angive relevante værdier i felterne Navn og WorkflowActivityGroupName under området Redigerbar. Du kan finde flere oplysninger om brug af værktøjet til registrering af plug-in i Gennemgang: Registrere en plug-in ved hjælp af værktøjet til registrering af plug-in.

Angiv gruppenavnet og navnet under registrering

Når denne brugerdefinerede arbejdsprocesaktivitet er registreret, kan du bruge den fra Microsoft Dynamics 365-procesdesigner til arbejdsprocesser eller dialogbokse. Du kan finde flere oplysninger under Registrer og brug en assembly for brugerdefinerede arbejdsprocesaktiviter.

Se også

Brugerdefinerede arbejdsprocesaktiviteter (arbejdsprocesassemblies)
Føj metadata til en brugerdefineret arbejdsprocesaktivitet
Brug IOrganization-webtjenesten i en brugerdefineret arbejdsprocesaktivitet
Eksempel: Opret en brugerdefineret arbejdsprocesaktivitet
Eksempel: Azure-følsom brugerdefineret arbejdsprocesaktivitet
Grundlæggende aktivitetsklasser i Windows Workflow Foundation 4

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret