Ce navigateur n’est plus pris en charge.
Effectuez une mise à niveau vers Microsoft Edge pour tirer parti des dernières fonctionnalités, des mises à jour de sécurité et du support technique.
L’application de la signature correcte aux messages lors de l’utilisation de plusieurs comptes Exchange est désormais facilitée par l’ajout des OnMessageFromChanged événements et OnAppointmentFromChanged à la fonctionnalité d’activation basée sur les événements . L’événement OnMessageFromChanged se produit lorsque le compte dans le champ De d’un message en cours de composition est modifié, tandis que l’événement OnAppointmentFromChanged se produit lorsque l’organisateur d’une réunion en cours de composition est modifié. Ces événements étendent davantage les fonctionnalités des compléments de signature et leur permettent d’effectuer les opérations suivantes :
Les sections suivantes vous guident tout au long du développement d’un complément basé sur des événements qui gère l’événement pour mettre à jour automatiquement la OnMessageFromChanged signature d’un message lorsque le compte de messagerie dans le champ De est modifié.
Notes
Les OnMessageFromChanged événements et OnAppointmentFromChanged ont été introduits dans l’ensemble de conditions requises 1.13. Pour plus d’informations sur la prise en charge des clients pour ces événements, consultez Clients et plateformes pris en charge.
Les tableaux suivants répertorient les combinaisons client-serveur qui prennent en charge les OnMessageFromChanged événements et OnAppointmentFromChanged . Sélectionnez l’onglet correspondant à l’événement applicable.
| Client | Exchange Online | Exchange 2019 en local (mise à jour cumulative 12 ou ultérieure) | Exchange 2016 en local (mise à jour cumulative 22 ou ultérieure) |
|---|---|---|---|
|
Navigateur web (interface utilisateur moderne) nouvel Outlook sur Windows |
Pris en charge | Non applicable | Non applicable |
|
Windows (classique) Version 2304 (build 16327.20248) ou ultérieure |
Pris en charge | Pris en charge | Pris en charge |
|
Mac Version 16.77 (23081600) ou ultérieure |
Pris en charge | Non applicable | Non applicable |
| iOS | Non applicable | Non applicable | Non applicable |
| Android | Non applicable | Non applicable | Non applicable |
Pour tester la procédure pas à pas, vous devez disposer d’au moins deux comptes Exchange.
Suivez le guide de démarrage rapide Outlook, qui crée un projet de complément avec le générateur Yeoman pour les compléments Office.
Ouvrez le fichier manifest.json .
Accédez au tableau « authorization.permissions.resourceSpecific ». Dans l’objet tableau, remplacez la valeur de la propriété « name » par « MailboxItem.ReadWrite.User ». Le complément en a besoin pour pouvoir mettre à jour la signature d’un message.
...
"authorization": {
"permissions": {
"resourceSpecific": [
{
"name": "MailboxItem.ReadWrite.User",
"type": "Delegated"
}
]
}
},
...
Ajoutez l’objet suivant au tableau « extensions.runtimes ». Notez les points suivants concernant ce balisage.
La « minVersion » de l’ensemble de conditions requises mailbox est configurée comme « 1.13 », car il s’agit de la version la plus basse de l’ensemble de conditions requises qui prend en charge l’événement OnMessageFromChanged . Pour plus d’informations, consultez le tableau « Événements pris en charge » dans Configurer votre complément Outlook pour l’activation basée sur les événements.
L'« id » du runtime est défini sur un nom descriptif, « autorun_runtime ».
La propriété « code » a une propriété « page » enfant définie sur un fichier HTML et une propriété « script » enfant définie sur un fichier JavaScript. Vous allez créer ou modifier ces fichiers dans les étapes ultérieures. Office utilise l’une de ces valeurs en fonction de la plateforme.
<script> balise qui charge ensuite le fichier JavaScript.Pour plus d’informations, voir Runtimes dans les compléments Office.
La propriété « lifetime » est définie sur « short ». Cela signifie que le runtime démarre lorsque l’événement se produit et s’arrête lorsque le gestionnaire se termine.
Il existe des « actions » pour exécuter des gestionnaires pour les OnMessageFromChanged événements et OnNewMessageCompose . Vous allez créer les gestionnaires dans une étape ultérieure.
{
"requirements": {
"capabilities": [
{
"name": "Mailbox",
"minVersion": "1.13"
}
]
},
"id": "autorun_runtime",
"type": "general",
"code": {
"page": "https://localhost:3000/commands.html",
"script": "https://localhost:3000/launchevent.js"
},
"lifetime": "short",
"actions": [
{
"id": "onMessageFromChangedHandler",
"type": "executeFunction",
"displayName": "onMessageFromChangedHandler"
},
{
"id": "onNewMessageComposeHandler",
"type": "executeFunction",
"displayName": "onNewMessageComposeHandler"
}
]
}
Ajoutez un tableau « autoRunEvents » en tant que propriété de l’objet dans le tableau « extensions ». Le tableau « autoRunEvents » contient un objet avec les propriétés clés suivantes.
OnMessageFromChanged événements et OnNewMessageCompose . Pour plus d’informations sur les noms d’événements utilisés dans le manifeste unifié, consultez le tableau « Événements pris en charge » dans Configurer votre complément Outlook pour l’activation basée sur les événements."autoRunEvents": [
{
"requirements": {
"capabilities": [
{
"name": "Mailbox",
"minVersion": "1.13"
}
],
"scopes": [
"mail"
]
},
"events": [
{
"type": "messageFromChanged",
"actionId": "onMessageFromChangedHandler"
},
{
"type": "newMessageComposeCreated",
"actionId": "onNewMessageComposeHandler"
}
]
}
]
Conseil
Les gestionnaires d’événements doivent être configurés pour les OnNewMessageCompose événements et OnMessageFromChanged . La onNewMessageComposeHandler fonction ajoute une signature à un message nouvellement créé si un message par défaut n’est pas déjà configuré sur le compte actuel. Lorsque le compte dans le champ De est modifié, la onMessageFromChangedHandler fonction met à jour la signature en fonction du compte nouvellement sélectionné.
À partir du même projet de démarrage rapide, accédez au répertoire ./src , puis créez un dossier nommé launchevent.
Dans le dossier ./src/launchevent , créez un fichier nommé launchevent.js.
Ouvrez le fichier ./src/launchevent/launchevent.js dans votre éditeur de code et ajoutez le code JavaScript suivant.
/*
* Copyright (c) Microsoft Corporation. All rights reserved. Licensed under the MIT license.
* See LICENSE in the project root for license information.
*/
// The OnNewMessageCompose event handler that adds a signature to a new message.
function onNewMessageComposeHandler(event) {
const item = Office.context.mailbox.item;
// Check if a default Outlook signature is already configured.
item.isClientSignatureEnabledAsync({ asyncContext: event }, (result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.log(result.error.message);
return;
}
// Add a signature if there's no default Outlook signature configured.
if (result.value === false) {
item.body.setSignatureAsync(
"<i>This is a sample signature.</i>",
{ asyncContext: result.asyncContext, coercionType: Office.CoercionType.Html },
addSignatureCallback
);
}
});
}
// The OnMessageFromChanged event handler that updates the signature when the email address in the From field is changed.
function onMessageFromChangedHandler(event) {
const item = Office.context.mailbox.item;
const signatureIcon =
"iVBORw0KGgoAAAANSUhEUgAAACcAAAAnCAMAAAC7faEHAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAAzUExURQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKMFRskAAAAQdFJOUwAQIDBAUGBwgI+fr7/P3+8jGoKKAAAACXBIWXMAAA7DAAAOwwHHb6hkAAABT0lEQVQ4T7XT2ZalIAwF0DAJhMH+/6+tJOQqot6X6joPiouNBo3w9/Hd6+hrYnUt6vhLcjEAJevVW0zJxABSlcunhERpjY+UKoNN5+ZgDGu2onNz0OngjP2FM1VdyBW1LtvGeYrBLs7U5I1PTXZt+zifcS3Icw2GcS3vxRY3Vn/iqx31hUyTnV515kdTfbaNhZLI30AceqDiIo4tyKEmJpKdP5M4um+nUwfDWxAXdzqMNKQ14jLdL5ntXzxcRF440mhS6yu882Kxa30RZcUIjTCJg7lscsR4VsMjfX9Q0Vuv/Wd3YosD1J4LuSRtaL7bzXGN1wx2cytUdncDuhA3fu6HPTiCvpQUIjZ3sCcHVbvLtbNTHlysx2w9/s27m9gEb+7CTri6hR1wcTf2gVf3wBRe3CMbcHYvTODkXhnD0+178K/pZ9+n/C1ru/2HAPwAo7YM1X4+tLMAAAAASUVORK5CYII=";
// Get the currently selected From account.
item.from.getAsync({ asyncContext: event }, (result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.log(result.error.message);
return;
}
// Create a signature based on the currently selected From account.
const name = result.value.displayName;
const options = { asyncContext: { event: result.asyncContext, name: name }, isInline: true };
item.addFileAttachmentFromBase64Async(signatureIcon, "signatureIcon.png", options, (result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.log(result.error.message);
return;
}
// Add the created signature to the mail item.
const signature = "<img src='cid:signatureIcon.png'>" + result.asyncContext.name;
item.body.setSignatureAsync(
signature,
{ asyncContext: result.asyncContext.event, coercionType: Office.CoercionType.Html },
addSignatureCallback
);
});
});
}
// Callback function to add a signature to the mail item.
function addSignatureCallback(result) {
if (result.status === Office.AsyncResultStatus.Failed) {
console.log(result.error.message);
return;
}
console.log("Successfully added signature.");
result.asyncContext.completed();
}
// IMPORTANT: To ensure your add-in is supported in Outlook, remember to
// map the event handler name specified in the manifest's LaunchEvent element (with the add-in only manifest)
// or the "autoRunEvents.events.actionId" property (with the unified manifest for Microsoft 365)
// to its JavaScript counterpart.
Office.actions.associate("onNewMessageComposeHandler", onNewMessageComposeHandler);
Office.actions.associate("onMessageFromChangedHandler", onMessageFromChangedHandler);
Important
Windows : À l’heure actuelle, les importations ne sont pas prises en charge dans le fichier JavaScript dans lequel vous implémentez la gestion de l’activation basée sur les événements.
Conseil
Les compléments basés sur les événements s’exécutant dans Outlook classique sur Windows n’exécutent pas de code inclus dans les Office.onReady() fonctions et Office.initialize . Nous vous recommandons d’ajouter votre logique de démarrage de complément, par exemple vérifier la version d’Outlook de l’utilisateur, à vos gestionnaires d’événements à la place.
Dans le dossier ./src/commands , ouvrez commands.html.
Ajoutez le code suivant sous la balise de script existante.
<script type="text/javascript" src="../launchevent/launchevent.js"></script>
Enregistrez vos modifications.
Dans le répertoire racine du projet, ouvrez le fichier webpack.config.js .
Recherchez le plugins tableau dans l’objet config et ajoutez le nouvel objet suivant au début du tableau.
new CopyWebpackPlugin({
patterns: [
{
from: "./src/launchevent/launchevent.js",
to: "launchevent.js",
},
],
}),
Enregistrez vos modifications.
Exécutez les commandes suivantes dans le répertoire racine de votre projet. Lorsque vous exécutez npm start, le serveur web local démarre (s’il n’est pas déjà en cours d’exécution) et votre complément est chargé de manière indépendante.
npm run build
npm start
Notes
Si votre complément n’a pas été automatiquement chargé de manière indépendante, suivez les instructions fournies dans Charger une version test des compléments Outlook pour charger manuellement une version test du complément dans Outlook.
Dans votre client Outlook préféré, créez un message. Si aucune signature Outlook par défaut n’est configurée, le complément en ajoute une au message nouvellement créé.
Activez le champ De , le cas échéant. Pour obtenir des conseils sur la façon de l’activer, consultez la section « Pourquoi le bouton De est-il manquant ? » dans Modifier le compte utilisé pour envoyer des messages électroniques.
Sélectionnez De, puis choisissez un autre compte Exchange. Vous pouvez également entrer manuellement l’adresse e-mail Exchange en sélectionnant À partir>d’une autre adresse Email. Une signature mise à jour est ajoutée au message, en remplaçant la signature précédente.
Lorsque vous souhaitez arrêter le serveur web local et désinstaller le complément, suivez les instructions applicables :
Pour arrêter le serveur, exécutez la commande suivante. Si vous avez utilisé npm start, la commande suivante doit également désinstaller le complément.
npm stop
Si vous avez chargé manuellement le complément, consultez Supprimer un complément chargé de manière indépendante.
Pour obtenir des conseils sur la façon de résoudre les problèmes de votre complément d’activation basée sur les événements, consultez Résoudre les problèmes de compléments basés sur les événements et la création de rapports de courrier indésirable.
À l’instar des autres compléments basés sur les événements, les compléments qui utilisent les événements et OnAppointmentFromChanged doivent être déployés par l’administrateur OnMessageFromChanged d’un organization. Pour obtenir des conseils sur le déploiement de votre complément via le Centre d’administration Microsoft 365, consultez la section « Déployer sur les utilisateurs » de Configurer votre complément Outlook pour l’activation basée sur les événements.
Étant donné que les OnMessageFromChanged événements et OnAppointmentFromChanged sont pris en charge par le biais de la fonctionnalité d’activation basée sur les événements, le même comportement et les mêmes limitations s’appliquent aux compléments qui s’activent à la suite de cet événement. Pour obtenir une description détaillée, consultez Comportement et limitations de l’activation basée sur les événements.
En plus de ces caractéristiques, les aspects suivants s’appliquent également lorsqu’un complément s’active sur ces événements.
OnMessageFromChanged est pris en charge uniquement en mode de composition de message, tandis que l’événement OnAppointmentFromChanged est uniquement pris en charge en mode de composition de rendez-vous.OnMessageFromChanged est pris en charge.OnMessageFromChanged événements et OnAppointmentFromChanged prennent uniquement en charge les comptes Exchange. Dans les messages en cours de composition, le compte Exchange est sélectionné dans la liste déroulante Du champ ou entré manuellement dans le champ. Dans les rendez-vous en cours de composition, le compte Exchange est sélectionné dans la liste déroulante du champ organisateur. Si un utilisateur bascule vers un compte non-Exchange dans le champ De ou organisateur, le client Outlook efface automatiquement la signature définie par le compte sélectionné précédemment.OnAppointmentFromChanged n’est pas pris en charge dans les calendriers de groupe Microsoft 365. Si un utilisateur passe de son compte Exchange à un compte de calendrier de groupe Microsoft 365 dans le champ organisateur, le client Outlook efface automatiquement la signature définie par le compte Exchange.OnMessageFromChanged ou OnAppointmentFromChanged .OnMessageFromChanged ou OnAppointmentFromChanged se produit sans recharger les compléments du compte.OnMessageFromChanged ou OnAppointmentFromChanged se produit, mais les compléments du compte ne sont pas arrêtés ou rechargés.Commentaires sur Office Add-ins
Office Add-ins est un projet open source. Sélectionnez un lien pour fournir des commentaires :
Entrainement
Parcours d’apprentissage
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization
Certification
Spécialiste Microsoft Office : Outlook Associate (Office 2019) - Certifications
Démontrez que vous avez les compétences nécessaires pour tirer le meilleur parti d’Outlook 2019 en obtenant la certification Microsoft Office Specialist (MOS).