Utilisation des composants WebPart Outlook Web App

  • Article

 

S’applique à : Exchange Server 2010 SP2, Exchange Server 2010 SP3

Dernière rubrique modifiée : 2016-11-28

Les composants WebPart Microsoft Office Outlook Web App 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 App 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, comme une page MicrosoftOffice SharePoint Server 2007 ou SharePoint Server 2010. Le code de l’interface utilisateur crée ensuite l’URL. Les composants WebPart Outlook Web App permettent notamment d’afficher la boîte de réception ou le calendrier d’un utilisateur dans une page SharePoint Server 2007 ou SharePoint Server 2010.

RemarqueRemarque :
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 des composants WebPart Outlook Web Access

Pour utiliser les composants WebPart Outlook Web App, vous devez au minimum disposer de l’accès « Relecteur » 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 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 App sans avoir à entrer de nouveau leurs informations d’identification.

Syntaxe des composants WebPart Outlook Web App

Outlook Web App dans Microsoft Exchange Server 2010 comporte 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 (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.

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&fpath=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.

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

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://<nom du serveur>/owa

Identification de boîte aux lettres par ouverture de session explicite Exchange 2010 (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 l’URL suivante :

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 App spécifié par les paramètres au lieu de l’interface utilisateur Outlook Web App complète.

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://<nom du serveur>/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://<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, par exemple :

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

fpath (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 l’URL suivante :

https://<nom du serveur>/owa/?cmd=contents&fpath= 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 :

  • Inbox

  • Calendar

  • Contacts

  • Tasks

  • Publicfolders

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

https://<nom du serveur>/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 :

  • Calendar   Daily

  • Messages   Messages

  • Contacts   Two%20Line

  • Tasks   By%20Due%20Date

RemarqueRemarque :
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 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 :

  • Daily   Affichage du calendrier quotidien

  • Weekly   Affichage du calendrier hebdomadaire

  • Monthly   Affichage du calendrier mensuel

Affichages des messages :

  • Messages   Affichage des messages, avec tri par défaut

  • By%20Sender   Affichage des messages triés par expéditeur dans l’ordre alphabétique

  • By%20Subject   Affichage des messages triés par objet dans l’ordre alphabétique

  • By%20Conversation%20Topic   Affichage Conversation non disponible dans la version légère d’Outlook Web App 

Affichages des contacts :

  • Phone%20List   Affichage des contacts avec tri par défaut

Affichages des tâches :

  • By%20Due%20Date   Affichage des tâches avec tri par défaut

  • By%20Subject   Affichage des tâches triées par objet dans l’ordre alphabétique

https://<nom du serveur>/owa/?cmd=contents&fpath=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 03.05.10 et si vous spécifiez la valeur « 9 » pour le mois de septembre, la date affichée sera le 03.09.10.

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

part (facultatif)

Spécifie 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://<nom du serveur>/owa/?cmd=contents&fpath=tasks&part=1

Le paramètre part ne s’applique pas au module calendrier.

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

URL de composant WebPart sans Part=1

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

URL de composant WebPart avec Part=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.

RemarqueRemarque :
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 App a été désactivé, vous ne pourrez pas accéder aux calendriers via les composants WebPart Outlook Web App.

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.

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 App en y ajoutant la chaîne suivante à la fin : <adresse SMTP de la boîte aux lettres>/?cmd=contents&fpath=calendar&view=weekly.

  3. Entrez les informations d’identification de connexion si vous y êtes invité.

Par exemple, si l’URL d’Outlook Web App est https://email.fourthcoffee.com/owa, l’URL suivante ouvre alors le calendrier de l’utilisateur tsmith en affichage hebdomadaire : https://email.fourthcoffee.com/owa/tsmith@fourthcoffee.com/?cmd=contents\&fpath=calendar\&view=weekly

Pour plus d’informations

 © 2010 Microsoft Corporation. Tous droits réservés.