Registrere og distribuere egendefinert plugin-modul for å bruke din foretrukne geospatiale dataleverandør
Før en plugin-modul kan brukes må den registreres og distribueres på serveren.
Bygging av plugin-modulprosjektet fører til en plugin-modulsamling (.dll). Denne artikkelen inneholder informasjon om hvordan du kan registrere og distribuere plugin-modulsamlingen for to geospatiale handlinger, slik at du kan bruke din foretrukne geospatiale dataleverandør. For informasjon om hvordan du skriver en plugin-modul, se Opprette egendefinert plugin-modul for å bruke din foretrukne geospatiale dataleverandør
Utføringsrekkefølgevurderinger under registrering av din egendefinerte plugin-modul
Når du registrerer flere plugin-moduler for den samme enheten og meldingen, defineres kjøringsrekkefølgen for plugin-modulene av Utføringsrekkefølgen for de individuelle plugin-modulene. Den med laveste kjøringsrekkefølgeverdi utføres først, etterfulgt av én med høyere kjøringsrekkefølgeverdi.
Kjøringsrekkefølgeverdien for den standard plugin-modulen Field Service og Project Service som bruker Bing-kart for geokode og avstandsmatrisehandlinger, er satt til 1. Du kan angi kjøringsrekkefølgen til en tilpasset plugin-modul som kjører før (mindre enn 1) eller etter (større enn 1) standard plugin-modul.
Tabellen nedenfor viser hvordan du kanskje vil at plugin-modulen skal bli behandlet avhengig av den angitte kjøringsrekkefølgen under plugin-modulregistrering og parameterbetingelser.
| Hierarki | Bekrivelse |
|---|---|
| Primær | Hvis du vil behandle en egendefinert plugin-modul som primær og standard Bing plugin-modul som sekundær, setter du kjøring av rekkefølge for plugin-modulen til 0. Dette fører til at din plugin-modul utføres før Bing-plugin-modulen. Bing-plugin-modulen vil undersøke "breddegrad"- og "lengdegrad"-verdier som plugin-modulen returnerer, og fortsetter bare til geokode med Bing hvis begge de returnerte verdier er 0. Dette er den beste måten hvis din plugin-modul forventes å levere de fleste geokodebehovene dine. |
| Sekundær | Hvis du vil behandle din egendefinerte plugin-modul som sekundær til Bing-plugin-modulen ved å levere geokodingtjenesten bare når Bing ikke kan geokode, angir du denne kjøringsrekkefølgen for plugin-modulen til 2. Du skriver også den egendefinerte plugin-koden slik at den første undersøker "breddegrad"- og "lengdegrad"-verdiene som Bing-plugin-modulen returnerer, og fortsetter bare hvis begge de returnerte verdiene er 0. Dette er den beste utførelsen hvis Bing forventes å levere de fleste geokodebehovene dine. |
| Fullstendig overstyre | Hvis du alltid vil at den egendefinerte plugin-modulen skal være kilden til geokoding og fullstendig overstyre Bing fra geokoding, selv når den egendefinerte plugin-modulen mislykkes, må du alltid returnere noe annet enn 0,0 for "breddegrad"- og "lengdegrad"-verdier. Du vil kanskje avgjøre hvilke unntaksbetingelser som skal iverksette et .NET-unntak, og hvilke som ikke skal returnere et resultat. For å ikke returnere et resultat og ikke tillate at en etterfølgende plugin-modul skal returnere et resultat, må den egendefinerte plugin-modulen din returnere for eksempel 0,0001, 0,0001. |
Registrere og distribuere den tilpassede plugin-modulen din
Du kan registrere og distribuere plugin-moduler ved å bruke registreringsverktøyet for plugin-moduler eller skrive registreringskode ved å bruke bestemte SDK-klasser. Hvis du vil ha mer informasjon: Registere og distribuere plugin-moduler.
I denne delen skal vi bruke registreringsverktøyet for plugin-modulen, som gir et grafisk brukergrensesnitt for å registrere og distribuere plugin-moduler på en enkel måte. Denne delen inneholder også informasjon som er basert på antagelsen om at du arbeider med eksempelplugin-modulen og har bygget eksempelprosjektet for å generere samlingen CustomPlugin-FS-Geospatial.dll. Hvis du har utformet din egen egendefinerte plugin-modul, vil navnet på samlingen og plugin-modulene variere, men de samlede instruksjonene for å registrere plugin-modulen forblir de samme.
Tips
Hvis du vil ha detaljert informasjon om hvordan du bruker registreringsverktøyet for plugin-modul, kan du se Gjennomgang: Registrere en plugin-modul ved å bruke registreringsverktøyet for plugin-modul
Hent registreringsverktøyet for plugin-modul. Hvis du vil ha verktøyet for registrering av plugin-modul, kan du se Laste ned verktøy fra NuGet.
Naviger til
[Your folder]\Tools\PluginRegistration-mappen, og dobbeltklikk filen PluginRegistration.exe for å kjøre verktøyet.Klikk på OPPRETT NY TILKOBLING.
I Pålogging-dialogboksen angir du legitimasjonen for tilkobling til Dynamics 365-forekomsten, og klikk deretter på Pålogging.
Hvis du har tilgang til flere organisasjoner i Dynamics 365-forekomsten, vises en liste over organisasjoner som du kan koble til. Hvis ikke brukes standardorganisasjonen din.
Du vil se en sammentrukket liste over registrerte plugin-moduler eller tilpassede arbeidsflytaktivitetssamlinger. Velg Registrer>Registrer ny samling.
I dialogboksen Registrer ny samling:
Under Trinn 1-delen klikker du på ellipseknappen […] for å velge samlingen CustomPlugin-FS-Geospatial.dll.
Under Trinn 2 velger du begge plugin-modulene.
Under Trinn 3 velger du Sandkasse-alternativene.
Under Trinn 4 velger du Database-alternativene.
Velg Registrer valgte plugin-moduler.
Samlingen CustomPlugin-FS Geospatial.dll og de to plugin-modulene for msdyn_GeocodeAddress og msdyn_RetrieveDistanceMatrix er nå registrert og distribuert på serveren.
Det neste trinnet er å registrere et trinn for hver handling. Et trinn refererer til enheten for behandlingstrinnet for SDK-meldingen som brukes til å konfigurere når og hvordan plugin-modulen skal utføres.
I trevisningen Registrerte programtillegg og egendefinerte arbeidsflytaktiviteter utvider du noden (Samling) CustomPlugin-FS Geospatial.dll, og velg et registrert programtillegg, for eksempel Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix.
Høyreklikk Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix, og velg Registrer nytt trinn.
I dialogboksen Registrer nytt trinn angi følgende:
- Melding: msdyn_RetrieveDistanceMatrix
- Utføringsrekkefølge: Etter behov. Se Utføringsrekkefølgevurderinger under registrering av din egendefinerte plugin-modul tidligere i denne artikkelen.
- Pipelinetrinn for utførelse for hendelse: PostOperation
- Utføringsmodus: Synkron
- La resten av feltene stå med standardverdiene. Klikk Registrer nytt trinn.
Deretter høyreklikker du plugin-modulen Microsoft.Crm.Sdk.Samples.msdyn_GeocodeAddress og velger Registrer nytt trinn.
I dialogboksen Registrer nytt trinn angi følgende:
- Melding: msdyn_GeocodeAddress
- Utføringsrekkefølge: Etter behov. Se Utføringsrekkefølgevurderinger under registrering av din egendefinerte plugin-modul tidligere i dette emnet.
- Pipelinetrinn for utførelse for hendelse: PostOperation
- Utføringsmodus: Synkron
- La resten av feltene stå med standardverdiene. Klikk Registrer nytt trinn.
Du er nå ferdig med å registrere trinn for å kalle den egendefinerte plugin-modulen for begge de geospatiale handlingene.
Hvis du viser noen av de geospatiale Universal Resource Scheduling-handlingene i registreringsverktøyet for plugin-modul, vil du se både standard og egendefinert plugin-modul registrert for handlingen. Se for eksempel plugin-modulen for handlingen mdyn_GeocodeAddress.
Se også
Eksempel: Egendefinert plugin-modul for å bruke Google Maps API som leverandør av geospatiale data