Configuração

This setup is required when using the classic Microsoft 365 activities. If you are using the newer Microsoft 365 activities with Integration Service connections, see.…

Introdução

Para habilitar as atividades do Microsoft Office 365, seu aplicativo deve estar integrado à plataforma de identidade da Microsoft e ter as permissões corretas da API do Microsoft Graph atribuídas a ele.

Para integrar seu aplicativo, atribuir permissões e começar a criar seu projeto de automação, conclua as seguintes etapas:

1. Registre seu aplicativo.
2. Adicione permissões de API.
3. Construa seu projeto.

Depois de registrar seu aplicativo do Microsoft Office 365, o Azure Active Directory atribui uma ID de aplicativo (cliente) exclusiva que você insere na atividade do escopo do Microsoft Office 365 junto com os serviços aos quais você atribuiu permissões (por exemplo, arquivos, correio, calendário).

Etapas

Registre seu aplicativo

1. Entre no portal do Azure usando sua conta pessoal, profissional ou escolar do Microsoft Office 365.
2. No painel de navegação à esquerda, clique em Azure Active Directory.
3. Depois que a página do Azure Active Directory for aberta, clique em Registros de aplicativos.

4. Clique em + Novo registro na barra de navegação superior.

   
   

   

   
   
5. Insira um Nome para seu aplicativo (por exemplo, "Office365App").

6. Em Tipos de conta com suporte, selecione a opção que se aplica a você. Para obter mais informações sobre qual opção selecionar, abaixo estão as recomendações da Microsoft:

   • Contas apenas neste diretório organizacional - Use esta opção se seu público-alvo for interno à sua organização.
   • Contas em qualquer diretório organizacional (qualquer diretório do Azure AD - multilocatário) - use esta opção se seu público-alvo for clientes corporativos ou educacionais e para habilitar a multilocação.
   • Contas em qualquer diretório organizacional (qualquer diretório do Azure AD - multilocatário) e contas pessoais da Microsoft (por exemplo, Skype, Xbox) - Use esta opção para direcionar o conjunto mais amplo de identidades da Microsoft e habilitar a multilocação.

7. Em URI de redirecionamento (opcional), insira um endereço de URI (se aplicável).

   • Sua seleção depende do tipo de autenticação. Para obter mais informações sobre este tópico, consulte a seção Automação não assistida e assistida na página de detalhes da atividade Microsoft 365 Scope ).
   • Em nosso exemplo, a organização oferece suporte à autenticação multilocatário e só pode usar o tipo de autenticação de token interativo, que requer um URI de redirecionamento.
   • Se o seu tipo de autenticação for Autenticação Integrada do Windows ou Nome de Usuário e Senha, você não precisará registrar um URI de redirecionamento para seu aplicativo. Esses fluxos fazem uma viagem de ida e volta para o ponto de extremidade v2.0 da plataforma de identidade da Microsoft e seu aplicativo não será chamado de volta em nenhum URI específico.
   • Ao trabalhar com o Office 365 em um projeto UiPath Studio voltado para .NET 5.0, os clientes devem adicionar http://localhost ao URI de redirecionamento de seus aplicativos personalizados.

     Para obter mais informações, consulte Registro de aplicativo de área de trabalho na documentação da plataforma de identidade da Microsoft.

8. Clique em Registrar. Um exemplo de configuração está disponível na captura de tela abaixo.

   Nota: Esta configuração é apenas um exemplo. Siga as etapas descritas na documentação e faça seleções com base nas políticas de sua organização.
   
   

   

   
   
   Observação:

   Hoje, a Microsoft Authentication Library (MSAL.NET) usa urn:ietf:wg:oauth:2.0:oob como o URI de redirecionamento padrão e esse valor provavelmente funcionará para você ao usar o tipo de autenticação InteractiveToken (usamos isso em todos os nossos exemplos e guias de início rápido).

   No futuro, a Microsoft planeja alterar o URI de redirecionamento padrão para https://login.microsoftonline.com/common/oauth2/nativeclient, portanto, considere usá-lo.

Você Terminou! Agora, vamos adicionar permissões de API ao seu aplicativo registrado.

Adicionar permissões de API

1. Na página do aplicativo registrado (portal do Azure > Azure Active Directory > registros de aplicativo > Office365App), clique em permissões de API no painel de navegação à esquerda.
2. Depois que a página de permissão da API for aberta, clique em + Adicionar uma permissão (isso abre a janela Solicitar permissões da API ).
3. Em Selecione uma API, clique em APIs da Microsoft (podem ser abertas por padrão).

4. Em APIs da Microsoft comumente usadas, clique em Microsoft Graph.

   
   

   

   
   

5. Em Que tipo de permissões seu aplicativo requer?, clique em Permissões delegadas ou Permissões do aplicativo para mostrar a lista de permissões. As permissões do aplicativo devem ser definidas quando o valor de AuthenticationType na atividade do escopo do Microsoft Office 365 é definido como ApplicationIdAndSecret ou ApplicationIdAndCertificate. Os outros tipos de autenticação disponíveis na atividade do escopo do Microsoft Office 365 exigem permissões delegadas.

   Para obter mais informações sobre tipos de permissão, consulte Configure a client application to access web APIs na documentação do Microsoft Azure.

   Importante:

   Algumas atividades não oferecem suporte ao tipo de autenticação ApplicationIdAndSecret ou ApplicationIdAndCertificate (por exemplo, Find Meeting Times).

   Para atividades de e-mail, é obrigatório especificar um valor para o parâmetro Account (ou seja, qual caixa de correio de todas as caixas de correio do inquilino você deseja usar).

   Ao usar esse tipo de autenticação, o aplicativo tem acesso a todas as caixas de correio de seu locatário, o motivo é que a permissão de API do aplicativo Mail.Read significa Ler e-mail em todas as caixas de correio e Mail.ReadWrite significa Ler e escrever e-mail em todas as caixas de correio.

   Uma solução é restringir as permissões do aplicativo a caixas de correio específicas, para que o aplicativo tenha acesso apenas às caixas de correio especificadas.

   Para obter mais informações, consulte permissões de aplicativo de escopo para caixas de correio específicas do Exchange Online.

   Use a permissão de aplicativo Sites.Selected para permitir que o aplicativo acesse apenas os conjuntos de sites específicos do SharePoint em vez de todos.

6. Use a barra de pesquisa ou role para baixo na lista alfabética e selecione as seguintes permissões:

   • Calendário

     • Calendários.Leia
     • Calendários.ReadWrite

   • Arquivos

     • Arquivos.Read
     • Arquivos.Ler.Todos
     • Arquivos.ReadWrite
     • Arquivos.ReadWrite.All

   • Sites

     • Sites.Read.All
     • Sites.ReadWrite.All

   • Email

     • Mail.Read
     • Mail.ReadWrite
     • E-mail.Enviar

   • Compartilhado\*

     • Mail.Read.Shared
     • Mail.ReadWrite.Shared
     • Mail.Enviar.Compartilhado
     • Calendars.Read.Shared

     • Calendars.ReadWrite.Shared

       \* Escopos necessários para acessar recursos compartilhados com o usuário, mas que não pertencem a ele.

   • Clique em Adicionar permissões (retornando à sua lista de permissões de API)

     
     

     

     
     

7. Verifique se suas permissões de API incluem as permissões de calendários, arquivose e -mail adicionados.

   
   

   

   
   

Crie seu projeto

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

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

   • Clique em Criar.

     
     

     

     
     

2. Instale o pacote UiPath.MicrosoftOffice365.Activities .

   • Na faixa de opções Design , clique em Gerenciar pacotes (isso abre a janela Gerenciar pacotes ).
   • Em Todos os pacotes, clique em Ir!
   • Na barra de pesquisa , digite Office365.

   • Clique, instale e aceite a licença do UiPath.MicrosoftOffice365.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 Office 365 ao seu projeto.

Próximas Etapas

Para um aprendizado prático e para começar a usar as atividades rapidamente, consulte os Guias de início rápido . Esses guias fornecem instruções passo a passo para ajudar você a criar amostras de trabalho das diferentes atividades para que você possa verificar a conexão com seu aplicativo registrado e se familiarizar com as propriedades de entrada/saída.

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