Personas y contactos en EWS en Exchange

Obtenga información sobre las personas, el Almacén de contactos unificado y cómo trabajar con contactos mediante la API administrada de EWS o EWS en Exchange.

Los contactos son elementos de Exchange que almacenan información sobre una persona, grupo u organización. Los contactos pueden incluir nombres y direcciones de correo electrónico, así como otra información, como direcciones de MI, direcciones físicas, cumpleaños, información de la familia y una foto o imagen que represente al contacto.

La información de contacto se almacena en uno de los dos lugares:

• Servicios de dominio de Active Directory (AD DS), si el contacto está dentro de la organización.

• La carpeta Contactos u otra carpeta del buzón de un usuario, si el contacto está fuera de la organización.

Varios elementos de contacto pueden representar a una sola persona. Exchange usa personas para ayudar a reunir estos diferentes elementos de contacto. Una persona es una agregación de información de contacto para el mismo individuo de orígenes diferentes. Además de la información de contacto de Exchange, los contactos también se pueden agregar a partir de información de la caché de destinatarios del buzón, una carpeta oculta para contactos de mensajería instantánea denominada QuickContacts y de orígenes de datos de terceros. El almacén de contactos unificado de Exchange permite a los clientes de mensajería instantánea usar esta agregación; la única diferencia es que el almacén de contactos unificado no agrega información de AD DS, como se muestra en la figura 1.

Figura 1. Orígenes de información de contacto para personas y para el almacén de contactos unificado

Tabla 1. Métodos de API administrada de EWS y operaciones de EWS para trabajar con contactos

Si quiere...	Uso de este método de API administrada de EWS	Uso de esta operación de EWS
Creación de un nuevo contacto	Crear una instancia de un nuevo objeto Contact y usar Contact.Save	CreateItem
Copia de un contacto	Contact.Copy	CopyItem
Mover un contacto	Contact.Move	MoveItem
Actualización de un contacto existente	Contact.Bind y Contact.Update	UpdateItem
Eliminación de un contacto	Contact.Bind y Contact.Delete	DeleteItem
Búsqueda de un contacto	ExchangeService.FindItems	FindItem
Busque personas	N/D	FindPeople
Expandir un grupo de distribución	ExchangeService.ExpandGroup	ExpandDL
Resolución de un nombre ambiguo	ExchangeService.ResolveName	ResolveNames
Obtener un personaje	N/D	GetPersona
Trabajar con fotos de contacto	Contact.SetContactPicture, Contact.GetContactPictureAttachment o Contact.RemoveContactPicture	GetUserPhoto o GetAttachment

Personas

Hasta hace poco, los contactos se almacenaban normalmente en una sola ubicación, normalmente, en un cliente de correo electrónico. Hoy en día, es cada vez más común almacenar contactos en muchas ubicaciones diferentes, como en un teléfono, en un sitio de redes sociales, en una carpeta Contactos en un buzón de Exchange o en el servicio de directorio de una organización. Con la proliferación de información de contacto, es posible que varios contactos que representan a la misma persona contengan información diferente; por ejemplo, un contacto podría incluir un número de teléfono comercial y otro un número de teléfono personal, o un contacto almacenado en una carpeta Contactos podría tener un nombre diferente al del contacto de la misma persona que se almacena en el teléfono.

En Exchange Online, Exchange Online como parte de Office 365 y versiones locales de Exchange a partir de Exchange 2013, los contactos de diferentes orígenes que representan a la misma persona se asocian entre sí, de forma similar a la forma en que los mensajes de correo electrónico se agregan a las conversaciones, mediante un identificador de vínculo común. Cuando un servidor exchange devuelve información de contacto agregada, incluye un conjunto de atributos para cada contacto, como una carpeta de origen, un nombre para mostrar, un identificador y un identificador de origen. La suma de las propiedades y atributos devueltos se conoce como persona y el conjunto de propiedades devueltas se conoce como la forma del personaje.

Dado que la información que constituye un rol no se almacena en una sola ubicación y porque esa información puede cambiar en cualquier momento, solo se crea una persona cuando se realiza una solicitud a un servidor exchange. Use la operación EWS FindPeople para realizar una solicitud de búsqueda de personas. La solicitud puede incluir un criterio de ordenación y se puede filtrar según una cadena de consulta para ayudarle a encontrar la persona correcta mediante el orden y el filtrado de los resultados. Por ejemplo, puede recuperar el nombre para mostrar y un conjunto de todas las direcciones de correo electrónico asociadas a un contacto específico de la carpeta Contactos, una cuenta de Hotmail, una cuenta de LinkedIn y el servicio de directorio de una empresa, o bien puede recuperar un conjunto de todas las personas que tienen direcciones de MI. La vinculación de contactos a personas es automática en función de un algoritmo que reconoce una relación entre los contactos almacenados en varios dispositivos.

Nota:

La API administrada de EWS no implementa esta funcionalidad.

Tabla 2. Operaciones de EWS para trabajar con personas

Nombre de operación	Descripción
FindPeople	Devuelve todos los contactos disponibles de una carpeta de contactos especificada o recupera los contactos que coinciden con una cadena de consulta especificada.
GetPersona	Devuelve un conjunto de propiedades asociadas a un rol específico, como todas las direcciones de MI o nombres para mostrar de un identificador de persona especificado.

Puede usar las operaciones GetPersona y FindPeople para recuperar de forma eficaz información de contacto de varios orígenes. Dado que todos los elementos relacionados con una persona están asociados a un identificador de vínculo, puede usar estas operaciones en una amplia variedad de aplicaciones que usan datos de contacto. A continuación se proporcionan ejemplos:

• Una aplicación de teléfono móvil que usa la operación GetPersona cuando un usuario llama a un contacto y, a continuación, ofrece números de teléfono adicionales para llamar si nadie responde.

• Aplicación que usa la operación FindPeople para examinar los mensajes de la Bandeja de entrada en busca de direcciones de correo electrónico con el fin de determinar si se encuentran en un rol existente. Las direcciones que aún no están asociadas a un rol se pueden usar para crear clientes potenciales de ventas o enumerar todas las comunicaciones recientes con la persona representada por esa persona.

• Una aplicación de correo para Outlook que ofrece diferentes saludos en función de si la correspondencia es formal o informal. Los saludos formales los proporcionan los nombres para mostrar del servicio de directorio y los saludos informales proceden del nombre para mostrar que se origina en los contactos de redes sociales.

Almacén de contactos unificado

Las personas no solo se limitan a un cliente de correo electrónico. Si va a desarrollar un cliente de mensajería instantánea, es posible que se pregunte a sí mismo alguna de las siguientes opciones:

• ¿Cómo puedo aprovisionar aplicaciones cliente de Lync con un conjunto predeterminado de elementos de contacto de mensajería instantánea?

• Cómo administrar listas de grupos y contactos de mensajería instantánea?

• Cómo administrar el acceso de cliente de Lync personalizado a los contactos de mensajería instantánea y los grupos de mensajería instantánea?

El Almacén de contactos unificado funciona en segundo plano en Exchange para agregar datos de contacto de Exchange y otros orígenes en una sola entidad o persona. Aunque las operaciones de EWS que se usan para acceder al Almacén de contactos unificado son específicas de los contactos de mensajería instantánea, puede usar el Almacén de contactos unificado de Exchange para trabajar con personas en todos los tipos de aplicaciones. Tenga en cuenta que el almacén de contactos unificado no puede acceder a los datos de contacto de AD DS.

Los contactos de mensajería instantánea se almacenan en una carpeta oculta denominada QuickContacts. Puede usar las operaciones AddNewImContactToGroup y AddImContactToGroup para agregar contactos a los grupos almacenados en esta carpeta oculta. Y como puedes usar el Almacén de contactos unificado para agrupar contactos de mensajería instantánea, puedes acceder y actualizar grupos de contactos más fácilmente.

Nota:

La API administrada de EWS no implementa esta funcionalidad.

Tabla 3. Operaciones de EWS para acceder al almacén de contactos unificado

Nombre de operación	Descripción
AddNewImContactToGroup	Agrega un nuevo contacto de mensajería instantánea a un grupo de mensajería instantánea, hasta un máximo de 1000 contactos.
AddImContactToGroup	Agrega un contacto de mensajería instantánea existente a un grupo de mensajería instantánea, hasta un máximo de 1000 contactos.
AddImGroup	Agrega un nuevo grupo de mensajería instantánea, hasta un máximo de 64 grupos.
AddDistributionGroupToImList	Agrega un nuevo grupo de distribución a un grupo de mensajería instantánea, hasta un máximo de 64 grupos.
GetImItemList	Recupera una lista de grupos de mensajería instantánea y contactos de mensajería instantánea.
GetImItems	Recupera información sobre grupos de mensajería instantánea específicos y contactos de mensajería instantánea.
RemoveContactFromImList	Quita un contacto de un grupo de mensajería instantánea.
RemoveImContactFromGroup	Quita un contacto de MI de un grupo de mensajería instantánea.
RemoveDistributionGroupFromImList	Quita un grupo de distribución de un grupo de mensajería instantánea.
RemoveImGroup	Quita un grupo de mensajería instantánea.
SetImGroup	Cambia el nombre para mostrar de un grupo de mensajería instantánea.

En esta sección

• Procesar contactos en lotes mediante EWS en Exchange

• Resolución de nombres ambiguos mediante EWS en Exchange 2013

• Obtener fotos de usuario mediante EWS en Exchange

Vea también

• Desarrollo de clientes de servicios web de Exchange

• Empezar a usar los servicios web de Exchange

• Introducción al diseño de EWS cliente de Exchange