Zum Inhalt springen

Slack-Verbindung

Einführung

Eine Slack-Verbindung, die mit dem Slack-Connector erstellt wurde, ermöglicht den Zugriff auf Slack. Sobald eine Verbindung konfiguriert ist, können Instanzen von Slack-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Wichtig

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

Erstellen oder Bearbeiten einer Slack-Verbindung

Eine neue Slack-Verbindung wird mit dem Slack-Connector von einem dieser Standorte erstellt:

Eine vorhandene Slack-Verbindung kann von diesen Standorten bearbeitet werden:

Konfigurieren einer Slack-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Slack-Verbindung wird im Folgenden beschrieben.

Die in der Konfiguration der Slack-Verbindung verwendete Benutzeroberfläche 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.

  • Authorization Code Grant: Bei dieser Option wird die Verbindung über Slack in einem separaten Browser-Tab authentifiziert (3-beinige OAuth). Nach der Authentifizierung erteilen Sie die Zustimmung, dass Harmony auf die Slack-App zugreifen kann. Diese Option erfordert die Verwendung der Agentenversion 10.83 / 11.21 oder höher.

Hinweis

Token-basierte Authentifizierung muss für einen Slack globalen Endpunkt verwendet werden.

Token-basierte Authentifizierung

Wenn Token-basierte Authentifizierung als Authentifizierungsmechanismus ausgewählt ist, wird die unten beschriebene Schnittstelle angezeigt.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Symbol für Variablen klicken, um ein Menü mit vorhandenen Variablen anzuzeigen, aus dem Sie auswählen können.

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

  • Authentifizierungsmechanismus: Wählen Sie Token-basierte Authentifizierung, um sich mit einem OAuth-Zugriffstoken zu authentifizieren.

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

  • Bot-Benutzer-OAuth-Zugriffstoken: Wenn Bot-Benutzer-OAuth-Zugriffstoken als Authentifizierungstyp ausgewählt wurde, geben Sie das Bot-Token ein, das Sie von der Slack API-Website erhalten haben, wie unter Erhalten eines OAuth-Tokens in Voraussetzungen beschrieben. Dies ist die empfohlene Option.

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

  • Test: Klicken Sie, 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 mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie "Automatische Connector-Aktualisierung deaktivieren".

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen wurden, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem eine bestehende Verbindungs-Konfiguration geöffnet wurde, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung löschen möchten.

Autorisierungscode-Grant

Wenn Autorisierungscode-Grant als Authentifizierungsmechanismus ausgewählt wird, wird die unten beschriebene Schnittstelle angezeigt.

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

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

  • OAuth-Anwendung: Sichtbar nur, wenn private Anwendungen auf der Seite App-Registrierung registriert sind. 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 keine privaten Anwendungen auf der Seite App-Registrierung registriert sind, wird standardmäßig Jitterbit App verwendet.

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

    Hinweis

    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 über Slack in einem separaten Browser-Tab zu authentifizieren und Jitterbit die Zustimmung zum Zugriff auf die Slack-App zu erteilen.

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

  • Test: Klicken Sie, 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 mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie Auto Connector Update deaktivieren.

  • Änderungen speichern: Klicken Sie, um die Konfigurationsänderungen zu speichern und die Verbindung zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fragt Sie, ob Sie die Verbindung wirklich löschen möchten.

Nächste Schritte

Nachdem eine Slack-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsgrafik, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Suchen: Findet Nachrichten in Slack und ist als Quelle in einem Vorgang gedacht.

  • Posten: Postet ein Objekt in einen Slack-Kanal und ist als Ziel in einem Vorgang gedacht.

  • Chat: Platziert Chatinformationen in Slack und ist als Ziel in einem Vorgang gedacht.

  • Abrufen: Ruft Objektdaten aus Slack ab und ist als Quelle in einem Vorgang gedacht.

  • Dateien: Platziert Dateiinformationen in Slack und ist als Ziel in einem Vorgang gedacht.

  • Conversations: Überträgt Informationen zu Konversationen in Slack und ist als Ziel in einem Vorgang gedacht.

  • Users: Überträgt Benutzerinformationen in Slack und ist als Ziel in einem Vorgang gedacht.