Get message

Überblick

Die Aktivität Get Message ruft die Microsoft Graph GetChannelMessage- oder GetChatMessage- API auf

, um eine angegebene Nachricht (MessageId) aus einem Chat (ChatId) oder einem Kanal (ChannelId) und einem Team (TeamID) abzurufen.

Nach dem Durchführen der Suche gibt die Aktivität ihre Eigenschaften in einem ChatMessage -Objekt (Message) aus, das Sie als Eingabevariablen in nachfolgenden Aktivitäten verwenden können (z. B. ChatMessage.Id in Get Message Replies, Reply To Message usw.).

Der Unterschied zwischen dieser Aktivität und der Aktivität Get Messages besteht in der Anforderung, eine bestimmte Nachricht einzugeben (MessageId). Durch Eingabe der MessageId können Sie ein bestimmtes ChatMessage -Objekt anstelle eines Arrays von Objekten abrufen, das in der Aktivität Get Messages zurückgegeben wird.

Wie es funktioniert

Die folgenden Schritte und das folgende Nachrichtensequenzdiagramm sind ein Beispiel dafür, wie die Aktivität von der Entwurfszeit (d. h. den Aktivitätsabhängigkeiten und Eingabe-/Ausgabeeigenschaften) bis zur Laufzeit funktioniert.

1. Schließen Sie die Einrichtungsschritte ab.
2. Fügen Sie die Aktivität Microsoft Teams Scope zu Ihrem Projekt hinzu.
3. Führen Sie eine der beiden folgenden Optionen aus (A oder B):

A. Fügen Sie eine Aktivität hinzu, oder führen Sie einen externen Prozess aus, der einen Chat.Id -Wert ausgibt (z. B. Get Chats).

B. Fügen Sie eine Aktivität hinzu, oder führen Sie einen externen Prozess aus, der einen Team.Id -Wert ausgibt (z. B.Get Teams) UND eine Aktivität oder einen externen Prozess, der einen Channel.Id -Wert ausgibt (z. B. Get Channels).

1. Fügen Sie die Aktivität Get Message innerhalb der Aktivität Microsoft Teams Scope hinzu.
2. Geben Sie Werte für die Eigenschaften „ Kanal ODER Chat“ und „Eingabe “ ein.
3. Erstellen und geben Sie eine ChatMessage -Variable für Ihre Ausgabeeigenschaft ein.

4. Führen Sie die Aktivität aus.

   • Ihre Eingabeeigenschaftswerte werden an die GetChannelMessage- oder GetChatMessage- API gesendet.
   • Die API gibt den Wert ChatMessage an Ihre Ausgabeeigenschaftsvariable zurück.
     
     

     

     
     

Eigenschaften

Die Werte für die folgenden Eigenschaften werden beim Hinzufügen dieser Aktivität zu Ihrem Projekt in UiPath Studio angegeben.

Allgemein

DisplayName

Der Anzeigename der Aktivität.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Get Messages
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Keine Angabe

Kanal

Team ID

Die ID des Team -Objekts, das den Kanal enthält, von dem Sie Nachrichten abrufen möchten.

Attribute	Details
Typ	String
Erforderlich	Ja (wenn ChatId leer ist)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Um den Team.Id -Wert abzurufen, verwenden Sie einen externen Prozess oder eine externe Aktivität, der/die den Team.Id -Wert in der Ausgabe enthält (z. B. „ Get Teams “ oder ein externer API-Aufruf). Entweder (ChatId) oder (TeamId und KanalID) ist erforderlich.

Channel ID

Die ID des Channel -Objekts, von dem Sie die Nachricht abrufen möchten.

Attribute	Details
Typ	String
Erforderlich	Ja (wenn TeamId einen Wert hat)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Um den Channel.Id -Wert abzurufen, verwenden Sie einen externen Prozess oder eine externe Aktivität, die den Channel.Id -Wert in der Ausgabe enthält (z. B. Kanäle abrufen oder externer API-Aufruf). Entweder (ChatId) oder (TeamId und KanalID) ist erforderlich.

Chat

ChatId

Die ID des Chat -Objekts, an das Sie die Nachricht senden möchten.

Attribute	Details
Typ	String
Erforderlich	Ja (wenn TeamId und KanalID leer sind)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Um den Wert Chat.Id abzurufen, verwenden Sie einen externen Prozess oder eine externe Aktivität, der/die den Wert Chat.Id in seiner Ausgabe enthält (z. B. „ Get Chats “ oder ein externer API-Aufruf). Entweder (ChatId) oder (TeamId und KanalID) ist erforderlich.

Eingabe

NachrichtenID

Die ID der Nachricht, die Sie abrufen möchten.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Um den Message.Id -Wert abzurufen, verwenden Sie einen externen Prozess oder eine externe Aktivität, der/die den Message.Id -Wert in der Ausgabe enthält (z. B. Get Messages oder externer API-Aufruf).

Sonstiges

Private

Falls ausgewählt werden die Werte von Variablen und Argumenten nicht mehr auf ausführlicher Ebene protokolliert.

Attribute	Details
Typ	Kontrollkästchen
Erforderlich	Nein
Standardwert	nicht ausgewählt
Zulässige Werte	Ausgewählt oder nicht ausgewählt
Hinweise	Keine Angabe

Ausgabe

Meldung

Das ChatMessage -Objekt, das die in der MessageId- Eigenschaft angegebene Nachricht darstellt.

Attribute	Details
Typ	ChatMessage
Erforderlich	Nein (erforderlich, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten)
Standardwert	Leer
Zulässige Werte	Geben Sie eine ChatMessage -Variable ein.
Hinweise	Die Variable, die Sie für diese Eigenschaft erstellen, kann als Eingabevariable in nachfolgenden Aktivitäten verwendet werden (z. B. Get Message Replies, Reply To Message usw.). Das ChatMessage -Objekt enthält mehrere Eigenschaften , die Sie in anderen Aktivitäten verwenden können. Die folgende Beispielabbild zeigt einige der Eigenschaften, die Sie zurückgeben können. Hinweis – Einige im Designer aufgeführte Eigenschaften gelten nicht für das ChatMessage -Objekt (z. B. ODatatType). Eine Liste der anwendbaren Team -Eigenschaften finden Sie unter den obigen Links.

Beispiel

Die folgende Abbildung zeigt ein Beispiel für die Aktivitätsabhängigkeitsbeziehung und Eingabe-/Ausgabe-Eigenschaftswerte.

Schritt-für-Schritt-Anweisungen und Beispiele finden Sie in den Schnellstartanleitungen .