Einrichten

Einleitung

Um die Slack-Aktivitäten zu aktivieren, müssen Sie Authentifizierungsdetails in der Aktivität Slack Scope eingeben. Diese Authentifizierungsdetails geben einem Roboter die Möglichkeit, Actions in Ihrem Namen auszuführen und auf Ihre zulässigen Daten zuzugreifen.

Führen Sie die folgenden Schritte aus, um die Authentifizierungsdetails zu generieren und zu gewähren und mit der Erstellung Ihres Automatisierungsprojekts zu beginnen:

Erstellen einer neuen Slack-App (keine Programmierung erforderlich)
App-Berechtigungen hinzufügen
Installieren Sie Ihre App in Ihrem Workspace
Erstellen Sie Ihr Projekt

Nachdem Sie Ihre App erstellt haben, weist Slack ihr eine eindeutige Client-ID, Client Secret (d. h. App-Anmeldeinformationen) und ein OAuth-Zugriffstoken (für die Unattended-Automatisierung), das Sie in die Authentifizierungseigenschaften der Slack Scope -Aktivität eingeben.

Schritte

Bevor Sie die Slack-Aktivitäten verwenden, führen Sie die folgenden Schritte aus, um die erforderlichen Eingabedaten für die Slack Scope -Aktivität zu generieren oder zu sammeln.

1. Erstellen Sie eine Slack-App

Um die Slack -Aktivitäten zu verwenden, können Sie eine einfache App für einen einzelnen Arbeitsbereich erstellen. Bei den folgenden Schritten und Beispielen wird davon ausgegangen, dass Sie über einen vorhandenen Arbeitsbereich verfügen und Mitglied eines vorhandenen sind.

Melden Sie sich bei Ihrem Slack-Arbeitsbereich an, oder öffnen Sie die Slack-Desktopanwendung.
- Wenn Sie sich mit der obigen URL anmelden, benötigen Sie die Slack-URL Ihres Arbeitsbereichs.
Wechseln Sie zu Ihre Apps und klicken Sie auf die Schaltfläche Neue App erstellen .
Geben Sie Ihren App-Namenein, wählen Sie den Slack-Arbeitsbereich Entwicklung aus und klicken Sie auf die Schaltfläche App erstellen .

Nachdem Sie Ihre App erstellt haben, gelangen Sie zur Seite Allgemeine Informationen . Hier finden Sie die Client-ID und den geheimen Clientschlüssel , die Sie für die Attended-Automation-Authentifizierung in der Slack Scope -Aktivität benötigen.

Bevor Sie diese kopieren und in Ihre Aktivität einfügen, sollten Sie die Funktionen für OAuth und Berechtigungen konfigurieren, indem Sie die Schritte im nächsten Abschnitt ausführen.

Hinweis:

Obwohl dies technisch möglich ist, wird dies nicht empfohlen, da Sie Ihr Clientgeheimnis für sie freigeben müssten.

Wenn Sie Ihre App für Teammitglieder freigeben möchten, können Sie den Unattended-Automatisierungsmodus verwenden, da dieser auf einem teilbaren OAuth-Zugriffstoken basiert.

2. App-Berechtigungen hinzufügen

Das Hinzufügen von Berechtigungen zu Ihrer App erfolgt mithilfe von Scopes. Scopes definieren die API-Methoden, die diese App aufrufen kann, und die Informationen, auf die sie im Arbeitsbereich, in dem sie installiert ist, zugreifen kann. Viele Scopes sind auf bestimmte Ressourcen wie Kanäle oder Dateien beschränkt.

Hinweis:

Das direkte Hinzufügen von Scopes zu Ihrer App ist nicht erforderlich, wenn Sie nur die beaufsichtigte Automatisierung ausführen möchten. Wenn Sie die beaufsichtigte Automatisierung ausführen, wählen Sie Ihre Scopes mithilfe der Scopes -Eigenschaft in der Slack Scope -Aktivität aus.

Da das Festlegen von Scopes in Ihrer App sowohl die Unattended- als auch die Attended-Automatisierung ermöglicht, empfehlen wir, die folgenden Schritte auszuführen, bevor Sie mit der Verwendung des Aktivitätspakets beginnen. Auf diese Weise können Sie frei zwischen den Modi wechseln.

Klicken Sie im linken Navigationsbereich auf OAuth und Berechtigungen.
Klicken Sie im Abschnitt Umleitungs-URLs auf die Schaltfläche Neue Umleitungs-URL hinzufügen und geben Sie Ihre URL ein.
- Wenn Sie die URL, die Sie eingeben sollten, nicht kennen, können Sie sie vorerst leer lassen.
- Wenn Sie zum ersten Mal versuchen, eine Verbindung mit Ihrer App mit der Slack Scope -Aktivität herzustellen (unter Verwendung der Attended-Automatisierung), öffnet die Aktivität eine neue Webseite, die einen OAuth-Fehleranzeigt. Dieser Fehler enthält die Umleitungs-URL (z. B. übergebene URI), die Ihr Arbeitsbereich verwendet. Sie können diese URL kopieren und als Ihre Weiterleitungs-URL eingeben.
Fügen Sie im Abschnitt Scopes die Berechtigungs-Scopes hinzu, die Sie Ihrer App zuweisen möchten, und klicken Sie auf die Schaltfläche Änderungen speichern ( Save Changes ) (die vollständige Liste der hinzuzufügenden Scopes finden Sie im nächsten Abschnitt).

Scopes, die hinzugefügt werden sollen

Im Folgenden sind die für die verschiedenen Slack-Aktivitäten erforderlichen Scopes aufgeführt. Die Tabelle enthält auch die Zuordnung jedes Scopes zu den Scopes -Eigenschaftswerten aus der Slack Scope -Aktivität.

Umfang	Aktivität	Scopes-Eigenschaft
channels:write ^{Ändern Sie Ihre öffentlichen Kanäle}	Create Channel Invite to Channel Join Channel Leave Channel Remove from Channel Send Message	PublicChannels
Gruppen:schreiben ^{Ändern Sie Ihre privaten Kanäle}	Invite to Channel Leave Channel Remove from Channel Send Message	PrivateChannels
im:write ^{Direktnachrichten des Benutzers ändern}	Invite to Channel Leave Channel Remove from Channel Send Message	DirectMessages
mpim:write ^{Gruppennachrichten des Benutzers ändern}	Invite to Channel Leave Channel Remove from Channel Send Message	GroupMessages
Dateien:write:user ^{Dateien als Benutzer hochladen und ändern}	Send Message	Dateien
Dateien:lesen ^{Auf die Dateien, Kommentare und zugehörigen Informationen des Arbeitsbereichs zugreifen}	Download File Send Message	Dateien
channels:read ^{Zugriff auf Informationen über den öffentlichen Kanal des Benutzers}	Get Messages	PublicChannels
Gruppen:lesen ^{Zugriff auf Informationen über die privaten Kanäle des Benutzers}	Get Messages	PrivateChannels
im:read ^{Zugriff auf Informationen über Direktnachrichten des Benutzers}	Get Messages	DirectMessages
mpim:read ^{Zugriff auf Informationen zu Gruppennachrichten des Benutzers}	Get Messages	GroupMessages
channels:history ^{Auf öffentliche Kanäle des Benutzers zugreifen}	Get Replies	PublicChannels
Gruppen:Verlauf ^{Auf Inhalte in den privaten Kanälen des Benutzers zugreifen}	Get Replies	PrivateChannels
im:history ^{Auf Inhalte in den Direktnachrichten des Benutzers zugreifen}	Get Replies	DirectMessages
mpim:history ^{Auf Gruppennachrichten des Benutzers zugreifen}	Get Replies	GroupMessages
chat:write:user ^{Nachrichten als Benutzer senden}	Reply Send Message	Chat
Suche:lesen ^{Inhalt Ihres Arbeitsbereichs durchsuchen}	Suche	(enthalten in DirectMessages und/oder GroupMessages)
users.profile:write ^{Benutzerprofil ändern}	Update Status	Benutzer
Benutzer:read.email ^{E-Mail-Adressen der Workspace-Mitglieder anzeigen}	Invite to Channel Remove from Channel	Benutzer
users:read ^{Liste der Mitglieder des Arbeitsbereichs und deren Kontaktinformationen anzeigen}	Invite to Channel Remove from Channel	Benutzer

Nachdem Sie Ihre Scopes ausgewählt haben, können Sie Ihre App in Ihrem Arbeitsbereich installieren, indem Sie die Schritte im nächsten Abschnitt ausführen.

3. Installieren Sie Ihre App in Ihrem Workspace

Je nachdem, wie Ihr Arbeitsbereich verwaltet wird, müssen Sie möglicherweise die Installation der App anfordern.

Klicken Sie im Abschnitt OAuth-Token und Weiterleitungs-URLs auf die Schaltfläche App in Workspace installieren oder auf die Schaltfläche Installation anfordern .
Nach der Installation der App wird ein OAuth-Zugriffstoken generiert.
- Ähnlich wie die Client-ID und der geheimeClientschlüssel wird das OAuth-Zugriffstoken für Authentifizierungszwecke verwendet. Die Unterschiede zwischen den beiden werden beim Ausführen Ihres Automatisierungsprojekts wirksam.
  - Wenn Sie die beaufsichtigte Automatisierung ausführen, benötigt die Slack Scope -Aktivität Werte in den Eigenschaften Client ID, Client Secret, Scopes .
  - Wenn Sie die Unattended-Automatisierung ausführen, benötigt die Slack-Scope -Aktivität nur einen Wert in der Eigenschaft OAuth Access Token .

4. Erstellen Sie Ihr Projekt

Erstellen Sie ein neues Automatisierungsprojekt.
1. Öffnen Sie UiPath Studio.
2. Klicken Sie unter Neues Projektauf Prozess (dadurch wird das Fenster Neuer leerer Prozess geöffnet).
3. Geben Sie einen Projektnamen, einen Speicherortund eine Beschreibungein.
4. Klicken Sie auf Erstellen.
Installieren Sie das UiPath.Slack.Activities -Paket.
1. Klicken Sie im Menüband Design auf Pakete verwalten (dadurch wird das Fenster Pakete verwalten geöffnet).
2. Klicken Sie unter Alle Paketeauf Los!
3. Geben Sie in der Suchleiste Slackein.
4. Klicken Sie auf, installieren und akzeptieren Sie die Lizenz für UiPath.Slack.Activities.
  - Weitere Informationen zu UiPath Studio-Paketen finden Sie unter Verwalten von Paketen im Studio-Handbuch.

Alles erledigt!

Nachdem Sie die Einrichtung abgeschlossen haben, können Sie mit dem Hinzufügen der Slack-Aktivitäten zu Ihrem Projekt beginnen.

Nächste Schritte

Für eine praxisbezogene Lernerfahrung und für einen schnellen Einstieg in die Verwendung der Aktivitäten, sehen Sie sich die Schnellstartanleitungen an. Diese Anleitungen enthalten Schritt-für-Schritt-Anweisungen, mit denen Sie Arbeitsbeispiele für die verschiedenen Aktivitäten erstellen können, damit Sie die Verbindung zu Ihrem Slack WorkSpace und sich mit den Eingabe-/Ausgabeeigenschaften vertraut machen können.

Weitere Informationen zu den Slack-Aktivitäten (einschließlich Beispieleigenschaftseingaben/-ausgaben) finden Sie auf der Seite Aktivitäten für eine vollständige Aktivitätsliste und Links zu den Aktivitätsdetailseiten.

Auf dieser Seite