Aangepaste invoegtoepassing van uw opgegeven georuimtelijke gegevensprovider te gebruiken
Voordat een invoegtoepassing kan worden gebruikt, moet deze op de server worden geregistreerd en geïmplementeerd.
Wanneer u een invoegtoepassingsproject maakt, resulteert dit in een invoegtoepassingassembly (.dll). Dit artikel biedt informatie over hoe u de invoegtoepassingassembly voor de twee georuimtelijke acties kunt registreren en implementeren om de georuimtelijke gegevensprovider van uw voorkeur te gebruiken. Voor informatie over het schrijven van een invoegtoepassing raadpleegt u Aangepaste invoegtoepassing van uw opgegeven georuimtelijke gegevensprovider te gebruiken
Overwegingen voor de uitvoeringsvolgorde bij het registreren van uw aangepaste invoegtoepassing
Als u meerdere invoegtoepassingen voor dezelfde entiteit en hetzelfde bericht registreert,wordt de uitvoeringsvolgorde van invoegtoepassingen gedefinieerd door de uitvoeringsvolgorde van afzonderlijke invoegtoepassingen. De invoegtoepassing met een lagere uitvoeringsvolgorde wordt als eerste uitgevoerd, gevolgd door de invoegtoepassing met een hogere uitvoeringswaarde.
De waarde voor de uitvoeringsvolgorde van de standaardinvoegtoepassing in Field Service en Project Service die Bing Kaarten gebruikt voor de geocode- en afstandsmatrixacties is ingesteld op 1. U kunt de uitvoeringsvolgorde van uw aangepaste invoegtoepassing instellen om te worden uitgevoerd voor (kleiner dan 1 ) of na (groter dan 1 ) de standaardinvoegtoepassing.
In de volgende tabel wordt aangegeven hoe u uw aangepaste invoegtoepassing mogelijk wilt behandelen, afhankelijk van de opgegeven uitvoeringsvolgorde tijdens de invoegtoepassingsregistratie en parameteromstandigheden.
| Hiërarchie | Omschrijving |
|---|---|
| Primair | Als u uw aangepaste invoegtoepassing als primaire invoegtoepassing wilt behandelen en de Bing-invoegtoepassing als de secundaire invoegtoepassing, stelt u de uitvoeringsvolgorde van uw invoegtoepassing in op 0. Het resultaat is dat uw invoegtoepassing eerder wordt uitgevoerd dan de Bing-invoegtoepassing. De Bing-invoegtoepassing controleert de waarden voor breedte- en lengtegraad die door uw aangepaste invoegtoepassing worden geretourneerd en gaat alleen door met geocoderen als beide geretourneerde waarden 0 zijn. Dit zou de voorkeursmanier zijn als uw aangepaste invoegtoepassing geacht wordt te voorzien in het merendeel van uw geocoderingsbehoeften. |
| Secundair | Als u uw aangepaste invoegtoepassing als secundaire invoegtoepassing wilt gebruiken die alleen geocoderingsservices biedt op het moment dat Bing niet geocodeert, stelt u de uitvoeringsvolgorde van uw invoegtoepassing in op 2. U schrijft de code voor uw aangepaste invoegtoepassing zo dat eerst de waarden voor breedte- en lengtegraad van Bing worden gecontroleerd en dat alleen wordt doorgegaan als beide geretourneerde waarden 0 zijn. Dit zou de voorkeursmanier van uitvoeren zijn als Bing geacht wordt te voorzien in het merendeel van uw geocoderingsbehoeften. |
| Volledig overschrijven | Als u wilt dat uw aangepaste invoegtoepassing altijd de bron van geocodering is en u Bing helemaal niet wilt gebruiken, ook niet als uw aangepaste invoegtoepassing niet geocodeert, moet u altijd iets anders dan 0,0 retourneren voor de waarden voor breedte- en lengtegraad. U kunt bepalen bij welke uitzonderingsomstandigheden een .NET-uitzondering moet optreden en in welke gevallen geen resultaat moet worden geretourneerd. Om geen resultaat te retourneren en een andere invoegtoepassing niet toe te staan om een resultaat te retourneren, moet uw aangepaste invoegtoepassing zoiets als 0,0001, 0,0001 retourneren. |
Uw aangepaste invoegtoepassing registreren en implementeren
U kunt invoegtoepassingen registreren en implementeren met de Plug-in Registration Tool of door registratiecode te schrijven met bepaalde SDK-klassen. Meer informatie: Invoegtoepassingen registreren en implementeren.
Voor deze sectie gebruiken we de Plug-in Registration Tool, die een grafische gebruikersinterface biedt waarin u invoegtoepassingen eenvoudig kunt registreren en implementeren. Daarnaast bevat deze sectie informatie op basis van de aanname dat u werkt met het voorbeeld van de aangepaste invoegtoepassing en het voorbeeldproject hebt gebouwd om de assembly CustomPlugin-FS-Geospatial.dll te genereren. Als u uw eigen aangepaste invoegtoepassing hebt ontwikkeld, hebben de assembly en invoegtoepassingen andere namen, maar komen de instructies voor het registreren van de invoegtoepassing wel overeen.
Fooi
Gedetailleerde informatie over het gebruik van de Plug-in Registration Tool in het algemeen vindt u in Overzicht: Een plug-in registreren met het registratiehulpprogramma voor plug-ins
Download de Plug-in Registration Tool. Als u het hulpmiddel voor invoegtoepassingsregistratie wilt ophalen, leest u Hulpmiddelen downloaden van NuGet.
Navigeer naar de map
[Your folder]\Tools\PluginRegistrationen dubbelklik op het bestand PluginRegistration.exe om het hulpprogramma uit te voeren.Klik op NIEUWE VERBINDING MAKEN.
Geef in het dialoogvenster Aanmelden de referenties voor verbinding met uw Dynamics 365-exemplaar op en klik op Aanmelden.
Als u toegang tot meerdere organisaties hebt in het Dynamics 365-exemplaar, wordt een lijst met organisaties weergegeven waaruit u kunt kiezen. Anders wordt de standaardorganisatie gebruikt.
Er wordt een samengevouwen lijst weergegeven met geregistreerde invoegtoepassingen of aangepaste werkstroomactiviteitassembly's. Selecteer Registreren>Nieuwe assembly registreren.
In het dialoogvenster Nieuwe assembly registreren:
Klik onder de sectie Stap 1 het beletselteken […] om de assembly CustomPlugin-FS-Geospatial.dll te selecteren.
Selecteer onder Stap 2 beide invoegtoepassingen.
Selecteer onder Stap 3 de optie Sandbox.
Selecteer onder Stap 4 de optie Database.
Selecteer Geselecteerde invoegtoepassingen registreren.
De assembly CustomPlugin-FS-Geospatial.dll en de twee invoegtoepassingen voor msdyn_GeocodeAddress en msdyn_RetrieveDistanceMatrix zijn nu geregistreerd en op de server geïmplementeerd.
In de volgende stap registreert u een stap voor elke actie. Een stap verwijst naar de verwerkingsstapentiteit voor SDK-berichten die wordt gebruikt om te configureren wanneer en hoe de plug-in moet worden uitgevoerd.
In de structuurweergave Registered Plug-ins & Custom Workflow Activities vouwt u het knooppunt (Assembly) CustomPlugin-FS-Geospatial uit en selecteert u een geregistreerde invoegtoepassing, bijvoorbeeld Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix.
Klik met de rechtermuisknop op Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix en selecteer Nieuwe stap registreren.
Geef in het dialoogvenster Nieuw stap registreren de volgende gegevens op:
- Bericht: msdyn_RetrieveDistanceMatrix
- Uitvoeringsvolgorde: zoals vereist. Zie Overwegingen voor de uitvoeringsvolgorde bij het registreren van uw aangepaste invoegtoepassing eerder in dit artikel.
- Fase van uitvoering gebeurtenis-pipeline: Nabewerking
- Uitvoeringsmodus: Synchroon
- Laat voor de rest van de velden standaardwaarden ongewijzigd. Klik op Nieuwe stap registreren.
Klik nu met de rechtermuisknop op de invoegtoepassing Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix en selecteer Nieuwe stap registreren.
Geef in het dialoogvenster Nieuw stap registreren de volgende gegevens op:
- Bericht: msdyn_GeocodeAddress
- Uitvoeringsvolgorde: zoals vereist. Zie Overwegingen voor de uitvoeringsvolgorde bij het registreren van uw aangepaste invoegtoepassing eerder in dit onderwerp.
- Fase van uitvoering gebeurtenis-pipeline: Nabewerking
- Uitvoeringsmodus: Synchroon
- Laat voor de rest van de velden standaardwaarden ongewijzigd. Klik op Nieuwe stap registreren.
U bent nu klaar met het registreren van stappen om uw aangepaste invoegtoepassing aan te roepen voor beide georuimtelijke acties.
Als u een van de georuimtelijke Universal Resource Scheduling-acties in de Plug-in Registration Tool bekijkt, ziet u zowel de standaardinvoegtoepassing en uw geregistreerde aangepaste invoegtoepassing voor de actie. Bekijk bijvoorbeeld de invoegtoepassingen voor de actie mdyn_GeocodeAddress.
