Procédure de configuration des composants WebPart dans Outlook Web Access

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Dernière rubrique modifiée : 2009-10-29

Cette rubrique décrit les composants WebPart Microsoft Office Outlook Web Access et leur utilisation pour ouvrir des dossiers spécifiques. Les composants WebPart Outlook Web Access permettent de spécifier la boîte aux lettres à ouvrir, le dossier à ouvrir dans la boîte aux lettres et l'affichage du contenu à utiliser.

Les composants WebPart Outlook Web Access permettent d'accéder au contenu Outlook Web Access 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 sur la base de sélections effectuées dans une interface utilisateur ou directement intégrés dans une application, telle qu'une page Microsoft Office SharePoint Server 2007. Le code de l'interface utilisateur crée ensuite l'URL. Les composants WebPart Outlook Web Access permettent d'afficher la boîte de réception ou le calendrier d'un utilisateur dans une page Office SharePoint Server 2007.

Notes

Pour utiliser les WebPart Outlook Web Access, la boîte aux lettres de l’utilisateur et la boîte aux lettres en cours d’ouverture via un WebPart doivent être installées dans une même forêt Active Directory.

Autorisations pour l'utilisation des composants WebPart Outlook Web Access

Pour utiliser les composants WebPart Outlook Web Access, vous devez au minimum disposer de l'accès « Relecteur » au contenu que vous êtes en train d'ouvrir. Si vous avez intégré un composant WebPart Outlook Web Access 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 Access pour 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 Access sans avoir à entrer de nouveau leurs informations d'identification.

Syntaxe des composants WebPart Outlook Web Access

Exchange 2007 Outlook Web Access inclut un nouveau format d'URL à utiliser pour les demandes au répertoire virtuel /owa. Ces demandes peuvent être effectuées en tapant une URL directement dans un navigateur Web ou en intégrant l'URL dans une application Web, telle qu'une page Office SharePoint Server.

Les composants WebPart Outlook Web Access 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 d'une 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.

Par exemple, l'URL de composant WebPart simple https://<nom du serveur>/owa/?cmd=contents ouvre la boîte de réception de la boîte aux lettres identifiée par l'ouverture de session de l'utilisateur. L'URL de composant WebPart plus complexe https://<nom du serveur>/owa/<adresse SMTP>/?cmd=contents&f=inbox%2fProjects&view=by%20subject ouvre la boîte aux lettres spécifiée par l'adresse SMTP dans le sous-dossier Projets, trié par objet.

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.

Les composants WebPart Microsoft Exchange 2000 et Exchange 2003 sont automatiquement convertis en composants WebPart Exchange 2007.

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

Tableau 1   Paramètres de composant WebPart et leur utilisation

Paramètre d'URL Description Valeurs et exemples

Nom du serveur et répertoire (obligatoire)

URL du répertoire virtuel d'Outlook Web Access

Il peut s'agir de la même URL que celle dont se servent les utilisateurs pour ouvrir une session sur Outlook Web Access, par exemple :

https://<nom du serveur>/owa

Identification de boîte aux lettres par ouverture de session explicite Exchange 2007 (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 dont l'adresse SMTP est tsmith@fourthcoffee.com, utilisez :

https://<nom du serveur>/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=contents affiche le composant WebPart Outlook Web Access spécifié par les paramètres au lieu de l'interface utilisateur Outlook Web Access complète.

Si aucune boîte aux lettres n'est spécifiée, ce paramètre suit le répertoire du serveur :

https://<nom du serveur>/owa/?cmd=contents

Si une boîte aux lettres est spécifiée, ce paramètre suit l'identification de boîte aux lettres explicite :

https://<nom du serveur>/owa/<adresse SMTP>/?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.

id (facultatif)

ID du dossier à partir duquel le composant WebPart doit afficher le contenu. L'ID de dossier peut être déterminé à l'aide des services Web et être utilisé dans les applications pour sélectionner de façon dynamique le dossier à ouvrir.

L'ID de dossier correspond à la propriété PR_ENTRY_ID codée en Base64 du dossier :

https://<nom du serveur>/owa/?cmd=contents&id=<PR_ENTRY_ID>

f (facultatif)

Chaîne spécifiant le dossier de boîte aux lettres devant s'afficher dans le composant WebPart. L'URL de composant WebPart 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 :

https://<nom du serveur>/owa/?cmd=contents&f= inbox%2fprojects

module (facultatif)

Ce paramètre permet de spécifier l'un des quatre dossiers par défaut sans connaître le nom localisé.

Les valeurs du paramètre de module ne sont pas sensibles à la casse et incluent les éléments suivants :

  • Boîte de réception

  • Calendrier

  • Contacts

  • Tâches

  • Publicfolders

Pour ouvrir le calendrier d'une boîte aux lettres indépendamment de la localisation :

https://<nom du serveur>/owa/?cmd=contents&module=calendar

view (facultatif)

Ce paramètre spécifie l'affichage du dossier.

Lorsque ce paramètre est inexistant, les affichages par défaut sont les suivants :

  • Calendar   Daily

  • Messages   Messages

  • Contacts   Two%20Line

  • Tâches   By%20Due%20Date

> [!Note] > Les chaînes des affichages par défaut sont automatiquement codées dans l'URL.

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

Les affichages de composant WebPart Exchange 2003 non pris en charge dans Exchange 2007 sont les suivants :

  • Contacts   Carte de visite et carte de visite détaillée

  • Messages   Non lus par sujet de conversation et destinataire.

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 :

  • Daily   Affichage du calendrier quotidien

  • Weekly   Affichage du calendrier hebdomadaire

  • Monthly   Affichage du calendrier mensuel

Affichages des messages :

  • Messages   Affichage un message par ligne, tri par défaut

  • By%20Sender   Affichage un message par ligne, tri par expéditeur selon l'ordre alphabétique

  • By%20Subject   Affichage un message par ligne, tri par objet selon l'ordre alphabétique

  • By%20Conversation%20Topic   Affichage Conversations, uniquement disponible dans Outlook Web Access Premium

  • Two%20Line   Affichage deux lignes par message, tri par défaut, uniquement disponible dans Outlook Web Access Premium

Affichages des contacts :

  • Phone%20List   Affichage un contact par ligne, tri par défaut

  • Two%20Line   Affichage deux lignes par contact, tri par défaut, uniquement disponible dans Outlook Web Access Premium

Affichages des tâches :

  • By%20Due%20Date   Affichage un contact par ligne, tri par défaut

  • By%20Subject   Affichage un contact par ligne, tri par objet selon l'ordre alphabétique

https://<nom du serveur>/owa/?cmd=contents&f=Calendar&view=Weekly affiche le calendrier demandé selon l'affichage hebdomadaire (weekly).

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 2007 et que vous spécifiez la valeur « 9 » pour le mois de septembre, la date affichée sera le 3 septembre 2007.

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 2007, vous utilisez https://<nom du serveur>/owa/?cmd=content&f=calendar&view=daily&d=3&m=5&y=2007

part (facultatif)

Spécifie qu'Outlook Web Access doit afficher un composant WebPart réduit.

Lorsque vous utilisez les composants WebPart pour accéder au contenu Outlook Web Access, l'IU qui s'affiche est plus petite que l'IU Outlook Web Access complète. Le paramètre part réduit davantage l'IU. Cet exemple affiche la liste des tâches dans le plus petit format de composant WebPart :

https://<nom du serveur>/owa/?cmd=contents&f=tasks&part=1

Les figures 1 et 2 affichent l'IU qu'Outlook Web Access affiche avec et sans le paramètre part=1 appliqué au composant WebPart Tâches.

La figure 1 montre le composant WebPart Outlook Web Access Tâches sans le paramètre part=1.

Figure 1   URL de composant WebPart sans Part=1

Composant WebPart sans 1

La figure 2 montre le composant WebPart Outlook Web Access Tâches avec le paramètre part=1.

Figure 2   URL de composant WebPart avec Part=1

Composant WebPart avec 1

Vous pouvez utiliser plusieurs paramètres pour spécifier le dossier à afficher et son format d'affichage. Si plus d'un paramètre de dossier est utilisé, l'ordre de priorité est id, f, puis module. Si aucun de ces paramètres n'est présent, la boîte de réception est affichée par défaut.

Notes

Si une fonction a été désactivée à l'aide de la segmentation, elle n'est pas disponible en tant que composant WebPart. Par exemple, si le calendrier Outlook Web Access a été désactivé, vous ne pourrez pas accéder aux calendriers via les composants WebPart Outlook Web Access.

Utilisation manuelle des composants WebPart Outlook Web Access

Les composants WebPart Outlook Web Access 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 Access pour ouvrir le calendrier d'un autre utilisateur.

Pour ouvrir un calendrier spécifique dans un affichage hebdomadaire (weekly) :

  1. Ouvrez une fenêtre du navigateur Web.

  2. Entrez l'URL d'Outlook Web Access et ajoutez la chaîne suivante à la fin de l'URL : <adresse SMTP de la boîte aux lettres>/?cmd=contents&f=calendar&view=weekly.

  3. Entrez les informations d'identification d'ouverture de session si vous y êtes invité.

Par exemple, si l'URL d'Outlook Web Access est https://email.fourthcoffee.com/owa, l'URL suivante ouvre le calendrier de l'utilisateur tsmith en affichage hebdomadaire :

https://email.fourthcoffee.com/owa/tsmith@fourthcoffee.com/?cmd=contents\&f=calendrier\&view=weekly

Pour accéder directement à un dossier spécifique dans les dossiers publics, ajoutez la chaîne &f=<Nom_dossier> à l'URL /owa/?cmd=contents&module=PublicFolders. Par exemple, l'URL complète pour accéder à un dossier spécifique dans les dossiers publics est semblable à ce qui suit :

https://cas.contoso.com/owa/?cmd=contents\&module=PublicFolders\&f=\<Nom_dossier>

Pour chaque niveau de dossier inférieur à ce niveau auquel vous voulez accéder, vous devez ajouter la chaîne %2f<Nom_dossier>. Par exemple, pour accéder à un dossier au niveau suivant dans la hiérarchie de dossiers publics, l'URL complète doit être semblable à ce qui suit :

https://cas.contoso.com/owa/?cmd=contents\&module=PublicFolders\&f=\<Nom_dossier>%2f<Nom_dossier>

Pour chaque niveau de dossier auquel vous voulez accéder, ajoutez la chaîne %2f<Nom_dossier>. Par exemple, si vous voulez accéder à un dossier avec une imbrication de quatre niveaux dans les dossiers publics, utilisez une URL semblable à ce qui suit :

https://cas.contoso.com/owa/?cmd=contents\&module=PublicFolders\&f=\<Nom_dossier>%2f<Nom_dossier>%2f<Nom_dossier>%2f<Nom_dossier>

Pour plus d'informations

Pour plus d'informations sur les composants WebPart et la planification des pages Web, consultez les pages suivantes :

Pour plus d'informations sur l'authentification Outlook Web Access, consultez les rubriques suivantes :