Slack Scope

UiPath.Slack.Activities.SlackScopeActivity

Visão geral

A atividade 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 Slack Scope possa estabelecer uma conexão, ela precisa de autorização para realizar ações em seu nome e acessar seus dados permitidos. Para conceder autorização, você cria e instala um novo aplicativo Slack no seu espaço de trabalho (sem necessidade de codificação). Você não precisa distribuir publicamente esse aplicativo pelo Diretório de Aplicativos do Slack, você só precisa instalá-lo no espaço de trabalho que você deseja automatizar.

• Para obter mais informações, consulte Aplicativos de espaço de trabalho único na documentação de Distribuição de aplicativos Slack.
• Para obter instruções passo a passo sobre como criar um aplicativo, consulte Criar um aplicativo 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, posteriormente, as atividades) podem chamar e as informações que ele pode acessar.

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

After registering the app, Slack assigns a unique Client ID (ClientID), Client Secret (ClientSecret), and OAuth Access Token (Token) that you enter in the Slack Scope activity to initiate a connection.

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 (assistida) e Autenticação (não assistida) .

   

No corpo da atividade

The Slack Scope activity has two different authentication models depending on the automation mode (unattended or attended).

There are two differences between unattended and attended automation as it pertains to Slack Scope activity: scope setting requirements and allowing access.

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 unattended, você deve definir os escopos usando as configurações da funcionalidade OAuth e Permissões do aplicativo.

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

To enable the best user experience when using the activities, it's recommended that you set the using the app's OAuth & Permissions feature settings (as described in the Setup guide). By setting the scopes ahead a time, you can freely switch between unattended and attended automation when you're building and running your project.

Permitindo o acesso

When the Slack Scope activity runs during attended automation, a web page opens that prompts you to grant your app access to your selected scopes by clicking an Allow button.

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 - The unique ID assigned to your app by Slack. Enter a String value.
  • Esta propriedade aceita apenas o valor String do seu ID de cliente. Não suporta variáveis String .
  • To find your Client ID, go to your created app's Basic Information page. Under App Credentials you'll see both your Client ID and Client Secret.
• ClientSecret - The unique ID associated with your ClientID. Enter a String value.
  • Esta propriedade aceita apenas o valor String do seu segredo do cliente. Não suporta variáveis String .
  • To find your Client Secret, go to your app's Basic Information page. Under App Credentials you'll see both your Client ID and Client Secret.
• Token - The app's OAuth Access Token to use for unattended automation only. Slack automatically generates this token when you install the app to your workspace. Enter a String value. This property only accepts the String value of your OAuth Access Token. It does not support String variables.
  • To get your OAuth Access Token, you must first install the app to your workspace. After installing your app, go to your app's Installed App Settings page (image shown above).
  • Para obter mais informações, consulte Instale seu aplicativo no seu espaço de trabalho no guia de configuração.

Propriedades

Autenticação

• Scopes - A categorized list of the scopes to grant (or previously granted when following the Setup guide) to the app. Select all the applicable scopes. There are 7 scopes: 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 a adicionar no guia de Configuração .

Comum

• DisplayName - The display name of the activity. This field supports only Strings or String variables.

Diversos

• Privado - Se selecionado, os valores de variáveis e argumentos não são mais registrados no nível Verbose.
• ReportApiErrorAsException - When selected, API error responses are reported in BusinessActivityExecutionException by all child activities that use this application scope. When cleared, the child activity populates the API error message in the ResponseStatus output property and workflow execution continues. Check the ResponseStatus property to confirm successful execution.

Saída

• Connection - The connection which can be passed to a child application scope. This field supports only Connection variables.

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 .