Implémenter des dossiers partagés et des scénarios de boîte aux lettres partagées dans un complément Outlook
Cet article explique comment implémenter des dossiers partagés (également appelés accès délégué) et des scénarios de boîte aux lettres partagées dans votre complément Outlook, notamment les autorisations que l’API JavaScript Office prend en charge.
Remarque
La prise en charge des dossiers partagés a été introduite dans l’ensemble de conditions requises 1.8, tandis que la prise en charge des boîtes aux lettres partagées a été introduite dans l’ensemble de conditions requises 1.13. Pour plus d’informations sur la prise en charge des clients pour ces fonctionnalités, consultez Clients et plateformes pris en charge.
Clients et plateformes pris en charge
Le tableau suivant présente les combinaisons client-serveur prises en charge pour cette fonctionnalité, y compris la mise à jour cumulative minimale requise, le cas échéant. Les combinaisons exclues ne sont pas prises en charge.
| Client | Exchange Online | Exchange 2019 en local (Mise à jour cumulative 1 ou ultérieure) |
Exchange 2016 en local (Mise à jour cumulative 6 ou ultérieure) |
|---|---|---|---|
| Navigateur web (interface utilisateur Outlook moderne) | Pris en charge | Non applicable | Non applicable |
| Navigateur web (interface utilisateur Outlook classique) | Non applicable | Non applicable | Non applicable |
| nouvel Outlook sur Windows | Pris en charge | Non applicable | Non applicable |
|
Windows (classique) Dossiers partagés : version 1910 (build 12130.20272) ou ultérieure Boîtes aux lettres partagées : version 2304 (build 16327.20248) ou ultérieure |
Pris en charge | Supporté* | Supporté* |
|
Mac Version 16.47 ou ultérieure |
Pris en charge | Pris en charge | Pris en charge |
Remarque
* La prise en charge de cette fonctionnalité dans un environnement Exchange local est disponible à partir de la version 2206 classique d’Outlook sur Windows (build 15330.20000) pour le canal actuel et de la version 2207 (build 15427.20000) pour le canal Entreprise mensuel.
Configurations prises en charge
Les sections suivantes décrivent les configurations prises en charge pour les boîtes aux lettres partagées et les dossiers partagés. Les API de fonctionnalité peuvent ne pas fonctionner comme prévu dans d’autres configurations. Sélectionnez la plateforme que vous souhaitez apprendre à configurer.
Dossiers partagés
Le propriétaire de la boîte aux lettres doit d’abord fournir l’accès à un délégué.
Pour fournir l’accès à la gestion des réunions et des réponses aux réunions au nom du propriétaire de la boîte aux lettres, consultez Délégation de calendrier dans Outlook sur le web.
Pour fournir l’accès à la gestion de la boîte de réception et du calendrier au nom du propriétaire de la boîte aux lettres, l’accès doit être configuré via l’une des options suivantes.
Le propriétaire de la boîte aux lettres peut configurer l’accès via Outlook classique sur Windows. Pour plus d’informations, consultez Autoriser une autre personne à gérer votre courrier et votre calendrier.
Un administrateur peut configurer l’accès via le Centre d’administration Microsoft 365. Pour plus d’informations, consultez Accorder des autorisations de boîte aux lettres à un autre utilisateur Microsoft 365.
Un administrateur peut configurer l’accès via le Centre d’administration Exchange. Pour plus d’informations, consultez Gérer les autorisations pour les destinataires.
Une fois l’accès fourni, le délégué doit suivre les instructions décrites dans la section « Ajouter la boîte aux lettres d’une autre personne à votre liste de dossiers dans Outlook Web App » de l’article Accéder à la boîte aux lettres d’une autre personne.
Boîtes aux lettres partagées
Une boîte aux lettres partagée permet à un groupe d’utilisateurs de surveiller et d’envoyer facilement des messages et des invitations à une réunion à l’aide d’une adresse e-mail partagée.
Dans Outlook sur le web, une boîte aux lettres partagée peut être ouverte dans le même panneau que la boîte aux lettres principale d’un utilisateur ou dans un onglet ou une fenêtre de navigateur distinct. Pour obtenir des conseils, consultez Ouvrir et utiliser une boîte aux lettres partagée dans Outlook sur le web.
Remarque
Dans Outlook sur le web, si vous ouvrez une boîte aux lettres partagée dans un onglet ou une fenêtre de navigateur distinct à l’aide de l’option Ouvrir une autre boîte aux lettres, vous pouvez rencontrer des problèmes lors de l’accès aux compléments à partir de la boîte aux lettres. Nous vous recommandons plutôt d’ouvrir la boîte aux lettres dans le même panneau que votre boîte aux lettres principale. Cela garantit que les compléments fonctionnent comme prévu dans votre boîte aux lettres partagée.
Si vous préférez ouvrir la boîte aux lettres partagée à l’aide de l’option Ouvrir une autre boîte aux lettres , nous vous recommandons de déployer le complément sur votre utilisateur principal et sur vos boîtes aux lettres partagées.
Dans le nouvel Outlook sur Windows, une boîte aux lettres partagée est ajoutée à la section Partagé avec moi du volet dossier. Pour obtenir des conseils, voir Ouvrir et utiliser une boîte aux lettres partagée dans Outlook.
Pour en savoir plus sur l’endroit où les compléments s’activent et ne s’activent pas en général, reportez-vous à la section Éléments de boîte aux lettres disponibles pour les compléments de la page vue d’ensemble des compléments Outlook.
Configurer le manifeste
Pour implémenter des dossiers partagés et des scénarios de boîte aux lettres partagées dans votre complément, vous devez d’abord configurer la prise en charge de la fonctionnalité dans votre manifeste. Le balisage varie en fonction du type de manifeste utilisé par votre complément.
Ajoutez un objet supplémentaire au tableau « authorization.permissions.resourceSpecific » et définissez sa propriété « name » sur « Mailbox.SharedFolder ».
"authorization": {
"permissions": {
"resourceSpecific": [
...
{
"name": "Mailbox.SharedFolder",
"type": "Delegated"
},
]
}
},
Identifier si un dossier ou une boîte aux lettres est partagé
Avant de pouvoir exécuter des opérations dans un dossier partagé ou une boîte aux lettres partagée, vous devez d’abord identifier si le dossier ou la boîte aux lettres actif est partagé. Pour le déterminer, appelez Office.context.mailbox.item.getSharedPropertiesAsync sur un message ou un rendez-vous en mode composition ou lecture. Si l’élément se trouve dans un dossier partagé ou une boîte aux lettres partagée, la méthode renvoie un objet SharedProperties qui fournit les autorisations de l’utilisateur, l’adresse e-mail du propriétaire, l’URL de base de l’API REST et l’emplacement de la boîte aux lettres cible.
L’exemple suivant appelle la getSharedPropertiesAsync méthode pour identifier le propriétaire de la boîte aux lettres et les autorisations de l’utilisateur délégué ou partagé.
Office.context.mailbox.item.getSharedPropertiesAsync((result) => {
if (result.status === Office.AsyncResultStatus.Failed) {
console.error("The current folder or mailbox isn't shared.");
return;
}
const sharedProperties = result.value;
console.log(`Owner: ${sharedProperties.owner}`);
console.log(`Permissions: ${sharedProperties.delegatePermissions} `);
});
Autorisations prises en charge
Le tableau suivant décrit les autorisations qui getSharedPropertiesAsync prennent en charge les délégués et les utilisateurs de boîtes aux lettres partagées.
| Autorisation | Valeur | Description |
|---|---|---|
| Lire | 1 (000001) | Peut lire des éléments. |
| Écrire | 2 (000010) | Peut créer des éléments. |
| DeleteOwn | 4 (000100) | Peut supprimer uniquement les éléments qu’il a créés. |
| DeleteAll | 8 (001000) | Peut supprimer n’importe quel élément. |
| EditOwn | 16 (010000) | Peut modifier uniquement les éléments qu’il a créés. |
| Modifiertous | 32 (100000) | Peut modifier n’importe quel élément. |
Remarque
Actuellement, l’API prend en charge l’obtention d’autorisations existantes, mais pas la définition d’autorisations.
L’énumération DelegatePermissions retournée par la propriété delegatePermissions est implémentée à l’aide d’un masque de bits pour indiquer les autorisations. Chaque position dans le masque de bits représente une autorisation particulière et, si elle est définie sur 1, l’utilisateur dispose de l’autorisation correspondante. Par exemple, si le deuxième bit de droite est 1, l’utilisateur dispose de l’autorisation Écriture .
Effectuer une opération en tant qu’utilisateur délégué ou partagé de boîte aux lettres
Une fois que vous avez identifié que l’élément de courrier actuel se trouve dans un dossier partagé ou une boîte aux lettres partagée, votre complément peut ensuite effectuer les opérations nécessaires sur l’élément dans l’environnement partagé. Pour exécuter des opérations sur un élément dans un contexte partagé, vous devez d’abord configurer l’autorisation de votre complément dans le manifeste. Ensuite, utilisez Microsoft Graph pour effectuer les opérations.
Remarque
Les services web Exchange (EWS) ne sont pas pris en charge dans les scénarios de dossier partagé et de boîte aux lettres partagée.
Configurer les autorisations du complément
Pour utiliser les services Microsoft Graph, un complément doit configurer l’autorisation de boîte aux lettres en lecture/écriture dans son manifeste. Le balisage varie en fonction du type de manifeste utilisé par votre complément.
- Manifeste unifié pour Microsoft 365 : définissez la propriété « name » d’un objet dans le tableau « authorization.permissions.resourceSpecific » sur « Mailbox.ReadWrite.User ».
- Manifeste du complément uniquement : définissez l’élément Permissions sur ReadWriteMailbox.
Utiliser Microsoft Graph
Pour implémenter vos scénarios de dossier partagé et de boîte aux lettres partagée, utilisez Microsoft Graph pour accéder aux informations et ressources de boîte aux lettres supplémentaires. Par exemple, vous pouvez utiliser Microsoft Graph pour obtenir le contenu d’un message Outlook joint à un message dans une boîte aux lettres où un utilisateur dispose d’un accès délégué. Pour obtenir des conseils sur l’utilisation de Microsoft Graph, consultez Vue d’ensemble de Microsoft Graph et de l’API demessagerie Outlook dans Microsoft Graph.
Conseil
Pour accéder aux API Microsoft Graph à partir de votre complément, utilisez MSAL.js'authentification d’application imbriquée (NAA). Pour plus d’informations, consultez Activer l’authentification unique dans un complément Office à l’aide de l’authentification d’application imbriquée (préversion).
Limitations
Selon les scénarios de votre complément, il existe quelques limitations à prendre en compte lors de la gestion des dossiers partagés ou des situations de boîte aux lettres partagées.
Mode Compose message
En mode message Compose, getSharedPropertiesAsync n’est pas pris en charge dans Outlook sur le web ou sur Windows (nouveau et classique), sauf si les conditions suivantes sont remplies.
Déléguer l’accès/Dossiers partagés
- Le propriétaire de la boîte aux lettres démarre un message. Il peut s’agir d’un nouveau message, d’une réponse ou d’un transfert.
- Ils enregistrent le message, puis le déplacent de leur propre dossier Brouillons vers un dossier partagé avec le délégué.
- Le délégué ouvre le brouillon à partir du dossier partagé, puis continue la composition.
Boîte aux lettres partagée (s’applique uniquement à Outlook classique sur Windows)
- Un utilisateur de boîte aux lettres partagée démarre un message. Il peut s’agir d’un nouveau message, d’une réponse ou d’un transfert.
- Ils enregistrent le message, puis le déplacent de leur propre dossier Brouillons vers un dossier dans la boîte aux lettres partagée.
- Un autre utilisateur de boîte aux lettres partagée ouvre le brouillon à partir de la boîte aux lettres partagée, puis continue de composer.
Une fois ces conditions remplies, le message devient disponible dans un contexte partagé et les compléments qui prennent en charge ces scénarios partagés peuvent obtenir les propriétés partagées de l’élément. Une fois le message envoyé, il se trouve généralement dans le dossier Éléments envoyés de la boîte aux lettres personnelle de l’expéditeur.
Boîte aux lettres utilisateur ou partagée masquée dans une liste d’adresses
Si un administrateur a masqué l’adresse d’un utilisateur ou d’une boîte aux lettres partagée d’une liste d’adresses, telle que la liste d’adresses globale (GAL), les éléments de courrier affectés ouverts dans le rapport Office.context.mailbox.item de boîte aux lettres ont la valeur Null. Par exemple, si l’utilisateur ouvre un élément de courrier dans une boîte aux lettres partagée qui est masquée dans la liste d’adresses, Office.context.mailbox.item ce qui représente cet élément de courrier est null.
Synchroniser entre les clients de dossiers partagés
Les mises à jour d’un délégué dans la boîte aux lettres du propriétaire sont généralement synchronisées immédiatement entre les boîtes aux lettres. Toutefois, si des opérations Microsoft Graph ont été utilisées pour définir une propriété étendue sur un élément, la synchronisation de ces modifications peut prendre un certain temps. Pour éviter un délai, nous vous recommandons d’utiliser plutôt l’objet CustomProperties et les API associées. Pour plus d’informations, consultez la section « Données personnalisées par élément dans une boîte aux lettres : propriétés personnalisées » de la rubrique Obtenir et définir des métadonnées dans un complément Outlook.