Mukautetun laajennuksen rekisteröiminen ja käyttöönottaminen ensisijaisen geospatiaalisen tietopalvelun käyttöä varten
Ennen kuin laajennusta voidaan käyttää, se on rekisteröitävä ja otettava käyttöön palvelimessa.
Laajennusprojektin muodostamisen tuloksena on laajennuskokoonpano (.dll). Tässä artikkelissa on tietoja sellaisen laajennuskokoonpanon rekisteröinnistä ja käyttöönotosta, jolla kaksi geospatiaalista toimintoa käyttää ensisijaista geospatiaalista tietopalvelua. Lisätietoja laajennuksen kirjoittamisesta on kohdassa Mukautetun laajennuksen luominen käyttämään ensisijaista geospatiaalista tietopalvelua
Mukautetun laajennuksen rekisteröinnin suoritusjärjestykseen liittyviä seikkoja
Kun samalle entiteetille ja sanomalle rekisteröidään useita laajennuksia, yksittäisten laajennusten Suoritusjärjestys määrittää laajennusten suoritusjärjestyksen. Laajennus, jonka suoritusjärjestyksen arvo on pienin, suoritetaan ensin. Sen jälkeen suoritetaan suoritusjärjestysarvoltaan seuraava laajennus.
Field Servicen ja Project Servicen Bing Mapsia geokoodaukseen ja etäisyystaulukkotoimiin käyttävän oletuslaajennuksen suoritusjärjestyksen arvo on 1. Voit määrittää mukautetun laajennuksen suoritusjärjestyksen siten, että suoritetaan ennen oletuslaajennus (arvo pienempi kuin 1) tai sen jälkeen (arvo suurempi kuin 1).
Seuraavassa taulukossa osoittaa, miten haluat mukautettua laajennusta käsiteltävän laajennuksen rekisteröinti- ja parametriehdoissa määritetyn suoritusjärjestyksen mukaan.
| Hierarkia | Description |
|---|---|
| Ensisijainen | Jos haluat käsitellä mukautettua laajennusta ensisijaisena ja Bing-oletuslaajennusta toissijaisena, määritä laajennuksen suoritusjärjestykseksi 0. Tällä tavoin laajennus suoritetaan ennen Bing-laajennusta. Bing-laajennus tarkastelee mukautetun laajennuksen palauttamia leveys- ja pituusastearvoja ja siirtyy geokoodaukseen Bingin kautta vain, jos molemmat palautetut arvot ovat 0. Tämä on ensisijainen tapa, jos mukautetun laajennuksen odotetaan tuottavan suurimman osan geokoodauksesta. |
| Toissijainen | Jos haluat käsitellä mukautettua laajennusta toissijaisena Bing-laajennukseen nähden toimittamalla geokoodauspalvelun vain, kun Bingin geokoodaus epäonnistuu, määritä laajennuksen suoritusjärjestykseksi 2. Lisäksi mukautetun laajennuksen koodi kirjoitetaan siten, että se tarkastelee ensin Bing-laajennuksen palauttamia leveys- ja pituusastearvoja ja siirtyy geokoodaukseen vain, jos molemmat palautetut arvot ovat 0. Tämä on ensisijainen suoritustapa, jos Bingin odotetaan tuottavan suurimman osan geokoodauksesta. |
| Ohitetaan kokonaan | Jos haluat, että mukautettu laajennus on aina geokoodauksen lähde ja ohittaa täysin Bingin geokoodauksessa myös silloin, kun mukautetun laajennuksen geokoodaus ei onnistu, leveys- ja pituusastearvoksi on aina palautettava jokin muu arvo kuin 0,0. Haluat ehkä päättää, mitkä poikkeusehdot aiheuttavat .NET-poikkeuksen ja mitkä eivät vain palauta tulosta. Jos et haluat, että mukautettu laajennus ei palauta tulosta eikä salli minkään seuraavan laajennuksen palauttaa tulosta, mukautetun laajennuksen palautettava arvo, kuten 0,0001, 0,0001. |
Mukautetun laajennuksen rekisteröityminen ja käyttöönottaminen
Voit rekisteröidä ja ottaa käyttöön laajennuksia käyttämällä laajennusten rekisteröintityökalua tai kirjoittamalla rekisteröintikoodin ohjelmallisesti käyttämällä tiettyjä SDK-luokkia. Lisätietoja: Laajennusten rekisteröinti ja käyttöönottaminen.
Tässä osassa käytetään laajennuksen rekisteröintityökalua, jonka käyttöliittymällä on helppo rekisteröidä ja ottaa käyttöön laajennuksia. Tämä osa sisältää tietoja sillä oletuksella, että käytät mukautettua näytelaajennusta ja että olet muodostanut näyteprojektin, joka luo CustomPlugin-FS-Geospatial.dll-kokoonpanon. Jos olet kehittänyt oman mukautetun laajennuksen, kokoonpanolla ja laajennuksilla on eri nimi. Laajennuksen rekisteröinnin ohjeet ovat yleisesti ottaen samat.
Tippi
Lisätietoja laajennuksen rekisteröintityökalusta yleensä on kohdassa Opastus: Laajennuksen rekisteröinti laajennuksen rekisteröintityökalulla
Hanki laajennuksen rekisteröintityökalu. Lisätietoja laajennusten rekisteröintityökalun hankkimisesta on kohdassa Työkalujen lataaminen NuGetista.
Siirry
[Your folder]\Tools\PluginRegistration-kansioon ja suorita työkalu kaksoisnapsauttamalla PluginRegistration.exe-tiedostoa.Valitse LUO UUSI YHTEYS.
Määritä Sisäänkirjaus-valintaikkunassa tunnistetiedot, jolla muodostetaan yhteys Dynamics 365 -esiintymään, ja valitse Kirjaudu sisään.
Jos Dynamics 365 -esiintymässä voi käyttää useita organisaatiota, voit valita luettelosta organisaation, johon yhteys muodostetaan. Muussa tapauksessa käytetään oletusorganisaatiota.
Näkyvissä pitäisi olla kutistettu rekisteröityjen laajennusten luettelo tai mukautetut työnkulun aktiviteettikokoonpanot. Valitse Rekisteröinti>Rekisteröi uusi kokoonpano.
Tee Rekisteröi uusi kokoonpano -valintaikkunassa seuraavat toiminnot:
Valitse Vaihe 1 -osassa kolme pistettä […] painike, jolla valitaan CustomPlugin-FS-Geospatial.dll -kokoonpano.
Valitse Vaihe 2 -osassa molemmat laajennukset.
Valitse Vaihe 3 -osassa Sandbox-ympäristö-asetus.
Valitse Vaihe 4 -osassa Tietokanta-asetus.
Valitse Rekisteröi valitut laajennukset.
CustomPlugin-FS-Geospatial.dll-kokoonpano sekä kaksi msdyn_GeocodeAddress- ja msdyn_RetrieveDistanceMatrix-laajennusta on nyt rekisteröity ja otettu käyttöön palvelimessa.
Seuraava vaihe on vaiheen rekisteröinti kullekin toiminnolle. Vaihe viittaa SDK-sanoman käsittelyvaiheen entiteetin, jolla määritetään, miten ja milloin laajennus suoritetaan.
Laajenna Rekisteröidyt laajennukset ja mukautetut työnkulun aktiviteetit -puunäkymässä (Kokoonpano) CustomPlugin-FS-Geospatial -solmu ja valitse rekisteröity laajennus, kuten Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix.
Valitse kaksoisnapsauttamalla ensin Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix ja sitten Rekisteröi uusi vaihe.
Määritä Rekisteröi uusi vaihe -valintaikkunassa seuraavat tiedot:
- Sanoma: msdyn_RetrieveDistanceMatrix
- Suoritusjärjestys: Tarvittaessa. Katso Mukautetun laajennuksen rekisteröinnin suoritusjärjestykseen liittyviä seikkoja aiemmin tässä artikkelissa.
- Tapahtuman putken suoritusvaihe: toiminnon jälkeinen.
- Suoritustila: synkroninen.
- Jätä muihin kenttiin oletusarvot. Valitse Rekisteröi uusi vaihe.
Kaksoisnapsauta sitten Microsoft.Crm.Sdk.Samples.msdyn_GeocodeAddress-laajennusta ja valitse sitten Rekisteröi uusi vaihe.
Määritä Rekisteröi uusi vaihe -valintaikkunassa seuraavat tiedot:
- Sanoma: msdyn_GeocodeAddress
- Suoritusjärjestys: Tarvittaessa. Katso Mukautetun laajennuksen rekisteröinnin suoritusjärjestykseen liittyviä seikkoja aiemmin tässä ohjeaiheessa.
- Tapahtuman putken suoritusvaihe: toiminnon jälkeinen.
- Suoritustila: synkroninen.
- Jätä muihin kenttiin oletusarvot. Valitse Rekisteröi uusi vaihe.
Rekisteröintivaiheiden valmistuttua mukautettu laajennus voidaan nyt kutsua molemmille geospatiaalisille toiminnoille.
Jos tarkastelet Universal Resource Schedulingin geospatiaalisia toimintoja laajennuksen rekisteröintityökalussa, sekä oletuslaajennus että mukautettu laajennus näkyvät toiminnolle rekisteröitynä. Katso esimerkiksimdyn_GeocodeAddress-toiminnon laajennukset.
