Zum Inhalt springen

Microsoft Teams Chat-Aktivität

Einführung

Eine Chat-Aktivität von Microsoft Teams unter Verwendung ihrer Microsoft Teams-Verbindung, ruft einen vorhandenen Chat ab oder erstellt einen neuen Chat bei Microsoft Teams und soll als Ziel zum Verbrauchen von Daten in einem Operation verwendet werden.

Erstellen einer Microsoft Teams Chataktivität

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

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 Chat-Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Microsoft Teams Chataktivität

Befolgen Sie diese Schritte, um eine Microsoft Teams Chat-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Geben Sie in diesem Schritt einen Namen für die Aktivität an und legen Sie fest, ob ein vorhandener Chat ausgewählt oder ein neuer Chat erstellt werden soll. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben.

Die in diesem Schritt der Konfiguration einer Microsoft Teams -Chat-Aktivität verwendete Schnittstelle hängt von den ausgewählten Optionen Chat-Auswahl und Neuen Chat erstellen ab:

Vorhandenen Chat auswählen

Microsoft Teams Chat-Aktivitätskonfiguration, Schritt 1

  • Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede Microsoft Teams Chat-Aktivität eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :.

  • Chat-Auswahl: Wählen Sie eine der beiden Möglichkeiten, um den gesuchten Chat zu identifizieren, entweder Vorhandenen Chat auswählen oder Chat-ID manuell eingeben. Wenn Sie einen neuen Chat erstellen möchten, scrollen Sie an der Liste der vorhandenen Chats vorbei nach unten und klicken Sie auf Neuen Chat erstellen.

  • Chat auswählen: In diesem Abschnitt werden die im Microsoft Teams Endpoint verfügbaren Chats angezeigt.

    • Ausgewählter Chat: Nachdem ein Chat ausgewählt wurde, werden sein Typ und seine Kennung hier aufgelistet.

    • Suchen: Geben Sie den Wert einer beliebigen Spalte in das Suchfeld ein, um die Liste der Chats zu filtern. Bei der Suche wird die Groß-/Kleinschreibung nicht beachtet. Wenn in der Tabelle bereits Chats angezeigt werden, werden die Tabellenergebnisse mit jedem Tastendruck in Echtzeit gefiltert. Um Chats 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 Chats vom Microsoft Teams Endpoint neu zu laden. Dies kann nützlich sein, wenn Chats zu Microsoft Teams hinzugefügt wurden. Diese Aktion aktualisiert alle Metadaten, die zum Erstellen der in der Konfiguration angezeigten Chattabelle verwendet werden.

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

      • Chat-Typ: Der Typ des Chats (z. B. Gruppe oder Einzelchat) und die Chat-Kennung.

      • Beschreibung: Die Beschreibung des Chats, bestehend aus dem Chatthema und einer Liste der Chatmitglieder.

    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.

  • Neuen Chat erstellen: Standardmäßig ist dies nicht ausgewählt und die Aktivität ermöglicht die Auswahl eines vorhandenen Chats.

  • Speichern und beenden: Wenn aktiviert, klicken Sie, 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.

Chat-ID manuell eingeben

Microsoft Teams Chat-Aktivitätskonfiguration, Schritt 1

  • Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede Microsoft Teams Chat-Aktivität eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :.

  • Chat-Auswahl: Wählen Sie eine der beiden Möglichkeiten, um den gesuchten Chat zu identifizieren, entweder Vorhandenen Chat auswählen oder Chat-ID manuell eingeben. Wenn Sie einen neuen Chat erstellen möchten, scrollen Sie nach unten über das nächste Feld hinaus und klicken Sie auf Neuen Chat erstellen.

  • Chat-ID: Geben Sie die Chat-ID ein.

    Tipp

    Felder mit variablem Symbol Unterstützung der Verwendung von globalen 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.

  • Neuen Chat erstellen: Standardmäßig ist dies nicht ausgewählt und die Aktivität ermöglicht die Auswahl eines vorhandenen Chats.

  • Speichern und beenden: Wenn aktiviert, klicken Sie, 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.

Neuen Chat erstellen

Microsoft Teams Chat-Aktivitätskonfiguration, Schritt 1

  • Name: Geben Sie einen Namen zur Identifizierung der Aktivität ein. Der Name muss für jede Microsoft Teams Chat-Aktivität eindeutig sein und darf keine Schrägstriche enthalten / oder Doppelpunkte :.

  • Neuen Chat erstellen: Standardmäßig ist dies nicht ausgewählt und die Aktivität ermöglicht die Auswahl eines vorhandenen Chats. Wählen Sie dies aus, um einen neuen Chat zu erstellen. Wenn ausgewählt, werden die folgenden Optionen verfügbar.

  • Chat-Typ: Wählen Sie zwischen Einzelgespräch und Gruppe als Typ des zu erstellenden Chats.

    • Thema: Wenn ein Gruppen-Chat ausgewählt wurde, kann ein Thema für den Chat eingegeben werden.

  • Email und Rolle angeben: Geben Sie die Emails der Chat-Mitglieder an, entweder als kommagetrennte Liste oder als Tabelle:

    • Bei Verwendung von Geben Sie durch Kommas getrennte Emails im Textfeld an:

      • Email: Geben Sie eine durch Kommas getrennte Liste der Email Adressen der Mitglieder ein, die in den Kanal aufgenommen werden sollen.
      • Eigentümerrolle Wenn ausgewählt, erhalten alle dem Kanal hinzugefügten Mitglieder die Rolle_Eigentümer_. Sie ist standardmäßig ausgewählt. Wenn für verschiedene Mitglieder unterschiedliche Rollen erforderlich sind, verwenden Sie die Tabelleneingabemethode.

      Microsoft Teams - Konfiguration der Aktivität „Mitglieder hinzufügen“ - Schritt 1, neuer Chat mit Feld

    • Wenn Sie Emails mithilfe einer Tabelle bereitstellen verwenden, können Sie mit den Steuerelementen Einträge zur Tabelle hinzufügen und daraus entfernen.

      • Email des Benutzers: Geben Sie die Email Adresse eines Mitglieds ein, das in den Kanal aufgenommen werden soll.
      • Benutzerrolle: Geben Sie eine Rolle für das Mitglied ein. Standardmäßig wird allen Mitgliedern, die dem Kanal hinzugefügt werden, die Rolle_Besitzer_ zugewiesen.

      Microsoft Teams - Konfiguration der Aktivität „Mitglieder hinzufügen“ - Schritt 1, neuer Chat mit Tabelle

      Tipp

      Felder mit einem variablen Symbol Unterstützung der Verwendung von globalen 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.

      Wichtig

      Felder in der Tabelle Emails zeigen das variable Symbol nur im Bearbeitungsmodus. Damit die Variablenwerte dieser Felder zur Laufzeit ausgefüllt werden, muss die Agentenversion mindestens 10.75 / 11.13 sein.

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

  • 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. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemata

Alle vom Endpoint generierten Anforderungs- oder Antwortschemata werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird unten beschrieben. Die angezeigten Anforderungs- und Antwortdatenschemata hängen davon ab, ob Sie in Schritt 1 angegeben haben, einen vorhandenen Chat auszuwählen oder Neuen Chat zu erstellen.

Wenn Sie angegeben haben, dass ein vorhandener Chat ausgewählt werden soll, werden die folgenden Datenschemata angezeigt:

Microsoft Teams Chat-Aktivitätskonfiguration, Schritt 2

Wenn Sie angegeben haben, einen neuen Chat zu erstellen, werden diese Datenschemata angezeigt:

Microsoft Teams Chat-Aktivitätskonfiguration, Schritt 2

  • 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.

  • 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 Editor 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 neu hinzugefügten Knoten und Felder werden auf [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.

  • 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 hierauf, 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.

Nächste Schritte

Nachdem Sie eine Microsoft Teams Chat-Aktivität 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 Chat-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.