Pessoas e contatos no EWS no ExchangePeople and contacts in EWS in Exchange

Saiba mais sobre personas, o repositório unificado de contatos e como trabalhar com contatos usando a API gerenciada do EWS ou o EWS no Exchange.Learn about personas, the Unified Contact Store, and how to work with contacts by using the EWS Managed API or EWS in Exchange.

Os contatos são itens no Exchange que armazenam informações sobre um indivíduo, grupo ou organização.Contacts are items in Exchange that store information about an individual, group, or organization. Os contatos podem incluir nomes e endereços de email e outras informações, incluindo endereços de mensagens instantâneas, endereços físicos, aniversários, informações da família e uma foto ou imagem que representa o contato.Contacts can include names and email addresses, and other information, including IM addresses, physical addresses, birthdays, family information, and a photo or image that represents the contact.

As informações de contato são armazenadas em um dos dois locais:Contact information is stored in one of two places:

  • Active Directory Domain Services (AD DS), se o contato estiver dentro da organização.Active Directory Domain Services (AD DS), if the contact is within the organization.

  • A pasta contatos ou outra pasta na caixa de correio de um usuário, se o contato estiver fora da organização.The Contacts folder or another folder in a user's mailbox, if the contact is outside the organization.

Vários itens de contato podem representar uma única pessoa.Multiple contact items can represent a single individual. O Exchange usa personas para ajudar a trazer esses diferentes itens de contato juntos.Exchange uses personas to help bring these different contact items together. Uma pessoa é uma agregação de informações de contato para a mesma pessoa de fontes diferentes.A persona is an aggregation of contact information for the same individual from different sources. Além das informações de contato no Exchange, as pessoas também podem ser agregadas das informações no cache de destinatários da caixa de correio, uma pasta oculta para contatos de mensagens instantâneas chamadas QuickContacts e de fontes de dados de terceiros.In addition to contact information in Exchange, personas can also be aggregated from information in the recipient cache for the mailbox, a hidden folder for IM contacts called QuickContacts, and from third-party data sources. O repositório unificado de contatos no Exchange permite que clientes de mensagens instantâneas usem essa agregação; a única diferença é que o repositório unificado de contatos não agrega informações do AD DS, conforme mostrado na Figura 1.The Unified Contact Store in Exchange enables IM clients to use this aggregation; the only difference is that the Unified Contact Store does not aggregate information from AD DS, as shown in Figure 1.

Figura 1. Fontes de informações de contato para pessoas e para o repositório unificado de contatosFigure 1. Contact information sources for personas and for the Unified Contact Store

Imagem que mostra as fontes que são agregadas em personas em comparação com as fontes que são incluídas no Repositório de Contatos Unificado. O Repositório de Contatos Unificado não agrega informações de contato do serviço de diretório.

Tabela 1. Métodos da API gerenciada do EWS e operações do EWS para trabalhar com contatosTable 1. EWS Managed API methods and EWS operations for working with contacts

Se você quiser...If you want to… Usar este método de API gerenciada do EWSUse this EWS Managed API method Use esta operação do EWSUse this EWS operation
Criar um novo contatoCreate a new contact
Criar uma instância de um novo objeto de contato e usar Contact. SaveInstantiate a new Contact object, and use Contact.Save
CreateItemCreateItem
Copiar um contatoCopy a contact
Contato. CopyContact.Copy
CopyItemCopyItem
Mover um contatoMove a contact
Contato. moveContact.Move
MoveItemMoveItem
Atualizar um contato existenteUpdate an existing contact
Contact. bind e Contact. UpdateContact.Bind and Contact.Update
UpdateItemUpdateItem
Excluir um contatoDelete a contact
Contact. bind e Contact. DeleteContact.Bind and Contact.Delete
DeleteItemDeleteItem
Pesquisar um contatoSearch for a contact
ExchangeService. FindItemsExchangeService.FindItems
FindItemFindItem
Pesquisar pessoasSearch for people
N/AN/A
FindPeopleFindPeople
Expandir um grupo de distribuiçãoExpand a distribution group
ExchangeService. ExpandExchangeService.ExpandGroup
ExpandDLExpandDL
Resolver um nome ambíguoResolve an ambiguous name
ExchangeService. ResolveNameExchangeService.ResolveName
ResolveNamesResolveNames
Obter uma pessoaGet a persona
N/AN/A
GetpersonaGetPersona
Trabalhar com fotos de contatoWork with contact photos
Contact. SetContactPicture, Contact. GetContactPictureAttachmentou Contact. RemoveContactPictureContact.SetContactPicture, Contact.GetContactPictureAttachment, or Contact.RemoveContactPicture
GetUserPhoto ou GetAttachmentGetUserPhoto or GetAttachment

PersonasPersonas

Até recentemente, os contatos geralmente eram armazenados em um único local, geralmente, em um cliente de email.Until recently, contacts were commonly stored in a single location — typically, on an email client. Hoje, é mais comum armazenar contatos em vários locais diferentes, como em um telefone, em um site de rede social, em uma pasta de contatos em uma caixa de correio do Exchange ou em um serviço de diretório da organização.Today, it is becoming more common to store contacts in many different locations, such as on a phone, on a social networking site, in a Contacts folder in an Exchange mailbox, or in an organization's directory service. Com a proliferação de informações de contato, é possível que vários contatos que representem a mesma pessoa contenham informações diferentes; por exemplo, um contato pode incluir um número de telefone comercial e outro número de telefone pessoal, ou um contato armazenado em uma pasta de contatos pode ter um nome diferente do contato para a mesma pessoa que está armazenada em seu telefone.With the proliferation of contact information, it's possible that multiple contacts that represent the same person contain different information; for example, one contact might include a business phone number and another a personal phone number, or a contact stored in a Contacts folder might have a different name than the contact for the same person that is stored on your phone.

No Exchange Online, no Exchange Online como parte do Office 365 e nas versões locais do Exchange a partir do Exchange 2013, os contatos de fontes diferentes que representam a mesma pessoa estão associados, de maneira semelhante à forma como as mensagens de email são agregadas às conversas, por meio de uma ID de link comum.In Exchange Online, Exchange Online as part of Office 365, and on-premises versions of Exchange starting with Exchange 2013, contacts from different sources that represent the same person are associated with one another, similar to the way that email messages are aggregated into conversations, by means of a common link ID. Quando informações de contato agregadas são retornadas por um servidor Exchange, ela inclui um conjunto de atributos para cada contato, como uma pasta de origem, um nome de exibição, uma ID e uma ID de origem.When aggregated contact information is returned by an Exchange server, it includes a set of attributes for each contact, such as a source folder, a display name, an ID, and a source ID. A soma das propriedades e dos atributos retornados é conhecida como uma pessoa e o conjunto de propriedades retornado é referido como a forma da pessoa.The sum of the properties and attributes returned is known as a persona, and the set of properties returned is referred to as the persona's shape.

Como as informações que compõem uma pessoa não são armazenadas em um único local e as informações podem ser alteradas a qualquer momento, uma pessoa só é criada quando você faz uma solicitação a um servidor do Exchange.Because the information that makes up a persona is not stored in a single location, and because that information can change at any time, a persona is created only when you make a request to an Exchange server. Você usa a operação FindPeople EWS para fazer uma solicitação de pesquisa persona.You use the FindPeople EWS operation to make a persona search request. Sua solicitação pode incluir uma ordem de classificação e pode ser filtrada de acordo com uma cadeia de caracteres de consulta para ajudá-lo a encontrar a ordenação e filtragem dos resultados.Your request can include a sort order, and can be filtered according to a query string to help you find the correct persona by ordering and filtering the results. Por exemplo, você pode recuperar o nome de exibição e um conjunto de todos os endereços de email associados a um contato específico da pasta contatos, de uma conta do hotmail, de uma conta do LinkedIn e do serviço de diretório de uma empresa ou você pode recuperar um conjunto de todas as pessoas que têm endereços de mensagens instantâneas.For example, you can retrieve the display name and a set of all email addresses that are associated with a specific contact from the Contacts folder, a Hotmail account, a LinkedIn account, and a company's directory service, or you can retrieve a set of all personas that have IM addresses. A vinculação de contatos em personas é automática com base em um algoritmo que reconhece uma relação entre os contatos armazenados em vários dispositivos.The linking of contacts into personas is automatic based on an algorithm that recognizes a relationship between contacts stored on various devices.

Observação

A API gerenciada EWS não implementa essa funcionalidade.The EWS Managed API does not implement this functionality.

Tabela 2. Operações do EWS para trabalhar com pessoasTable 2. EWS operations for working with personas

Nome da operaçãoOperation name DescriçãoDescription
FindPeopleFindPeople
Retorna todas as personas disponíveis a partir de uma pasta de contatos especificada ou recupera contatos que correspondem a uma cadeia de caracteres de consulta especificada.Returns all available personas from a specified contacts folder or retrieves contacts that match a specified query string.
GetpersonaGetPersona
Retorna um conjunto de propriedades associadas a um persona específico, como todos os endereços de mensagens instantâneas ou nomes de exibição de uma ID persona especificada.Returns a set of properties associated with a specific persona, such as all the IM addresses or display names for a specified persona ID.

Você pode usar as operações Getpersona e FindPeople para recuperar com eficiência informações de contato de várias fontes.You can use the GetPersona and FindPeople operations to efficiently retrieve contact information from multiple sources. Como todos os itens relacionados a uma pessoa estão associados a um ID de link, você pode usar essas operações em uma ampla variedade de aplicativos que usam dados de contato.Because all items related to a persona are associated with a link ID, you can use these operations in a wide variety of applications that use contact data. Estes são alguns exemplos:The following are some examples:

  • Um aplicativo de telefone celular que usa a operação Getpersonum quando um usuário chama um contato e oferece números de telefone adicionais para chamar, se não houver uma resposta.A mobile phone app that uses the GetPersona operation when a user calls a contact, and then offers additional phone numbers to call if no one answers.

  • Um aplicativo que usa a operação FindPeople para verificar mensagens de caixa de entrada para endereços de email a fim de determinar se eles são encontrados em um persona existente.An application that uses the FindPeople operation to scan Inbox messages for email addresses to determine whether they are found in an existing persona. Os endereços que ainda não estão associados a um persona podem ser usados para criar clientes potenciais de vendas ou listar todas as comunicações recentes com a pessoa representada por esse persona.Addresses that are not already associated with a persona can be used to create sales leads or list all recent communications with the person represented by that persona.

  • Um aplicativo de email para o Outlook que oferece Saudações diferentes com base em se a correspondência é formal ou informal.A mail app for Outlook that offers different salutations based on whether correspondence is formal or informal. As saudações formais são fornecidas pelos nomes de exibição do serviço de diretório e de saudações informais provenientes do nome de exibição originado em contatos da rede social.Formal salutations are supplied by the display names from the directory service and informal salutations come from the display name that originates in social network contacts.

Armazenamento de Contato UnificadoUnified Contact Store

As pessoas não estão limitadas a um cliente de email.Personas aren't just limited to an email client. Se você estiver desenvolvendo um cliente de mensagens instantâneas, poderá fazer a si mesmo qualquer um ou todos os seguintes itens:If you're developing an IM client, you might ask yourself any or all of the following:

  • Como posso provisionar aplicativos cliente do Lync com um conjunto padrão de itens de contato de IM?How can I provision Lync client applications with a default set of IM contact items?

  • Como faço para gerenciar o contato IM e as listas de grupo?How do I manage IM contact and group lists?

  • Como gerenciar o acesso de cliente do Lync personalizado para contatos de mensagens instantâneas e grupos de mensagens instantâneas?How do I manage custom Lync client access to IM contacts and IM groups?

O repositório unificado de contatos funciona em segundo plano no Exchange para agregar dados de contato do Exchange e de outras fontes em uma única entidade, ou persona.The Unified Contact Store works behind the scenes in Exchange to aggregate contact data from Exchange and other sources into a single entity, or persona. Embora as operações do EWS que você usa para acessar o repositório unificado de contatos sejam específicas para contatos de mensagens instantâneas, você pode usar o repositório unificado de contatos no Exchange para trabalhar com pessoas em todos os tipos de aplicativos.Although the EWS operations that you use to access the Unified Contact Store are specific to IM contacts, You can use the Unified Contact Store in Exchange to work with personas in all types of applications. Tenha em mente que o repositório unificado de contatos não pode acessar dados de contato do AD DS.Keep in mind that the Unified Contact Store cannot access contact data AD DS.

Os contatos de mensagens instantâneas são armazenados em uma pasta oculta chamada QuickContacts.IM contacts are stored in a hidden folder called QuickContacts. Você pode usar as operações AddNewImContactToGroup e AddImContactToGroup para adicionar contatos a grupos armazenados nessa pasta oculta.You can use the AddNewImContactToGroup and AddImContactToGroup operations to add contacts to groups that are stored in this hidden folder. E, como você pode usar o repositório unificado de contatos para agrupar contatos de mensagens instantâneas, é possível acessar e atualizar grupos de contatos com mais facilidade.And because you can use the Unified Contact Store to group IM contacts, you can access and update groups of contacts more easily.

Observação

A API gerenciada EWS não implementa essa funcionalidade.The EWS Managed API does not implement this functionality.

Tabela 3. Operações do EWS para acessar o repositório unificado de contatosTable 3. EWS operations for accessing the Unified Contact Store

Nome da operaçãoOperation name DescriçãoDescription
AddNewImContactToGroupAddNewImContactToGroup
Adiciona um novo contato de mensagens instantâneas a um grupo de mensagens instantâneas, até um máximo de 1000 contatos.Adds a new IM contact to an IM group, up to a maximum of 1000 contacts.
AddImContactToGroupAddImContactToGroup
Adiciona um contato de IM existente a um grupo de mensagens instantâneas, até um máximo de 1000 contatos.Adds an existing IM contact to an IM group, up to a maximum of 1000 contacts.
AddImGroupAddImGroup
Adiciona um novo grupo de mensagens instantâneas, até um máximo de 64 grupos.Adds a new IM group, up to a maximum of 64 groups.
AddDistributionGroupToImListAddDistributionGroupToImList
Adiciona um novo grupo de distribuição a um grupo de mensagens instantâneas, até um máximo de 64 grupos.Adds a new distribution group to an IM group, up to a maximum of 64 groups.
GetImItemListGetImItemList
Recupera uma lista de grupos de IM e pessoas de contato de mensagens instantâneas.Retrieves a list of IM groups and IM contact personas.
GetImItemsGetImItems
Recupera informações sobre grupos de mensagens instantâneas específicos e pessoas de contato de mensagens instantâneas.Retrieves information about specific IM groups and IM contact personas.
RemoveContactFromImListRemoveContactFromImList
Remove um contato de um grupo de mensagens instantâneas.Removes a contact from an IM group.
RemoveImContactFromGroupRemoveImContactFromGroup
Remove um contato de mensagens instantâneas de um grupo de mensagens instantâneas.Removes an IM contact from an IM group.
RemoveDistributionGroupFromImListRemoveDistributionGroupFromImList
Remove um grupo de distribuição de um grupo de mensagens instantâneas.Removes a distribution group from an IM group.
RemoveImGroupRemoveImGroup
Remove um grupo de mensagens instantâneas.Removes an IM group.
SetImGroupSetImGroup
Altera o nome de exibição de um grupo de mensagens instantâneas.Changes the display name of an IM group.

Nesta seçãoIn this section

Confira tambémSee also