Slack Scope

UiPath.Slack.Activities.SlackScopeActivity

Vue d'ensemble (Overview)

L'activité SlackScope suit le protocole OAuth 2.0 pour établir une connexion authentifiée entre UiPath et l'API Slack.

Avant que l'activité Slack Scope puisse établir une connexion, elle a besoin d'une autorisation pour agir en votre nom et accéder à vos données autorisées. Pour accorder une autorisation, vous créez et installez une nouvelle application Slack dans votre espace de travail (aucun codage requis). Vous n'avez pas besoin de distribuer publiquement cette application via le répertoire d'applications Slack, il vous suffit de l'installer dans l'espace de travail que vous souhaitez automatiser.

• Pour plus d'informations, consultez Applications à espace de travail unique dans la documentation sur la distribution des applications Slack.
• Pour obtenir des instructions détaillées sur la création d'une application, consultez Créer une application Slack dans le Guide de configuration .

Lors de la création de l'application, vous attribuez les étendues (c'est-à-dire les autorisations) pour définir les méthodes API que l'application (et par la suite les activités) peut appeler et les informations auxquelles elle peut accéder.

• Pour obtenir des instructions détaillées sur la façon d'ajouter des étendues, consultez Ajouter des autorisations d'application dans le Guide de configuration .
• Pour obtenir la liste complète des étendues requises pour ce package d'activités, consultez Étendues à ajouter ( Scopes to add ) dans le guide de configuration .

Après avoir enregistré l'application, Slack attribue un ID de client (ClientID), une clé secrète (ClientSecret) et un jeton d'accès OAuth (Token) uniques que vous saisissez dans l'activité Slack Scope pour établir une connexion.

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Terminez les étapes de configuration .
2. Ajoutez l'activité Slack Scope à votre projet.

3. Entrez des valeurs pour les propriétés Authentification (Attended), Authentification (Unattended) .

   
   

   

   
   

Dans le corps de l’activité

L'activité Slack Scope a deux modèles d'authentification différents selon le mode d'automatisation (Unattended ou Attended).

Il existe deux différences entre l’automatisation Unattended et l’automatisation Attended en ce qui concerne l’activité Étendue Slack : les exigences de définition de l’étendue et l’autorisation d’accès.

Exigences de définition de l'étendue

Comme indiqué dans la section Ajouter des autorisations d'application ( Add app permissions ) du Guide de configuration , si vous prévoyez d'exécuter une automatisation non assistée ( Unattended ), vous devez définir les étendues à l'aide des paramètres de fonctionnalité OAuth et Autorisations de l'application.

Si vous souhaitez exécuter une automatisation Attended , vous n'avez pas besoin de définir les étendues à l'aide des paramètres de fonctionnalité OAuth et autorisations de l'application (vous le pouvez). Vous pouvez plutôt définir les étendues à l'aide de la propriété Étendues (décrite ci- dessous).

Pour offrir la meilleure expérience utilisateur lors de l'utilisation des activités, il est recommandé de définir l'utilisation des paramètres de la fonctionnalité OAuth et autorisations de l'application (comme décrit dans le guide de configuration ). En définissant les étendues à l'avance, vous pouvez basculer librement entre l'automatisation Unattended et Attended lors de la création et de l'exécution de votre projet.

Autoriser l'accès

Lorsque l'activité Étendue Slack s'exécute pendant l'automatisation Attended, une page Web s'ouvre et vous invite à accorder à votre application l'accès aux étendues sélectionnées en cliquant sur un bouton Autoriser .

Lors de l'automatisation Unattended, l'accès est accordé silencieusement à votre application en arrière-plan (aucune action de l'utilisateur requise).

• IDClient : l'ID unique attribué à votre application par Slack. Entrez une valeur String .
  • Cette propriété accepte uniquement la valeur String de votre ID de client. Il ne prend pas en charge les variables String .
  • Pour trouver votre ID de client, accédez à la page Informations de base ( Basic Information ) de votre application créée. Sous Informations d'identification de l'application ( App Credentials ), vous verrez à la fois votre ID client et votre clé secrète client.
• ClientSecret : l'ID unique associé à votre IDClient. Entrez une valeur String .
  • Cette propriété accepte uniquement la valeur String de votre clé secrète client. Il ne prend pas en charge les variables String .
  • Pour trouver votre clé secrète client, accédez à la page Informations de base ( Basic Information ) de votre application. Sous Informations d'identification de l'application ( App Credentials ), vous verrez à la fois votre ID client et votre clé secrète client.
• Jeton : le jeton d'accès OAuth de l'application à utiliser uniquement pour l'automatisation Unattended. Slack génère automatiquement ce jeton lorsque vous installez l'application sur votre espace de travail. Entrez une valeur String . Cette propriété accepte uniquement la valeur String de votre jeton d'accès OAuth. Il ne prend pas en charge les variables String .
  • Pour obtenir votre jeton d'accès OAuth, vous devez d'abord installer l'application sur votre espace de travail. Après avoir installé votre application, accédez à la page Paramètres de l'application installée ( Installed App Settings ) de votre application (image ci-dessus).
  • Pour plus d'informations, consultez Installer votre application sur votre WorkSpace ( Install your app to your WorkSpace dans le guide de configuration.

Propriétés

Authentification

• Étendues (Scopes ) - Une liste classée des étendues à accorder (ou précédemment accordées en suivant le guide de configuration ) à l'application. Sélectionnez toutes les étendues applicables. Il existe 7 étendues : PublicChannels, PrivateChannels, DirectMessages, GroupMessages, Utilisateurs, Chat, Fichiers.

  • Pour obtenir la liste complète des étendues et leur mappage aux activités ainsi qu'aux valeurs autorisées ci-dessus, consultez Étendues à ajouter dans le guide de configuration .

Commun

• NomAffichage (DisplayName) : nom affiché de l'activité. Ce champ prend uniquement en charge les variables Strings et String.

Divers

• Privé (Private) - Si cette option est sélectionnée, les valeurs des variables et des arguments ne sont plus enregistrées au niveau Détaillé (Verbose).
• ReportApiErrorAsException : lorsque cette option est sélectionnée, les réponses d'erreur d'API sont signalées dans BusinessActivityExecutionException par toutes les activités enfants qui utilisent cette étendue d'application. Lorsqu'elle est décochée, l'activité enfant renseigne le message d'erreur d'API dans la propriété de sortie ResponseStatus et l'exécution du workflow se poursuit. Vérifiez la propriété ResponseStatus pour confirmer la réussite de l'exécution.

Sortie

• Connexion - La connexion qui peut être transmise à une étendue d'application enfant. Ce champ ne prend en charge que Connection variables.

Exemple

L'image suivante montre un exemple de la relation de dépendance d'activité et des valeurs de propriété d'entrée/sortie.

Pour obtenir des instructions étape par étape et des exemples, consultez les guides de démarrage rapide .