Partager via

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.

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
  • Dossiers partagés : Pris en charge
  • Boîtes aux lettres partagées : non applicable
  • Dossiers partagés : Pris en charge
  • Boîtes aux lettres partagées : 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
Android Non applicable Non applicable Non applicable
iOS Non applicable Non applicable Non applicable

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 des boîtes aux lettres partagées et des dossiers partagés qui prennent en charge l’utilisation de compléments. 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é.

Une fois l’accès fourni, le délégué doit suivre les instructions décrites dans Accéder à la boîte aux lettres d’une autre personne.

Dans le nouvel Outlook sur Windows, par défaut, les boîtes aux lettres partagées qui sont automatiquement mappées par un administrateur sont ajoutées en tant que dossiers partagés. Cela signifie qu’un utilisateur peut lire et envoyer des messages à partir de la boîte aux lettres partagée, mais qu’il ne peut pas gérer les paramètres de boîte aux lettres. Pour gérer les paramètres, un utilisateur doit promouvoir la boîte aux lettres partagée en un compte complet. Pour plus d’informations, voir Gérer les paramètres de boîte aux lettres partagées dans le nouvel Outlook.

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.

Dans la nouvelle version d’Outlook sur Windows, une boîte aux lettres partagée est accessible à partir du volet dossiers du client. Une boîte aux lettres partagée peut être automatiquement ajoutée par un administrateur ou manuellement par l’utilisateur. Les boîtes aux lettres ajoutées manuellement sont automatiquement configurées en tant que comptes complets dans le client Outlook, afin que les utilisateurs puissent gérer les paramètres de boîte aux lettres. À l’inverse, par défaut, les boîtes aux lettres partagées ajoutées par un administrateur sont configurées en tant que dossiers partagés. Si un utilisateur souhaite gérer les paramètres de la boîte aux lettres, il doit promouvoir le dossier partagé en un compte complet sur le client. Pour plus d’informations, voir Gérer les paramètres de boîte aux lettres partagées dans le nouvel Outlook.

Configurer le manifeste

Pour implémenter des scénarios de dossier partagé et de boîte aux lettres partagée 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.

Remarque

L’implémentation de scénarios de dossier partagé et de boîte aux lettres partagées avec un manifeste unifié pour Microsoft 365 est actuellement prise en charge uniquement dans Outlook classique sur Windows. Pour les autres plateformes prises en charge, utilisez le manifeste de complément uniquement à la place.

Ajoutez un objet supplémentaire au "authorization.permissions.resourceSpecific" tableau. Définissez sa "name" propriété sur "Mailbox.SharedFolder" et sa "type" propriété sur "Delegated".

"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.

Remarque

Dans Outlook sur le web et sur Windows (nouveau et classique), selon la façon dont le dossier partagé ou la boîte aux lettres est accessible, la getSharedPropertiesAsync méthode peut nécessiter que certaines conditions soient remplies en mode Compose message. Pour plus d’informations, consultez la section « Mode de Compose de message » dans Limitations.

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.

  • Dans les scénarios délégués ou partagés, un délégué peut obtenir les catégories à partir de la liste de master Outlook, mais ne peut pas ajouter ou supprimer des catégories de la liste.

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 "name" propriété d’un objet dans le "authorization.permissions.resourceSpecific" tableau 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).

Prise en charge des compléments dans les scénarios de dossier partagé et de boîte aux lettres partagée

La disponibilité des compléments dans un dossier partagé ou une boîte aux lettres partagée varie en fonction du scénario et du client Outlook.

Conseil

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.

Compléments dans les scénarios de dossier partagé

Le tableau suivant décrit la disponibilité des compléments dans les scénarios de dossier partagé.

Scénario Disponibilité du complément
Le dossier boîte de réception est partagé avec un délégué Les compléments sont disponibles pour le délégué en mode lecture de message.
Le dossier Brouillons est partagé avec un délégué Les compléments sont disponibles pour le délégué en mode de composition de message.
(Nouveau Outlook sur Windows uniquement) La boîte aux lettres partagée est automatiquement mappée par un administrateur et n’est pas promue en compte complet par l’utilisateur Consultez les comportements décrits dans la colonne « Web : même onglet ou fenêtre, Windows (nouveau) : boîte aux lettres non promue, Windows (classique) et Mac » des compléments dans les scénarios de boîte aux lettres partagée.
Le calendrier est explicitement partagé avec un délégué (la boîte aux lettres entière peut ne pas être partagée) Les compléments sont disponibles pour le délégué dans les modes de lecture et de composition de rendez-vous.
Le calendrier est partagé avec un groupe d’utilisateurs avec un accès différent (par exemple, il est modifiable pour une liste de distribution particulière ou l’ensemble de la organization) Les compléments sont disponibles pour les utilisateurs disposant d’autorisations indirectes ou implicites dans les modes de lecture et de composition de rendez-vous.

Compléments dans les scénarios de boîte aux lettres partagée

Le tableau suivant décrit la disponibilité des compléments dans les scénarios de boîte aux lettres partagée sur différents clients Outlook. Notez que le comportement dans Outlook sur le web peut varier selon que la boîte aux lettres partagée est ouverte dans le même panneau que la boîte aux lettres principale de l’utilisateur ou dans un onglet ou une fenêtre distincte à l’aide de l’option Ouvrir une autre boîte aux lettres. De même, le comportement dans le nouvel Outlook sur Windows peut également différer selon que la boîte aux lettres partagée a été ajoutée ou promue en tant que compte complet sur le client.

Scénario Clients Outlook applicables
  • Web : même onglet ou fenêtre
  • Windows (nouveau) : non promu
  • Windows (classique)
  • Mac
 Clients Outlook applicables
  • Web : onglet ou fenêtre distinct
  • Windows (nouveau) : promu
Complément installé par l’utilisateur Les utilisateurs ne peuvent pas installer de compléments dans une boîte aux lettres partagée. Les compléments installés par un utilisateur sont ajoutés à la boîte aux lettres principale de l’utilisateur. Les utilisateurs ne peuvent pas installer de compléments dans une boîte aux lettres partagée. Le magasin Microsoft 365 et Copilot in-app n’apparaît pas dans le ruban de la boîte aux lettres.
Complément installé par un administrateur Les administrateurs ne doivent pas déployer de compléments dans une boîte aux lettres partagée. À la place, ils doivent déployer un complément sur la boîte aux lettres principale de l’utilisateur. L’utilisateur peut ensuite utiliser le complément dans une boîte aux lettres partagée tant que le complément répond à certaines exigences (consultez les scénarios suivants pour la disponibilité du complément en mode lecture et composition). La même limitation et recommandation sur d’autres plateformes s’applique (voir la colonne précédente).
Complément utilisé en mode lecture Le manifeste d’un complément doit être configuré pour prendre en charge les scénarios de boîte aux lettres partagées. Pour plus d’informations, consultez Configurer le manifeste. Le complément doit être installé dans la boîte aux lettres principale de l’utilisateur par l’utilisateur ou l’administrateur. La même configuration de manifeste et le même comportement sur d’autres plateformes s’appliquent (voir la colonne précédente).
Complément utilisé en mode composition Dans Outlook sur le web (boîte aux lettres ouverte dans la même fenêtre) et sur Windows (nouveau et classique), les compléments installés dans la boîte aux lettres principale de l’utilisateur qui prennent en charge le mode composition sont disponibles. Le manifeste d’un complément n’a pas besoin d’une configuration supplémentaire pour prendre en charge les scénarios de boîte aux lettres partagées.

Toutefois, dans Outlook sur Mac, le manifeste d’un complément doit être configuré pour prendre en charge les scénarios de boîte aux lettres partagées. Pour plus d’informations, consultez Configurer le manifeste.		 Le manifeste d’un complément doit être configuré pour prendre en charge les scénarios de boîte aux lettres partagées. Pour plus d’informations, consultez Configurer le manifeste. Le complément doit être installé dans la boîte aux lettres principale de l’utilisateur par l’utilisateur ou l’administrateur.
Modèles créés à l’aide du complément Mes modèles Cela s’applique uniquement aux Outlook sur le web et sur Windows (nouveau et classique), car le complément Mes modèles n’est pas pris en charge dans les boîtes aux lettres partagées sur Outlook sur Mac.

Les modèles créés sont enregistrés dans la boîte aux lettres principale du créateur. Bien que le créateur puisse utiliser ces modèles dans ses boîtes aux lettres principales et partagées, les autres utilisateurs qui ont accès à la boîte aux lettres partagée ne peuvent pas accéder à ces modèles. Pour plus d’informations, consultez Créer un modèle de message électronique.		 Les modèles créés sont enregistrés dans la boîte aux lettres partagée. Toute personne ayant accès à la boîte aux lettres partagée peut modifier ou utiliser ces modèles s’il ouvre la boîte aux lettres à l’aide de Ouvrir une autre boîte aux lettres dans Outlook sur le web, ou si la boîte aux lettres est promue en compte complet dans le nouvel Outlook sur Windows. Ces modèles partagés ne sont accessibles à personne, y compris le créateur du modèle, à partir d’autres plateformes. Cela inclut Outlook sur le web, si la boîte aux lettres partagée est ouverte dans le même onglet que la boîte aux lettres principale de l’utilisateur, et la nouvelle boîte aux lettres Outlook sur Windows, si la boîte aux lettres partagée n’a pas été promue en compte complet. À l’inverse, les modèles créés sur d’autres plateformes ne sont pas accessibles à partir d’une boîte aux lettres partagée ouverte à l’aide de l’option Ouvrir une autre boîte aux lettres ou à partir d’une boîte aux lettres partagée promue. Pour plus d’informations, consultez Créer un modèle de message électronique.
Compléments par défaut dans Outlook Dans Outlook sur le web et sur Windows (nouveau et classique), les compléments Outlook par défaut peuvent être utilisés dans une boîte aux lettres partagée. Les compléments Outlook par défaut peuvent inclure Mes modèles, Désabonnement et Actions. Notez que certains compléments par défaut peuvent ne pas apparaître dans votre organization.

Dans Outlook sur Mac, les compléments par défaut ne sont pas disponibles dans une boîte aux lettres partagée.		 Les compléments par défaut sont disponibles dans une boîte aux lettres partagée.

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

    1. 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.
    2. Ils enregistrent le message, puis le déplacent de leur propre dossier Brouillons vers un dossier partagé avec le délégué.
    3. Le délégué ouvre le brouillon à partir du dossier partagé, puis continue la composition.

  • Boîte aux lettres partagée ouverte dans le même panneau que la boîte aux lettres principale de l’utilisateur (web, Windows classique) ou la boîte aux lettres partagée qui n’a pas été promue en compte complet (nouveau Windows)

    1. 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.
    2. Ils enregistrent le message, puis le déplacent de leur propre dossier Brouillons vers un dossier dans la boîte aux lettres partagée.
    3. 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.

    Remarque

    La getSharedPropertiesAsync méthode est prise en charge sur les plateformes suivantes sans conditions supplémentaires.

    • Outlook sur le web lorsque la boîte aux lettres partagée est ouverte dans un onglet ou une fenêtre distincte à l’aide de l’option Ouvrir une autre boîte aux lettres.
    • nouveau Outlook sur Windows lorsque la boîte aux lettres partagée est promue en compte complet.

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 en savoir plus, consultez l’onglet « Propriétés personnalisées » de l’article Obtenir et définir des métadonnées dans un complément Outlook.

Voir aussi