Regisztráljon és telepítsen egy egyéni beépülő modult az előnyben részesített földrajzi adatszolgáltatójának használatához

A beépülő modult a használata előtt regisztrálni és telepíteni kell a kiszolgálón.

A beépülő modul projekt létrehoz egy beépülő modul összeállítást (.dll). Ez a cikk ismerteti, hogyan regisztrálni és telepíteni az egyéni beépülő modul összeállítást két földrajzi művelethez, az előnyben részesített földrajziadat-szolgáltató használatához. További tudnivalókért a beépülő modul írásáról, lásd: Egyéni beépülő modul létrehozása az előnyben részesített földrajzi adatszolgáltató használatához

Végrehajtási sorrend az egyéni beépülő modul regisztrálásakor

Amikor regisztrál ugyanazon entitáshoz és üzenethez több beépülő modult, a beépülő modulok végrehajtási sorrendjét az egyedi beépülő modulok Végrehajtási sorrendje határozza meg. Az alacsonyabb értékkel rendelkező lesz először végrehajtva, ezt követi a magasabb értékű végrehajtása.

A végrehajtási sorrend értéke az alapértelmezett beépülő modulnál a Field Service és a Project Service esetében, amely a Bing Mapst használja a geokód és távolságmátrix műveletekhez: 1. Megadhatja a végrehajtási sorrendet az egyéni beépülő modulhoz, hogy az alapértelmezett beépülő modul előtt (1-nél kisebb) vagy után (1-nél nagyobb) legyen végrehajtva.

Az alábbi táblázat azt szemlélteti, hogyan lehet célszerű az egyéni beépülő modul kezelése a végrehajtási sorrendtől függően, a beépülő modul regisztrációjakor és a paraméter feltételeknél.

Elsődleges	Ha azt szeretné, hogy az egyéni beépülő modul kezelési módja elsődleges legyen, és az alapértelmezett Bing beépülő modul legyen a másodlagos, az egyéni beépülő modul végrehajtási sorrendjét állítsa 0 értékre. Ez azt eredményezi, hogy a beépülő modulja végrehajtása a Bing beépülő modulé előtt történik. A Bing beépülő modul megvizsgálja a „szélesség” és „hosszúság” értékeket, amelyeket az egyéni beépülő modul ad vissza, és csak akkor használja a Binget a geokódoláshoz, ha mindkét visszaadott értékek: 0. Ez lehet a kívánt lehetőség, ha az egyéni beépülő modultól várjuk azt, hogy kielégítse a geokódolási igények többségét.
Másodlagos	Ha azt szeretné, hogy az egyéni beépülő modulja másodlagosként legyen kezelve a Bing beépülő modulhoz képest, és csak akkor nyújtson geokódolási szolgáltatást, ha a Bing használatával sikertelen a geokódolás, állítsa be a beépülő modulja végrehajtási sorrendjét a 2 értékre. Az egyéni beépülő modult úgy kell megírni, hogy először megvizsgálja a „szélesség” és „hosszúság” értékeket, amelyeket a Bing beépülő modul ad vissza, és csak akkor lépjen működésbe, ha mindkét visszaadott értékek: 0. Ez lehet a kívánt végrehajtás, ha z Bing beépülő modultól várjuk azt, hogy kielégítse a geokódolási igények többségét.
Teljesen felülbírálás	Ha szeretné, hogy mindig az egyéni beépülő modul legyen a geokódolás forrása, és teljesen felül szeretné írni a Binget a geokódolásnál még akkor is, ha az egyéni beépülő modulnak nem sikerül a geokódolás, mindig 0,0-tól eltérő a „szélesség” és „hosszúság” értéket kell visszaadni. Célszerű lehet eldönteni, hogy milyen kivételfeltételek eredményezzenek .NET-keretrendszer kivételt, és melyek egyszerűen nem adjanak vissza eredményt. Ahhoz, hogy legyen visszaadva eredmény, és ne engedélyezze a későbbi beépülő moduloknak az eredmény visszaadását, az egyéni beépülő modulnak ehhez hasonlót kell visszaadnia: 0.0001,0.0001.

Egyéni beépülő modul regisztrálása és telepítése

Beépülő modult egisztrálni és telepíteni a Plugin Registration Tool (PRT) használatával lehet, vagy programozott módon regisztrációs kód írásáva bizonyos SDK osztályok használatával. További információ: Beépülő modul regisztrálása és telepítése.

Ebben a szakaszban a Plugin Registration Toolt (PRT) használjuk, amely a beépülő modulok egyszerű regisztrálásához és telepítéséhez grafikus felhasználói felület kínál. Ez a szakaszt azt feltételezi, hogy a minta egyéni beépülő modullal dolgozik, és a mintaprojektet építette a CustomPlugin-FS-Geospatial.dll összeállítás létrehozásához. Ha kifejlesztette a saját egyéni beépülő modulját, az összeállítás és a beépülő modulok neve eltérő lesz, de a beépülő modul regisztrálására vonatkozó általános útmutatás változatlan marad.

Tipp

A Plugin Registration Tool (PRT) használatával kapcsolatos részletes tudnivalókért lásd: Forgatókönyv: egy beépülő modul regisztrálása a beépülőmodul-regisztrációs eszköz használatával

1. Szerezze be a Plug-in Registration Toolt. A Plug-in Registration Tool letöltésével kapcsolatban tekintse meg az Eszközök letöltése a NuGet felületéről című cikket.

2. Keresse meg ezt a mappát: [Your folder]\Tools\PluginRegistration, és kattintson duplán a PluginRegistration.exe fájlra az eszköz futtatásához.

3. Kattintson az ÚJ KAPCSOLAT LÉTREHOZÁSA lehetőségre.

4. A Bejelentkezés párbeszédpanelen adja meg a Dynamics 365 példányhoz való kapcsolódáshoz szükséges hitelesítő adatokat, és kattintson a Bejelentkezés elemre.

5. Ha több szervezethez van hozzáférése a Dynamics 365 példányban, megjelenik a szervezetek listája, amelyekhez csatlakozhat. Ellenkező esetben az alapértelmezett szervezet lesz használatban.

6. Látnia kell a regisztrált beépülő modulok vagy az egyéni munkafolyamat-tevékenységek összeállításainak listáját. Válassza a Regisztráció > Új összeállítás regisztrálása elemet.

7. Az Új összeállítás regisztrálása párbeszédablakban:

   • Az 1. lépés részben kattintson a három pont […] gombra, majd válassza a CustomPlugin-FS-Geospatial.dll összeállítást.

   • A 2. lépés szakaszban jelölje be mindkét beépülő modult.

   • A 3. lépés szakaszban jelölje be a Védőfal lehetőséget.

   • A 4. lépés szakaszban jelölje be az Adatbázis lehetőséget.

   • Válassza ki a Kiválasztott beépülő modulok regisztrálása elemet.

     

     A CustomPlugin-FS-Geospatial.dll összeállítás és a két beépülő modul, az msdyn_GeocodeAddress és az msdyn_RetrieveDistanceMatrix most már regisztrálva van és üzembe van helyezve a kiszolgálón.

8. A következő lépés egy lépés regisztrálása minden egyes művelethez. A lépés az SDK-üzenet feldolgozási lépés entitásra utal: ezzel konfiguráljuk, hogy mikor és hogyan történik a beépülő modul végrehajtása.

   A Beépülő modulok és az egyedi munkafolyamat-műveletek regisztrálása fanézetben bontsa ki az (Összeállítás) CustomPlugin-FS-Geospatial csomópontot, és jelöljön ki egy regisztrált beépülő modult, ami legyen például ez: Microsoft.Crm.Sdk.Samples.msdyn_ RetrieveDistanceMatrix.

   

9. Kattintson a jobb gombbal a Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix elemre, és jelölje ki az Új lépés regisztrálása elemet.

10. Az Új lépés regisztrálása párbeszédpanelen adja meg a következőket:

    • Üzenet: msdyn_RetrieveDistanceMatrix
    • Végrehajtási sorrend: Igény szerint. Lásd: Végrehajtási sorrend az egyéni beépülő modul regisztrálásakor, korábban ebben a cikkben.
    • Eseményértékesítési-prognózisfolyamat végrehajtása: PostOperation
    • Végrehajtási mód: Szinkron
    • Hagyja alapértelmezett értéken a többi mezőt. Kattintson az Új lépés regisztrálása lehetőségre.

    

11. Ezután kattintson a jobb gombbal a Microsoft.Crm.Sdk.Samples.msdyn_GeocodeAddress elemre, és jelölje ki az Új lépés regisztrálása elemet.

12. Az Új lépés regisztrálása párbeszédpanelen adja meg a következőket:

    • Üzenet: msdyn_GeocodeAddress
    • Végrehajtási sorrend: Igény szerint. Lásd: Végrehajtási sorrend az egyéni beépülő modul regisztrálásakor, korábban ebben a témakörben.
    • Eseményértékesítési-prognózisfolyamat végrehajtása: PostOperation
    • Végrehajtási mód: Szinkron
    • Hagyja alapértelmezett értéken a többi mezőt. Kattintson az Új lépés regisztrálása lehetőségre.

    

Ezzel a végére ért azoknak a regisztrációs lépéseknek, hogy meghívhassa az egyéni beépülő modult mindkét földrajzi művelethez.

Ha megtekinti bármelyik Universal Resource Scheduling földrajzi műveletet a Plugin Registration Tool eszközben, láthatja, hogy az alapértelmezett és az egyéni beépülő modul is regisztrálva lesz a művelethez. Tekints meg például a beépülő modulokat a mdyn_GeocodeAddress művelethez.

Kapcsolódó információk

Minta: Egyéni beépülő modul a Google Maps API használatára földrajzi adatszolgáltatóként

Hinweis

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).