Send channel message

Beschreibung

Sendet eine Nachricht in einem Teamkanal.

Projektkompatibilität

Windows | Plattformübergreifend

Konfiguration

• Verbindung – Die im Integration Service hergestellte Verbindung. Greifen Sie auf das Dropdown-Menü zu, um Verbindungen auszuwählen, hinzuzufügen oder zu verwalten.

• Wählen Sie Zur Objektansicht wechseln aus, um Ihre Daten mit dem Datenzuordnungs-Editor zu erkunden und zuzuordnen .

• Team-ID – Die ID des Teams, dem der Kanal angehört. Geben Sie den Namen des Teams ein, um es aus der verfügbaren Dropdownliste abzurufen, oder geben Sie eine benutzerdefinierte Team-ID ein. Sie können die ID aus der Ausgabe der Aktivität Get Team by Name abrufen. Dieses Feld unterstützt die Eingabe vom Typ String .
• Kanal-ID – Die ID des Kanals, an den die Nachricht gesendet werden soll. Geben Sie den Namen des Kanals ein, um ihn aus der verfügbaren Dropdownliste abzurufen, oder geben Sie eine Kanal-ID ein. Sie können die ID aus der Ausgabe der Aktivität Get Channel by Name abrufen. Dieses Feld unterstützt die Eingabe vom Typ String .
• Nachrichtentext – Der Inhalt der Nachricht, die Sie senden möchten. Dieses Feld unterstützt die Eingabe vom Typ String .
• Anpassungsfähiges Karten-JSON – Geben Sie den anpassungsfähigen Kartenstring ein, indem Sie das generierte JSON-Objekt von https://adaptivecards.io/designer konvertieren. Ersetzen Sie \" durch ' und entfernen Sie alle Escape-Zeichen, die '\' enthalten, z. B. \n, \r. Ersetzen Sie beispielsweise \r\n\"type\" durch 'type'. Weitere Informationen finden Sie in der Microsoft Teams API-Dokumentation und in der Dokumentation zu Adaptativen Karten.
• Bild – Der Bildanhang, den Sie hochladen möchten. Dieses Feld unterstützt die Eingabe vom Typ IResource .
• Datei-ID – Geben Sie eine oder mehrere SharePoint-Datei-IDs in einem durch Kommas getrennten Format ein. Sie können diese ID aus der Ausgabe von Get File oder Folder oder Upload Files (Microsoft 365-Aktivitäten) abrufen. Dieses Feld unterstützt die Eingabe vom Typ String .

Eigenschaften verwalten

Verwenden Sie den Assistenten Eigenschaften verwalten , um Standard- oder benutzerdefinierte Felder des Objekts zu konfigurieren oder zu verwenden. Sie können Felder auswählen, um sie der Aktivitäts-Canvas hinzuzufügen. Die hinzugefügten Standard- oder benutzerdefinierten Felder sind im Eigenschaftenbereich (in Studio Desktop) oder unter Zusätzliche Eigenschaften anzeigen (in Studio Web) verfügbar.

Zusätzliche Eigenschaften

Optionen

• Erwähnungs-ID – Numerischer Bezeichner, der <at> -Tags im Nachrichtentext mit Erwähnungseinträgen verknüpft. Muss mit dem id -Attribut im <at> -HTML-Tag übereinstimmen. Mögliche Werte: 0, 1, 2 usw.
• Erwähnungen Erwähnungstext – Anzeigename, der in der Erwähnung angezeigt wird. Text zwischen <at> -Tags muss übereinstimmen. Zum Beispiel: John Doe.
• Erwähnt wird der Anzeigename des Benutzers – Der vollständige Anzeigename des Benutzers von Azure AD. Beispiel: John Doe.
• Erwähnung erwähnt Benutzer-ID – Azure AD-Objekt-ID des Benutzers (eindeutiger Bezeichner des AAD-Benutzers). Beispiel: 74a49af0-e4a2-43d6-9d83-52f5f0.
• Erwähnung erwähnt Benutzer Identitätstyp – Gibt den Identitätstyp an. Häufige Werte: member, aadUser, onPremiseAadUser, guest. Der Standardwert für reguläre Teammitglieder ist member.

Ausgabe

• Nachrichten-ID – Die ID der Nachricht, an die in Teams eine Antwort gesendet werden soll. Automatisch generierte Ausgabevariable.
• Web-URL - Die Web-URL der Nachricht. Automatisch generierte Ausgabevariable.
• Nachricht – Kanalnachricht. Automatisch generierte Ausgabevariable.

Verwenden von Benutzererwähnungen

Um einen Benutzer in Ihrer Teams-Kanalnachricht zu erwähnen, müssen Sie sowohl den Nachrichtentext als auch die Erwähnungseigenschaften konfigurieren.

Hinweis: Das Erwähnen von Tags wird derzeit nicht unterstützt. Sie können nur Benutzer erwähnen.

1. Formatieren Sie den Nachrichtentext.
   Fügen Sie die Erwähnung mithilfe von HTML- <at> -Tags mit einem id -Attribut ein:

   "Hello <at id=\"0\">John Doe</at>, please review this."

2. Konfigurieren Sie Erwähnungseigenschaften wie in der folgenden Tabelle.

   Eigenschaften	Wert	Beschreibung
   Erwähnungs-ID	0	Numerischer Bezeichner (Erhöheung bei mehreren Erwähnungen)
   Erwähnungen Erwähnungstext	Max Mustermann	Anzeigename, der in der Erwähnung angezeigt wird
   Erwähnt den Anzeigenamen des Benutzers	Max Mustermann	Vollständiger Name des Benutzers von Azure AD
   Erwähnung der Benutzer-ID	{AAD-Objekt-ID}	Azure AD Objekt-ID des Benutzers (s.u.)
   Erwähnt den Benutzeridentitätstyp	Mitglied	Identitätstyp (member/aadUser/Gast)

   So erhalten Sie die Azure AD-Objekt-ID:

   • Azure Portal – Navigieren Sie zu Azure Active Directory > Benutzer > {User}> Objekt-ID kopieren.
   • Microsoft Graph-API – GET https://graph.microsoft.com/v1.0/users/{userPrincipalName}
   • PowerShell – Get-AzureADUser -ObjectId "[e-mail]" | Select ObjectId

Beispielkonfiguration zur Erwähnung des Benutzers „Jane Smith“:

• Meldungstext: "Task completed <at id=\"0\">Jane Smith</at>"
• Erwähnungs-ID: 0
• Erwähnungen Erwähnungstext: "Jane Smith"
• Erwähnungen erwähnt Benutzer Anzeigename: "Jane Smith"
• Erwähnungen erwähnt Benutzer-ID: "ef1c916a-3135-4417-ba27-8eb7bd084193"
• Erwähnungen erwähnt Benutzeridentitätstyp: "member"

Hinweis:

• Pro Aktivitätsinstanz kann nur ein Benutzer erwähnt werden.
• Der id im <at> -Tag muss mit der Eigenschaft Erwähnungs-ID übereinstimmen.
• Eine falsche Azure AD-Objekt-ID führt dazu, dass die Erwähnung fehlschlägt.
• Stellen Sie sicher, dass Ihr Bot/Ihre App über Berechtigungen verfügt, um Benutzer im Kanal zu erwähnen.