Zum Inhalt springen

Microsoft Teams Aktivität „Nachricht senden“

Einführung

Eine Microsoft Teams Aktivität Nachricht senden unter Verwendung ihrer Microsoft Teams-Verbindung, sendet eine Nachricht an ein bestimmtes Team und einen bestimmten Kanal bei Microsoft Teams und soll als Ziel zum Verbrauchen von Daten in einem Operation verwendet werden.

Erstellen einer Microsoft Teams Aktivität „Nachricht senden“

Eine Instanz einer Microsoft Teams Aktivität Nachricht senden wird aus einer Microsoft Teams-Verbindung erstellt mithilfe des Aktivitätstyps Nachricht senden.

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ätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Microsoft Teams Aktivität Nachricht senden kann an diesen Orten bearbeitet werden:

Konfigurieren einer Microsoft Teams Aktivität „Nachrichten senden“

Befolgen Sie diese Schritte, um eine Microsoft Teams Aktivität Nachricht senden zu konfigurieren:

Schritt 1: Gib einen Namen ein und wähle ein Team aus

Geben Sie in diesem Schritt einen Namen für die Aktivität ein und wählen Sie ein Team aus. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Microsoft Teams - Konfigurationsschritt 1 der Aktivität „Nachrichten senden“

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

  • Wählen Sie ein Team aus: In diesem Abschnitt werden die im Microsoft Teams Endpoint verfügbaren Teams angezeigt.

    • Ausgewähltes Team: Nachdem ein Team ausgewählt wurde, wird es hier aufgelistet.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Teams zu filtern. Bei der Suche wird die Groß- und Kleinschreibung nicht beachtet. Wenn in der Tabelle bereits Teams angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Teams beim Suchen vom Endpoint neu zu laden, geben Sie Suchkriterien ein und aktualisieren Sie dann, wie unten beschrieben.

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

    • Team auswählen: Klicken Sie in der Tabelle irgendwo auf eine Zeile, um ein Team auszuwählen. Es kann nur ein Team ausgewählt werden. Die für jedes Team verfügbaren Informationen werden vom Microsoft Teams Endpoint abgerufen:

      • Name: Der Name des Teams.

      • Beschreibung: Die Beschreibung des Teams. Wenn ein Team keine Beschreibung hat oder eine Beschreibung hat, die aus Leerzeichen besteht, verwendet der Connector den Teamnamen als Teambeschreibung. Dies hat keine Auswirkungen auf das Schema, die Ausführung oder die zurückgegebene Antwort.

    Tipp

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

  • Speichern und beenden: Klicken Sie, wenn aktiviert, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt 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. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Einen Kanal auswählen

Wählen Sie in diesem Schritt einen Kanal aus. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Microsoft Teams - Konfigurationsschritt 2 der Aktivität „Nachrichten senden“

  • Kanal auswählen: In diesem Abschnitt werden die im Microsoft Teams Endpoint verfügbaren Kanäle angezeigt.

    • Ausgewähltes Team: Das im vorherigen Schritt ausgewählte Team wird hier aufgelistet.

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

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

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

    • Auswählen eines Kanals: Klicken Sie in der Tabelle irgendwo auf eine Zeile, um einen Kanal auszuwählen. Es kann nur ein Kanal ausgewählt werden. Die für jeden Kanal verfügbaren Informationen werden vom Microsoft Teams Endpoint abgerufen:

      • Name: Der Name des Kanals.

      • Beschreibung: Die Beschreibung des Kanals. Wenn der Kanal keine Beschreibung hat, wird der Kanalname als Beschreibung wiederholt.

    Tipp

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

  • Optionale Einstellungen: Klicken Sie, um eine zusätzliche optionale Eigenschaften-Einstellung anzuzeigen:

    • Inhaltstyp: „HTML“: Wählen Sie diese Option aus, um anzugeben, dass der Inhaltstyp der Nachrichten html.

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

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

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

Schritt 3: Überprüfen der Datenschemata

Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Microsoft Teams - Konfigurationsschritt 3 der Aktivität „Nachrichten senden“

  • Datenschemata: Diese Datenschemata werden von benachbarten Transformations übernommen und beim Transformation erneut angezeigt.

    Notiz

    Die in einer Transformation bereitgestellten Daten haben Vorrang vor der Aktivitätskonfiguration.

    Der Microsoft Teams Connector verwendet die Microsoft Graph REST API v1.0. Informationen zu den Schema und -feldern finden Sie in der API -Dokumentation. Beachten Sie außerdem:

    • Dateien anhängen: Wenn Sie in der Anfrage Dateien anhängen, die größer als 4 MB sind, schlägt der Operation fehl und es werden Fehler in das Protokoll geschrieben. Als Workaround können Sie eine ZIP-Datei in kleinere, separate Dateien aufteilen und mehrere Nachrichten senden.

    • Senden von HTML-Nachrichten: In der Anfrage unterstützt das Nachrichtenfeld HTML, wenn die optionale Einstellung von Schritt 2 ausgewählt ist, und der gesamte Text sollte richtig formatiertes HTML sein. Zeilenumbrüche, die beibehalten werden sollen, sollten durch das HTML ersetzt werden <br> Tag. Sie können beispielsweise eine HTML-Nachricht senden, die sich in mehrere Zeilen auflöst und Text wie diesen verwendet:

      <b>NOTE:</b> Do not ignore this message!<br>More information to follow.

    • Zusätzlich zurückgegebene Felder: In der Antwort können zusätzliche Felder mit einer Warnung zurückgegeben werden. Diese Warnungen können ignoriert werden.

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Microsoft Teams Endpoint neu zu generieren. Diese Aktion generiert auch ein Schema an anderen Stellen im gesamten Projekt neu, an denen auf dasselbe Schema verwiesen wird, z. B. in einer angrenzenden Transformation.

  • Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über jedem Schema, um den Bearbeitungsmodus für dieses Schema aufzurufen. Mit dem Editor können Sie Knoten und Felder hinzufügen, löschen und neu organisieren sowie deren Datentypen ändern. Alle Vorkommen von Knoten und Feldern werden als [0, 1]Kardinalität. Änderungen an den Datenschemata müssen für den Endpoint akzeptabel sein und sollten nur nach Konsultation der verfügbaren Dokumentation für den Endpoint vorgenommen werden. Nach der Durchführung von Schema wird oben im entsprechenden Schema ein Datum der letzten Bearbeitung angezeigt, um darauf hinzuweisen, dass das Schema manuell bearbeitet wurde. Durch Aktualisieren der Schemata werden die Schemata auf ihre Standardstrukturen zurückgesetzt.

    Notiz

    Alle Änderungen werden ohne Bestätigung direkt an der Aktivität vorgenommen. Wenn Sie Änderungen rückgängig machen oder zurücksetzen müssen, nehmen Sie sie entweder im Bearbeitungsmodus erneut vor oder erstellen Sie die Aktivität mit einer neuen Instanz der Aktivität neu.

  • Zurück: Klicken Sie hier, 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 auf, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Mit Ausnahme von Änderungen, die im Bearbeitungsmodus eines Schema vorgenommen wurden, werden Sie in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Microsoft Teams Aktivität Nachricht senden konfiguriert haben, schließen Sie die Konfiguration des Operation ab, indem Sie andere Aktivitäten, Transformations oder Scripts als Operation hinzufügen und konfigurieren. Sie können auch die Operation konfigurieren, die die Möglichkeit umfassen, Vorgänge zu verketten, die sich im gleichen oder in unterschiedlichen Workflows befinden.

Auf Menüaktionen für eine Aktivität kann über den Projektbereich und die Design-Canvas zugegriffen werden. Weitere Informationen finden Sie unter Aktionsmenü in Connector-Grundlagen.

Microsoft Teams Sendenachricht-Aktivitäten können mit diesen Operation als Ziel 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, einsetzen und ausführen den Operation und validieren Sie das Verhalten durch Überprüfen der Operation.