Présentation des types d’actions disponibles pour la fonctionnalité Messages actionnables d’Outlook

Effectué

Les messages actionnables dans Outlook sont basés sur le format de carte adaptative. Outlook étend le schéma de carte adaptative standard pour définir des actions supplémentaires pour la prise en charge de scénarios de messages interactifs.

Dans cette unité, nous examinons les actions Outlook spécifiques suivantes.

  • Action.Http
  • Action.InvokeAddInCommand
  • Action.DisplayMessageForm
  • Action.DisplayAppointmentForm
  • Action.ToggleVisibility

Action.Http

L’action Action.Http est l’action fondamentale utilisée pour faire interagir un message interactif avec votre service. Cette action envoie un billet HTTP à votre service et peut inclure une entrée d’utilisateur.

Votre service peut fournir une nouvelle carte en réponse à cette action, appelée carte d’actualisation. La carte d’actualisation remplace définitivement la carte dans ce message électronique. Les cartes d’actualisation sont généralement utilisées pour signaler l’état précédent de l’action. Par exemple, lorsqu’un destinataire répond à un messages actionnables d’enquête, celui-ci peut renvoyer une carte pour y répondre.

Une action Action.Http peut également être réglée pour s’exécuter automatiquement lorsque l’utilisateur ouvre le message. Le résultat de l’action contient une nouvelle carte, mise à jour avec les informations les plus récentes. Par exemple, si un outil de rapport de dépenses envoie une demande d'approbation à plusieurs approbateurs, la carte appelle automatiquement une action pour interroger le service et déterminer si un utilisateur a déjà approuvé le rapport. Dans ce cas, il peut remplacer la carte demandant au destinataire d’approuver par une carte qui l’a approuvée et à quel moment.

{
  "type": "Action.Http",
  "title": "Send Feedback",
  "method": "POST",
  "url": "https://...",
  "body": "{{feedbackText.value}}"
}

Action.InvokeAddInCommand

L’action Action.InvokeAddInCommand appelle un complément Outlook du volet Office. Elle prend en charge l’installation en un clic du complément. Par conséquent, il n’est pas nécessaire que le complément soit déjà installé sur le destinataire.

Cette action peut être utilisée pour :

  • Activer les scénarios qui nécessitent des interactions utilisateur plus complexes qui ne conviennent pas au schéma de message exploitable, tout en gardant l'utilisateur dans Outlook en appelant un complément.
  • Aider l’adoption de votre complément Outlook en offrant aux destinataires la possibilité d’installer votre complément d’un simple clic et de l’utiliser pour répondre à une demande d’action.
{
  "type": "Action.InvokeAddInCommand",
  "title": "Create Support Ticket with Contoso Support",
  "addInId": "527104a1-f1a5-475a-9199-7a968161c870",
  "desktopCommandId": "openTicketPane",
  "initializationContext": {
    "referenceNumber": "REF039420",
    "bucketId": 2,
    "priority": "normal"
  }
}

Action.DisplayMessageForm et Action.DisplayAppointmentForm

Les actions Action.DisplayMessageForm et Action.DisplayAppointmentForm sont utilisées pour ouvrir un message électronique ou un rendez-vous existant dans la boîte aux lettres du destinataire.

{
  "type": "Action.DisplayMessageForm",
  "title": "Show me the message",
  "itemId": "AAMkAGUy...g3BZAAA="
}

Action.ToggleVisibility

L’action Action.ToggleVisibility permet d'afficher et/ou de masquer des éléments spécifiques d'une carte à la suite d'un clic d'un utilisateur sur un bouton ou un autre élément actionnable.

{
  "type": "Action.ToggleVisibility",
  "title": "Show only unassigned issues",
  "targetElements": [
    "assignedIssues"
  ]
}