Actions dans Microsoft 365

Article
02/14/2024

Remarque

Les actions sont disponibles dans la préversion publique pour les développeurs.
Les actions sont prises en charge pour l’application Microsoft 365 (Office) pour le web et le bureau.

Les actions visent à intégrer votre application dans le flux de travail de votre utilisateur en permettant une découverte facile et une interaction transparente avec son contenu. Les actions permettent une exécution efficace des tâches en dirigeant les utilisateurs vers votre application avec leur intention et leur contenu contextuel. L’intégration améliore la visibilité et l’engagement de votre application avec un effort de développement minimal.

Le graphique suivant est un exemple d’action qui indique à l’utilisateur d’afficher la liste des fournisseurs liés au fichier :

Le graphique montre que l’utilisateur clique avec le bouton droit sur le fichier Excel et sélectionne les fournisseurs associés.

Étapes	Description
1	Dans Microsoft 365, l’utilisateur clique avec le bouton droit sur le fichier Excel. Un menu contextuel s’affiche.
2	L’utilisateur sélectionne Fournisseurs associés pour afficher la liste des fournisseurs de la société Northwind.
3	L’onglet Personnel Northwind s’ouvre avec la liste des fournisseurs mentionnés dans le fichier Excel. L’utilisateur gagne du temps en vérifiant le résultat d’un simple clic sur le fichier Excel sans ouvrir manuellement le fichier à chaque fois.

Comprendre le fonctionnement des actions

Les actions sont générées à l’aide d’une intention, d’un objet et d’un gestionnaire. Lorsqu’un utilisateur vise à effectuer une tâche, elle est appelée Action, et l’action est représentée par l’intention et l’objet . L’intention sert de verbe, décrivant l’action prévue de l’utilisateur, tandis que l’objet est le nom sur lequel l’action est effectuée. Par exemple, l’ouverture d’un fichier est une intention et le fichier est un objet . Vous devez considérer l’intention et l’objet de l’utilisateur comme entrée et créer le gestionnaire approprié pour permettre l’achèvement des tâches pour l’utilisateur.

Pour générer une action, vous devez définir l’intention, l’objet et le gestionnaire dans le manifeste de l’application et utiliser la bibliothèque JavaScript Teams (Teams JS) pour obtenir les détails de l’action afin que les utilisateurs puissent facilement effectuer des tâches spécifiques.

Le tableau suivant répertorie les éléments requis et les informations de prise en charge pour Actions :

Nom	Description	Ce qui est pris en charge dans cette préversion
Intent	L’intention est l’objectif qu’un utilisateur souhaite réaliser ou atteindre. L’intention est généralement représentée par un verbe, tel que `Open`, `Add to`ou toute autre action qu’un utilisateur a l’intention d’effectuer. Microsoft 365 utilise l’intention pour afficher des actions dans des emplacements qui s’alignent sur les besoins et les intentions de l’utilisateur. L’intention détermine l’emplacement des actions.	Vous pouvez créer une intention pour `Open`les actions , `Add to`et `custom` . Vous pouvez utiliser `custom` Action pour créer une action personnalisée.
Objet	L’objet est le fichier sur lequel l’utilisateur souhaite effectuer une action. Object représente le nom ou le contexte qui définit sur quoi l’utilisateur souhaite effectuer une action.	Les actions peuvent être déclenchées sur des objets de contenu (fichiers) qui ont une extension, tels que Word, PowerPoint, Excel, PDF et des images. Les fichiers doivent être disponibles dans OneDrive ou SharePoint et doivent être accessibles via Microsoft Graph.
Gestionnaires	Un gestionnaire fait référence à la méthode permettant de répondre à l’intention de l’utilisateur et d’effectuer l’action souhaitée sur l’objet spécifié. Handler est responsable de l’implémentation de la logique et des fonctionnalités de l’action, garantissant ainsi une expérience utilisateur transparente et significative.	Les actions prennent en charge le `openPage` gestionnaire. Le `openPage` gestionnaire vous permet de guider directement les utilisateurs vers l’onglet personnel de votre application. Le `openPage` gestionnaire vous aide à diriger les utilisateurs vers l’onglet personnel dédié de votre application, en leur fournissant une interface riche et étendue pour atteindre leurs objectifs.

Instructions de conception

Créez des icônes d’application et des noms d’affichage dans un menu contextuel pour Actions. Une seule action montre l’essence de votre application et, en concevant la connexion visuelle entre l’icône de l’application et son nom d’affichage, vous pouvez améliorer l’apparence et la fonction.

Commencez par le nom de l’intention, généralement représenté par un verbe, tel que Open ou Add to et suivi d’un terme qui décrit votre application ou ce que fait votre action.
Vérifiez que la première lettre est en majuscule. Lors de l’utilisation d’un nom de marque, seule la première lettre du nom de marque doit être en majuscule.

L’image suivante est une anatomie d’un emplacement d’icône :

Nom d’affichage

Le tableau suivant fournit des conseils sur les éléments à faire et à ne pas faire pour le nom d’affichage :

✔️ À faire	❌ Ne pas
Ajouter à Todo : Ajouter à représente l’intention et Todo est le nom de l’application.	Évitez d’utiliser Contoso comme seul nom d’application, car il ne transmet pas correctement les fonctionnalités de l’application.
Ouvrir dans Contoso : Ouvrir représente l’intention et Contoso est le nom de l’application.	Ouvrir des fichiers PDF, Word, PPT ou TXT dans Contoso est trop long.
Ajouter au tableau de bord : Ajouter à représente l’intention et Contoso est le nom de l’application. Toutefois, le tableau de bord fournit une description plus précise du cas d’usage.	Document de signature personnalisée : intention personnalisée, il n’est pas nécessaire d’inclure personnalisé dans le nom d’affichage. Commencez par la description de l’intention avec un verbe.
Signatures de demande : commencez par l’intention personnalisée, suivie d’une description complète de l’action. Le nom de marque ou le nom de l’objet, signe Contoso, n’est pas nécessairement obligatoire.
Convertir au format PDF : commencez par l’intention personnalisée, qui est identifiée comme le verbe, pour exprimer clairement l’action dans l’application Contoso.