Passo a passo: Registrar um plug-in compatível com o Azure com a ferramenta de registro de plug-in do CRM

  • Artigo

 

Publicado: novembro de 2016

Aplicável a: Dynamics CRM 2015

Esse roteiro demonstra como configurar o Microsoft Azure Active Directory Access Control Service (ACS) e registrar uma etapa de ponto de extremidade de serviço usando a ferramenta de registro de plug-in. Depois de configurado, o Microsoft Dynamics CRM 2015 e o Microsoft Dynamics CRM Online podem postar o contexto de execução da operação atual em um ponto de extremidade de solução do Microsoft Azure. Para esse roteiro, a etapa é registrada para postar o contexto de execução da mensagem CreateRequest para uma entidade do Account no Barramento de Serviço do Microsoft Azure.

Os seguintes pré-requisitos devem ser concluídos antes de iniciar este roteiro:

Etapas

Este guia passo a passo contém as etapas a seguir:

  1. Conectar-se ao servidor Microsoft Dynamics CRM

  2. Crie uma configuração de ponto de extremidade de serviço

  3. Configurar ACS

  4. Registrar uma etapa do ponto de extremidade de serviço para um evento

  5. Testar o registro do ponto de extremidade

Conectar-se ao servidor Microsoft Dynamics CRM

Siga as etapas a seguir para se conectar ao servidor Microsoft Dynamics 365 usando a ferramenta de Registro de Plug-in.

  1. Executar a ferramenta Plug-in Registration.

  2. Selecione Criar Nova Conexão.

  3. Na caixa de diálogo Logon, selecione o botão de opção do tipo de implantação que corresponde ao servidor Microsoft Dynamics 365 em que você deseja registrar um ponto de extremidade de serviço. O botão de opção Local inclui uma implantação IFD, o botão Online é para o provedor Windows Live do Microsoft Dynamics CRM Online, e o botão Office 365 é para o provedor Microsoft Online Services do Microsoft Dynamics CRM Online.

    Formulário de logon para uma implantação online

    Formulário de logon para uma implantação online
    Janela de logon para uma implantação local

    Formulário de logon para uma implantação no local

  4. Se você marcar Sempre exibir uma lista de organizações disponíveis, será exibida uma lista de organizações às quais você pertence depois de selecionar Logon. Isso permite escolher a organização na qual você deseja registrar o ponto de extremidade de serviço. Caso contrário, será usada a organização padrão.

  5. Insira as informações indicadas sobre o servidor e a conta de logon e, em seguida, selecione Logon.

Crie uma configuração de ponto de extremidade de serviço

Siga as etapas a seguir para registrar um ponto de extremidade de serviço do Microsoft Azure.

  1. Selecione a guia da organização na qual você deseja registrar um ponto de extremidade de serviço.

  2. Na barra de ferramentas da guia, selecione Registrar e, em seguida, em Registrar novo ponto de extremidade de serviço.

  3. Preencha a caixa de diálogo Registro do ponto de extremidade de serviço com as informações relacionadas à solução, conforme mostrado na figura a seguir e descrito na tabela seguinte. Verifique se o contrato especificado é o mesmo contrato usado pelo aplicativo de listener da solução.

    Criar um ponto de extremidade do serviço

    Elemento da UI

    description

    Nome (campo)

    Um nome para o registro de ponto de extremidade de serviço.

    Descrição (campo)

    Uma descrição deste registro do ponto de extremidade.

    Espaço Reservado da Solução (campo)

    O nome do namespace do serviço da solução.

    Caminho (campo)

    O caminho do projeto. Por exemplo, para um determinado ponto de extremidade de serviço URL do https://crmsdkdemo-sb.accesscontrol.windows.net/TwoWayService/Demo, o caminho é TwoWayService/Demo.

    Contrato (menu suspenso)

    O contrato de ponto de extremidade. Um aplicativo de listener deve usar esse contrato para ler a mensagem postada. Para obter mais informações, consulte Gravar um ouvinte para uma solução do Microsoft Azure.

    Declaração (menu suspenso)

    As declarações para enviar ao Microsoft Azure. Use Nenhum para a declaração padrão. Especifique UserId ou UserInfo para enviar informações adicionais sobre o usuário conectado.

    Modo federado (caixa de seleção)

    Marque essa caixa para usar o modo federado.

    ID (campo)

    Campo não gravável que é preenchido automaticamente com a ID da configuração do ponto de extremidade.

    Salvar e Configurar ACS (botão)

    Salva a configuração inserida e automatiza o processo de configuração do ACS para você. Fornece uma maneira interativa de fazer o que está descrito no tópico Passo a passo: configurar ACS do Microsoft Azure para integração com o Microsoft Dynamics CRM 2015.

    Salvar e Verificar Autenticação (botão)

    Salva a configuração inserida e verifique se o ACS está configurado corretamente.

    Salvar (botão)

    Salva a configuração inserida e fecha a caixa de diálogo.

  4. Se você ainda não tiver configurado a integração do ACS com o Microsoft Dynamics 365 e quiser que a ferramenta de registro de plug-in faça a configuração para você, selecione Salvar e configurar o ACS e, em seguida, siga as instruções na próxima seção deste roteiro. Se você já tiver configurado o ACS, selecione Salvar e verificar a autenticação ou em Salvar e continue com as instruções em Registrar uma etapa do ponto de extremidade de serviço para um evento.

Configurar ACS

Siga as etapas abaixo para configurar o Microsoft Azure Active Directory Access Control Service (ACS).

  1. Depois de selecionar Salvar e Configurar ACS, a caixa de diálogo Configuração ACS aparece. Insira os valores de dados adequados nos campos de formulário conforme descrito na tabela a seguir.

    Nome do Campo

    Descrição

    Chave de Gerenciamento

    A chave de gerenciamento da sua solução. É possível obter este valor de chave no Portal de Gerenciamento do Azure.

    Obtenha uma chave de gerenciamento para um namespace do barramento de serviço

    1. Entre no portal do Azure.

    2. No painel esquerdo, selecione Barramento de Serviço e selecione o espaço reservado na lista.

    3. Na parte inferior da página, selecione Informações de conexão.

    4. Na caixa de diálogo Acessar as informações de conexão, a Chave padrão será mostrada. Esta é a chave de gerenciamento.

    Observação

    Se você tiver modificado a chave simétrica, digite essa chave em vez da chave padrão no campo Chave de Gerenciamento. Se você não fizer isso, talvez receba erros com uma descrição como: “ACS50012: falha na autenticação”.

    Arquivo do Certificado

    O arquivo de certificado público que foi usado para configurar o Microsoft Dynamics 365 para integração com o Microsoft Azure.

    Para o Atualização do Microsoft Dynamics CRM 2015 e Microsoft Dynamics CRM Online 2015, é possível baixar este arquivo de certificado do servidor. No aplicativo Web Microsoft Dynamics 365, selecione Configurações > Personalizações e selecione Recursos do Desenvolvedor. Baixe e salve o arquivo de certificado usando o link fornecido abaixo de Barramento de Serviço do Microsoft Azure Certificado de emissor.

    Nome do Emissor

    O nome do emissor. Esse nome deve ser o mesmo usado para configurar o Microsoft Dynamics 365 para integração com o Microsoft Azure. É possível obter o nome do emissor na página Recursos do Desenvolvedor mencionada na descrição anterior.

    Para obter mais informações, consulte Configurar a integração do Azure com o Microsoft Dynamics CRM 2015.

  2. Selecione Configurar ACS. Um log do processo de configuração é exibido na área de saída do formulário.

  3. Escolha Fechar.

  4. Selecione Salvar e Verificar Autenticação na caixa de diálogo Registro do Ponto de Extremidade do Serviço. Após a verificação ser concluída, é possível fechar as caixas de diálogo.

Registrar uma etapa do ponto de extremidade de serviço para um evento

Siga as etapas a seguir para registrar uma etapa para um evento no ponto de extremidade de serviço.

  1. Selecione o ponto de extremidade de serviço registrado anteriormente na exibição em árvore da ferramenta.

  2. Navegue até o menu Registrar e selecione Registrar nova etapa.

  3. Preencha a caixa de diálogo Registrar nova etapa para um evento de criação de conta, conforme mostrado na figura a seguir.

    Criar uma etapa de extremidade de serviço

  4. Selecione Registrar Nova Etapa.

O Microsoft Dynamics 365 agora postará a mensagem atual que contém o contexto de execução para o barramento de serviço sempre que uma conta é criada. A postagem é executada de maneira assíncrona e não imediatamente.

Testar o registro do ponto de extremidade

Após o registro do ponto de extremidade, é possível testá-lo. Um listener deve estar executando ou uma fila deve estar disponível no ponto de extremidade de destino da postagem do barramento de serviço do plug-in a ocorrer.

  1. Abra o aplicativo Web Microsoft Dynamics 365 para a mesma organização em que você registrou o ponto de extremidade do serviço.

  2. Selecione o botão CriarBotão Criar e selecione Conta.

  3. Digite um nome de conta, por exemplo, Adventure Works Cycle, no campo Nome da conta e, em seguida, selecione Salvar.

  4. Aguarde cerca de 10 minutos para que a postagem do Barramento de Serviço do Microsoft Azure ocorra.

  5. Selecione Configurações > Trabalhos do Sistema.

  6. Abra o trabalho do sistema que tem o mesmo nome especificado para o ponto de extremidade do serviço. Verifique o status para consultar se a postagem foi bem-sucedida, se está aguardando ou se falhou.

Agora você pode cancelar o registro do ponto de extremidade, se desejar, selecionando-o na exibição em árvore da ferramenta e selecione Cancelar registro.

Confira Também

Extensões do Azure para Microsoft Dynamics CRM 2015
Integração do Azure com o Microsoft Dynamics CRM
Ativar diretório e autenticação com base em declarações

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais