Aktualisieren einer Nachricht, die aktionenfähig ist, wenn der Benutzer sie öffnet

Wichtig

Das Onboarding von neuen Anbietern für aktionenfähige Nachrichten im Global-Bereich wird aufgrund von Dienstupgrades vorübergehend bis zum 30. Juni 2024 angehalten. Vorhandene globale Anbieter und das Onboarding von Organisations- und Testbereichsanbietern sind nicht betroffen. Weitere Informationen finden Sie unter Häufig gestellte Fragen zu Aktionen erfordernden Nachrichten.

Nachrichten mit Aktionen ermöglichen Es Benutzern, schnelle Aktionen für eine E-Mail-Nachricht zu ergreifen, die häufig auf Daten basieren, die im Karte dargestellt werden. Manchmal ändern sich jedoch Daten, nachdem die Nachricht mit Aktionen gesendet wurde. Ihr Dienst kann z. B. eine Umsetzbare Nachricht an mehrere genehmigende Personen senden, die sie auffordern, eine Anforderung zu genehmigen oder abzulehnen. Eine genehmigende Person genehmigt die Anforderung, aber die Umsetzbare Nachricht im Postfach der anderen genehmigenden Person fordert weiterhin zur Genehmigung auf. Mit der autoInvokeAction -Eigenschaft für Nachrichten mit Aktionen können Sie nun einen HTTP-Endpunkt bereitstellen, um eine aktuelle Adaptive Card-Nutzlast mit den neuesten Informationen abzurufen, wenn der Benutzer die E-Mail in Outlook öffnet.

Wichtig

Das Aktualisieren der Nachricht, die aktionenfähig ist, wenn der Benutzer sie öffnet, hat direkte Auswirkungen auf die wahrgenommene Leistung Ihrer Umsetzbaren Nachrichtenlösung. Es ist von entscheidender Bedeutung, dass Ihr Dienst, der die aktualisierten Karte bereitstellt, die unter Implementieren der Web-API beschriebenen Leistungsanforderungen erfüllt.

Registrierungsanforderungen

Aktionen erfordernde Nachrichtendienste, die im Entwickler-Dashboard mit dem Bereich "Testbenutzer" oder "Organisation" registriert sind, können dieses Feature verwenden, sobald sie genehmigt wurden. Wenn Ihr Dienst im Global-Bereich registriert ist, müssen Sie sich an wenden onboardoam@microsoft.com , um dieses Feature zu aktivieren.

Verwenden von autoInvokeAction

Um dieses Feature verwenden zu können, muss Ihr Karte das Format adaptiver Karten verwenden. Die autoInvokeAction-Eigenschaft ist eine Outlook-spezifische Eigenschaft, die dem AdaptiveCard-Typ hinzugefügt wird. Der Wert dieser Eigenschaft ist eine Action.Http-Aktion , bei der auf methodPOSTfestgelegt ist. Die url -Eigenschaft gibt einen Web-API-Endpunkt in Ihrem Dienst an, der die aktualisierte Nutzlast der adaptiven Karte bereitstellt.

{
  "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
  "type": "AdaptiveCard",
  "version": "1.0",
  "body": [...],
  "actions": [...],
  "autoInvokeAction": {
    "method": "POST",
    "url": "https://actionablemessages.contoso.com/api/getupdatedcard",
    "body": "",
    "type": "Action.Http"
  }
}

Erstellen der anfänglichen adaptiven Karte

Bei der Verwendung von autoInvokeAction ist es sehr wichtig, dass die anfängliche Karte, die in der Nachricht enthalten ist, für den Endbenutzer weiterhin wertvoll und im Idealfall umsetzbar ist. Die autoInvokeAction kann fehlschlagen, oder Netzwerkbedingungen können es verlangsamen. In diesem Fall wird der anfängliche Karte dem Endbenutzer angezeigt.

• Senden Sie keine leere anfängliche Karte nur mit .autoInvokeAction Solche Karten werden von der Plattform für aktionenfähige Nachrichten abgelehnt.
• Senden Sie keinen anfänglichen Karte, bei dem es sich nur um einen Platzhalter handelt, der den Benutzer zum Warten auffordern wird.
• Senden Sie eine anfängliche Karte, die die Informationen im aktuellen Zustand darstellt, auch wenn dies bedeutet, dass dem Benutzer möglicherweise veraltete Daten angezeigt werden, wenn er ihre Nachricht öffnet.

Implementieren der Web-API

Die Action.Http in der autoInvokeAction -Eigenschaft angegebene Aktion funktioniert genauso wie jede andere Action.Http Aktion. Ausführliche Informationen zum Implementieren des Endpunkts für diese Aktion finden Sie unter Implementieren der Web-API.

Der Endpunkt für muss autoInvokeAction auch die folgenden zusätzlichen Anforderungen erfüllen.

• Anforderungen müssen innerhalb von 2 Sekunden zurückgegeben werden.
• Anforderungen, die länger dauern, werden vom Client ignoriert, und die ursprüngliche Karte wird weiterhin angezeigt. Die Meldung wird weiterhin auf dem Server aktualisiert.
• Erfolgreiche Antworten sollten einen CARD-UPDATE-IN-BODY Header mit einem Wert true und eine JSON-Nutzlast für adaptive Karten enthalten.

Bei Erfolg ersetzt die zurückgegebene adaptive Karte die vorhandene Karte in der E-Mail-Nachricht vollständig. Wenn die URL einen Fehler zurückgibt oder ein Zeitüberschreitung auftritt, wird die vorhandene Karte weiterhin angezeigt.

Beispiel für ein Genehmigungsszenario

Betrachten Sie dieses Beispiel einer Urlaubsanfrage Karte von einem Urlaubsanforderungstool generiert und an den Vorgesetzten des Mitarbeiters gesendet.

Tipp

Sie können auf den JSON-Code zugreifen und dieses Karte Beispiel ändern, indem Sie das Urlaubsgenehmigungsbeispiel im Designer Aktion erfordernde Nachricht auswählen.

Die Karte enthält Informationen, die dem Vorgesetzten bei der Entscheidungsfindung helfen, einschließlich der angeforderten Termine und der verbleibenden Urlaubszeit des Mitarbeiters. Diese Informationen waren genau, als die Nachricht generiert und gesendet wurde. Die Daten können sich jedoch ändern, bevor der Manager seine E-Mail überprüft. Beispielsweise kann der Mitarbeiter seine Anforderung im Tool für die Urlaubsanfrage bearbeiten, um die angeforderten Datumsangaben zu ändern.

Indem Sie eine autoInvokeAction -Eigenschaft in die vom Tool generierte Aktion erfordernde Nachricht einfügen, wird Ihre Karte mit den ursprünglichen Daten durch eine neue Karte mit neuen Daten ersetzt, wenn der Manager sie öffnet. Die in autoInvokeAction angegebene URL gibt die gleiche JSON-Nutzlast mit neuen Werten für die angeforderten Urlaubsdaten zurück.