Slack Scope

UiPath.Slack.Activities.SlackScopeActivity

Visão geral

A atividade do SlackScope segue o protocolo OAuth 2.0 para estabelecer uma conexão autenticada entre o UiPath e a API do Slack.

Antes que a atividade do Slack Scope possa estabelecer uma conexão, ela precisa de autorização para agir em seu nome e acessar seus dados permitidos. Para conceder autorização, você cria e instala um novo aplicativo Slack em seu espaço de trabalho (sem necessidade de codificação). Você não precisa distribuir este aplicativo publicamente por meio do Slack App Directory, basta instalá-lo no espaço de trabalho que deseja automatizar.

• Para obter mais informações, consulte Aplicativos de espaço de trabalho único na documentação Distribuindo aplicativos do Slack.
• Para obter instruções passo a passo sobre como criar um aplicativo, consulte Criar um aplicativo do Slack no Guia de configuração .

Ao criar o aplicativo, você atribui os escopos (ou seja, permissões) para definir os métodos de API que o aplicativo (e subsequentemente as atividades) podem chamar e as informações que podem acessar.

• Para obter instruções passo a passo sobre como adicionar escopos, consulte Adicionar permissões do aplicativo no Guia de configuração .
• Para obter uma lista completa dos escopos necessários para esse pacote de atividades, consulte Escopos a adicionar no Guia de configuração .

Depois de registrar o aplicativo, o Slack atribui um ID de cliente exclusivo (ClientID), Segredo do cliente (ClientSecret) e Token de acesso OAuth (Token) que você insere na atividade Slack Scope para iniciar uma conexão.

Como funciona

As etapas a seguir e o diagrama de sequência de mensagens são um exemplo de como a atividade funciona desde o tempo de design (ou seja, as dependências da atividade e as propriedades de entrada/saída) até o tempo de execução.

1. Conclua as etapas de Configuração .
2. Adicione a atividade Slack Scope ao seu projeto.

3. Insira valores para as propriedades Autenticação (Attended), Autenticação (Unattended) .

   
   

   

   
   

No corpo da atividade

A atividade Slack Scope possui dois modelos de autenticação diferentes, dependendo do modo de automação (autônomo ou assistido).

Há duas diferenças entre automação autônoma e assistida no que se refere à atividade do Slack Scope : requisitos de definição de escopo e permissão de acesso.

Requisitos de definição de escopo

Conforme observado na seção Adicionar permissões do aplicativo do Guia de configuração , se você planeja executar a automação não Unattended , deve definir os escopos usando as configurações dos recursos OAuth e Permissões do aplicativo.

Se você quiser executar a automação assistida, você não precisa definir os escopos usando as configurações dos recursos OAuth e Permissões do aplicativo (você pode); em vez disso, você define os escopos usando a propriedade Escopos (descrito abaixo).

Para permitir a melhor experiência do usuário ao usar as atividades, é recomendável definir as configurações do recurso OAuth e permissões do aplicativo (conforme descrito no guia de configuração ). Definindo os escopos com antecedência, você pode alternar livremente entre automação autônoma e assistida ao criar e executar seu projeto.

Permitindo o acesso

Quando a atividade Slack Scope é executada durante a automação assistida, uma página da Web é aberta solicitando que você conceda ao aplicativo acesso aos escopos selecionados clicando em um botão Permitir .

Durante a automação autônoma, o acesso é concedido silenciosamente ao seu aplicativo em segundo plano (nenhuma ação do usuário é necessária).

• ClientID - o ID exclusivo atribuído ao seu aplicativo pelo Slack. Insira um valor String .
  • Esta propriedade aceita apenas o valor String do seu ID de cliente. Não suporta variáveis String .
  • Para encontrar seu ID de cliente, acesse a página de informações básicas do aplicativo criado. Em Credenciais do aplicativo, você verá o ID do cliente e o Segredo do cliente.
• ClientSecret - O ID exclusivo associado ao seu ClientID. Insira um valor String .
  • Esta propriedade aceita apenas o valor String do seu segredo do cliente. Não suporta variáveis String .
  • Para encontrar o segredo do cliente, acesse a página Informações básicas do aplicativo. Em Credenciais do aplicativo, você verá o ID do cliente e o Segredo do cliente.
• Token - O token de acesso OAuth do aplicativo a ser usado apenas para automação autônoma. O Slack gera esse token automaticamente quando você instala o aplicativo em seu workspace. Insira um valor String . Esta propriedade aceita apenas o valor String do seu token de acesso OAuth. Ele não suporta String variáveis.
  • Para obter seu token de acesso OAuth, você deve primeiro instalar o aplicativo em seu espaço de trabalho. Depois de instalar seu aplicativo, vá para a página de configurações do aplicativo instalado (imagem mostrada acima).
  • Para obter mais informações, consulte Instale seu aplicativo em seu WorkSpace no guia de configuração.

Propriedades

Autenticação

• Escopos - Uma lista categorizada dos escopos a serem concedidos (ou concedidos anteriormente ao seguir o guia de configuração ) para o aplicativo. Selecione todos os escopos aplicáveis. Existem 7 escopos: PublicChannels, PrivateChannels, DirectMessages, GroupMessages, Users, Chat, Files.

  • Para obter uma lista completa de escopos e seu mapeamento para as atividades e os valores permitidos acima, consulte Escopos para adicionar no Guia de configuração .

Comum

• NomeDeExibição — o nome de exibição da atividade. Este campo é compatível apenas com variáveis Strings ou String.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.
• ReportApiErrorAsException - Quando selecionado, as respostas de erro da API são relatadas em BusinessActivityExecutionException por todas as atividades filhas que usam esse escopo de aplicativo. Quando desmarcada, a atividade filho preenche a mensagem de erro da API na propriedade de saída ResponseStatus e a execução do fluxo de trabalho continua. Verifique a propriedade ResponseStatus para confirmar a execução bem-sucedida.

Saída

• Conexão - A conexão que pode ser passada para um escopo de aplicativo filho. Este campo suporta apenas Connection variáveis.

Exemplo

A imagem a seguir mostra um exemplo do relacionamento de dependência de atividade e valores de propriedade de entrada/saída.

Para obter instruções passo a passo e exemplos, consulte os guias de início rápido .