Activer les dossiers partagés et les scénarios de boîte aux lettres partagées dans un complément Outlook

Cet article explique comment activer les dossiers partagés (également appelés accès délégué) et les 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)	Exchange 2013 en local
Fenêtres 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	Soutenu*	Soutenu*	Soutenu*
Mac Build 16.47 ou version ultérieure	Pris en charge	Pris en charge	Pris en charge	Pris en charge
Navigateur web (interface utilisateur Outlook moderne)	Pris en charge	Non applicable	Non applicable	Non applicable
Navigateur web (interface utilisateur Outlook classique)	Non applicable	Non applicable	Non applicable	Non applicable

Remarque

* La prise en charge de cette fonctionnalité dans un environnement Exchange local est disponible à partir d’Outlook sur Windows version 2206 (build 15330.20000) pour le canal actuel et 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.

Fenêtres

Dossiers partagés

Le propriétaire de la boîte aux lettres doit d’abord fournir l’accès à un délégué à l’aide de l’une des options suivantes.

• Configurez l’accès délégué à partir de la boîte aux lettres dans Outlook sur Windows. Pour plus d’informations, consultez Autoriser une autre personne à gérer votre courrier et votre calendrier.

• Configurez l’accès délégué à partir du Centre d'administration Microsoft 365. Cette option ne peut être effectuée que par les administrateurs. Pour plus d’informations, consultez Accorder des autorisations de boîte aux lettres à un autre utilisateur Microsoft 365.

• Configurez l’accès délégué à partir du Centre d’administration Exchange. Cette option ne peut être effectuée que par les administrateurs. 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 profil » de l’article Gérer les éléments de courrier et de calendrier d’une autre personne.

Boîtes aux lettres partagées

Les administrateurs de serveur Exchange peuvent créer et gérer des boîtes aux lettres partagées accessibles à des ensembles d’utilisateurs. Exchange Online et les environnements Exchange locaux sont pris en charge.

Une fonctionnalité Exchange Server appelée « mappage automatique » est activée par défaut, ce qui signifie que la boîte aux lettres partagée doit apparaître automatiquement dans l’application Outlook d’un utilisateur après la fermeture et la réouverture d’Outlook. Toutefois, si un administrateur a désactivé le mappage automatique, l’utilisateur doit suivre les étapes manuelles décrites dans la section « Ajouter une boîte aux lettres partagée à Outlook » de l’article Ouvrir et utiliser une boîte aux lettres partagée dans Outlook.

Avertissement

Ne vous connectez PAS à la boîte aux lettres partagée avec un mot de passe. Les API de fonctionnalité ne fonctionnent pas dans ce cas.

Navigateur web – Outlook moderne

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

Lorsqu’une boîte aux lettres partagée est ouverte dans le même panneau que la boîte aux lettres principale d’un utilisateur, le type de compléments accessibles à partir de la boîte aux lettres partagée diffère entre les modes de composition et de lecture.

• En mode composition, tous les compléments déployés par l’administrateur d’un organization peuvent être utilisés à partir de la boîte aux lettres partagée.
• En mode lecture, seuls les compléments configurés dans le manifeste pour prendre en charge les fichiers partagés peuvent être utilisés à partir de la boîte aux lettres partagée. Pour obtenir des instructions sur la procédure à suivre pour le manifeste XML ou le manifeste unifié, consultez la section Configurer le manifeste .

Lorsqu’une boîte aux lettres partagée est ouverte dans un onglet ou une fenêtre de navigateur distinct, seuls les compléments qui répondent aux critères suivants peuvent être utilisés à partir de la boîte aux lettres partagée.

• Complément configuré dans le manifeste pour prendre en charge les fichiers partagés. Pour obtenir des instructions sur la procédure à suivre pour le manifeste XML ou le manifeste unifié, consultez la section Configurer le manifeste .
• Le complément est déployé sur la boîte aux lettres partagée et la boîte aux lettres de l’utilisateur qui a accès à la boîte aux lettres partagée par l’administrateur d’un organization.
• Le complément doit être déployé à l’aide de la méthode Déploiement centralisé fixe ou facultatif. Pour plus d’informations sur les méthodes de déploiement, consultez FAQ sur le déploiement centralisé.

Mac

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. Pour obtenir des conseils sur l’accès à une boîte aux lettres partagée pour laquelle vous disposez d’autorisations dans Outlook sur Mac, consultez la section « Ouvrir une boîte aux lettres partagée ou déléguée » de l’article Ouvrir un dossier courrier, calendrier ou Personnes partagé dans Outlook pour Mac.

Les utilisateurs disposant d’autorisations sur une boîte aux lettres partagée peuvent activer des compléments configurés pour les scénarios de boîte aux lettres partagées dans les modes de lecture et de composition de message et de rendez-vous.

Dossiers partagés

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

Si le dossier Brouillons est également partagé avec le délégué, les compléments sont disponibles en mode composition.

Calendrier partagé local (nouveau modèle)

Si le propriétaire du calendrier a explicitement partagé son calendrier avec un délégué (la totalité de la boîte aux lettres 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.

Calendrier partagé distant (modèle précédent)

Si le propriétaire du calendrier a accordé un accès étendu à son calendrier (par exemple, l’a rendu modifiable à une DL particulière ou à l’ensemble de l’organization), les utilisateurs peuvent alors disposer d’autorisations indirectes ou implicites et les compléments sont disponibles pour ces utilisateurs dans les modes de lecture et de composition de rendez-vous.

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.

Autorisations prises en charge

Le tableau suivant décrit les autorisations que l’API JavaScript Office prend en charge pour les délégués et les utilisateurs de boîtes aux lettres partagées.

Autorisation	Valeur	Description
Lecture	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’objet DelegatePermissions est implémenté à 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 . Vous pouvez voir un exemple de case activée pour une autorisation spécifique dans la section Effectuer une opération en tant qu’utilisateur de boîte aux lettres déléguée ou partagée plus loin dans cet article.

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 REST ou EWS (Exchange Web Services) ont été utilisées pour définir une propriété étendue sur un élément, la synchronisation de ces modifications peut prendre quelques heures. Nous vous recommandons plutôt d’utiliser l’objet CustomProperties et les API associées pour éviter un tel délai. Pour en savoir plus, consultez la section propriétés personnalisées de l’article « Obtenir et définir des métadonnées dans un complément Outlook ».

Importante

Dans un scénario de délégué, vous ne pouvez pas utiliser EWS avec les jetons actuellement fournis par office.js'API.

Configurer le manifeste

Pour activer les dossiers partagés et les scénarios de boîte aux lettres partagées dans votre complément, vous devez activer les autorisations requises dans le manifeste.

Tout d’abord, pour prendre en charge les appels REST d’un délégué, le complément doit demander l’autorisation de boîte aux lettres en lecture/écriture . Le balisage varie en fonction du type de manifeste.

• Manifeste XML : définissez l’élément Permissions> sur<ReadWriteMailbox.
• Manifeste unifié pour Microsoft 365 (préversion) : définissez la propriété « name » d’un objet dans le tableau « authorization.permissions.resourceSpecific » sur « Mailbox.ReadWrite.User ».

Ensuite, activez la prise en charge des dossiers partagés. Le balisage varie en fonction du type de manifeste.

Manifeste unifié pour Microsoft 365 (préversion pour les développeurs)

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"
      },
    ]
  }
},

Manifeste XML

Définissez l’élément trueSupportsSharedFolders sur dans le manifeste sous l’élément DesktopFormFactorparent . Actuellement, les autres facteurs de forme ne sont pas pris en charge.

...
<VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides" xsi:type="VersionOverridesV1_0">
  <VersionOverrides xmlns="http://schemas.microsoft.com/office/mailappversionoverrides/1.1" xsi:type="VersionOverridesV1_1">
    ...
    <Hosts>
      <Host xsi:type="MailHost">
        <DesktopFormFactor>
          <SupportsSharedFolders>true</SupportsSharedFolders>
          <FunctionFile resid="residDesktopFuncUrl" />
          <ExtensionPoint xsi:type="MessageReadCommandSurface">
            <!-- configure selected extension point -->
          </ExtensionPoint>

          <!-- You can define more than one ExtensionPoint element as needed -->

        </DesktopFormFactor>
      </Host>
    </Hosts>
    ...
  </VersionOverrides>
</VersionOverrides>
...

Effectuer une opération en tant qu’utilisateur délégué ou utilisateur de boîte aux lettres partagée

Vous pouvez obtenir les propriétés partagées d’un élément en mode Compose ou Lecture en appelant la méthode item.getSharedPropertiesAsync . Cela renvoie un objet SharedProperties qui fournit actuellement les autorisations de l’utilisateur, l’adresse e-mail du propriétaire, l’URL de base de l’API REST et la boîte aux lettres cible.

L’exemple suivant montre comment obtenir les propriétés partagées d’un message ou d’un rendez-vous, case activée si le délégué ou l’utilisateur de boîte aux lettres partagée dispose de l’autorisation Écriture, et effectuer un appel REST.

function performOperation() {
  Office.context.mailbox.getCallbackTokenAsync({
      isRest: true
    },
    function (asyncResult) {
      if (asyncResult.status === Office.AsyncResultStatus.Succeeded && asyncResult.value !== "") {
        Office.context.mailbox.item.getSharedPropertiesAsync({
            // Pass auth token along.
            asyncContext: asyncResult.value
          },
          function (asyncResult1) {
            let sharedProperties = asyncResult1.value;
            let delegatePermissions = sharedProperties.delegatePermissions;

            // Determine if user can do the expected operation.
            // E.g., do they have Write permission?
            if ((delegatePermissions & Office.MailboxEnums.DelegatePermissions.Write) != 0) {
              // Construct REST URL for your operation.
              // Update <version> placeholder with actual Outlook REST API version e.g. "v2.0".
              // Update <operation> placeholder with actual operation.
              let rest_url = sharedProperties.targetRestUrl + "/<version>/users/" + sharedProperties.targetMailbox + "/<operation>";
  
              $.ajax({
                  url: rest_url,
                  dataType: 'json',
                  headers:
                  {
                    "Authorization": "Bearer " + asyncResult1.asyncContext
                  }
                }
              ).done(
                function (response) {
                  console.log("success");
                }
              ).fail(
                function (error) {
                  console.log("error message");
                }
              );
            }
          }
        );
      }
    }
  );
}

Conseil

En tant que délégué, vous pouvez utiliser REST pour obtenir le contenu d’un message Outlook attaché à un élément ou une publication de groupe Outlook.

Gérer l’appel de REST sur des éléments partagés et non partagés

Si vous souhaitez appeler une opération REST sur un élément, que l’élément soit partagé ou non, vous pouvez utiliser l’API getSharedPropertiesAsync pour déterminer si l’élément est partagé. Après cela, vous pouvez construire l’URL REST de l’opération à l’aide de l’objet approprié.

if (item.getSharedPropertiesAsync) {
  // In Windows, Mac, and the web client, this indicates a shared item so use SharedProperties properties to construct the REST URL.
  // Add-ins don't activate on shared items in mobile so no need to handle.

  // Perform operation for shared item.
} else {
  // In general, this isn't a shared item, so construct the REST URL using info from the Call REST APIs article:
  // https://learn.microsoft.com/office/dev/add-ins/outlook/use-rest-api

  // Perform operation for non-shared item.
}

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 de composition de messages

En mode Composition de messages, getSharedPropertiesAsync n’est pas pris en charge dans Outlook sur le web ou sur Windows, sauf si les conditions suivantes sont remplies.

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

b. Boîte aux lettres partagée (s’applique uniquement à Outlook sur 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.

Le message est maintenant 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 l’expéditeur.

REST et EWS

Votre complément peut utiliser REST. Pour activer l’accès REST à la boîte aux lettres du propriétaire ou à la boîte aux lettres partagée, le cas échéant, le complément doit demander l’autorisation de boîte aux lettres en lecture/écriture dans le manifeste. Le balisage varie en fonction du type de manifeste.

• Manifeste XML : définissez l’élément Permissions> sur<ReadWriteMailbox.
• Manifeste unifié pour Microsoft 365 (préversion) : définissez la propriété « name » d’un objet dans le tableau « authorization.permissions.resourceSpecific » sur « Mailbox.ReadWrite.User ».

EWS n’est pas pris en charge.

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

Voir aussi

• Autoriser une autre personne à gérer votre courrier électronique et votre calendrier
• Partage de calendrier dans Microsoft 365
• Ajouter une boîte aux lettres partagée à Outlook
• Guide pratique pour trier les éléments de manifeste
• Masque (informatique)
• Opérateurs de bits JavaScript