Dela via

Registrera och använda anpassade plugin-program att använda som primär geospatial dataprovider

  • Artikel

För ett plugin-program ska kunna användas, måste de registreras och distribueras på servern.

Skapa plugin-programprojektet resulterar i ett plugin-programpaket (dll). Det här avsnittet innehåller information om hur du registrerar och distribuerar plugin-programprojektet för två geospatiala åtgärder för att använda din föredragna geospatiala dataprovider. Information om hur du skriver ett plugin-program finns i skapa anpassade plugin-program för att använda din föredragna geospatiala dataprovider

Att tänka på vid körning av order när du registrerar ditt eget plugin-program

När du registrerar flera plugin-program för samma entitet och meddelande definieras plugin-programmets körningssekvens av Körningsordning av enskilda plugin-program. Den med ett lägre körningsvärde körs först, följt av den med ett högre körningsvärde.

Körningordervärdet för vanliga plugin-program i Field Service och Project Service som använder Bing Maps för åtgärder för geokodning och avståndsmatris har värdet 1. Du kan ange körningsordning för dina anpassade plugin-program som ska köras innan (mindre än 1) eller efter (större än 1) det vanliga plugin-programmet.

I tabellen nedan visas hur du din egna plugin-program behandlas beroende på körningsordningen som anges vid plugin-programmets villkor för registrering och parameter.

Hierarki Description
Primär Om du vill behandla din egna plugin-program som primära och standard Bing plugin-program som sekundär anger du körningsordning för plugin-programmet till 0. Detta resulterar i att din plugin-program körs innan Bing plugin-programmet. Bing plugin-programmet kommer att undersöka värdena för ”latitud” och ”longitud” som dina anpassade plugin-program returnerar och fortsätter att geokoda med Bing endast om båda returnerade värdena är 0. Detta är det bästa sättet om ditt eget plugin-program förväntas erbjuda större delen av dina geokodningsbehov.
Sekundär Om du vill behandla dina egna plugin-program som sekundära till Bing plugin-program som utför geokodningstjänsten endast när Bing misslyckas med geokodning, ange körningsordning för ditt plugin-program till 2. Du skulle också skriva koden för ditt anpassade plugin-program så att den först undersöker värdena för ”latitud” och ”longitud” som Bing plugin-program returnerar endast om båda returnerade värdena är 0. Detta är det bästa sättet om ditt föredragna körningssätt av Bing förväntas erbjuda större delen av dina geokodningsbehov.
Åsidosätta helt Om du alltid vill använda ditt anpassade plugin-program ska vara källan till geokodning och helt åsidosätta Bing från geokodning, även om ditt eget plugin-program inte kan geokoda, måste du visa något annat än 0,0 för värdena ”latitud” och ”longitud”. Du kanske vill bestämma vilka undantagsvillkor som utlöser ett .NET-undantag och vilka som inte returnerar ett resultat. För att inte returnera ett resultat och inte tillåta efterföljande plugin-program att returnera ett resultat måste ditt anpassade plugin-program returnera någonting i stil med 0,0001, 0,0001.

Registrera och distribuera ditt anpassade plugin-program

Du kan registrera och distribuera plugin-program med hjälp av verktyget för registrering av plugin-program eller programmässigt genom att skriva registreringskod med vissa SDK-klasser. Mer information: registrera och distribuera plugin-program

I det här avsnittet ska vi använda verktyget för registrering av plugin-program som har ett grafiskt användargränssnitt för att enkelt registrera och distribuera plugin-program. Det här avsnittet innehåller även information som baseras på förutsättningen att du arbetar med exempel på anpassat plugin-program och att du har skapat exempelprojektet för att generera paketet CustomPlugin-FS-Geospatial.dll. Om du har utvecklat din egen eget plugin-program kommer namnet på paketet och plugin-programmen se lite annorlunda ut, men allmänna anvisningar om att registrera plugin-programmet är desamma.

Dricks

Detaljerad information om hur du använder verktyget för registrering av plugin-program i allmänhet finns i genomgång: registrera ett plugin-program med hjälp av verktyget för registrering av plugin-program

  1. Skaffa verktyget för registrering av plugin-program. Information om hur du hämtar plugin-registreringsverktyget finns i Ladda ned verktyg från NuGet.

  2. Gå till mappen [Your folder]\Tools\PluginRegistration och dubbelklicka på filen PluginRegistration.exe för att köra verktyget.

  3. Klicka på SKAPA NY ANSLUTNING.

  4. I dialogrutan Inloggning anger du autentiseringsuppgifterna för att ansluta till din Dynamics 365-instans och klickar på Logga in.

  5. Om du har tillgång till flera organisationer i Dynamics 365-instansen får du en lista med alla organisationer som du väljer att ansluta till. Annars används din standardorganisation.

  6. Du bör se en komprimerad lista över registrerade plugin-program eller paket med anpassade arbetsflödesfunktioner. Välj registrera>registrera nytt paket.

  7. I dialogrutan Registrera nytt paket:

    • Under avsnittet Steg 1 klicka på ellisper […] knappen för att välja sammansättning CustomPlugin-FS-Geospatial.dll.

    • Under avsnittet Steg 2 väljer du båda plugin-programmen.

    • Under avsnittet Steg 3 väljer du alternativet Begränsat läge.

    • Under avsnittet Steg 4 väljer du alternativet Databas.

    • Välj Registrera markerade plugin-program.

      The Register New Assembly dialog box

      Paketet CustomPlugin-FS-Geospatial.dll och två plugin-program för msdyn_GeocodeAddress och msdyn_RetrieveDistanceMatrix är nu registrerade och distribueras till servern.

  8. Nästa steg är att registrera ett steg för varje åtgärd. Ett steg refererar till entiteten SDK-meddelandets bearbetningssteg som används för att konfigurera när och hur plugin-programmet ska köras.

    I trädvyn Registrerade plugin-program & Anpassade arbetsflödesaktiviteter expandera noden (Assembly) CustomPlugin-FS-Geospatial och välj ett registrerat plugin-program, t.ex. Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix.

    The Registered Plug-ins & Custom Workflow Activities tree view

  9. Högerklicka på Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix, och välj registrera nytt steg.

  10. I dialogrutan Registrera nytt steg anger du följande:

    Screenshot of the Register New Step Dialog window with the General Configuration Information filled out. The Execution Order is set to 0.

  11. Högerklicka sedan på plugin-programmet Microsoft.Crm.Sdk.Samples.msdyn_GeocodeAddress och välj Registrera nytt steg.

  12. I dialogrutan Registrera nytt steg anger du följande:

    Screenshot showing the Register New Step Dialog window with the General Configuration Information filled out. The Execution Order is set to 0.

Du är nu klar med registrering av stegen för att anropa din egna plugin-program för båda geospatiala åtgärder.

Om du inte hittar någon av geospatiala åtgärder för Universal Resource Scheduling i verktyget för registrering av plugin-program visas både standard- och ditt anpassade plugin-program registrerade för åtgärden. Se exempelvis plugin-program för åtgärden mdyn_GeocodeAddress.

The Plug-in Registration tool

Se även

Exempel: Eget plugin-program du använder Google Maps API som geospatiala dataprovider