Distribución de tarjetas de presentación electrónicas en Outlook 2007

Paquetes de soluciones de ejemplo

Las soluciones de ejemplo se empaquetan como archivos IExpress. Al hacer doble clic en el paquete de IExpress, se le pide que indique una ubicación de carpeta para los archivos.

La solución de ejemplo para implementar tarjetas de presentación electrónicas con un sitio de Office SharePoint Server 2007 es el documento de ejemplo de implementación en SharePoint de plantillas de tarjeta de presentación electrónica. La solución de ejemplo para implementar tarjetas de presentación con una solución de .NET es el documento de ejemplo de implementación en .NET de plantillas de tarjeta de presentación electrónica.

Los archivos y carpetas siguientes se incluyen en el paquete de la solución de ejemplo de SharePoint (EBCSharePoint.exe):

Los archivos y carpetas siguientes se incluyen en el paquete de la solución de ejemplo de .NET (EBCNet.exe):

Trabajo con la solución de ejemplo de SharePoint: introducción

Los pasos para trabajar con la solución de ejemplo de SharePoint se presentan aquí. Para obtener descripciones detalladas que hacen referencia al código de ejemplo, vea Uso de un sitio de SharePoint para distribuir tarjetas de presentación, más adelante en este tema.

Instale y configure el entorno siguiente para trabajar con la solución de ejemplo de SharePoint:

• Office SharePoint Server 2007 debe estar instalado en un equipo local que ejecute Microsoft Windows Server 2003 o posterior.

• Debe haber un sitio de Office SharePoint Server 2007 disponible, configurado con perfiles de usuario.

Con los requisitos instalados, siga estos pasos para instalar y configurar la solución para el entorno de la organización. En primer lugar, configure el archivo Web.Config.

1. Abra el archivo Web.Config del paquete de descarga en un editor y establezca el valor de SiteURL en la dirección URL del sitio de SharePoint (por ejemplo, direcciónURLDelSitioDeSharePoint).

2. Abra el archivo Web.Config del sitio de SharePoint en un editor y copie la sección appSettings del archivo Web.Config del paquete de descarga en la sección appSettings del archivo Web.Config del sitio de SharePoint. El archivo Web.Config del sitio está ubicado en el directorio principal de SharePoint.

3. Guarde los archivos Web.Config y salga de los editores.

Siga estas instrucciones para encontrar el archivo Web.Config del sitio de SharePoint.

Para encontrar el directorio principal de un sitio de SharePoint

1. En Windows, haga clic en el menú Inicio y, a continuación, en Herramientas administrativas.

2. Haga clic en Administrador de Internet Information Services (IIS) y expanda el nodo del equipo.

3. Expanda Sitios web y haga clic cn el botón secundario en la aplicación web apropiada (por ejemplo, SharePoint (80)).

4. Haga clic en Propiedades.

5. Haga clic en la ficha Directorio particular.

Después de configurar el archivo Web.Config, debe compilar la solución y colocar los archivos necesarios en las carpetas correctas.

Para compilar la solución

1. Abra EBCDeploymentExample.sln en Microsoft Visual Studio 2005.

2. Compile el proyecto.

3. Copie el ensamblado compilado, ubicado de forma predeterminada en bin\debug, o bien en bin\release si compila en modo Liberar, en la caché de ensamblados global. Para obtener instrucciones más detalladas, vea Copia de la solución en la memoria caché de ensamblados global en la sección "Uso de un sitio de SharePoint para distribuir tarjetas de presentación", más adelante en este tema.

4. Copie EBCDeploymentExample.aspx y la carpeta Templates en <unidad de instalación de SharePoint>\Archivos de programa\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS.

Es posible que deba cambiar los permisos de EBCDeploymentExample.aspx para copiar el archivo.

Navegue a http://direcciónURLDelSitioDeSharePoint/_layouts/EBCDeploymentExample.aspx para explorar la solución de ejemplo.

Cuando los usuarios hacen clic en una imagen de tarjeta, ven un cuadro de diálogo similar al siguiente ejemplo:

Cuando los usuarios hacen clic en Abrir, la tarjeta de presentación se agrega a Contactos en Outlook y se personaliza con su información de contacto.

Trabajo con la solución de ejemplo de .NET: introducción

Los pasos para trabajar con la solución de ejemplo de .NET se presentan aquí. Para obtener descripciones detalladas que hacen referencia al código de ejemplo, vea Uso de un sitio web interno de .NET 2.0 para distribuir tarjetas de presentación, más adelante en este tema.

Para trabajar con la solución de ejemplo de .NET, Microsoft Visual Studio 2005 debe estar instalado en el equipo local. También resulta útil usar un sitio web local al trabajar con la solución de ejemplo.

Configure el entorno para usar la solución de ejemplo.

1. En Visual Studio, abra un sitio web existente y seleccione la carpeta de ejemplo.

2. En el menú Sitio Web, haga clic en Agregar referencia... y seleccione System.DirectoryServices.

3. En el menú Sitio Web, haga clic en Agregar referencia... y seleccione System.Drawing.

4. En el Explorador de soluciones, haga clic con el botón secundario en EBCDeploymentExample.aspx y seleccione Establecer como página de inicio.

5. Edite el archivo Web.Config del paquete de descarga en un editor y establezca los valores de userName y password con un nombre de usuario y una contraseña válidos en el dominio.

   [!NOTA] No es seguro incluir en un archivo un nombre de usuario y una contraseña en texto sin formato. Para obtener información acerca de la creación de una solución más segura, consulte los artículos sobre cómo usar la utilidad ASP.NET para cifra las credenciales y las cadenas de conexión de estado de sesión y la guía del programador de .NET Framework: representación de ASP.NET.

6. En Web.Config, establezca ADPath para que señale a una instancia de Active Directory válida en la red.

7. Guarde el archivo Web.Config y salga del editor.

Tras completar estos pasos de configuración, podrá ver la solución de ejemplo si hace clic en Ejecutar para ejecutar el sitio web en Visual Studio.

Cuando los usuarios hacen clic en una imagen de tarjeta, ven un cuadro de diálogo similar al siguiente ejemplo:

Cuando hacen clic en Abrir, la tarjeta de presentación se agrega a Contactos en Outlook y se personaliza con su información de contacto.

Creación de una tarjeta de presentación en un nuevo contacto de Outlook

El primer paso para proporcionar una tarjeta de presentación electrónica para que los usuarios la puedan descargar es diseñar una tarjeta de presentación para que se use como plantilla. Para ello, se crea una tarjeta de presentación en un nuevo contacto de Outlook.

Para crear una tarjeta de presentación electrónica en Outlook

1. En el menú Archivo, elija Nuevo y haga clic en Contacto.

2. Escriba un nombre para el contacto (por ejemplo, Tarjeta de ejemplo).

3. Escriba información en las tarjetas de presentación. Por ejemplo, puede incluir lo siguiente:

   • Nombre completo

   • Puesto

   • Compañía

   • Teléfono del trabajo

   • Fax del trabajo

   • Dirección de correo electrónico

Incluya todos los elementos que desee que aparezcan en la tarjeta de presentación. Los elementos específicos de cada persona se rellenarán con la información personal de dicha persona cuando se descargue la tarjeta de presentación. Es posible que otros elementos, como el número de fax del trabajo, sean los mismos para todas las personas de la organización.

Una vez creada la tarjeta de presentación con información de ejemplo, haga clic en Tarjeta de presentación en la cinta de opciones del elemento de contacto para abrir el editor de tarjetas de presentación electrónicas (EBC).

En el editor, diseñe la tarjeta de presentación de forma que incluya el diseño y las características. Por ejemplo, para importar un logotipo corporativo, haga cli en Cambiar en el área Diseño de tarjeta. Ajuste el diseño, el área y la alineación de la imagen hasta que el logotipo aparezca en el lugar correcto de la tarjeta.

Ajuste los campos de texto para que el texto aparezca en el orden deseado y tenga el tamaño y el color correctos. También puede cambiar el color de fondo.

Haga clic en Guardar y cerrar para guardar los cambios.

Procedimiento para guardar una plantilla de tarjeta de presentación electrónica en un servidor web

A continuación, debe guardar la tarjeta como archivo en el servidor web que proporciona el sitio web donde los usuarios obtienen vistas previas de las tarjetas de presentación y las descargan.

Para guardar una tarjeta de presentación electrónica como archivo en el servidor web

1. Haga clic en el contacto que creó para seleccionarlo.

2. En el menú Archivo, haga clic en Guardar como.

3. En la lista Guardar en, desplácese a la carpeta del servidor web donde se ubicarán las plantillas.

4. En el cuadro Nombre de archivo, escriba un nombre descriptivo para el archivo, como oficina.vcf.

5. En la lista Guardar como tipo, haga clic en Archivos vCard.

Creación de una imagen de vista previa de la tarjeta de presentación electrónica

Si tiene más de un diseño de tarjeta de presentación, puede ayudar a los usuarios a decidir qué tarjeta deben descargar si proporciona una imagen de vista previa de las plantillas de tarjeta de presentación.

Para proporcionar una imagen de vista previa de una plantilla de tarjeta de presentación

1. En Outlook, abra el elemento de contacto que contiene la tarjeta de presentación que diseñó y que desea usar como plantilla.

2. Haga clic con el botón secundario en la imagen de la tarjeta de presentación para abrir el elemento de contacto.

3. En el menú contextual, haga clic en Copiar imagen.

4. En el menú Herramientas de Microsoft Paint, haga clic en Editar.

5. Haga clic en Pegar para pegar la imagen de vista previa.

6. En el menú Herramientas, haga clic en Archivo.

7. Haga clic en Guardar y seleccione la carpeta donde guardó el archivo vCard anteriormente.

Creación de un proyecto de biblioteca de clases C#

Mediante la creación de una biblioteca de clases, se configura el proyecto para compilar el ensamblado. Posteriormente, el ensamblado compilado puede copiarse en la memoria caché de ensamblados global (GAC). Para que EBCDeploymentExample.aspx y EBCDeploymentExample.aspx.cs funcionen juntos en SharePoint, EBCDeploymentExample.aspx debe hacer referencia a un ensamblado en la GAC que contenga el código C# compilado de EBCDeploymentExample.aspx.cs.

Para crear un nuevo proyecto de ensamblado C# en Visual Studio

1. En el menú Archivo de Visual Studio, haga clic en Nuevo y, a continuación, en Proyecto.

2. En el área Tipos de proyecto del cuadro de diálogo Nuevo proyecto, haga clic en Visual C#.

3. En el área Plantillas:, haga clic en Biblioteca de clases.

4. En el campo Nombre:, escriba un nombre para el proyecto (por ejemplo, EBCDeploymentExample) y especifique una ubicación o use la ubicación predeterminada.

5. Haga clic en Aceptar.

   
   

Firma del ensamblado con una clave de nombre seguro

Para que el ensamblado compilado sea de confianza en SharePoint, debe estar firmado con una clave de nombre seguro. Para firmar el ensamblado compilado, use la clave de nombre seguro proporcionada con la solución de ejemplo en el archivo ExampleAssembly.snk, o bien, cree su propia clave de nombre seguro.

Para firmar un ensamblado compilado con la clave de nombre seguro proporcionada en el ejemplo

1. En Visual Studio, vaya al Explorador de soluciones.

2. Haga clic con el botón secundario en EBCDeploymentExample y haga clic en Propiedades.

3. En la ficha Firma, active la caslla Firmar el ensamblado.

4. En la lista desplegable Seleccione un archivo de clave de nombre seguro:, haga clic en**<Examinar...>**.

5. En el cuadro de diálogo Abrir archivo, desplácese al archivo ExampleAssembly.snk y haga clic en Abrir.

6. En el menú Archivo, haga clic en Guardar para guardar el cambio.

   
   

Para obtener más información acerca de las claves de nombre seguro y la firma de ensamblados, vea la sección sobre la creación de ensamblados del manual del programador de .NET Framework y la sección sobre cómo firmar un ensamblado con un nombre seguro del manual del programador de .NET Framework.

Especificación de opciones para la solución personalizada

Para personalizar la solución de ejemplo de manera que funcione en su entorno, debe proporcionar el código de servidor con la siguiente información:

• La ubicación de las plantillas que se muestra en la página Tarjetas de presentación electrónicas.

• El formato de las imágenes en miniatura que corresponden a cada tarjeta de presentación. Este formato es la extensión que se usa al guardar las vistas previas de las tarjetas de presentación; por ejemplo, .jpg.

• La dirección URL del sitio de SharePoint donde se ejecutará esta solución.

El archivo Web.Config de SharePoint es un método útil para poner esta información a disposición del código del servidor. El archivo Web.Config se encuentra en el directorio principal del sitio de SharePoint. Para encontrar el directorio principal de un sitio de SharePoint, siga el procedimiento incluido anteriormente en este tema, Para encontrar el directorio principal de un sitio de SharePoint, en la sección Trabajo con la solución de ejemplo de SharePoint: introducción.

Copie los parámetros del archivo Web.Config incluido en la solución de ejemplo que descargó en el bloque appSettings del archivo Web.Config de SharePoint. Cambie el valor de siteURL por la dirección URL del sitio de SharePoint local. Si es necesario, actualice los valores de las opciones templatePath y templateFormat.

<configuration>

...

</appSettings>

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

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

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

...

</appSettings>

...

</configuration>

Adición de referencias necesarias

Para que la solución de ejemplo funcione correctamente, debe agregar ciertas referencias a la solución. Agregue las siguientes referencias a la solución en Visual Studio; para ello, haga clic con el botón secundario en el proyecto EBCDeploymentExample y haga clic en Agregar referencia…:

• System

• Sstem.Configuration

• System.Drawing

• System.Web

• Microsoft.SharePoint

• Microsoft.Office.Server

La solución de ejemplo usa los perfiles de usuario de SharePoint como orígenes de los datos de la información de contacto de los empleados. En la sección siguiente se proporciona información detallada acerca del uso de perfiles de usuario en la aplicación de ejemplo. El trabajo con perfiles de usuario es más cómodo si incluye referencias específicas en el código. Agregue lo siguiente al archivo EBCDeploymentExample.aspx.cs:

using System;

...

using Microsoft.SharePoint;

using Microsoft.Office.Server.UserProfiles;

Recuperación de la información de contacto mediante el acceso a perfiles de usuario de SharePoint

Los perfiles de usuario de SharePoint proporcionan una interfaz de programación de aplicaciones (API) coherente para tener acceso a los datos de los usuarios de SharePoint, independientemente del origen de datos original (por ejemplo, Active Directory o un directorio LDAP). En la solución de ejemplo, los perfiles de usuario proporcionan la información de contacto de los empleados necesaria para completar las tarjetas de presentación.

Realice los pasos siguientes para recuperar la información de contacto de los empleados y rellenar una tarjeta de presentación:

1. Busque el perfil de usuario de SharePoint del empleado que ha elegido una tarjeta de presentación para descargarla.

2. Cree propiedades para cada elemento (nombre, puesto, etc.).

3. Extraiga el valor de cada elemento del perfil de usuario (UserProfile).

En primer lugar, busque el perfil de SharePoint del usuario. Vea la función PopulateCard() de la solución de ejemplo.

// 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);

A continuación, cree las propiedades de cada elemento.

UserProfileValueCollection givenName = null;

UserProfileValueCollection lastName = null;

UserProfileValueCollection jobTitle = null;

UserProfileValueCollection email = null;

UserProfileValueCollection phone = null;

UserProfileValueCollection company = null;

Recupere los valores de las propiedades de UserProfile. Las propiedades que no se incluyen en elementos UserProfile de forma predeterminada se pueden incluir en ellos cuando SharePoint se sincronice con el origen de los datos de los usuarios. Por ejemplo, "company" no es una propiedad de UserProfile predeterminada. En este ejemplo de código, "company" se asigna al campo Company (Compañía) en el directorio que proporciona a SharePoint los datos de contaco de los empleados.

givenName = user[PropertyConstants.FirstName];

lastName = user[PropertyConstants.LastName];

jobTitle = user[PropertyConstants.Title];

email = user[PropertyConstants.WorkEmail];

phone = user[PropertyConstants.WorkPhone];

company = user["company"];

Para obtener más información acerca de la definición de propiedades adicionales de UserProfile de SharePoint, vea el artículo acerca de los servicios de personalización de Productos y Tecnologías de SharePoint (en inglés).

Uso de plantillas de sitio para obtener un aspecto coherente

La configuración de páginas nuevas hospedadas en un sitio de SharePoint para que sigan el aspecto y la apariencia del sitio resulta sencilla. Para que la página nueva se ajuste perfectamente al resto del sitio, sólo hay que especificar un archivo de página maestra y agregar secciones asp:Content para el encabezado, el pie y otros paneles comunes de las páginas en el sitio de SharePoint.

Observe que para que una página hospedada por SharePoint pueda tener acceso a un ensamblado compilado (como EBCDeploymentExample.aspx), la página debe hacer referencia al nombre, la versión y el token de clave pública del ensamblado. Estos valores se especifican mediante el parámetro Inherits, como se muestra en el ejemplo siguiente.

Los parámetros del archivo de página maestra (MasterPageFile) y de herencia (Inherits) se establecen en la etiqueta Page, situada al principio del archivo EBCDeploymentExample.aspx.

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

Las secciones de contenido especifican los componentes estándar de SharePoint que siguen una plantilla de sitio de SharePoint. La sección de contenido siguiente ilustra cómo puede seguir la plantilla de sitio.

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

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

</asp:Content>

Hospedaje de la página nueva en el sitio de SharePoint

Para hospedar la página nueva en SharePoint, se debe colocar en el directorio virtual LAYOUTS de SharePoint. Para ello, copie el archivo EBCDeploymentExample.aspx en la siguiente carpeta:

1. <unidadDelSistema> :\Archivos de programa\Common Files\Microsoft Shared\web server extensions\12\TEMPLATE\LAYOUTS

   A continuación, los usuarios podrán tener acceso a la página en la ubicación siguiente:

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

   Donde ejemplo es el nombre del sitio de SharePoint.

Copia de la solución en la memoria caché de ensamblados global

Los últimos pasos de la implementación de la solución de ejemplo de SharePoint consisten en compilar el ensamblado y, a continuación, copiarlo en la memoria caché de ensamblados global (GAC), donde EBCDeploymentExample está configurado para tener acceso al ensamblado. Copie el ensamblado compilado (EBCDeploymentxample.dll) de <carpetaDeProyecto> \bin\debug a la GAC, que se encuentra en <unidadDelSistema> :\windows\assembly. Si compila en modo Liberar, la carpeta será bin\release en lugar de \bin\debug.

Para copiar el ensamblado en la nueva carpeta, abra las dos carpetas en el Explorador de Windows y arrastre el archivo .dll desde la carpeta \debug a la carpeta de la GAC.

A continuación, puede navegar a http://direcciónURLDelSitioDeSharePoint/_layouts/EBCDeploymentExample.aspx para explorar la solución de ejemplo.

Apertura de un sitio web actual en Visual Studio

Para empezar a trabajar con la solución de .NET de ejemplo proporcionada en el paquete de descarga, abra un sitio web local en Microsoft Visual Studio (VS) 5.0 y navegue a la carpeta que contiene la solución de ejemplo. Cuando se abre un sitio web existente en VS, el proyecto de VS reconoce la relación entre los archivos EBCDeploymentExample.aspx y EBCDeploymentExample.aspx.cs. La configuración del sitio web se importa automáticamente del archivo Web.config de la solución de ejemplo.

Para usar un sitio web existente con la solución de ejemplo en Visual Studio

1. En el menú Archivo de Visual Studio, haga clic en Abrir y, a continuación, en Sitio web.

2. Desplácese a la carpeta que contiene la solución de ejemplo del paquete de descarga.

3. Haga clic en Aceptar.

Especificación de opciones para la solución personalizada

Para personalizar la solución de ejemplo de manera que funcione en su entorno, debe proporcionar el código de servidor con la siguiente información:

• La ubicación de las plantillas que se muestra en la página Tarjetas de presentación electrónicas.

• El formato de las imágenes en miniatura que corresponden a cada tarjeta e presentación. Este formato es la extensión que se usa al guardar las vistas previas de las tarjetas de presentación; por ejemplo, .jpg.

• La ruta de acceso de carpeta de Active Directory que proporciona los datos de los empleados usados para personalizar las plantillas de tarjeta de presentación.

• El método de autenticación; por ejemplo, autenticación de Windows.

• Las credenciales de suplantación.

Si lo desea, puede optar por proporcionar referencias a ensamblados en el compilador de Visual Studio. Las referencias necesarias para la solución de ejemplo se proporcionan en las instrucciones correspondientes más adelante.

El archivo Web.Config del sitio web es un método útil para poner a disposición del código del servidor esta información. Abra el archivo Web.Config de la solución de ejemplo para establecer los valores de los parámetros de la configuración.

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

Es importante especificar una instancia de Active Directory válida para el parámetro ADPath. Los parámetros userName y password representan el nombre de usuario y la contraseña de la cuenta de servicio del sitio web. Una forma más segura de proporcionar credenciales es cifrar los valores en lugar de dejarlos como texto no cifrado. Para obtener más información acerca del cifrado de credenciales, vea el artículo sobre cómo usar la utilidad ASP.NET para cifrar las credenciales y las cadenas de conexión de estado de sesión.

Adición de referencias necesarias

Debe agregar referencias específicas a la solución para que la solución de ejemplo funcione correctamente. En Visual Studio, haga clic con el botón secundario en el proyecto EBCDeploymentExample y haga clic en Agregar referencia… para agregar cada una de las referencias siguientes a la solución.

• System

• System.Configuration

• System.DirectoryServices

• System.Web

La referencia System.DirectoryServices es necesaria para conectarse a Active Directory y ejecutar consultas en este servicio.

El trabajo con Active Directory es más cómodo si incluye referencias específicas en el código. Agregue la referencia siguiente al archivo EBCDeploymentExample.aspx.cs:

...

Using System.DirectoryServices;

Conexión a Active Directory

Para conectarse a Active Directory, cree un parámetro DirectoryEntry que incluya la variable de ruta de acceso de Active Directory ( ADPath ):

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

Consulta e información de contacto de los empleados en Active Directory

La función DirectorySearcher se usa para consultar la información de contacto de los empleados en Active Directory. Cree la función con el parámetro DirectoryEntry creado en la sección anterior.

DirectorySearcher ds = new DirectorySearcher(de);

A continuación, determine la identidad del usuario que visita el sitio web. Quite el dominio de la identidad del usuario y asegúrese de que sólo se recuperan los datos específicos del usuario con el alias correcto. En este ejemplo se da por supuesto que el formato de las direcciones de correo electrónico de la organización es alias@dominio.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 + ")";

A continuación, especifique las propiedades del contacto de Outlook (vCard) que se recuperará, para poder actualizarlo posteriormente.

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.

Busque en el directorio el usuario con el alias especificado y almacene los resultados en SearchResultCollection.

SearchResultCollection data = ds.FindAll();

Acceso a la información de contacto en los resultados de consulta de Active Directory

Después de recuperar la información de contacto de Active Directory, esta información se usa para personalizar la tarjeta de presentación del empleado.

Para tener acceso a la información de contacto en los resultados de consulta de Active Directory, primero debe crear propiedades para la información de contacto.

PropertyValueCollection givenName = null;

PropertyValueCollection lastName = null;

PropertyValueCollection jobTitle = null;

PropertyValueCollection email = null;

PropertyValueCollection phone = null;

PropertyValueCollection company = null;

A continuación, busque los valores de las propiedades en el conjunto de resultados.

// 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 = esultEntry.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();

}

Cuando el empleado descargue la tarjeta de presentación, ya estará rellenada con su información de contacto.