Como usar atividades Microsoft 365 sem conexões do Integration Service

Sobre

Agora você pode usar as atividades mais recentes Microsoft 365 mesmo se não tiver o Integration Service, por meio do Microsoft 365 Scope.

As atividades Microsoft 365 projetadas especificamente para o Integration Service apresentam um campo Conexão, que permite que você escolha uma conexão criada por meio de um conector do Integration Service. Quando usadas dentro do Microsoft 365 Scope, as atividades simplesmente herdam as informações de conexão do Scope.

Matriz de tipos de projetos e autenticação

Microsoft 365
	Cloud		No local
	Escopo do aplicativo Microsoft Office 365	Integration Service	Escopo do aplicativo Microsoft Office 365	Integration Service
Multiplataforma
ID do Aplicativo e Certificado
ID do Aplicativo e Segredo
OAuth — BYOA
OAuth — aplicativo UiPath
Nome de Usuário e Senha
Autenticação do Windows Integrada
Windows
ID do Aplicativo e Certificado
ID do Aplicativo e Segredo
OAuth — BYOA
OAuth — aplicativo UiPath
Nome de Usuário e Senha
Autenticação do Windows Integrada

Métodos de conexão

Há duas maneiras de configurar uma conexão na atividade Microsoft 365 Scope .

Método de conexão		Description	Benefícios	Desvantagens
Ativo Observação: Recomendado.		Usa um Ativo do Orchestrator para armazenar a conexão com a configuração do Escopo. O ativo está no formato JSON. Sempre que é usada, a atividade recupera a configuração do ativo. Com base na configuração do ativo, o Scope se comporta de maneira diferente; ele identifica o tipo de autenticação e oculta campos desnecessários. Se o JSON do ativo não estiver definido corretamente, ele receberá um erro de validação.	As atividades se beneficiam das pesquisas de tempo de design e podem descobrir arquivos, pastas, listas, intervalos, entre outros. A conexão é facilmente transferível, pois as credenciais não são passadas de um usuário para outro em texto simples. Pode ser configurado por um Admin. É mais seguro, porque as credenciais não chegam no fluxo de trabalho do Studio.	Requer um usuário avançado para configurar o Ativo. Não é fácil configurá-lo para um Desenvolvedor Não Técnico.
Painel de Propriedades		Use o painel de propriedades existente para configurar as credenciais da conexão. A configuração pode ser adicionada em texto simples ou por meio de variáveis.	Mais fácil de usar. Mantém a compatibilidade com versões anteriores.
	Configuração por meio de texto simples Observação: Não é recomendado.	Configure o painel Propriedades com valores de texto simples.	As atividades se beneficiam das pesquisas de tempo de design e podem descobrir arquivos, pastas, listas, intervalos, entre outros.	Menos seguro, porque as credenciais precisam ser passadas entre usuários em texto simples.
	Configuração por meio de variáveis	Configure o painel de propriedades com variáveis.	Mais seguro, porque as credenciais não chegam ao fluxo de trabalho do Studio.	As atividades não podem descobrir quaisquer recursos no momento do design.

Formato de ativo do Microsoft 365 Scope

Formato padrão do ativo

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default" | "Global" | "China" | "Germany" | "USGovernment" | "USGovernmentDOD",
    "Mode": "interactive" | "integrated" | "uap" | "appidsecret" | "appidcertificate",
    "OAuth2AppData": {
        "ApplicationId": "",
        "TenantId": ""
    }
}

Configuração de ativo de aplicativo da UiPath

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive" | "integrated" | "uap" | "appidsecret" | "appidcertificate",
    "OAuth2AppData": {
        "ApplicationId": "f2f43f65-16a6-4319-91b6-d2a342a88744",
        "TenantId": ""
    }
}

Configuração de ativo do aplicativo personalizado

Observação: esse é apenas um exemplo. Configure seu próprio aplicativo e recupere os OAuth2AppData necessários.

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive" | "integrated" | "uap" | "appidsecret" | "appidcertificate",
    "OAuth2AppData": {
        "ApplicationId": "d47f7253-65ae-58n5-ag04-26109734e6de",
        "TenantId": "3ce4ef03-chb1-871f-94b0-345136965f10"
    }
}

Limitações

Os seguintes recursos não estão disponíveis ao usar atividades dentro do Microsoft 365 Scope: gatilhos, associações e experiência de substituição.

Atualização do token

Não há nenhum serviço disponível para atualizar seus tokens de conexão, como o que está disponível no Integration Service.

Se o token de autorização não for atualizado por um certo número de dias, ele expirará, e você deve autenticar novamente. Para evitar a expiração de tokens de autorização, execute um UiPath Robot com essa conexão específica. A execução de uma automação com a atividade Scope atualiza o token de autorização.

Recursos adicionais do OAuth 2.0:

• Com o fluxo de aprovação do administrador: fluxo de credenciais do cliente OAuth 2.0 na plataforma de identidade da Microsoft
• Sem fluxo de aprovação do administrador: plataforma de identidade da Microsoft e fluxo de código de autorização do OAuth 2.0 - plataforma de identidade da Microsoft