Registar e implementar o plug-in personalizado para utilizar o fornecedor de dados geospacial preferencial

Antes de um plug-in poder ser utilizado, deve ser registado e implementado no servidor.

Criar o seu projeto de plug-in irá originar um conjunto de plug-in (. dll). Este artigo fornece informações sobre como pode registar e implementar o conjunto de plug-in para as duas ações geoespaciais para utilizar o fornecedor de dados geoespaciais preferencial. Para obter informações sobre como criar um plug-in, consulte Criar plug-in personalizado para utilizar o fornecedor de dados geoespaciais preferencial

Considerações de ordem de execução ao registar o plug-in personalizado

Quando registar vários plug-ins para a mesma entidade e mensagem, a sequência de execução de plug-ins é definida pela Ordem de Execução de plug-ins individuais. A que tiver um valor de ordem de execução inferior é executada primeiro, seguido pela que tem um valor de ordem de execução superior.

O valor da ordem de execução do plug-in predefinido no Field Service e Project Service que utiliza o Mapas Bing para as ações de matriz de geocódigo e distância está definido como 1. Também pode definir a ordem de execução do seu plug-in personalizado para executar antes (menor do que 1) ou depois (maior do que 1) o plug-in predefinido.

A seguinte tabela mostra como poderá querer que o seu plug-in personalizado seja tratado consoante a ordem de execução especificada durante o registo e condições de parâmetro do plug-in.

Hierarquia	Description
Primário	Se pretender tratar o plug-in personalizado como primário e o plug-in predefinido do Bing plug-in como secundário, defina a ordem de execução do seu plug-in para 0. Isto fará com que o seu plug-in seja executado antes do plug-in do Bing. O plug-in do Bing examinará os valores "latitude" e "longitude" devolvidos pelo seu plug-in personalizado e apenas continua para aplicar geocódigo com o Bing se ambos os valores devolvidos forem 0. Esta seria a forma preferencial se o plug-in personalizado é esperado que forneça a maior parte das suas necessidades de geocodificação.
Secundário	Se pretender tratar o plug-in personalizado como secundário para o plug-in Bing, fornecendo o serviço de geocodificação apenas quando o Bing não consegue geocodificar, defina a ordem de execução do seu plug-in para 2. Também iria escrever o código do seu plug-in personalizado de forma a que examine primeiro os valores "latitude" e "longitude" devolvidos pelo plug-in do Bing e apenas continua se ambos os valores devolvidos forem 0. Esta seria a execução preferencial se o Bing é esperado que forneça a maior parte das suas necessidades de geocodificação.
Ignorar completamente	Se pretender sempre que o plug-in personalizado seja a origem da geocodificação e ignore completamente a geocodificação do Bing mesmo quando o plug-in personalizado não consegue geocodificar, terá de devolver sempre algo diferente de 0,0 para os valores "latitude" e "longitude". Poderá pretender decidir quais as condições de exceção que lançam uma exceção .NET e quais, simplesmente, não devolvem resultados. Para não devolver resultados e não permitir qualquer plug-in subsequente devolva um resultado, o plug-in personalizado tem de devolver algo como 0.0001, 0,0001.

Registar e implementar o plug-in personalizado

Pode registar e implementar plug-ins utilizando o Plugin Registration Tool ou programaticamente escrevendo o código de registo com determinadas classes SDK. Obter mais informações: Registar e Implementar Plug-ins.

Para esta secção, iremos utilizar o Plugin Registration Tool, que fornece uma interface de utilizador gráfica para registar e implementar plug-ins facilmente. Além disso, esta secção contém informações com base no princípio de que está a trabalhar com o exemplo de plug-in personalizado e criou o projeto de exemplo para gerar o conjunto CustomPlugin-FS-Geospatial.dll. Se ter desenvolvido o seu próprio plug-in personalizado, o nome do conjunto e os plug-ins variam, mas as instruções globais para registar o plug-in permanecerão inalteradas.

Gorjeta

Para obter informações detalhadas sobre como utilizar o Plugin Registration Tool em geral, consulte Passo a passo: registar um plug-in utilizando o Plugin Registration Tool

1. Obtenha o Plugin Registration Tool. Para obter a ferramenta Plug-in Registration Tool, consulte Transferir ferramentas a partir do NuGet.

2. Navegue para a pasta [Your folder]\Tools\PluginRegistration e faça duplo clique no ficheiro PluginRegistration.exe para executar a ferramenta.

3. Clique em CRIAR NOVA LIGAÇÃO.

4. Na caixa de diálogo Início de sessão, especifique as credenciais para se ligar à sua instância do Dynamics 365 e, em seguida, clique em Iniciar sessão.

5. Se tiver acesso a várias organizações na instância do Dynamics 365, é apresentada uma lista de organizações para que escolha a qual delas se pretende ligar. Caso contrário, a organização predefinida é utilizada.

6. Deverá ver uma lista fechada de plug-in registados ou conjuntos de atividade de fluxos de trabalho personalizados. Selecione Registar>Registar novo conjunto.

7. Na caixa de diálogo Registar Novo Conjunto:

   • Na secção Passo 1, clique nas reticências [...] botão para selecionar da assemblagem CustomPlugin-FS-Geospatial.dll.

   • Na secção Passo 2, selecione ambos os plug-ins.

   • Na secção Passo 3, selecione a opção Sandbox.

   • Na secção Passo 4, selecione a opção Base de Dados.

   • Selecione Registar Plug-ins Selecionados.

     

     O conjunto CustomPlugin-FS-Geospatial.dll e os dois plug-ins da msdyn_GeocodeAddress e msdyn_RetrieveDistanceMatrix agora estão registados e implementados no servidor.

8. O passo seguinte é registar um passo para cada ação. Um passo refere-se à entidade de passo de processamento de mensagem que é utilizada para configurar quando e como o plug-in será executado.

   Na vista de árvore Plug-ins Registados e Atividades de Fluxo de Ambiente de Trabalho Personalizado, expanda o nó (Assemblagem) CustomPlugin-FS-Geospatial e selecione um plug-in registado, digamos Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix.

   

9. Clique com o botão direito do rato em Microsoft.Crm.Sdk.Samples.msdyn_RetrieveDistanceMatrix e selecione Registar Novo Passo.

10. Na caixa de diálogo Registar Novo Passo, especifique o seguinte:

    • Message: msdyn_RetrieveDistanceMatrix
    • Ordem de Execução: conforme necessário. Consulte Considerações de ordem de execução ao registar o plug-in personalizado apresentado anteriormente neste artigo.
    • Estado de Execução do Pipeline do Evento: PostOperation
    • Modo de Execução: síncrono
    • Deixe o resto dos campos com os valores predefinidos. Clique em Registar Novo Passo.

    

11. De seguida, clique com o botão direito do rato no plug-in Microsoft.Crm.Sdk.Samples.msdyn_GeocodeAddress e selecione Registar Novo Passo.

12. Na caixa de diálogo Registar Novo Passo, especifique o seguinte:

    • Message: msdyn_GeocodeAddress
    • Ordem de Execução: conforme necessário. Consulte Considerações de ordem de execução ao registar o plug-in personalizado apresentado anteriormente neste tópico.
    • Estado de Execução do Pipeline do Evento: PostOperation
    • Modo de Execução: síncrono
    • Deixe o resto dos campos com os valores predefinidos. Clique em Registar Novo Passo.

    

Terminou agora os passos de registo para chamar o seu plug-in personalizado para as ambas as ações geoespaciais.

Se visualizar uma das ações geoespaciais do Universal Resource Scheduling no Plugin Registration Tool, verá o plug-in predefinido e o seu plug-in personalizado registados para a ação. Por exemplo, consulte os plug-ins para a ação mdyn_GeocodeAddress.

Consulte também

Amostra: plug-in personalizado para utilizar a API Google Maps como fornecedor de dados geoespacial