Configuração

Introdução

Para estabelecer uma conexão com êxito e enviar solicitações à API Web, a atividade Microsoft Dynamics Application Scope deve concluir a autenticação usando o protocolo OAuth 2.0 .

Para dar à atividade do Microsoft Dynamics 365 Scope a capacidade de autenticação usando OAuth 2.0 e para permitir que outras atividades enviem solicitações com êxito para a API da Web, você deve concluir as seguintes etapas:

1. Registre seu aplicativo.
2. Criar segredo do cliente.
3. Criar ativo de credencial.

4. Crie seu projeto.

   
   

   

   
   
   Observação:

   As atividades do Microsoft Dynamics 365 dependem do [Common Data Service])(https://docs.microsoft.com/en-us/dynamics365/human-resources/hr-admin-integration-choose-technology#common-data -entidades-de-serviço). Devido a essa dependência, as atividades suportam principalmente soluções de Customer Engagement .

   Atualmente, o Microsoft Dynamics for Finance & Operations não é suportado.

Etapas

1. Registre seu aplicativo

Siga as instruções específicas do Common Data Service na documentação da Microsoft para criar um registro de aplicativo (essas etapas incluem atribuir as permissões de API apropriadas).

Para obter mais informações sobre o registro do aplicativo para o Common Data Service, consulte Use OAuth with Common Data Service na documentação da Microsoft.

Ao registrar seu aplicativo, observe os valores de ID do aplicativo (cliente) e ID do diretório (inquilino) ; você os inserirá na atividade Escopo do aplicativo do Microsoft Dynamics .

2. Crie o segredo do cliente

Observação: esta etapa só é aplicável se você planejar usar ClientCredentials como o TipoDeAutenticação na atividade. Se você planeja usar PasswordCredentials, pode prosseguir para a compilação de seu projeto.

Siga as instruções na documentação da Microsoft para configurar seu aplicativo registrado para se conectar como um aplicativo (ou seja, conectar usando um segredo do cliente). Para obter mais informações sobre os segredos do cliente, consulte Use Client Secrets & Certificates na documentação da Microsoft.

Para referência rápida, a imagem abaixo mostra como criamos nosso segredo do cliente para nossos projetos de exemplo.

3. Criar usuário do aplicativo

Faça logon em sua conta do Microsoft Dynamics 365 Customer Engagement. Vá para Configurações > Segurança > Usuários > Novo usuário.

Altere a exibição para Usuário do Aplicativo. Insira a ID do aplicativo da etapa anterior no campo ID do aplicativo .

Preencha os outros campos como (Nome completo) e (E-mail principal) e salve o usuário.

4. Criar ativo de credencial

Observação: essa etapa só é aplicável se você planejar usar o ClientCredentials como o TipoDeAutenticação na atividade Microsoft Dynamics Application Scope . Se você planeja usar PasswordCredentials, pode prosseguir para a compilação de seu projeto.

A atividade do Escopo do Aplicativo do Microsoft Dynamics requer uma entrada SecureString para a propriedade ClientSecret . Para inserir a variável SecureString , é recomendável seguir as sugestões e etapas da seção deste guia.

5. Crie seu projeto

1. Crie um novo projeto de automação.

   1. Abra o UiPath Studio.
   2. Em Novo projeto, clique em Processo (isso abre uma janela Novo processo em branco ).
   3. Insira um Nome, Locale Descriçãodo projeto.
   4. Clique em Criar.

2. Instale o pacote UiPath.MicrosoftDynamics.Activities .

   1. Na faixa de opções Design , clique em Gerenciar pacotes (isso abre a janela Gerenciar pacotes ).
   2. Em Todos os Pacotes, clique em Oficial!
   3. Na barra de pesquisa , digite Dynamics.

   4. Clique, instale e aceite a licença do UiPath.MicrosoftDynamics.Activities.

      • Para obter mais informações sobre os pacotes do Uipath Studio, consulte Gerenciando pacotes no Guia do Studio.

Está feito!

Agora que você concluiu a configuração, pode começar a adicionar as atividades do Microsoft Dynamics 365 ao seu projeto.

Próximas Etapas

Para um aprendizado prático e para começar a usar as atividades rapidamente, consulte o Guia de início rápido. Este guia fornece instruções passo a passo para ajudar você a criar uma amostra de trabalho das diferentes atividades para que você possa verificar a conexão com sua instância do Microsoft Dynamics 365 e se familiarizar com as propriedades de entrada/saída.

Para saber mais sobre as atividades do Microsoft Dynamics 365 (incluindo exemplo de entradas/saídas de propriedades), consulte a página Atividades para uma lista completa de atividades e links para as páginas de detalhes das atividades.