Gennemgang: Registrere en plug-in ved hjælp af værktøjet til registrering af plug-in

 

Udgivet: januar 2017

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

Denne gennemgang viser, hvordan du registrerer en plug-in ved hjælp af det Plug-in Registration-værktøj, der findes i SDK. Den plug-in, der skal registreres, er FollowupPlugin fra emnet Eksempel: Oprette en grundlæggende plug-in.

Plug-in'en skal registreres på account-objektet, CreateRequest-meddelelsen, på en efterfølgende hændelse og i sandkassen. Plug-in'en kan registreres på en Microsoft Dynamics 365 (online og i det lokale miljø)-udrulning, hvor din brugerkonto har rollen Systemtilpasser eller Systemadministrator.

Følgende forudsætninger skal være fuldført, før du begynder denne gennemgang:

• Hent PluginRegistration.exe-værktøjet, som er placeret i Tools\PluginRegistration-mappen i SDK.Hent SDK-pakken til Microsoft Dynamics CRM.

• Få en systembrugerkonto på en Microsoft Dynamics 365-server.

• Din brugerkonto skal have rollen Systemadministrator eller Systemtilpasser. Se Hvordan rollebaseret sikkerhed kan bruges til at styre adgangen til objekter i Microsoft Dynamics 365.

Opret forbindelse til Microsoft Dynamics 365 Server

1. Kør Plug-in Registration-værktøjet.

2. Klik på CREATE NEW CONNECTION (OPRET NY FORBINDELSE).

3. Brug dialogboksen Log på til at vælge udrulningstypens alternativknap, der svarer til den Microsoft Dynamics 365-server, du vil registrere plug-ins med. Alternativknappen Det lokale miljø omfatter en IFD-udrulning, knappen Online er Windows Live-udbyder af Microsoft Dynamics 365 (online), og knappen Office 365 er Microsoft Online Services-udbyderen af Microsoft Dynamics 365 (online).

   Logonvinduet til en onlineudrulning

   Logonvinduet til en udrulning i det lokale miljø

4. Hvis du markerer Vis altid en liste over tilgængelige organisationer, får du vist en liste over organisationer, du tilhører, når du klikker på Log på. Dette gør det muligt at vælge den organisation, du vil registrere plug-in'en hos. Ellers bruges din standardorganisation.

5. Indtast de angivne oplysninger om serveren og logonkontoen, og klik derefter Log på.

Du bør se en skjult liste over registrerede plug-in- eller brugerdefinerede arbejdsprocesassemblies og serviceslutpunkter. Aktivitetsopdateringer og Microsoft.Crm.ObjectModel-assemblies er nødvendige for at få Microsoft Dynamics 365 til at fungere korrekt, så værktøjet forhindrer dig i at ændre dem. Hvis du vælger et element på listen, viser faneruderne Egenskaber og Detaljer oplysninger om det pågældende listeelement.

Programmets hovedvindue

Registrere en plug-in-assembly

1. Vælg en organisationsfane for at gøre den aktiv.

2. På værktøjslinjen under fanen skal du klikke på Registrer og derefter Registrer ny assembly.

3. Brug dialogboksen Registrer ny assembly til at klikke på på ellipseknappen [...] til højre for feltet Trin 1.

4. I dialogboksen Åbn skal du navigere til placeringen af den kompilerede SamplePlugin.dll-assembly.SDK\SampleCode\CS\Plug-ins\bin\Debug er standardplaceringen. Vælg assemblyen, og klik derefter på Åbn.

5. I sektionen Trin 2 skal du udvide SamplePlugins-assembly for at få vist alle plug-ins i denne assembly. Vælg (markér) kun Microsoft.Crm.Sdk.Samples.FollowupPlugin-plug-in.

6. Vælg i afsnit Trin 3 indstillingen Sandkasse.

7. Vælg i afsnit Trin 4 indstillingen Database.

   

   Dialogboksen til registrering af en ny assembly

8. Klik på Register valgte plug-ins. Du kan lukke alle åbne dialogbokse.

   

   En registreret plug-in vises i træstrukturen

   Tip

   Kan du se en fejl i Log-området, og indeholder loggen følgende meddelelse?

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

   Hvis det er tilfældet, skal du aktivere brugerdefineret kode på serveren og prøve igen. Du kan finde flere oplysninger i Aktivere eller deaktivere kørsel af brugerdefineret kode.

SamplePlugins.dll-assembly og FollowupPlugin-plug-in er nu registreret og udrullet på serveren. Hvis du har brugt værktøjet til at registrere en brugerdefineret assembly for arbejdsprocesaktivitet, gælder næste afsnit om registrering af et trin ikke.

Registrere et plug-in-trin for en hændelse

1. I trævisningen Registrerede plug-ins og brugerdefinerede arbejdsprocesaktiviteter skal du udvide noden (Assembly) SamplePlugins og vælge en registreret plug-in.

2. Naviger til menuen Registrer på værktøjslinjen, og klik derefter på Registrer nyt trin.

   Bemærk

   Plug-ins er registreret til at køre, når en hændelse behandles i pipeline for hændelseskørsel. Hver hændelse har et fasenavn og nummer, der angiver dens placering i pipelinen, enten før eller efter handlingen på kerneplatformen. Et trin henviser til SDK-meddelelsens behandlingstrinobjekt, der bruges til at konfigurere, hvornår og hvordan denne plug-in skal udføres.

3. Udfyld dialogboksen Registrer nyt trin som vist i følgende figur.

   

   Dialogboksen til registrering af et nyt trin

4. Klik på Registrer nyt trin.

5. Udvid noden (Assembly) SamplePlugins og undernoder for at se den plug-in og de trinnoder, som du har oprettet. Du kan nu lukke værktøjet, men kan du holde det åbent, indtil du har testet plug-in'en og fjernet registreringen af assemblyen.

   Bemærk

   Hvis du vil fjerne registreringen af trin, plug-in eller assembly, skal du vælge den tilhørende node i træet og derefter klikke på Fjern registrering på værktøjslinjen. For at redigere en assembly- eller trinregistrering skal du dobbeltklikke på assembly- eller trinnoden i trævisningen. Du kan også vælge noden og klikke på Opdater på værktøjslinjen.

Plug-in'en er nu registreret til at køre i sandkassen, for en firmaoprettelseshændelse, og efter kernehandlingen udføres. Du registrerede plug-in'en til at køre asynkront, oprettelsen af opfølgningsopgaveaktiviteten ikke er tidskritisk. Når du har oprettet et firma, vil denne plug-in udføres, næste den asynkrone service behandler dets kø.

Teste plug-in'en

Når du har registreret denne plug-in, kan du teste kørslen ved at benytte følgende fremgangsmåde.

1. Åbn Microsoft Dynamics 365-webprogrammet for den samme organisation, du har registreret plug-in-assemblyen under.

2. Gå til arbejdsområdet, og vælg Firmaer, og klik derefter på Nyt.

3. I feltet Firmanavn skal du skrive navnet på et firma, for eksempel Adventure Works Cycle, og derefter klikke på Gem og Luk.

4. Dobbeltklik på formularnavnet i gitteret Firmaer for at åbne formularen.

5. Klik på Aktiviteter for at få vist en liste over relaterede aktiviteter for firmaet. Du bør kunne se aktiviteten med navnet “Send email to the new customer“, der er oprettet af plug-in'en.

6. Hvis du har registreret denne plug-in til at køre asynkront og ikke har valgt indstillingen Slet AsyncOperation, hvis StatusCode = Successful i formularen Registrer nyt trin, vises der et nyt systemjob med navnet “FollowupPlugin: Create of account”. Klik på Indstillinger for at se det relaterede systemjob, og klik derefter på Systemjob. Dobbeltklik på ovennævnte systemjob.

Du kan nu fjerne registreringen af trinnet, plug-in'en og assembly'en, hvis du ønsker det. Du kan også slette det systemjob og firma, du har oprettet.

Se også

Plug-in-udvikling
Gennemgang: Konfigurere assembly-sikkerhed for en offline plug-in
Registrere og installere plug-ins
Pipeline for hændelseskørsel
Plug-in-isolation, -tillidsforhold og -statistik
Understøttede meddelelser og objekter for plug-ins

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret