Trabalhando com Contatos no Exchange Server

As contas do Exchange Server contêm mais do que apenas mensagens de e-mail. Além de recuperar, mover, enviar e deletar mensagens de e-mail de servidores do Exchange, o Aspose.Email permite que você trabalhe com contatos. Este artigo explica como recuperar informações de contato usando os Serviços Web do Exchange. Este artigo também mostra como você pode listar contatos da pasta de Contatos ou resolver contatos com base no nome do contato.

Obtendo Contatos com EWS

O Aspose.Email fornece a classe EWSClient para se conectar ao Microsoft Exchange Server usando os Serviços Web do Exchange. Os exemplos de código a seguir usam os Serviços Web do Exchange para ler todos os contatos. O seguinte exemplo de código mostra como obter contatos com EWS.

Resolver Contatos usando o Nome do Contato

O seguinte exemplo de código mostra como obter contatos com EWS.

Determinar o Formato das Notas de Contato

O Aspose.Email.Mail.Contact.NotesFormat especifica o tipo de formato de texto das notas de contato definido pelo enumerador Aspose.Email.TextFormat.

Buscar Contato usando o Id

Um contato específico pode ser recuperado do servidor usando seu id de contato, conforme mostrado no seguinte exemplo de código.

Adicionando Contatos

A classe EWSClient pode usar o método CreateContact() para adicionar informações de contato a um Exchange Server. O método CreateContact() recebe um objeto Contact como parâmetro de entrada.

Para adicionar contatos a um Exchange Server:

1. Inicialize o EWSClient com o endereço e credenciais.
2. Inicialize o objeto Contact com as propriedades desejadas.
3. Chame o método CreateContact para adicionar o contato ao Exchange Server.

O Aspose.Email fornece a classe EWSClient para se conectar ao Microsoft Exchange Server usando os Serviços Web do Exchange. Os exemplos de código mostram como usar os Serviços Web do Exchange para adicionar contatos a um Exchange Server.

Atualizando Contatos

As informações de contato podem ser atualizadas usando o Microsoft Outlook. O Aspose.Email também pode atualizar informações de contato no Exchange Server usando o Serviço Web do Exchange (EWS). O método IEWSClient UpdateContact pode atualizar informações de contato no Exchange Server.

Deletando Contatos

A classe EWSClient permite que o método DeleteContact acesse e delete contatos da pasta de contatos de um Exchange Server. Este método recebe o ID do contato ou MapiContact como parâmetro de entrada.

Para deletar contatos de um Exchange Server:

1. Inicialize o ExchangeWebServiceClient com o endereço e credenciais.
2. Delete um contato usando seu ID.
3. Delete um contato chamando o método DeleteContact com MapiContact como parâmetro de entrada.

Os seguintes exemplos de código mostram como deletar contatos de um servidor Exchange usando o serviço web do Exchange.

Trabalhando com Propriedades Estendidas de Contatos no Exchange Server

 IEWSClient client = EWSClient.GetEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
 
//As propriedades estendidas necessárias devem ser adicionadas para criá-las ou lê-las do Exchange Server

string[] extraFields = new string[] {{ "User Field 1", "User Field 2", "User Field 3", "User Field 4" }};

foreach (string extraField in extraFields)

    client.ContactExtendedPropertiesDefinition.Add(extraField);

//Criar um contato de teste no Exchange Server

Contact contact = new Contact();

contact.DisplayName = "EMAILNET-38433 - " + Guid.NewGuid().ToString();

foreach (string extraField in extraFields)

    contact.ExtendedProperties.Add(extraField, extraField);

string contactId = client.CreateContact(contact);

//recuperar o contato de volta do servidor após algum tempo

Thread.Sleep(5000);

contact = client.GetContact(contactId);

//Analisar as propriedades estendidas do contato

foreach (string extraField in extraFields)

    if (contact.ExtendedProperties.ContainsKey(extraField))

        Console.WriteLine(contact.ExtendedProperties[extraField].ToString());