Registrere og installere brugerdefineret plug-in for at bruge din foretrukne geospatiale dataprovider
Før en plug-in kan bruges, skal den være registreret og installeret på serveren.
Når du udvikler et plug-in-projekt, resulterer det i en plug-in-assembly (.dll). Denne artikel indeholder oplysninger om, hvordan du kan registrere og installere plug-in-assemblyen, så de to geospatiale handlinger kan bruge din foretrukne geospatiale dataprovider. Du kan finde oplysninger om at skrive en plug-in i Oprette brugerdefineret plug-in for at bruge din foretrukne geospatiale dataprovider
Overvejelser i forbindelse med udførelse af ordre under registrering af den brugerdefinerede plug-in
Når du registrerer flere plug-ins til det samme objekt og den samme meddelelse, defineres udførelsesrækkefølgen af plug-ins af Udførelsesrækkefølge for de enkelte plug-ins. Den plug-in med den laveste værdi for udførelsesrækkefølge udføres først efterfulgt af den, der har en højere værdi.
Værdien for udførelsesrækkefølgen af en standard-plug-in i Field Service og Project Service, der bruger Bing Maps som geokode og afstandsmatrixhandlinger, er indstillet til 1. Du kan angive, at udførelsesrækkefølgen af din brugerdefinerede plug-in skal udføres før (mindre end 1) eller efter (større end 1) standardplug-in'en.
I følgende tabel beskrives, hvordan du kan vælge, at din brugerdefinerede plug-in skal behandles, afhængigt af den udførelsesrækkefølge, der blev angivet sammen med plug-in-registrering og parameterbetingelser.
| Hierarki | Description |
|---|---|
| Primær | Hvis du vil behandle din brugerdefinerede plug-in som Primær og Bing-standard-plug-in som sekundær, skal du indstille udførelsesrækkefølgen af din plug-in til 0. Det vil resultere i, at din plug-in bliver udført inden Bing-plug-in'en. Bing-plug-in'en undersøger "breddegrad" og "længdegrad"-værdier, som den brugerdefinerede plug-in returnerer og beregner kun geokode i Bing, hvis begge returnerede værdier er 0. Dette er den foretrukne måde, hvis den brugerdefinerede plug-in forventes at dække de fleste af dine geokodningsbehov. |
| Sekundær | Hvis du vil behandle din brugerdefinerede plug-in som sekundær i forhold til Bing plug-in'en ved kun at levere geokodningstjenesten, når Bing ikke kan udføre geokode, skal du indstille rækkefølgen af din plug-in til 2. Du skal også skrive din brugerdefinerede plug-in-kode, så den først undersøger "breddegrad" og "længdegrad"-værdier, som Bing-plug-in'en returnerer, og kun fortsætter, hvis begge returnerede værdier er 0. Dette er den foretrukne udførelsesmåde, hvis Bing forventes at dække de fleste af dine geokodningsbehov. |
| Fuldstændig tilsidesættelse | Hvis du altid vil have, at din brugerdefineret plug-in skal være kilden til geokodning, kan du tilsidesætte Bing helt fra geokodningen, selv når din brugerdefinerede plug-in ikke kan geokode, så skal du altid returnere noget andet end 0,0 for "breddegrad" og "længdegrad"-værdier. Du kan evt. selv bestemme, hvilke undtagelsesbetingelser der skal udløse en .NET-undtagelse, og hvilke der ganske enkelt ikke skal returnere et resultat. Hvis der ikke skal returneres et resultat, og hvis du ikke vil tillade, at efterfølgende plug-ins returnerer et resultat, skal den brugerdefinerede plug-in returnere noget i stil med 0.0001, 0.0001. |
Registrere og installere den brugerdefinerede plug-in
Du kan registrere og installere plug-ins ved hjælp af Plug-in Registration Tool eller via programmering ved at skrive registreringskode ved hjælp af bestemte SDK-klasser. Flere oplysninger: Registere og installere plug-ins.
I dette afsnit bruger vi Plugin Registration Tool (PRT), som indeholder en grafisk brugergrænseflade, hvor det er nemt at registrere og installere plug-ins. Desuden indeholder dette afsnit oplysninger, der antager, at du arbejder med det brugerdefinerede plug-in-eksempel og har udviklet eksempelprojektet til at oprette CustomPlugin-FS-Geospatial.dll-assemblyen. Hvis du har udviklet din egen brugerdefinerede plug-in, er navnet på -assemblyen og plug-ins forskellige, men de overordnede instruktioner til registrering af plug-in'en forbliver uændrede.
Tip
Du kan finde detaljerede oplysninger om, hvordan du kan bruge Plug-in Registration Tool generelt, i Gennemgang: Registrere en plug-in ved hjælp af værktøjet til registrering af plug-in
Hent Plug-in Registration Tool. Du kan hente værktøjet til registrering af plug-ins under Hent værktøjer fra NuGet.
Naviger til
[Your folder]\Tools\PluginRegistration-mappen, og dobbeltklik på PluginRegistration.exe-filen for at køre værktøjet.Klik på CREATE NEW CONNECTION (OPRET NY FORBINDELSE).
I Logon-dialogboksen skal du angive legitimationsoplysningerne for at oprette forbindelse til din Dynamics 365-forekomst og klikke på Logon.
Hvis du har adgang til flere organisationer i Dynamics 365-forekomsten, vises en liste over organisationer, som du vælge at oprette forbindelse til. Ellers bruges din standardorganisation.
Du bør se en skjult liste over registrerede plug-in- eller brugerdefinerede arbejdsprocesaktivitet-assemblies. Vælg Registrer>Registrer ny assembly.
I Registrer ny assembly-dialogboksen:
Klik på ellipserne [...] under Trin 1. For at vælge assemblyen skal du vælge CustomPlugin-FS-Geospatial.dll.
Under sektionen Trin 2 skal du markere begge plug-ins.
Under sektionen Trin 3 skal du vælge indstillingen Sandkasse.
Under sektionen Trin 4 skal du vælge indstillingen Database.
Vælg Register valgte plug-ins.
CustomPlugin-FS-Geospatial.dll-assemblyen og de to plug-ins for msdyn_GeocodeAddress og msdyn_RetrieveDistanceMatrix er nu registreret og er installeret på serveren.
Næste trin er at registrere et trin for hver handling. Et trin henviser til SDK-meddelelsens behandlingstrinobjekt, der bruges til at konfigurere, hvornår og hvordan denne plug-in skal udføres.
I trævisningen Registrerede plug-ins og brugerdefinerede arbejdsprocesaktiviteter skal du udvide (Assembly) CustomPlugin-FS-geospatiale-noden og vælge en registreret plug-in, f.eks. Microsoft.Crm.Sdk.Samples.msdyn_ RetrieveDistanceMatrix.
Højreklik på Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix, og vælg Registrer nyt trin.
Angiv følgende oplysninger i dialogboksen Registrer nyt trin:
- Meddelelsen: msdyn_RetrieveDistanceMatrix
- Udførelsesrækkefølge: Efter behov. Se Overvejelser i forbindelse med udførelse af ordre under registrering af den brugerdefinerede plug-in tidligere i denne artikel.
- Hændelsespipelinefasen af udførelsen: PostOperation
- Udførelsestilstand: Synkron
- Lad standardværdierne stå i resten af felterne. Klik på Registrer nyt trin.
Højreklik derefter på Microsoft.Crm.Sdk.Samples.msdyn_GeocodeAddress- plug-in'en, og vælg Registrer nyt trin.
Angiv følgende oplysninger i dialogboksen Registrer nyt trin:
- Meddelelsen: msdyn_GeocodeAddress
- Udførelsesrækkefølge: Efter behov. Se Overvejelser i forbindelse med udførelse af ordre under registrering af den brugerdefinerede plug-in tidligere i dette emne.
- Hændelsespipelinefasen af udførelsen: PostOperation
- Udførelsestilstand: Synkron
- Lad standardværdierne stå i resten af felterne. Klik på Registrer nyt trin.
Du er nu færdig med at registrere trin til kald af din brugerdefineret plug-in for begge geospatiale handlinger.
Hvis du får vist nogen Universal Resource Scheduling geospatiale handlinger i Plugin Registration Tool, vises både standard-plug-in og det brugerdefinerede plug-in, der er registreret for handlingen. Se f.eks. plug-ins for handlingen mdyn_GeocodeAddress.
Se også
Eksempel: Brugerdefineret plug-in, der bruger Google Maps API som geospatial dataprovider