Zum Inhalt springen

Slack-Aktivität „Nachricht senden" in Jitterbit Studio

Einführung

Eine Slack-Aktivität Nachricht senden, die ihre Slack-Verbindung nutzt, sendet eine Nachricht an einen Benutzer, mehrere Benutzer, eine Unterhaltung oder einen Kanal in Slack und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Erstellen einer Slack-Aktivität „Nachricht senden"

Eine Instanz einer Slack-Aktivität Nachricht senden wird aus einer Slack-Verbindung mit ihrem Aktivitätstyp Nachricht senden erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitäts- oder Tool-Instanz in Komponentenwiederverwendung.

Eine vorhandene Slack-Aktivität Nachricht senden kann an diesen Orten bearbeitet werden:

Konfigurieren einer Slack-Aktivität „Nachricht senden"

Führen Sie diese Schritte aus, um eine Slack-Aktivität Nachricht senden zu konfigurieren:

Schritt 1: Namen eingeben und Nachrichtenrouting konfigurieren

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und konfigurieren Sie, wie Nachrichten an Empfänger weitergeleitet werden. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

  • Endpunkt-Menü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, wird oben auf dem Bildschirm ein Menü mit dem aktuellen Endpunktnamen angezeigt. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Zugewiesenen Endpunkt ändern in Konfigurationsbildschirme.

    • Endpunkt bearbeiten: Wird angezeigt, wenn Sie den Mauszeiger über den aktuellen Endpunktnamen bewegen. Klicken Sie, um die Verbindungskonfiguration 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-Aktivität Nachricht senden eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

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

    • Direkt oder Mehrpersonen: Senden Sie eine direkte Nachricht an einen Benutzer oder eine Gruppendirekt-Nachricht an mehrere Benutzer (bis zu 8).

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

  • Unterhaltungstyp: Dieses Feld wird angezeigt, wenn Sie Direkt oder Mehrpersonen für den Nachrichtentyp auswählen. Wählen Sie, wie Sie die Unterhaltung identifizieren oder erstellen möchten:

    • Neue Unterhaltung erstellen: Erstellen Sie eine neue Direkt-Nachricht oder Gruppendirekt-Nachricht-Unterhaltung.

    • Vorhandene Unterhaltung auswählen: Wählen Sie aus vorhandenen Unterhaltungen.

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

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Nachrichtenempfänger konfigurieren

Wählen Sie in diesem Schritt aus, wie Sie die Nachrichtenempfänger angeben möchten. Die angezeigte Benutzeroberfläche hängt vom gewählten Auswahltyp und den in Schritt 1 vorgenommenen Auswahlen ab.

  • Auswahltyp „Direkte Nachrichten/Kanäle": Wählen Sie aus, wie Sie die Empfänger für Ihre Nachricht angeben möchten:

    • Unterhaltungs-ID manuell bereitstellen: Geben Sie die Unterhaltungs-ID oder Kanal-ID manuell ein.

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

    • Überspringen: Überspringen Sie die Empfängerauswahl in diesem Schritt und stellen Sie die Empfängerinformationen über eine Transformation bereit. Wenn Sie diese Option auswählen, ordnen Sie Slack-Benutzer-IDs dem Knoten users im Anforderungsschema zu.

      Um Benutzer-IDs zu erhalten, konfigurieren Sie eine Slack-Aktivität „Benutzer" mit dem Objekttyp Benutzerliste, führen Sie den Vorgang aus und rufen Sie die Benutzer-IDs aus der Antwort-Payload ab. Sie können diese Benutzer-IDs dann in Ihrer Transformation verwenden, um 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 zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Unterhaltungs-ID manuell bereitstellen

Wenn Sie Unterhaltungs-ID manuell bereitstellen auswählen, können Sie die Unterhaltungs- oder Kanal-ID direkt eingeben.

  • Unterhaltungs-ID/Kanal-ID bereitstellen: Geben Sie die Unterhaltungs-ID oder Kanal-ID ein, an die Sie die Nachricht senden möchten. Das ID-Format hängt von Ihrer Nachrichtentypauswahl aus Schritt 1 ab:

    • Geben Sie für direkte oder Mehrpersonen-Nachrichten eine Unterhaltungs-ID ein.
    • Geben Sie für Kanalnachrichten 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 Nachrichtentypauswahlen und Unterhaltungstypauswahlen aus Schritt 1 an.

Neue direkte oder Mehrpersonen-Unterhaltung erstellen

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

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

    • 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 Symbol zum Aktualisieren, um die Benutzerliste von Slack neu zu laden.

    • Ausgewählte Benutzer: Zeigt die Benutzer an, die ausgewählt wurden, um in die Unterhaltung aufgenommen 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.

Vorhandene Unterhaltung auswählen

Wenn Sie in Schritt 1 Nachrichtentyp auf Direkt oder Mehrpersonen und Unterhaltungstyp auf Vorhandene Unterhaltung auswählen setzen, wählen Sie eine vorhandene Unterhaltung aus.

  • Vorhandenen Chat auswählen: Wählen Sie die vorhandene Unterhaltung aus, an die die Nachricht gesendet werden soll. Verwenden Sie das Suchfeld, um die Liste der Unterhaltungen zu filtern. Klicken Sie auf das Symbol zum Aktualisieren, um Unterhaltungen von Slack neu zu laden.

    • Ausgewählter Chat: Nach der Auswahl einer Unterhaltung wird diese hier aufgelistet.

  • Suche: Geben Sie einen beliebigen Wert aus einer Spalte in das Suchfeld ein, um die Liste der Unterhaltungen zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn Unterhaltungen bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse bei jedem Tastendruck in Echtzeit gefiltert. Um Unterhaltungen vom Endpunkt zu laden, wenn Sie suchen, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

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

  • Unterhaltung auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer Zeile, um eine Unterhaltung auszuwählen. Es kann nur eine Unterhaltung ausgewählt werden. Die für jede Unterhaltung verfügbaren Informationen werden vom Slack-Endpunkt abgerufen.

Tipp

Wenn die Tabelle nicht mit verfügbaren Unterhaltungen gefüllt wird, ist die Slack-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten erneut testen.

Kanal auswählen

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

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

    • Ausgewählter Slack-Kanal: Nach Auswahl eines Slack-Kanals wird dieser hier aufgelistet.

    • Suche: Geben Sie einen beliebigen Wert aus einer Spalte in das Suchfeld ein, um die Liste der Kanäle zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn Kanäle bereits in der Tabelle angezeigt werden, werden die Tabellenergebnisse bei jedem Tastendruck in Echtzeit gefiltert. Um Kanäle vom Endpunkt zu laden, wenn Sie suchen, geben Sie Suchkriterien ein und aktualisieren Sie dann wie unten beschrieben.

    • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um 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 angezeigten Tabelle der Kanäle in der Konfiguration verwendet werden.

    • Slack-Kanal auswählen: Klicken Sie in 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 für jeden Slack-Kanal verfügbaren Informationen werden vom Slack-Endpunkt abgerufen.

    Tipp

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

Schritt 3: Nachrichteninhalt konfigurieren

Geben Sie in diesem Schritt den zu sendenden Nachrichteninhalt an. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

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

  • Bei Fehler fortfahren: Wählen Sie diese Option, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Batch-Anfrage ein Fehler auftritt. Wenn Fehler auftreten, werden diese in das Vorgangsprotokoll geschrieben.

  • 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 zu wechseln. Die Konfiguration wird erst gespeichert, wenn Sie auf der letzten Seite auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne die in einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 4: Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

  • Datenschemas: Diese Datenschemas werden von angrenzenden Transformationen geerbt und werden während der Datenzuordnung 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 Schemaknoten und Feldern finden Sie in der API-Dokumentation.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Schemas vom Slack-Endpunkt neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden 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: Klicken Sie nach dem Vornehmen von Änderungen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Slack-Aktivität Nachricht senden schließen Sie die Konfiguration des Vorgangs ab, indem Sie weitere Aktivitäten oder Tools als Vorgangsschritte hinzufügen und konfigurieren. Sie können auch die Vorgangseinstellungen konfigurieren, die die Möglichkeit bieten, Vorgänge zu verketten, die sich in denselben oder verschiedenen Workflows befinden.

Menüaktionen für eine Aktivität sind über den Projektbereich und die Designoberfläche zugänglich. Weitere Informationen finden Sie unter Menü „Aktivitätsaktionen" in Connector-Grundlagen.

Slack-Aktivitäten Nachricht senden 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 diesen temporären Speicherort dann in der Skriptfunktion.

Wenn Sie bereit sind, stellen Sie den Vorgang bereit und führen ihn aus und validieren Sie das Verhalten, indem Sie die Vorgangsprotokolle überprüfen.