Office.NotificationMessageAction interface
Définition de l’action pour un message de notification.
Remarques
[ Ensemble d’API : Boîte aux lettres 1.10 ]
Niveau d’autorisation minimal : élément de lecture
Mode Outlook applicable : Rédiger ou Lire
Important : dans les Outlook sur le web modernes, l’objet NotificationMessageAction
est disponible uniquement en mode Composition.
Exemples
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/outlook/35-notifications/add-getall-remove.yaml
// Adds an informational message with actions to the mail item.
const id = $("#notificationId").val().toString();
const itemId = Office.context.mailbox.item.itemId;
const details = {
type: Office.MailboxEnums.ItemNotificationMessageType.InsightMessage,
message: "This is an insight notification with id = " + id,
icon: "icon1",
actions: [
{
actionText: "Open insight",
actionType: Office.MailboxEnums.ActionType.ShowTaskPane,
// Identify whether the current mail item is in read or compose mode to set the appropriate commandId value.
commandId: (itemId == undefined ? "PG.HelpCommand.Compose" : "PG.HelpCommand.Read"),
contextData: { a: "aValue", b: "bValue" }
}
]
};
Office.context.mailbox.item.notificationMessages.addAsync(id, details, handleResult);
Propriétés
action |
Texte du lien d’action. |
action |
Type d’action à effectuer. |
command |
Bouton défini dans le manifeste. |
context |
Toutes les données JSON que le bouton d’action doit transmettre au complément. |
Détails de la propriété
actionText
Texte du lien d’action.
actionText: string;
Valeur de propriété
string
actionType
Type d’action à effectuer. ActionType.ShowTaskPane
est la seule action prise en charge.
actionType: string | MailboxEnums.ActionType;
Valeur de propriété
string | Office.MailboxEnums.ActionType
commandId
Bouton défini dans le manifeste.
commandId: string;
Valeur de propriété
string
contextData
Toutes les données JSON que le bouton d’action doit transmettre au complément.
contextData: any;
Valeur de propriété
any
Remarques
Important:
Dans Outlook sur Windows, le
any
type est pris en charge à partir de la version 2402 (build 17308.20000). Dans les versions antérieures d’Outlook sur Windows, seul lestring
type est pris en charge.Pour récupérer les données JSON, appelez
Office.context.mailboxitem.getInitializationContextAsync
. Si vous créez une chaîne JSON à l’aideJSON.stringify()
de et que vous l’attribuez à lacontextData
propriété , vous devez analyser la chaîne à l’aideJSON.parse()
de une fois que vous l’avez récupérée.
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour