Utilisation des composants WebPart Outlook Web App

  • Article

S’applique à : Exchange Server 2013

Vous pouvez utiliser les composants WebPart Microsoft Office Outlook Web App pour spécifier la boîte aux lettres à ouvrir, le dossier de cette boîte aux lettres à ouvrir et l’affichage de contenu à utiliser.

Les composants WebPart Outlook Web App vous permettent d'accéder au contenu Outlook Web App directement à partir d'une URL. L'URL peut être entrée dans un navigateur web ou intégrée dans une application. En général, les composants WebPart ne sont pas créés manuellement. Ils sont créés par programmation à partir de sélections effectuées dans une interface utilisateur ou directement intégrés dans une application, telle qu'une page SharePoint Server. Le code de l'interface utilisateur crée ensuite l'URL. Les composants WebPart Outlook Web App vous permettent notamment d'afficher la boîte de réception ou le calendrier d'un utilisateur sur une page SharePoint.

Remarque

Pour utiliser les composants WebPart Outlook Web App, la boîte aux lettres de l'utilisateur et la boîte aux lettres ouverte via un composant WebPart doivent être installées dans une même forêt Active Directory.

Autorisations pour l’utilisation de composants WebPart Outlook Web App

Pour utiliser les composants WebPart Outlook Web App, vous devez au minimum disposer de l'accès « Réviseur » au contenu que vous ouvrez. Si vous avez intégré un composant WebPart Outlook Web App requérant une authentification pour accéder à une application, vous devez transmettre les informations d'authentification ainsi que la demande du composant WebPart. Pour cela, vous pouvez configurer le répertoire virtuel Outlook Web App afin d'utiliser l'authentification Windows intégrée. L'authentification Windows intégrée permet aux utilisateurs qui ont déjà ouvert une session via leur compte Active Directory d'utiliser Outlook Web App sans avoir à entrer de nouveau leurs informations d'identification.

Syntaxe des composants WebPart Outlook Web App

Outlook Web App dans Exchange 2013 comporte un format d'URL à utiliser pour les demandes au répertoire virtuel /owa. Ces demandes peuvent être effectuées en saisissant une URL directement dans un navigateur Web ou en intégrant l'URL dans une application web (par exemple, une page SharePoint Server).

Les composants WebPart Outlook Web App permettent de créer des URL présentant différents niveaux de complexité. Une URL de composant WebPart simple permet d'ouvrir la boîte de réception de n'importe quelle boîte aux lettres. Une URL de composant WebPart plus complexe permet de spécifier la boîte aux lettres à ouvrir, le dossier à ouvrir dans la boîte aux lettres et l'affichage du contenu à utiliser.

En fonction des mesures de sécurité appliquées à votre réseau, il se peut que vous deviez configurer le codage de l'URL de composants WebPart. Après la configuration du codage, le code de l'IU crée l'URL en utilisant les paramètres codés dans l'URL. Les paramètres codés dans l'URL utilisent %20 à la place des espaces et %2 à la place du délimiteur de chemin « / ». Tous les exemples de cette rubrique utilisent des paramètres codés.

Le tableau suivant répertorie les paramètres d'un composant WebPart et donne des exemples de leur utilisation.

Remarque

Exchange 2016, Exchange 2019 et Exchange Online ne prennent plus en charge les composants WebPart.

Paramètres de composant WebPart et exemples d’utilisation

Paramètre d’URL Description Valeurs et exemples
Nom du serveur et répertoire (obligatoire) URL du répertoire virtuel d'Outlook Web App Il peut s'agir de la même URL que celle dont se servent les utilisateurs pour se connecter à Outlook Web App, par exemple :

https://<server name>/owa
Identification de boîte aux lettres par ouverture de session explicite Exchange 2013 (facultatif) Toute adresse SMTP associée à la boîte aux lettres à ouvrir

Si cette section de l'URL est manquante, la boîte aux lettres par défaut de l'utilisateur authentifié est ouverte.

Si aucun paramètre supplémentaire n'est spécifié, le comportement par défaut consiste à ouvrir la boîte de réception.		 Pour ouvrir la boîte aux lettres avec l’adresse tsmith@fourthcoffee.comSMTP , utilisez l’URL suivante :

https://<server name>/owa/tsmith@fourthcoffee.com
cmd (obligatoire si vous spécifiez un paramètre autre que l'identification de boîte aux lettres par ouverture de session explicite) ?cmd=contentsaffiche la Composant WebPart Outlook Web App spécifiée par les paramètres au lieu de l’interface utilisateur complète d’Outlook Web App. Si aucune boîte aux lettres n'est spécifiée, le paramètre cmd apparaît après l'adresse de connexion, comme suit :

https://<server name>/owa/?cmd=contents

Si aucune boîte aux lettres n'est spécifiée, le paramètre cmd apparaît après l'identification de boîte aux lettres explicite, comme suit :

https://<server name>/owa/<SMTP address>/?cmd=contents

Si aucun paramètre supplémentaire n'est spécifié, le comportement par défaut consiste à ouvrir la boîte de réception.
exsvurl Ce paramètre doit être pris en compte lors de l'utilisation de l'authentification LiveID

Tous les paramètres seront ignorés lors de l’authentification LiveID si "exsvurl=1" n’est pas présent. Ce paramètre concerne uniquement les boîtes aux lettres Microsoft 365 et Office 365.		 https://<server name>/owa/?cmd=contents&exsvurl=1
fpath (facultatif) Cette partie de l'URL doit être écrite à l'aide du codage URL de sorte qu'elle puisse passer les pare-feu.

Lorsque vous utilisez le codage URL, une espace devient %20 et un délimiteur de chemin (/) devient %2f.

La hiérarchie de dossiers doit démarrer à partir de la racine de la boîte aux lettres.

Le chemin d'accès au dossier pointe vers des dossiers ordinaires ou des dossiers de recherche.		 Pour ouvrir le sous-dossier Projets de la boîte de réception, utilisez l'URL suivante :

https://<server name>/owa/?cmd=contents&fpath=inbox%2fprojects
module (facultatif) Ce paramètre permet de spécifier l'un des dossiers par défaut sans connaître le nom localisé. Les valeurs du paramètre de module ne respectent pas la casse et incluent les valeurs suivantes :
  • Boîte de réception
  • Calendrier
  • Teammailbox

Pour ouvrir le calendrier d'une boîte aux lettres indépendamment de l'emplacement, utilisez l'URL suivante :

https://<server name>/owa/?cmd=contents&module=calendar
view (facultatif) Ce paramètre spécifie l'affichage du dossier.

Lorsque ce paramètre n'est pas présent, les affichages par défaut sont les suivants :
  • Calendrier : Quotidien
  • Messages : Messages

Remarque : les chaînes des vues par défaut sont automatiquement encodées par URL.

Le tri par défaut d'un affichage correspond à la manière dont le dossier doit être trié s'il a été ouvert dans le client Outlook Web App.

Les chaînes identifiant les affichages ne sont pas localisées et ne sont pas sensibles à la casse.

 Les affichages disponibles varient en fonction du type de dossier.

Affichages du calendrier :
  • Quotidien : affichage calendrier quotidien
  • Hebdomadaire : affichage calendrier hebdomadaire
  • Mensuel : affichage calendrier mensuel

Affichages des messages :

  • Messages : affichage message, avec tri par défaut
  • By%20Sender : affichage des messages triés par De avec les noms d’expéditeur commençant par « a » en haut
  • By%20Subject : affichage message trié par objet avec des sujets qui commencent par « a » en haut
  • By%20Conversation%20Topic: Conversation View, not available in the light version of Outlook Web App
d, m, y (facultatif) Spécifie la date à laquelle le calendrier doit s'afficher. Ces paramètres peuvent apparaître dans n'importe quel ordre et être utilisés individuellement ou non.

Si l'un de ces paramètres n'est pas spécifié, les valeurs par défaut sont le jour, le mois et l'année en cours. Par exemple, si la date du jour est le 3 mai 2016 et si vous spécifiez la valeur « 9 » pour le mois de septembre, la date affichée sera le 3 septembre 2016.		 Les valeurs valides pour les paramètres de données sont les suivantes :

d=[1-31] ;

m=[1-12] ;

y=[année indiquée par quatre chiffres].

Pour ouvrir un calendrier à la date du 3 mai 2016, vous devez utiliser l’URL suivante : https://<server name>/owa/?cmd=content&fpath=calendar&view=daily&d=3&m=5&y=2016
part (facultatif) Indique qu'Outlook Web App doit afficher un composant WebPart réduit. Lorsque vous utilisez les composants WebPart pour accéder au contenu Outlook Web App, l'IU qui s'affiche est plus petite que l'IU Outlook Web App complète. Le paramètre part réduit davantage l'IU. L'exemple d'URL suivant affiche la liste des tâches dans le plus petit format de composant WebPart :

https://<server name>/owa/?cmd=contents&part=1

Le paramètre part ne s'applique pas au module calendrier.
FolderList Le paramètre de ce composant inclut le contrôle de liste des dossiers pour les utilisateurs qui souhaitent naviguer dans les sous-dossiers. Il s'applique uniquement aux dossiers de messagerie. https://<server name>/owa/?cmd=contents&folderlist=1

Entrer manuellement les composants WebPart Outlook Web App

Les composants WebPart Outlook Web App peuvent également être entrés manuellement dans un navigateur web. Par exemple, un utilisateur peut se servir d'une URL de composant WebPart Outlook Web App pour ouvrir le calendrier d'un autre utilisateur.

Les exemples ci-dessous montrent comment accéder directement aux affichages courants d'Outlook Web App :

  • Boîte de réception : https://<server name>_/owa/?cmd=contents\&module=inbox
  • Calendrier (aujourd’hui) : https://<server name>/owa/?cmd=contents\&module=calendar\&exsvurl=1
  • Calendrier (hebdomadaire) : https://<server name>/owa/?cmd=contents\&module=calendar\&view=weekly\&exsvurl=1
  • Calendrier (mensuel) : https://<server name>/owa/?cmd=contents\&module=calendar\&view=monthly\&exsvurl=1

Informations supplémentaires