Zum Inhalt springen

Microsoft Teams Chat-Aktivität in Jitterbit Studio

Einführung

Eine Microsoft Teams Chat-Aktivität verwendet ihre Microsoft Teams-Verbindung, ruft einen vorhandenen Chat ab oder erstellt einen neuen Chat in Microsoft Teams und ist als Ziel zum Verarbeiten von Daten in einem Vorgang vorgesehen.

Microsoft Teams Chat-Aktivität erstellen

Eine Instanz einer Microsoft Teams Chat-Aktivität wird aus einer Microsoft Teams-Verbindung mit ihrem Aktivitätstyp Chat erstellt.

Um eine Aktivitätsinstanz 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 Aktivitäts- oder Tool-Instanz erstellen in Komponentenwiederverwendung.

Eine vorhandene Microsoft Teams Chat-Aktivität kann von diesen Orten aus bearbeitet werden:

Microsoft Teams Chat-Aktivität konfigurieren

Führen Sie diese Schritte aus, 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 wählen Sie aus, ob Sie einen vorhandenen Chat auswählen oder einen neuen Chat erstellen möchten. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben.

Die in diesem Konfigurationsschritt einer Microsoft Teams Chat-Aktivität verwendete Benutzeroberfläche hängt von den ausgewählten Optionen Chat-Auswahl und Neuen Chat erstellen ab:

Vorhandenen Chat auswählen

  • Endpunktmenü: Wenn mehrere Endpunkte desselben Connector-Typs konfiguriert sind, zeigt ein Menü oben auf dem Bildschirm den Namen des aktuellen Endpunkts an. 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 Namen des aktuellen Endpunkts 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 Microsoft Teams Chat-Aktivität eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten.

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

  • Chat auswählen: Dieser Bereich zeigt im Microsoft Teams-Endpunkt verfügbare Chats an.

    • Ausgewählter Chat: Nach Auswahl eines Chats werden sein Typ und seine Kennung hier aufgelistet.

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

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder auf das Wort Aktualisieren, um Chats vom Microsoft Teams-Endpunkt 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 Chat-Tabelle verwendet werden.

  • Chat auswählen: Klicken Sie in der Tabelle auf eine beliebige Stelle in einer 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-Endpunkt abgerufen:

    • Chat-Typ: Der Typ des Chats (z. B. Gruppe oder Eins-zu-Eins) und die Chat-ID.

    • Beschreibung: Die Beschreibung des Chats, bestehend aus dem Chat-Thema und einer Liste der Chat-Mitglieder.

Tipp

Wenn die Tabelle nicht mit verfügbaren Teams gefüllt wird, ist die Microsoft Teams-Verbindung möglicherweise nicht erfolgreich. Stellen Sie sicher, dass Sie verbunden sind, indem Sie die Verbindung erneut öffnen und die Anmeldedaten 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 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 Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Chat-ID manuell bereitstellen

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

  • 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 bereitstellen. 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 einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit 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 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 Änderungen an einem Schritt zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Neuen Chat erstellen

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

  • 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 diese Option ausgewählt ist, werden die folgenden Optionen verfügbar.

  • Chat-Typ: Wählen Sie zwischen Eins-zu-Eins und Gruppe als Chattyp, der erstellt werden soll.

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

  • E-Mail und Rolle bereitstellen: Geben Sie E-Mails für Chat-Mitglieder an, entweder als kommagetrennte Liste oder als Tabelle:

    • Bei Verwendung von Kommagetrennte E-Mails mit Textfeld bereitstellen:
      • E-Mail: Geben Sie eine kommagetrennte Liste von E-Mail-Adressen der Mitglieder ein, die in den Kanal aufgenommen werden sollen.
      • Eigentümerrolle: Wenn diese Option ausgewählt ist, erhalten alle zum Kanal hinzugefügten Mitglieder die Rolle Eigentümer. Dies ist standardmäßig ausgewählt. Wenn unterschiedliche Rollen für verschiedene Mitglieder erforderlich sind, verwenden Sie die Tabelleneingabemethode.

  • Wenn Sie Emails über Tabelle bereitstellen verwenden, nutzen Sie die Steuerelemente, um Einträge in der Tabelle hinzuzufügen oder zu entfernen.

    • E-Mail des Benutzers: Geben Sie die E-Mail-Adresse eines Mitglieds ein, das in den Kanal aufgenommen werden soll.
    • Rolle des Benutzers: Geben Sie eine Rolle für das Mitglied ein. Standardmäßig erhalten alle Mitglieder, die zum Kanal hinzugefügt werden, die Rolle owner.

    Tipp

    Felder mit einem Variablensymbol unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder mit der Eingabe einer öffnenden eckigen Klammer [ in das Feld oder klicken Sie auf das Variablensymbol, um ein Menü mit vorhandenen Variablen anzuzeigen.

    Wichtig

    Felder in der Tabelle Emails zeigen das Variablensymbol nur im Bearbeitungsmodus an. Damit die Variablenwerte dieser Felder zur Laufzeit gefüllt werden, muss die Agent-Version mindestens 10.75 / 11.13 sein.

    Felder in der Tabelle Emails unterstützen nicht die Verwendung von Variablen zum Übergeben von Raw JSON. Wenn Ihr Anwendungsfall das direkte Definieren von Raw JSON in den Feldern nicht unterstützt, maskieren Sie den JSON-Inhalt, bevor Sie ihn mit einer Variablen übergeben. Beispielsweise wird {"success": "true"}; zu {\"success\": \"true\"}; maskiert.

  • 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 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 in einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Datenschemas überprüfen

Alle Anfrage- oder Antwortschemas, die vom Endpunkt generiert werden, werden angezeigt. Jedes Benutzeroberflächenelement dieses Schritts wird nachfolgend beschrieben. Die angezeigten Anfrage- und Antwortdatenschemas hängen davon ab, ob Sie in Schritt 1 angegeben haben, einen vorhandenen Chat auszuwählen oder einen neuen Chat zu erstellen.

Wenn Sie angegeben haben, einen vorhandenen Chat auszuwählen, werden diese Datenschemas angezeigt:

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

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

    Hinweis

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

    Der Microsoft Teams-Connector verwendet die Microsoft Graph REST API v1.0. Informationen zu den Schemaknoten und Feldern finden Sie in der API-Dokumentation.

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

  • Bearbeiten: Klicken Sie auf das Bearbeitungssymbol über jedem Datenschema, um den Editor für dieses Datenschema zu öffnen. Der Editor ermöglicht es Ihnen, Knoten und Felder hinzuzufügen, zu löschen und neu zu organisieren sowie deren Datentypen zu ändern. Alle neu hinzugefügten Knoten und Felder sind auf [0, 1] Kardinalität eingestellt. Änderungen an den Datenschemas müssen für den Endpunkt akzeptabel sein und sollten nur nach Rücksprache mit der verfügbaren Dokumentation für den Endpunkt vorgenommen werden. Nach dem Bearbeiten von Schemas wird oben im entsprechenden Schema ein Datum der letzten Bearbeitung angezeigt, um anzuzeigen, dass das Schema manuell bearbeitet wurde. Das Aktualisieren der Schemas setzt die Schemas auf ihre Standardstrukturen zurück.

  • 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 die an einem Schritt vorgenommenen Änderungen zu speichern. Eine Meldung fordert Sie auf zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nach der Konfiguration einer Microsoft Teams Chat-Aktivität 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 Aktivitätsaktionsmenü in Connector-Grundlagen.

Microsoft Teams Chat-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 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.