Slack Scope

UiPath.Slack.Activities.SlackScopeActivity

Überblick

Die SlackScope- Aktivität folgt dem OAuth 2.0- Protokoll, um eine authentifizierte Verbindung zwischen UiPath und der Slack-API herzustellen.

Bevor die Slack Scope- Aktivität eine Verbindung herstellen kann, benötigt sie eine Autorisierung, um in Ihrem Namen aktiv zu werden und auf Ihre zulässigen Daten zuzugreifen. Um die Autorisierung zu erteilen, erstellen und installieren Sie eine neue Slack-App in Ihrem Arbeitsbereich (keine Programmierung erforderlich). Sie müssen diese App nicht öffentlich über das Slack App-Verzeichnis verteilen, sondern sie nur in dem Arbeitsbereich installieren, den Sie automatisieren möchten.

• Weitere Informationen finden Sie unter Apps mit einem Arbeitsbereich in der Dokumentation zur Verteilung von Slack-Apps.
• Eine Schritt-für-Schritt-Anleitung zum Erstellen einer App finden Sie unter Erstellen einer Slack-App in der Setup -Anleitung.

Beim Erstellen der App weisen Sie die Scopes (d. h. Berechtigungen) zu, um die API-Methoden zu definieren, die die App (und anschließend die Aktivitäten) aufrufen kann, und die Informationen, auf die sie zugreifen kann.

• Eine Schritt-für-Schritt-Anleitung zum Hinzufügen von Scopes finden Sie unter Hinzufügen von App-Berechtigungen in der Setup- Anleitung.
• Eine vollständige Liste der für dieses Aktivitätspaket erforderlichen Scopes finden Sie unter Hinzufügende Scopes im Setup- Handbuch.

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.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.

2. Fügen Sie Ihrem Projekt die Aktivität Slack Scope hinzu.

3. Geben Sie Werte für die Eigenschaften Authentifizierung (Attended) und Authentifizierung (Unattended) ein.

   

Im Textkörper der Aktivität

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.

Anforderungen an Scope-Einstellungen

Wie im Abschnitt App-Berechtigungen hinzufügen der Setup- Anleitung angegeben, müssen Sie die Scopes mithilfe der Funktionseinstellungen für OAuth und Berechtigungen der App festlegen, wenn Sie eine unbeaufsichtigte Automatisierung ausführen möchten.

Wenn Sie eine Attended-Automatisierung ausführen möchten, müssen Sie die Scopes nicht mithilfe der Funktionseinstellungen für OAuth und Berechtigungen der App festlegen (Sie können dies tun), sondern Sie legen die Scopes mit der Eigenschaft Scopes fest ( unten beschrieben).

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.

Zugriff zulassen

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.

Während der Unattended-Automatisierung wird Ihrer App im Hintergrund der Zugriff gewährt (keine Benutzeraktion erforderlich).

• ClientID - The unique ID assigned to your app by Slack. Enter a String value.
  • Diese Eigenschaft akzeptiert nur den Wert String Ihrer Client-ID. Es unterstützt keine String -Variablen.
  • 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.
  • Diese Eigenschaft akzeptiert nur den Wert String Ihres geheimen Clientschlüssels. Es unterstützt keine String -Variablen.
  • 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).
  • Weitere Informationen finden Sie unter Installieren Ihrer App in Ihrem Arbeitsbereich in der Einrichtungsanleitung.

Eigenschaften

Authentication

• 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.
  • Eine vollständige Liste der Scopes und deren Zuordnung zu den oben genannten Aktivitäten und zulässigen Werten finden Sie unter Hinzufügende Scopes im Setup- Handbuch.

Allgemein

• AnzeigeName (DisplayName) - Der Anzeigename der Aktivität. Dieses Feld unterstützt nur Strings oder String-Variablen.

Sonstiges

• Privat (Private) - Bei Auswahl werden die Werte von Variablen und Argumenten nicht mehr auf der Stufe Verbose protokolliert.
• 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.

Ausgabe

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

Beispiel

Die folgende Abbildung zeigt ein Beispiel für die Aktivitätsabhängigkeitsbeziehung und Eingabe-/Ausgabe-Eigenschaftswerte.

Eine Schritt-für-Schritt-Anleitung und Beispiele finden Sie in den Schnellstartanleitungen .