Zum Inhalt springen

Slack Send Message-Aktivität

Einführung

Eine Slack Send Message-Aktivität, die über die Slack-Verbindung genutzt wird, sendet eine Nachricht an einen Benutzer, mehrere Benutzer, ein Gespräch oder einen Kanal in Slack und ist dafür gedacht, als Ziel zur Datenverarbeitung in einem Vorgang verwendet zu werden.

Erstellen einer Slack Send Message-Aktivität

Eine Instanz einer Slack Send Message-Aktivität wird aus einer Slack-Verbindung unter Verwendung des Aktivitätstyps Send Message erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für weitere Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

Eine vorhandene Slack Send Message-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Slack Send Message-Aktivität

Befolgen Sie diese Schritte, um eine Slack Send Message-Aktivität zu konfigurieren:

Schritt 1: Geben Sie einen Namen ein und konfigurieren Sie die Nachrichtenweiterleitung

In diesem Schritt geben Sie einen Namen für die Aktivität ein und konfigurieren, wie Nachrichten an die Empfänger weitergeleitet werden. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Endpoint-Menü: Wenn Sie mehrere Endpunkte desselben Verbindungstyps konfiguriert haben, wird ein Menü oben auf dem Bildschirm angezeigt, das den aktuellen Endpunktnamen anzeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirmen.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungsconfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Aktivität zu identifizieren. Der Name muss für jede Slack Nachricht senden-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

  • Nachrichtentyp: Wählen Sie aus, wie die Nachricht weitergeleitet werden soll:

    • Direkt oder Mehrpersonen: Senden Sie eine Direktnachricht an einen Benutzer oder eine Gruppen-Direktnachricht an mehrere Benutzer (bis zu 8).

    • Kanal: Senden Sie eine Nachricht an einen bestehenden Slack-Kanal.

  • Gesprächsart: Dieses Feld erscheint, wenn Sie Direkt oder Mehrpersonen für den Nachrichtentyp auswählen. Wählen Sie aus, wie Sie das Gespräch identifizieren oder erstellen möchten:

    • Neues Gespräch erstellen: Erstellen Sie ein neues Direktnachrichten- oder Gruppen-Direktnachrichten-Gespräch.

    • Vorhandenes Gespräch auswählen: Wählen Sie aus vorhandenen Gesprächen aus.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 2: Konfigurieren der Nachrichtenempfänger

In diesem Schritt wählen Sie aus, wie die Nachrichtenempfänger angegeben werden sollen. Die angezeigte Benutzeroberfläche hängt von der Auswahlart ab, die Sie wählen, und von den Auswahlmöglichkeiten, die in Schritt 1 getroffen wurden.

  • Auswahltyp für direkte Nachrichten/Kanäle: Wählen Sie aus, wie die Empfänger für Ihre Nachricht angegeben werden sollen:

    • Manuell informieren: Geben Sie die Gesprächs-ID oder die Kanal-ID manuell ein.

    • Aus Liste auswählen: Wählen Sie Empfänger aus einer Liste verfügbarer Benutzer, Gespräche oder Kanäle aus.

    • Überspringen: Überspringen Sie die Auswahl der Empfänger in diesem Schritt und geben Sie die Empfängerdaten über eine Transformation an. Wenn Sie diese Option wählen, ordnen Sie die Slack-Benutzer-IDs dem users-Knoten im Anforderungsschema zu.

      Um Benutzer-IDs zu erhalten, konfigurieren Sie eine Slack Benutzeraktivität mit dem Objekttyp Benutzerliste, führen Sie die Operation aus und rufen Sie die Benutzer-IDs aus der Antwortlast ab. Sie können diese Benutzer-IDs dann in Ihrer Transformation verwenden, um die Nachrichtenempfänger anzugeben.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern, nachdem Sie Änderungen vorgenommen haben. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Manuell informieren

Wenn Sie Manuell informieren auswählen, können Sie die Gesprächs- oder Kanalkennung direkt eingeben.

  • Gesprächs-ID/Kanal-ID informieren: Geben Sie die Gesprächs-ID oder die Kanal-ID ein, an die Sie die Nachricht senden möchten. Das ID-Format hängt von Ihrer Auswahl des Nachrichtentyps in Schritt 1 ab:

    • Für direkte oder Mehrpersonen-Nachrichten geben Sie eine Gesprächs-ID ein.
    • Für Kanalnachrichten geben Sie eine Kanal-ID ein.

Aus Liste auswählen

Wenn Sie Aus Liste auswählen wählen, zeigt die Benutzeroberfläche Optionen zur Auswahl von Empfängern basierend auf Ihren Auswahlmöglichkeiten für Nachrichtentyp und Konversationstyp aus Schritt 1 an.

Eine neue direkte oder Gruppenunterhaltung erstellen

Wenn Sie Nachrichtentyp auf Direkt oder Gruppenunterhaltung und Konversationstyp auf Neue Unterhaltung erstellen in Schritt 1 setzen, wählen Sie bis zu 8 Benutzer aus, um eine neue Unterhaltung zu erstellen.

  • Benutzerliste (Wählen Sie 1 bis 8): Wählen Sie die Benutzer aus, die in die neue Unterhaltung einbezogen werden.

    • Verfügbare Benutzer: Listet alle Benutzer auf, die in Ihrem Slack-Arbeitsbereich verfügbar sind. Verwenden Sie das Suchfeld, um die Liste zu filtern, indem Sie einen Benutzernamen eingeben. Klicken Sie auf das Aktualisierungs-Symbol, um die Benutzerliste von Slack neu zu laden.

    • Ausgewählte Benutzer: Zeigt die Benutzer an, die ausgewählt wurden, um in die Unterhaltung einbezogen zu werden. Verwenden Sie die Pfeiltasten, um Benutzer zwischen den Listen Verfügbare Benutzer und Ausgewählte Benutzer zu verschieben.

      • Klicken Sie auf den rechten Pfeil , um einen ausgewählten Benutzer aus der Liste Verfügbare Benutzer zur Liste Ausgewählte Benutzer hinzuzufügen.

      • Klicken Sie auf den linken Pfeil , um einen ausgewählten Benutzer aus der Liste Ausgewählte Benutzer zu entfernen.

Eine bestehende Unterhaltung auswählen

Wenn Sie Nachrichtentyp auf Direkt oder Gruppenunterhaltung und Konversationstyp auf Bestehende Unterhaltung auswählen in Schritt 1 setzen, wählen Sie eine bestehende Unterhaltung aus.

  • Bestehenden Chat auswählen: Wählen Sie die bestehende Unterhaltung aus, in die die Nachricht gesendet wird. Verwenden Sie das Suchfeld, um die Liste der Unterhaltungen zu filtern. Klicken Sie auf das Aktualisierungs-Symbol, um die Unterhaltungen von Slack neu zu laden.

    • Ausgewählter Chat: Nachdem eine Unterhaltung ausgewählt wurde, wird sie hier aufgelistet.

    • Suche: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Unterhaltungen zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Unterhaltungen bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Unterhaltungen von dem Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungsymbol oder das Wort Aktualisieren, um Gespräche vom Slack-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Gespräche zu Slack hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der in der Konfiguration angezeigten Gespräche verwendet werden.

    • Auswählen eines Gesprächs: Klicken Sie innerhalb der Tabelle auf eine beliebige Stelle in einer Zeile, um ein Gespräch auszuwählen. Es kann nur ein Gespräch ausgewählt werden. Die Informationen, die für jedes Gespräch verfügbar sind, werden vom Slack-Endpunkt abgerufen.

    Hinweis

    Wenn die Tabelle nicht mit verfügbaren Gesprächen gefüllt wird, könnte die Slack-Verbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

Wählen Sie einen Kanal

Wenn Sie den Nachrichtentyp auf Kanal in Schritt 1 setzen, wählen Sie einen vorhandenen Kanal aus.

  • Slack-Kanal auswählen: Wählen Sie den Slack-Kanal aus, in den die Nachricht gesendet wird. Verwenden Sie das Suchfeld, um die Liste der Kanäle zu filtern. Klicken Sie auf das Aktualisierungsymbol, um die Kanäle von Slack neu zu laden.

    • Ausgewählter Slack-Kanal: Nachdem ein Slack-Kanal ausgewählt wurde, wird er hier aufgelistet.

    • Suche: Geben Sie den Wert einer Spalte in das Suchfeld ein, um die Liste der Kanäle zu filtern. Die Suche ist nicht groß-/kleinschreibungsempfindlich. Wenn Kanäle bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse in Echtzeit mit jedem Tastendruck gefiltert. Um Kanäle vom Endpunkt beim Suchen neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungsymbol oder das Wort Aktualisieren, um die Kanäle vom Slack-Endpunkt neu zu laden. Dies kann nützlich sein, wenn Kanäle zu Slack hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der Tabelle der in der Konfiguration angezeigten Kanäle verwendet werden.

    • Auswählen eines Slack-Kanals: Klicken Sie innerhalb der Tabelle auf eine beliebige Stelle in einer Zeile, um einen Slack-Kanal auszuwählen. Es kann nur ein Slack-Kanal ausgewählt werden. Die Informationen, die für jeden Slack-Kanal verfügbar sind, werden vom Slack-Endpunkt abgerufen.

    Tipp

    Wenn die Tabelle nicht mit verfügbaren Kanälen gefüllt wird, könnte die Slack-Verbindung nicht erfolgreich sein. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldeinformationen erneut testen.

Schritt 3: Konfigurieren des Nachrichteninhalts

In diesem Schritt geben Sie den Nachrichteninhalt an, der gesendet werden soll. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Nachrichteninhalt: Geben Sie den Textinhalt der Nachricht ein, die an die ausgewählten Empfänger gesendet werden soll. Dieses Feld unterstützt einfachen Text und Slack Markdown-Formatierung.

  • Bei Fehler fortfahren: Wählen Sie diese Option, um die Ausführung der Aktivität fortzusetzen, wenn ein Fehler für einen Datensatz in einer Batch-Anfrage auftritt. Wenn Fehler auftreten, werden diese im Betriebsprotokoll aufgezeichnet.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Klicken Sie nach Änderungen, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Schritt 4: Überprüfen der Datenschemas

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schrittes wird im Folgenden beschrieben.

  • Datenschemas: Diese Datenschemas werden von benachbarten Transformationen geerbt und während der Transformationszuordnung erneut angezeigt.

    Hinweis

    Daten, die in einer Transformation bereitgestellt werden, haben Vorrang vor der Aktivitätskonfiguration.

    Der Slack-Connector verwendet die Slack REST API. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.

  • Aktualisieren: Klicken Sie auf das Aktualisieren-Symbol oder das Wort Aktualisieren, um die Schemata vom Slack-Endpunkt neu zu generieren. Diese Aktion regeneriert auch ein Schema an anderen Stellen im Projekt, an denen dasselbe Schema referenziert wird, z. B. in einer benachbarten Transformation.

  • Zurück: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne die Änderungen an einem Schritt zu speichern. Eine Nachricht fragt Sie, ob Sie die Änderungen wirklich verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Slack Nachricht senden-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration des Vorgangs, indem Sie andere Aktivitäten oder Werkzeuge als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit umfassen, Vorgänge zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Menüaktionen für eine Aktivität sind im Projektbereich und auf der Entwurfsgrafik zugänglich. Für Details siehe Aktivitätsaktionsmenü in Connector-Grundlagen.

Slack Nachricht senden-Aktivitäten können als Ziel mit diesen Vorgangsmustern verwendet werden:

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, bereitstellen und ausführen Sie den Vorgang und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.