Slack Scope

UiPath.Slack.Activities.SlackScopeActivity

Überblick

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

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

• Weitere Informationen finden Sie unter Apps für einen einzelnen Arbeitsbereich in der Dokumentation Verteilen von Slack- Apps.
• Eine Schritt-für-Schritt-Anleitung zum Erstellen einer App finden Sie unter Erstellen einer Slack-App in der Einrichtungsanleitung .

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 Einrichtungsanleitung .
• Eine vollständige Liste der für dieses Aktivitätspaket erforderlichen Scopes finden Sie unter Hinzuzufügende Scopes im Setup -Handbuch.

Nach der Registrierung der App weist Slack eine eindeutige Client-ID (ClientID), ein geheimes Clientgeheimnis (ClientSecret) und ein OAuth-Zugriffstoken (Token) zu, die Sie in die Slack Scope- Aktivität eingeben, um eine Verbindung zu initiieren.

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 die Aktivität Slack Scope zu Ihrem Projekt hinzu.

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

   
   

   

   
   

Im Textkörper der Aktivität

Die Slack Scope -Aktivität verfügt je nach Automatisierungsmodus (Unattended oder Attended) über zwei verschiedene Authentifizierungsmodelle.

Es gibt zwei Unterschiede zwischen der Unattended- und der Attended-Automatisierung, was die Slack Scope -Aktivität betrifft: Anforderungen an die Scope-Einstellung und das Zulassen des Zugriffs.

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 die Unattended-Automatisierung ausführen möchten.

Wenn Sie eine Attended -Automatisierung ausführen möchten, müssen Sie die Scopes nicht mit den Funktionseinstellungen für OAuth und Berechtigungen der App festlegen (das ist möglich). Stattdessen legen Sie die Scopes mithilfe der Eigenschaft Scopes fest ( weiter untenbeschrieben).

Um die beste Benutzererfahrung bei der Verwendung der Aktivitäten zu ermöglichen, wird empfohlen, dass Sie die Einstellungen für die Funktion „ OAuth und Berechtigungen “ der App festlegen (wie im Einrichtungsleitfaden beschrieben). Indem Sie die Scopes im Voraus festlegen, können Sie beim Erstellen und Ausführen Ihres Projekts frei zwischen der Unattended- und der Attended-Automatisierung wechseln.

Zugriff zulassen

Wenn die Slack Scope -Aktivität während der Attended-Automatisierung ausgeführt wird, wird eine Webseite geöffnet, auf der Sie aufgefordert werden, Ihrer App Zugriff auf Ihre ausgewählten Scopes zu gewähren, indem Sie auf eine Schaltfläche Zulassen klicken.

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

• ClientID – Die eindeutige ID, die Ihrer App von Slack zugewiesen wurde. Geben Sie einen String -Wert ein.
  • Diese Eigenschaft akzeptiert nur den Wert String Ihrer Client-ID. Es unterstützt keine String -Variablen.
  • Um Ihre Client-ID zu finden, wechseln Sie zur Seite Allgemeine Informationen Ihrer erstellten App. Unter App-Anmeldeinformationen sehen Sie sowohl Ihre Client-ID als auch den geheimen Clientschlüssel.
• ClientSecret – Die eindeutige ID, die Ihrer ClientID zugeordnet ist. Geben Sie einen String -Wert ein.
  • Diese Eigenschaft akzeptiert nur den Wert String Ihres geheimen Clientschlüssels. Es unterstützt keine String -Variablen.
  • Um Ihren geheimen Clientschlüssel zu finden, wechseln Sie zur Seite Basisinformationen Ihrer App. Unter App-Anmeldeinformationen sehen Sie sowohl Ihre Client-ID als auch den geheimen Clientschlüssel.
• Token – Das OAuth-Zugriffstoken der App, das nur für die Unattended-Automatisierung verwendet werden soll. Slack generiert dieses Token automatisch, wenn Sie die App in Ihrem Workspace installieren. Geben Sie einen String -Wert ein. Diese Eigenschaft akzeptiert nur den String -Wert Ihres OAuth-Zugriffstokens. Es unterstützt keine String -Variablen.
  • Um Ihr OAuth-Zugriffstoken zu erhalten, müssen Sie zuerst die App in Ihrem Arbeitsbereich installieren. Rufen Sie nach der Installation Ihrer App die Seite Installierte App-Einstellungen Ihrer App auf (Abbildung oben).
  • Weitere Informationen finden Sie unter Installieren Ihrer App in Ihrem WorkSpace im Setup-Handbuch.

Eigenschaften

Authentication

• Scopes (Scopes) – Eine kategorisierte Liste der Scopes, die der App gewährt werden sollen (oder zuvor gewährt wurden, wenn Sie dem Einrichtungsleitfaden folgen). Wählen Sie alle anwendbaren Scopes aus. Es gibt 7 Bereiche: PublicChannels, PrivateChannels, DirectMessages, GroupMessages, Benutzer, Chat, Dateien.

  • Eine vollständige Liste der Scopes und deren Zuordnung zu den oben genannten Aktivitäten und den zulässigen Werten finden Sie unter Hinzuzufü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 – Wenn diese Option ausgewählt ist, werden API-Fehlerantworten in BusinessActivityExecutionException von allen untergeordneten Aktivitäten gemeldet, die diesen Anwendungsbereich verwenden. Wenn diese Option deaktiviert ist, füllt die untergeordnete Aktivität die API-Fehlermeldung in der Ausgabeeigenschaft ResponseStatus aus und die Workflowausführung wird fortgesetzt. Überprüfen Sie die Eigenschaft ResponseStatus, um die erfolgreiche Ausführung zu bestätigen.

Ausgabe

• Verbindung – Die Verbindung, die an einen untergeordneten Anwendungsbereich übergeben werden kann. Dieses Feld unterstützt nur Connection Variablen.

Beispiel

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

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