Del via

Analysere kørslen af plug-ins

  • Artikel

 

Udgivet: januar 2017

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

Plug-in Profiler er et værktøj, der profilerer kørslen af plug-ins og brugerdefinerede arbejdsprocesaktiviteter med henblik på en forbedret fejlfindingsoplevelse i Microsoft Visual Studio. Dette værktøj, som kan køres fra kommandopromptvinduet eller fra værktøjet Plug-in Registration, gør udvikling af brugerdefineret kode i forhold til Microsoft Dynamics 365 (online og i det lokale miljø) hurtigere og nemmere. Desuden kan brugere profilere kørslen af fejl i kode og sende resultaterne til analyse hos udvikleren af koden eller uafhængige softwareleverandører. Udvikleren kan gentage afspilningen af sin plug-in eller kørslen af den brugerdefinerede arbejdsprocesaktivitet og udføre fejlfinding af koden eksternt, selv når der ikke er forbindelse til Microsoft Dynamics 365-serveren.

Værktøjet kan bruges i fejlfindings- eller genafspilningstilstand. Hver af disse tilstande er beskrevet i de følgende afsnit.

Dette emne indeholder

Foretage fejlfinding af en plug-in ved hjælp af plug-in-profilering

Gentage afspilning af plug-in-kørsel

Køre plug-in-profileringsværktøjet enkeltstående

Foretage fejlfinding af en plug-in ved hjælp af plug-in-profilering

  1. Kør værktøjet Plug-in Registration. Du kan finde værktøjets eksekverbare fil i mappen Tools\PluginRegistration i SDK.Hent SDK-pakken til Microsoft Dynamics CRM.

  2. Klik på CREATE NEW CONNECTION (OPRET NY FORBINDELSE) for at oprette forbindelse til en Microsoft Dynamics 365-server og organisation. Du kan finde flere oplysninger om tilslutning til en server og organisation i SDK-emne:t Gennemgang: Registrere en plug-in ved hjælp af værktøjet til registrering af plug-in.

  3. Registrer en plug-in og et trin på Microsoft Dynamics 365-serveren. Opbevar en kopi af den fejlfindingskompilerede plug-in-assembly på den computer, hvor værktøjet køres.

  4. Vælg Install Profiler (Installer profileringsværktøj) på værktøjslinjen for målorganisationen. Du får nu vist en Plug-in Profiler node på listen.

  5. Vælg et plug-in-trin, og klik på Start Profiling (Start profilering) på værktøjslinjen for at starte profileringen. Du kan vælge, hvordan profileringsværktøjet skal køres i den viste dialog Profiler Settings (Indstillinger for profileringsværktøj).

  6. Udfør den handling i Microsoft Dynamics 365, der får denne plug-in til at køre. For eksempel hvis trinnet er konfigureret til en opdatering til et firma, skal du opdatere et firma.

  7. Hvis du har valgt indstillingen Exception (Undtagelse) i dialogen Profiler Settings (Indstillinger for profileringsværktøj), skal du klikke på Download Log File (Hent logfil), når der opstår en undtagelse for plug-in-programmet, og dialogen Business Process Error (Fejl i forretningsproces) vises, og gemmer denne fil. Alternativt, hvis denne plug-in ikke udløser en undtagelse, skal du klikke på Stop Profiling (Stop profilering).

  8. I værktøjet Plug-in Registration skal du klikke på Debug (Fejlfinding).

  9. I dialogen Debug an Existing Plug-in (Fejlfinding af en eksisterende plug-in) skal du give de ønskede oplysninger under fanen Setup (Installation). Angiv placeringen af den tidligere gemte logfil i feltet Profile (Profil). Angiv eller vælg placeringen af plug-in-assemblyen og klassenavnet for den plug-in, der blev kørt.

  10. Start Microsoft Visual Studio, og knyt fejlfindingsværktøjet til PluginRegistration.exe-processen.

  11. Angiv et pausepunkt i plug-in-koden.

  12. Klik på Start Execution (Start kørsel) i dialogboksen Debug an Existing Plug-in (Fejlfinding af en eksisterende plug-in).

  13. Efter en mindre forsinkelse køres plug-in-programmet ved hjælp af den samme kørselskontekst, der blev overført til den af Microsoft Dynamics 365-serveren, og fejlfindingsværktøjet stopper kørslen på pausepunktet, som du tidligere har angivet.

  14. Fortsæt fejlfindingen af plug-in-programmet, som du normalt ville gøre. Spor, som plug-in-programmet efterlader, vises i dialogboksen Debug an Existing Plug-in (Fejlfinding af en eksisterende plug-in).

På dette tidspunkt du kan ændre plug-in-koden, bygge den, knytte fejlfindingsværktøjet til PluginRegistration.exe-processen igen og klikke på Start Execution (Start kørsel) for at fortsætte fejlfindingssessionen. Mens du udfører disse handlinger, behøver du ikke at lukke formularen Debug an Existing Plug-in (Fejlfinding af en eksisterende plug-in).

Du behøver ikke at installere plug-in-programmet til Microsoft Dynamics 365-serveren igen, før du har løst kodeproblemet. Dette fejlfindingsscenario fungerer, selvom du har en optimeret version af plug-in-programmet på serveren og en fejlfindingsversion af plug-in-programmet på den computer, hvor du foretager fejlfinding.

Gentage afspilning af plug-in-kørsel

Det kræver ikke en forbindelse til en Microsoft Dynamics 365-server og organisation at gentage afspilningen af plug-in-programmet. Fordelen ved denne metode er, at du kan hente plug-in-kørselsprofilen fra en kunde og foretage fejlfindingen eksternt. En begrænsning af genafspilningsfunktionen er, at du ikke kan ændre rækkefølgen af kald, som din plug-in-kode foretager i fejlfindingsprogrammet, mens du foretager fejlfinding.

Genafspilningsfunktionen giver plug-in-programmet et snapshot af kalddataene og hændelseskørselskonteksten fra Microsoft Dynamics 365-serveren. Du får de samme hændelser, GUID'er og så videre fra kald til organisationstjenesten, men ingen data ændres på serveren, når du foretager fejlfinding af plug-in-programmet. Under fejlfindingsproceduren i forrige afsnit opretter plug-in-programmet faktisk forbindelse til serveren og kalder i realtid.

Gentage afspilning af plug-in-kørsel

  1. Start Microsoft Visual Studio, og knyt fejlfindingsværktøjet til PluginRegistration.exe-processen.

  2. Klik på REPLAY PLUG-IN EXECUTION (GENTAG AFSPILNING AF PLUG-IN-KØRSEL).

  3. Angiv placering af log og plug-in-assemblyen i dialogboksen.

  4. Klik på Start Execution (Start kørsel).

  5. Foretag fejlfinding af plug-in-programmet som normalt.

Køre plug-in-profileringsværktøjet enkeltstående

Profileringsværktøjet kan køres fra et kommandopromptvindue, der er uafhængigt af Plug-in Registration-værktøjet. Dette er nyttigt, når du vil hente loggen for plug-in-profilen fra en kundes Microsoft Dynamics 365-server for at foretage fejlfinding af en plug-in med fejl. En udvikler kan derefter bruge loggen til at afspille kørslen af plug-in-programmet i Plug-in Registration-værktøjet og foretage fejlfinding af plug-in-programmet ved hjælp afMicrosoft Visual Studio.

Køre plug-in-profileringsværktøjet fra en kommandoprompt

  1. Åbn et kommandopromptvindue, og indstil arbejdsmappen til mappen Tools\PluginRegistration i SDK-overførslen.

  2. Skriv kommandoen: PluginProfiler.Debugger.exe /?

  3. Gennemse listen over understøttede parametre, og kør igen programmet PluginProfiler.Debugger.exe med de relevante parametre.

Se også

Udviklerværktøjer
Løsningsværktøjer til teamudvikling
Plug-in-udvikling
Registrere og installere plug-ins
Fejlfinding af en plug-in

Microsoft Dynamics 365

© 2017 Microsoft. Alle rettigheder forbeholdes. Ophavsret