Zum Inhalt springen

Slack-Verbindung

Einführung

Eine Slack-Verbindung, die mit dem Slack-Connector erstellt wurde, richtet den Zugriff auf Slack ein. Sobald eine Verbindung konfiguriert ist, können Sie Instanzen von Slack-Aktivitäten erstellen, die mit dieser Verbindung verknüpft sind und entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Wichtig

Um den Slack Connector zu verwenden, müssen Sie eine Slack-App erstellen und die erforderlichen Bereiche hinzufügen (wie in Slack-Voraussetzungen beschrieben)).

Erstellen oder Bearbeiten einer Slack-Verbindung

Eine neue Slack Verbindung wird mithilfe des Slack Connectors von einem dieser Standorte aus erstellt:

Eine bestehende Slack-Verbindung kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Slack-Verbindung

Jedes Benutzeroberflächenelement des Slack Verbindungskonfigurationsbildschirms wird unten beschrieben.

Die in der Slack-Verbindungskonfiguration verwendete Schnittstelle hängt von der ausgewählten Option Authentifizierungsmechanismus ab:

  • Token-basierte Authentifizierung: Bei dieser Option wird die Verbindung mithilfe eines OAuth-Tokens für Ihre Slack-App authentifiziert.

  • Autorisierungscode-Gewährung: Bei dieser Option wird die Verbindung über Slack in einem separaten Browser-Tab authentifiziert (3-legged OAuth). Nach der Authentifizierung erteilen Sie Harmony die Erlaubnis, auf die Slack App zuzugreifen. Diese Option erfordert die Verwendung der Agent-Version 10.83 / 11.21 oder höher.

Notiz

Token-basierte Authentifizierung muss für eine Slack globale Verbindung verwendet werden.

Token-basierte Authentifizierung

Wenn Token-basierte Authentifizierung als Authentifizierungsmechanismus ausgewählt ist, wird diese Schnittstelle angezeigt:

Slack Verbindungskonfiguration

Tipp

Felder mit einem Unterstützung variabler Symbole durch globale Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit einer öffnenden eckigen Klammer [ in das Feld oder durch Klicken auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen, aus denen Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Slack-Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :. Dieser Name wird auch verwendet, um den Slack Endpoint zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

  • Authentifizierungsmechanismus: Wählen Sie Token-basierte Authentifizierung, um die Authentifizierung mit einem OAuth-Zugriffstoken durchzuführen.

  • Authentifizierungstyp: Wählen Sie den Authentifizierungstyp, entweder OAuth-Zugriffstoken oder Bot-Benutzer-OAuth-Zugriffstoken (empfohlen):

  • Proxy-Einstellungen verwenden (nur Privater Agent): Bei Verwendung eines privaten Agenten kann diese Einstellung ausgewählt werden, um Proxy-Einstellungen des privaten Agenten zu verwenden.

  • Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Autorisierungscode-Erteilung

Wenn Authorization Code Grant als Authentifizierungsmechanismus ausgewählt ist, wird diese Schnittstelle angezeigt:

Slack Verbindungskonfiguration

  • Verbindungsname: Geben Sie einen Namen ein, der zur Identifizierung der Verbindung verwendet werden soll. Der Name muss für jede Slack-Verbindung eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :. Dieser Name wird auch verwendet, um den Slack Endpoint zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf ihre Aktivitäten bezieht.

  • Authentifizierungsmechanismus: Wählen Sie Authorization Code Grant, um die Authentifizierung durch Zustimmung über Slack in einem separaten Browser-Tab durchzuführen (3-legged OAuth).

  • OAuth-Anwendung: Nur sichtbar, wenn private Anwendungen bei der App-Registrierung registriert sind-Seite. Verwenden Sie das Menü, um eine OAuth 2.0-Anwendung aus einer dieser Kategorien auszuwählen:

    • Cloud-Anwendungen: Die Anwendung in dieser Kategorie (Jitterbit-App) ist eine von Jitterbit bereitgestellte OAuth 2.0-Anwendung. Wenn auf der App-Registrierung keine privaten Anwendungen registriert sind Seite wird standardmäßig die Jitterbit-App verwendet.

    • Private Anwendungen: Diese Kategorie zeigt Slack-Connector-Anwendungen, die in der Management Console konfiguriert sind App-Registrierungen-Seite. Weitere Informationen zum Konfigurieren einer Slack Connector-Anwendung auf der Seite App-Registrierungen finden Sie unter 3-legged OAuth konfigurieren in Voraussetzungen.

    Notiz

    Wenn das Feld OAuth-Anwendung nicht sichtbar ist, wird standardmäßig die von Jitterbit bereitgestellte OAuth 2.0-Anwendung verwendet.

  • Mit Slack anmelden: Klicken Sie, um sich in einem separaten Browser-Tab über Slack zu authentifizieren und Jitterbit die Erlaubnis zum Zugriff auf die Slack-App zu erteilen.

  • Proxy-Einstellungen verwenden (nur Privater Agent): Bei Verwendung eines privaten Agenten kann diese Einstellung ausgewählt werden, um Proxy-Einstellungen des privaten Agenten zu verwenden.

  • Test: Klicken Sie hier, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die der aktuellen Umfeld zugeordnet ist. Dieser Connector unterstützt das Anhalten des Downloads der neuesten Connector-Version mithilfe der Organisationsrichtlinie Automatische Connector-Aktualisierung deaktivieren.

  • Änderungen speichern: Klicken Sie hier, um die Verbindungskonfiguration zu speichern und zu schließen.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen an einer neuen oder vorhandenen Konfiguration hier, um die Konfiguration ohne Speichern zu schließen. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Verbindungskonfiguration hier, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen). Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Slack-Verbindung hergestellt wurde, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (zum Bereitstellen von Daten in einem Operation) oder als Ziele (zum Verbrauchen von Daten in einem Operation) verwendet werden können.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind über den Projektbereich und die Design-Komponentenpalette zugänglich. Weitere Informationen finden Sie unter Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Suchen: Sucht Nachrichten in Slack und soll als Quelle in einer Operation verwendet werden.

  • Post: Postet ein Objekt in einem Slack-Kanal und soll als Ziel in einer Operation verwendet werden.

  • Chat: Platziert Chat-Informationen in Slack und soll als Ziel in einer Operation verwendet werden.

  • Erhalten: Ruft Objektdaten von Slack ab und ist zur Verwendung als Quelle in einer Operation vorgesehen.

  • Dateien: Platziert Dateiinformationen in Slack und ist zur Verwendung als Ziel in einer Operation vorgesehen.

  • Gespräche: Postet Konversationsinformationen in Slack und soll als Ziel in einer Operation verwendet werden.

  • Benutzer: Platziert Benutzerinformationen in Slack und soll als Ziel in einer Operation verwendet werden.