Distribuer des cartes de visite électroniques dans Outlook 2007

Packages d'exemples de solutions

Les exemples de solutions sont fournis sous forme de fichiers IExpress. Lorsque vous double-cliquez sur le package IExpress, vous êtes invité à indiquer un emplacement de dossier pour les fichiers.

L'exemple de solution pour déployer des cartes de visite électroniques à l'aide d'un site Office SharePoint Server 2007 est EBC Templates on SharePoint Deployment Example. L'exemple de solution pour déployer des cartes de visite à l'aide d'une solution .NET est EBC Templates on .NET Deployment Example.

Remarque :
Les informations techniques sur les spécifications vCard d'Outlook peuvent être utiles lorsque vous personnalisez une solution de distribution de cartes de visite électroniques. Pour en savoir plus sur les cartes Outlook vCard, consultez le livre blanc consacré aux extensions Outlook vers le format vCard 2.1 inclus dans le package de téléchargement.

Les fichiers et dossiers suivants figurent dans le package d'exemple de solutions SharePoint (EBCSharePoint.exe) :

Les fichiers et dossiers suivants figurent dans le package d'exemple de solutions .NET (EBCNet.exe) :

Utilisation de l'exemple de solution SharePoint : vue d'ensemble

Les étapes à suivre pour utiliser l'exemple de solution SharePoint sont exposées ici. Pour obtenir une description détaillée qui fait référence à l'exemple de code, voir Utilisation d'un site SharePoint pour distribuer des cartes de visite plus loin dans cette rubrique.

Installez et configurez l'environnement suivant pour qu'il fonctionne avec l'exemple de solution SharePoint :

• Office SharePoint Server 2007 doit être installé sur un ordinateur local exécutant Microsoft Windows Server 2003 ou une version ultérieure.

• Un site Office SharePoint Server 2007 doit être disponible, configuré avec les profils utilisateur.

Une fois les conditions requises rassemblées, procédez comme suit pour installer et configurer la solution pour l'environnement de votre organisation. Tout d'abord, configurez le fichier Web.Config.

1. Ouvrez le fichier Web.Config à partir du package de téléchargement dans un éditeur et définissez SiteURL sur l'URL de votre site SharePoint (par exemple, URLSiteSharePoint).

2. Ouvrez le fichier Web.Config de votre site SharePoint dans un éditeur et copiez la section appSettings du fichier Web.Config du package de téléchargement dans la section appSettings du fichier Web.Config du site SharePoint. Le fichier Web.Config du site se trouve dans le répertoire de base de SharePoint.

3. Enregistrez les fichiers Web.Config et quittez les éditeurs.

Suivez les instructions ci-dessous pour rechercher le fichier Web.Config de votre site SharePoint.

Pour rechercher le répertoire de base d'un site SharePoint

1. Dans Windows, cliquez sur le menu Démarrer, puis sur Outils d'administration.

2. Cliquez sur Gestionnaire des services Internet (IIS) et développez le nœud correspondant à votre ordinateur.

3. Développez Sites Web, puis cliquez avec le bouton droit sur l'application Web appropriée (par exemple, SharePoint (80)).

4. Cliquez sur Propriétés.

5. Cliquez sur l'onglet Répertoire de base.

Après avoir configuré le fichier Web.Config, vous compilez la solution et placez les fichiers nécessaires dans les dossiers corrects.

Pour compiler la solution

1. Ouvrez EBCDeploymentExample.sln dans Microsoft Visual Studio 2005.

2. Compilez le projet.

3. Copiez l'assembly compilé, situé dans bin\debug par défaut ou bin\release si vous compilez en mode Release, dans le Global Assembly Cache. Pour plus d'informations, voir Copier la solution dans le Global Assembly Cache dans la section « Utilisation d'un site SharePoint pour la distribution des cartes de visite » plus loin dans cette rubrique.

4. Copiez EBCDeploymentExample.aspx et le dossier Templates dans <Lecteur d'installation de SharePoint>\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS.

Vous devrez peut-être modifier les autorisations sur EBCDeploymentExample.aspx pour copier ce fichier.

Accédez à http://URLSiteSharePoint/_layouts/EBCDeploymentExample.aspx pour explorer l'exemple de solution.

Lorsque les utilisateurs cliquent sur l'image d'une carte, une boîte de dialogue semblable à l'exemple suivant s'affiche :

Lorsque les utilisateurs cliquent sur Ouvrir, la carte de visite est ajoutée aux Contacts dans Outlook et la carte est personnalisée avec leurs informations de contact.

Utilisation de l'exemple de solution .NET : vue d'ensemble

Les étapes à suivre pour utiliser l'exemple de solution .NET sont décrites ici. Pour obtenir une description détaillée qui fait référence à l'exemple de code, voir Utilisation d'un site Web interne .NET 2.0 pour la distribution des cartes de visite plus loin dans cette rubrique.

Pour utiliser l'exemple de solution .NET, Microsoft Visual Studio 2005 doit être installé sur votre ordinateur local. Il est également utile d'utiliser un site Web local lorsque vous utilisez l'exemple de solution.

Configurez l'environnement pour qu'il utilise l'exemple de solution.

1. Dans Visual Studio, ouvrez un site Web existant et sélectionnez le dossier de l'exemple.

2. Dans le menu Site Web, cliquez sur Ajouter une référence..., puis sélectionnez System.DirectoryServices.

3. Dans le menu Site Web, cliquez sur Ajouter une référence..., puis sélectionnez System.Drawing.

4. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur EBCDeploymentExample.aspx et sélectionnez Définir en tant que page de démarrage.

5. Modifiez le fichier Web.Config du package de téléchargement dans un éditeur et définissez userName et password sur un nom d'utilisateur et un mot de passe valides sur votre domaine.

   Remarque :

   L'insertion d'un nom d'utilisateur et d'un mot de passe en texte brut dans un fichier n'est pas une solution sécurisée. Pour plus d'informations sur la création d'une solution plus sécurisée, voir les articles suivants : Comment faire pour utiliser l'utilitaire ASP.NET pour chiffrer des chaînes d'identification et de connexion pour l'état de la session et Guide du développeur . NET Framework : emprunt d'identité ASP.NET .

6. Dans le fichier Web.Config, définissez ADPath pour qu'il pointe vers un annuaire Active Directory valide sur votre réseau.

7. Enregistrez le fichier Web.Config et quittez l'éditeur.

Après avoir effectué ces étapes de configuration, vous pouvez voir l'exemple de solution en cliquant sur Exécuter pour exécuter le site Web dans Visual Studio.

Lorsque les utilisateurs cliquent sur l'image d'une carte, une boîte de dialogue semblable à l'exemple suivant s'affiche :

Lorsqu'ils cliquent sur Ouvrir, la carte de visite est ajoutée aux Contacts dans Outlook et la carte est personnalisée avec leurs informations de contact.

Création d'une carte de visite dans un nouveau contact Outlook

La première étape de la fourniture aux utilisateurs d'une carte de visite électronique téléchargeable consiste à concevoir une carte de visite utilisable comme modèle. Pour ce faire, vous créez une carte de visite dans un nouveau contact Outlook.

Pour créer une carte de visite électronique dans Outlook

1. Dans le menu Fichier, pointez sur Nouveau, puis cliquez sur Contact.

2. Tapez le nom du contact (par exemple, Exemple de carte).

3. Entrez des informations sur les cartes de visite, par exemple les détails suivants :

   • Nom complet

   • Fonction

   • Société

   • Téléphone professionnel

   • Télécopie (bureau)

   • Adresse de messagerie

Incluez tous les éléments qui doivent figurer sur la carte de visite. Les éléments propres à chaque personne seront remplis sur la base de ses informations personnelles, au téléchargement de la carte de visite. D'autres éléments, tels que le numéro de télécopie professionnel, peuvent être identiques pour tous les membres de l'organisation.

Une fois la carte de visite créée avec les exemples d'informations, cliquez sur Carte de visite dans le ruban d'élément de contact pour ouvrir l'éditeur de carte de visite électronique (EBC, Electronic Business Card).

Dans l'éditeur, concevez la carte de visite pour y inclure la disposition et les caractéristiques. Par exemple, vous pouvez importer un logo d'entreprise en cliquant sur Modifier dans la zone Conception de la carte. Ajustez la disposition, l'étendue et l'alignement de l'image jusqu'à ce que votre logo soit affiché comme il convient sur la carte.

Ajustez les champs de texte pour que le texte apparaisse dans l'ordre souhaité et dans la taille et la couleur correctes. Vous pouvez également modifier la couleur d'arrière-plan.

Cliquez sur Enregistrer et fermer pour enregistrer vos modifications.

Enregistrement d'un modèle de carte de visite électronique sur un serveur Web

Ensuite, vous enregistrez la carte en tant que fichier sur le serveur Web qui fournit le site Web où les personnes affichent l'aperçu et téléchargent les cartes de visite.

Pour enregistrer une carte de visite électronique en tant que fichier sur le serveur Web

1. Sélectionnez le contact que vous avez créé.

2. Dans le menu Fichier, cliquez sur Enregistrer sous.

3. Dans la liste Enregistrer dans, recherchez le dossier sur votre serveur Web où résideront vos modèles.

4. Dans la zone Nom de fichier, donnez un nom descriptif au fichier, par exemple office.vcf.

5. Dans la liste Type de fichier, cliquez sur Fichiers vCard.

Création d'une image d'aperçu de la carte de visite électronique

Si vous avez plus d'un style de carte de visite, vous pouvez aider les personnes à décider quelle carte télécharger en fournissant une image d'aperçu des modèles de carte de visite.

Pour fournir une image d'aperçu d'un modèle de carte de visite

1. Dans Outlook, ouvrez l'élément Contact contenant la carte de visite que vous avez créée pour l'utiliser comme modèle.

2. Cliquez avec le bouton droit sur l'image de carte de visite dans l'élément Contact ouvert.

3. Dans le menu contextuel, cliquez sur Copier l'image.

4. Dans Microsoft Paint, dans le menu Outils, cliquez sur Modifier.

5. Cliquez sur Coller pour coller l'image d'aperçu.

6. Dans le menu Outils, cliquez sur Fichier.

7. Cliquez sur Enregistrer et sélectionnez le dossier où vous avez enregistré votre carte vCard.

Créer un projet de bibliothèque de classes C#

Lorsque vous créez une bibliothèque de classes, votre projet est configuré pour se compiler dans un assembly. L'assembly compilé peut ultérieurement être copié dans le Global Assembly Cache (GAC). Pour que EBCDeploymentExample.aspx et EBCDeploymentExample.aspx.cs fonctionnent ensemble dans SharePoint, EBCDeploymentExample.aspx doit faire référence à un assembly dans le GAC qui contient le code C# compilé de EBCDeploymentExample.aspx.cs.

Pour créer un nouveau projet d'assembly C# dans Visual Studio

1. Dans Visual Studio, dans le menu Fichier, cliquez sur Nouveau, puis sur Projet.

2. Dans la boîte de dialogue Nouveau projet, dans la zone Types de projet :, cliquez sur Visual C# .

3. Dans la zone Modèles :, cliquez sur Bibliothèque de classes.

4. Dans le champ Nom :, tapez le nom du projet (par exemple, EBCDeploymentExample) et spécifiez un emplacement ou utilisez l'emplacement par défaut.

5. Cliquez sur OK.

   
   

Signer l'assembly avec une clé de nom fort

Pour que l'assembly compilé soit approuvé dans SharePoint, il doit être signé avec une clé de nom fort. Vous pouvez signer l'assembly compilé à l'aide de la clé de nom fort fournie avec l'exemple de solution dans le fichier ExampleAssembly.snk ou créer votre propre clé de nom fort.

Pour signer un assembly compilé avec la clé de nom fort fournie dans l'exemple

1. Dans Visual Studio, accédez à l'Explorateur de solutions.

2. Cliquez avec le bouton droit sur EBCDeploymentExample, puis cliquez sur Propriétés.

3. Sous l'onglet Signature, activez la case à cocher Signer l'assembly.

4. Dans la zone de liste déroulante Choisir un fichier de clé de nom fort :, cliquez sur <Parcourir…> .

5. Dans la boîte de dialogue Ouvrir le fichier, accédez au fichier ExampleAssembly.snk et cliquez sur Ouvrir.

6. Dans le menu Fichier, cliquez sur Enregistrer pour enregistrer la modification.

   
   

Pour plus d'informations sur les clés de nom fort et la signature d'assemblys, voir les ressources suivantes : Guide du développeur .NET Framework : Création d'assemblys et Guide du développeur .NET Framework : Comment : signer un assembly avec un nom fort.

Spécifier les options de votre solution personnalisée

Pour personnaliser l'exemple de solution pour qu'elle fonctionne dans votre environnement, vous devez fournir au code serveur les informations suivantes :

• Emplacement des modèles à afficher sur la page des cartes de visite électroniques

• Format des images miniatures qui correspondent à chaque carte de visite. Ce format est l'extension que vous avez utilisée lors de l'enregistrement des aperçus de carte de visite ; par exemple, .jpg

• URL du site SharePoint sur lequel cette solution sera exécutée

Le fichier Web.Config SharePoint est un moyen pratique de mettre ces informations à la disposition du code serveur. Le fichier Web.Config se trouve dans le répertoire de base du site SharePoint. Pour trouver le répertoire de base d'un site SharePoint, suivez la procédure décrite plus haut dans cette rubrique, Pour localiser le répertoire de base d'un site SharePoint, dans la section Utilisation de l'exemple de solution SharePoint : vue d'ensemble.

Copiez les paramètres du fichier Web.Config, inclus dans l'exemple de solution téléchargé, dans le bloc appSettings de votre fichier Web.Config SharePoint. Remplacez la valeur de siteURL par l'URL de votre site SharePoint local. Si nécessaire, mettez à jour les valeurs des paramètres templatePath et templateFormat.

<configuration>

...

</appSettings>

<add key="templatePath" value="~/_layouts/Templates" />

<add key="templateFormat" value="jpg" />

<add key="siteURL" value="http://example" />

...

</appSettings>

...

</configuration>

Ajouter les références requises

Pour que l'exemple de solution fonctionne correctement, vous devez y ajouter certaines références. Pour ajouter les références suivantes à votre solution dans Visual Studio, cliquez avec le bouton droit sur le projet EBCDeploymentExample, puis choisissez Ajouter une référence… :

• System

• System.Configuration

• System.Drawing

• System.Web

• Microsoft.SharePoint

• Microsoft.Office.Server

L'exemple de solution utilise les profils utilisateur SharePoint comme source de données pour les informations de contact des employés. La section suivante contient des informations détaillées sur l'utilisation des profils utilisateur dans l'exemple d'application. L'utilisation des profils utilisateur est plus pratique si vous incluez des références spécifiques dans le code. Ajoutez ce qui suit à EBCDeploymentExample.aspx.cs :

using System;

...

using Microsoft.SharePoint;

using Microsoft.Office.Server.UserProfiles;

Récupérer les informations de contact en accédant aux profils utilisateur SharePoint

Les profils utilisateur SharePoint fournissent une interface de programmation d'application (API) uniforme pour accéder aux données des utilisateurs SharePoint, indépendamment de la source de données d'origine (par exemple, Active Directory ou un annuaire LDAP). Dans l'exemple de solution, les profils utilisateur fournissent les informations de contact des employés pour compléter une carte de visite.

Procédez comme suit pour récupérer les informations de contact d'un employé et remplir une carte de visite :

1. Recherchez le profil utilisateur SharePoint de l'employé qui a choisi une carte de visite à télécharger.

2. Créez des propriétés pour chaque élément (nom, fonction, etc.).

3. Extrayez la valeur de chaque élément du profil utilisateur.

Tout d'abord, recherchez le profil SharePoint de l'utilisateur. Consultez la fonction PopulateCard() dans l'exemple de solution.

// Obtain the location of this SharePoint site.

String siteURL = ConfigurationManager.AppSettings["siteURL"];

// Create a Profile Manager for this site.

UserProfileManager profileManager = new UserProfileManager(Microsoft.Office.Server.ServerContext.GetContext(new SPSite(siteURL)));

// Find the identity of the user accessing this page.

string sAccount = this.User.Identity.Name;

// Get the SharePoint profile for the user with the given identity.

UserProfile user = profileManager.GetUserProfile(sAccount);

Ensuite, créez les propriétés de chaque élément.

UserProfileValueCollection givenName = null;

UserProfileValueCollection lastName = null;

UserProfileValueCollection jobTitle = null;

UserProfileValueCollection email = null;

UserProfileValueCollection phone = null;

UserProfileValueCollection company = null;

Récupérez les valeurs des propriétés à partir de UserProfile. Les propriétés qui ne figurent pas dans UserProfile par défaut peuvent être incluses dans UserProfile lorsque SharePoint se synchronise avec la source de données utilisateur. Par exemple, « company » n'est pas une propriété UserProfile par défaut. Dans cet exemple de code, « company » est mappé au champ Company dans l'annuaire qui fournit les données de contact des employés à SharePoint.

givenName = user[PropertyConstants.FirstName];

lastName = user[PropertyConstants.LastName];

jobTitle = user[PropertyConstants.Title];

email = user[PropertyConstants.WorkEmail];

phone = user[PropertyConstants.WorkPhone];

company = user["company"];

Pour plus d'informations sur la définition de propriétés UserProfile SharePoint supplémentaires, voir Services de personnalisation dans les produits et technologies SharePoint (en anglais) .

Utiliser des modèles de site pour en uniformiser l'apparence

Il est simple de configurer de nouvelles pages hébergées sur un site SharePoint qui respectent l'apparence et le ton du site. En spécifiant un fichier de page maître, puis en ajoutant des sections ASP:Content pour l'en-tête, le pied de page et les autres volets communs aux pages de votre site SharePoint, la nouvelle page s'ajuste uniformément au reste du site.

Notez que pour qu'une page hébergée par SharePoint accède à un assembly compilé (tel que EBCDeploymentExample.aspx), elle doit faire référence au nom, à la version et au jeton de clé publique de l'assembly. Pour spécifier ces valeurs, utilisez le paramètre Inherits, comme indiqué dans l'exemple suivant.

Le fichier de page maître et les paramètres Inherits sont définis dans la balise Page en haut de EBCDeploymentExample.aspx.

<%@ Page Language="C#" MasterPageFile="~/_layouts/simple.master" ValidateRequest="False" Inherits="EBCDeployment.Example, EBCDeploymentExample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=0bac7bedd8e30aa1" %>

Les sections de contenu spécifient les composants SharePoint standard qui suivent un modèle de site SharePoint. La section de contenu suivante illustre comment vous pouvez suivre le modèle de site.

<asp:Content ID="PageTitle" ContentPlaceHolderId="PlaceHolderPageTitle" runat="server">

<SharePoint:EncodedLiteral ID="EncodedLiteral1" runat="server" text="Electronic Business Cards" EncodeMethod='HtmlEncode'/>

</asp:Content>

Héberger la nouvelle page dans votre site SharePoint

Pour héberger la nouvelle page dans SharePoint, placez la page dans le répertoire virtuel SharePoint LAYOUTS. Pour ce faire, copiez le fichier EBCDeploymentExample.aspx dans le dossier suivant :

1. <Lecteur_système>:\Program Files\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS

   À présent, les utilisateurs peuvent accéder à la page à l'emplacement suivant :

2. http://exemple /_layouts/EBCDeploymentExample.html.

   Où exemple représente le nom de votre site SharePoint.

Copier la solution dans le Global Assembly Cache

Les dernières étapes d'implémentation de l'exemple de solution SharePoint consistent à compiler l'assembly, puis à le copier dans le Global Assembly Cache (GAC), où EBCDeploymentExample est configuré pour y accéder. Copiez l'assembly compilé, EBCDeploymentExample.dll, depuis <dossier_projet>\bin\debug dans le GAC, qui se trouve dans <lecteur_système>:\Windows\assembly. Si vous compilez en mode Release, le dossier sera bin\release au lieu de \bin\debug.

Pour copier votre assembly dans le nouveau dossier, ouvrez les deux dossiers dans l'Explorateur Windows et faites glisser le fichier .dll du dossier \debug dans le dossier GAC.

Remarque :
Vous devrez peut-être réinitialiser les services Internet (IIS) pour que la nouvelle page SharePoint puisse accéder à l'assembly et fonctionner correctement. Pour réinitialiser les services Internet (IIS), ouvrez une fenêtre de commande Windows et tapez iisreset.

Accédez à http://URLSiteSharePoint/_layouts/EBCDeploymentExample.aspx pour explorer l'exemple de solution.

Ouverture d'un site Web actuel dans Visual Studio

Pour commencer à utiliser l'exemple de solution .NET fourni dans le package de téléchargement, ouvrez un site Web local dans Microsoft Visual Studio 5.0 et accédez au dossier contenant l'exemple de solution. Lorsque vous ouvrez un site Web existant dans Visual Studio, le projet Visual Studio reconnaît la relation entre les fichiers EBCDeploymentExample.aspx et EBCDeploymentExample.aspx.cs. La configuration du site Web est importée automatiquement à partir du fichier Web.config de l'exemple de solution.

Pour utiliser un site Web existant avec l'exemple de solution dans Visual Studio

1. Dans Visual Studio, dans le menu Fichier, cliquez sur Ouvrir, puis sur Site Web.

2. Accédez au dossier contenant l'exemple de solution dans le package de téléchargement.

3. Cliquez sur OK.

Spécifier les options de votre solution personnalisée

Pour personnaliser la solution exemple afin qu'elle fonctionne dans votre environnement, vous devez fournir au code serveur les informations suivantes :

• Emplacement des modèles à afficher sur la page des cartes de visite électroniques

• Format des images miniatures qui correspondent à chaque carte de visite. Ce format est l'extension que vous avez utilisée lors de l'enregistrement des aperçus de carte de visite ; par exemple, .jpg

• Chemin d'accès au dossier de l'annuaire Active Directory fournisseur des données des employés destinées à personnaliser les modèles de carte de visite

• Méthode d'authentification ; par exemple, authentification Windows

• Informations d'identification pour l'emprunt d'identité

Vous pouvez également choisir de fournir des références d'assembly pour le compilateur Visual Studio. Les références requises pour l'exemple de solution sont indiquées dans les instructions « Ajouter les références requises » d'une section ultérieure.

Le fichier Web.Config du site Web est un moyen pratique de mettre ces informations à la disposition du code serveur. Ouvrez le fichier Web.Config dans l'exemple de solution pour définir les valeurs des paramètres de votre configuration.

<configuration>

<appSettings>

<add key="templatePath" value="~/Templates"/>

<add key="templateFormat" value="jpg"/>

<add key="ADPath" value="LDAP://ServerName.exchange.yourdomain.com/DC=exchange, DC=yourdomain,DC=com "/>

</appSettings>

<system.web>

<authentication mode="Windows"/>

<identity impersonate="true" userName="username"password="password"/>

</system.web>

</configuration>

Il est important de spécifier un annuaire Active Directory valide pour le paramètre ADPath. Les paramètres userName et password représentent le nom d'utilisateur et le mot de passe pour l'adresse du compte de service du site Web. Une méthode plus sûre pour fournir des informations d'identification consiste à chiffrer les valeurs au lieu de les laisser en texte clair. Pour plus d'informations sur le chiffrement des informations d'identification, voir Comment faire pour utiliser l'utilitaire ASP.NET pour chiffrer des chaînes d'identification et de connexion pour l'état de la session.

Ajouter les références requises

Vous devez ajouter à la solution des références spécifiques pour qu'elle puisse fonctionner correctement. Dans Visual Studio, cliquez avec le bouton droit sur le projet EBCDeploymentExample et cliquez sur Ajouter une référence… pour ajouter chacune des références suivantes à votre solution.

• System

• System.Configuration

• System.DirectoryServices

• System.Web

La référence System.DirectoryServices est requise pour se connecter à Active Directory et l'interroger.

L'utilisation d'Active Directory est plus pratique si vous incluez des références spécifiques dans le code. Ajoutez la référence suivante à EBCDeploymentExample.aspx.cs :

...

Using System.DirectoryServices;

Se connecter à Active Directory

Pour vous connecter à Active Directory, créez un paramètre DirectoryEntry qui contient la variable du chemin d'accès à Active Directory (ADPath) :

DirectoryEntry de = new DirectoryEntry(ConfigurationManager.AppSettings["ADPath"]);

Interroger Active Directory pour obtenir les informations de contact des employés

La fonction DirectorySearcher permet d'interroger Active Directory et d'obtenir les informations de contact des employés. Créez cette fonction à l'aide du paramètre DirectoryEntry créé dans la section précédente.

DirectorySearcher ds = new DirectorySearcher(de);

Déterminez ensuite l'identité de l'utilisateur qui visite le site Web. Supprimez le domaine de l'identité de l'utilisateur et assurez-vous que seules les données de l'utilisateur portant l'alias correct sont récupérées. Cet exemple suppose que le format des adresses de messagerie de votre organisation est alias@votre_domaine.com.

string longAlias = this.User.Identity.Name;

int start = longAlias.IndexOf("\\"); // Parse away the domain name.

int end = longAlias.Length; // Get the length of the alias.

string alias = longAlias.Substring(start + 1, (end - (start + 1)));

ds.Filter = "(mailnickname=" + alias + ")";

Spécifiez les propriétés du contact Outlook (vCard) qui seront récupérées, de sorte qu'il puisse être mis à jour ultérieurement.

ds.PropertiesToLoad.Add("givenName"); // Get the given name.

ds.PropertiesToLoad.Add("sn"); // Get the surname.

ds.PropertiesToLoad.Add("title"); // Get the job title.

ds.PropertiesToLoad.Add("mail"); // Get the email address.

ds.PropertiesToLoad.Add("telephoneNumber"); // Get the phone number.

ds.PropertiesToLoad.Add("company"); // Get the company name.

Recherchez dans l'annuaire l'utilisateur portant l'alias spécifié et stockez les résultats dans SearchResultCollection.

SearchResultCollection data = ds.FindAll();

Accédez aux informations de contact dans les résultats de l'interrogation d'Active Directory

Après avoir récupéré les informations de contact à partir d'Active Directory, vous pouvez les exploiter pour personnaliser la carte de visite de l'employé.

Pour accéder aux informations de contact dans les résultats de l'interrogation d'Active Directory, créez d'abord des propriétés pour les informations de contact.

PropertyValueCollection givenName = null;

PropertyValueCollection lastName = null;

PropertyValueCollection jobTitle = null;

PropertyValueCollection email = null;

PropertyValueCollection phone = null;

PropertyValueCollection company = null;

Recherchez ensuite les valeurs des propriétés dans le jeu de résultats.

// In case invalid data was returned, try...

try

{

// Get the properties needed for the EBC.

DirectoryEntry resultEntry = data[0].GetDirectoryEntry();

givenName = resultEntry.Properties["givenName"];

lastName = resultEntry.Properties["sn"];

jobTitle = resultEntry.Properties["title"];

email = resultEntry.Properties["mail"];

phone = resultEntry.Properties["telephoneNumber"];

company = resultEntry.Properties["company"];

}

catch (Exception)

{

// Create a writer for error output.

StreamWriter sw = new StreamWriter(Response.OutputStream);

sw.WriteLine("Error updating template!");

sw.Close();

}

Lorsque l'employé télécharge la carte de visite, elle est remplie avec ses informations de contact.