Excluir itens usando o EWS no Exchange
Descubra como você pode usar a API Gerenciada do EWS ou o EWS no Exchange para excluir itens movendo-os para a pasta Itens Excluídos ou para a lixeira.
Você já se perguntou qual é a diferença entre mover itens para a pasta Itens Excluídos e movê-los para a lixeira? Você pode estar curioso sobre as diferentes opções para lidar com itens excluídos e como implementar essas opções em seu aplicativo. Os Serviços Web do Exchange (EWS) incluem três opções para lidar com itens excluídos. Este artigo provavelmente esclarecerá qualquer confusão que você possa ter sobre as diferenças entre eles.
Excluindo itens – quais são minhas opções?
Antes de entender o panorama geral da exclusão de itens, é importante reconhecer a diferença entre o seguinte:
A pasta Itens Excluídos – Quando você exclui itens em uma caixa de correio, é para onde eles vão.
A lixeira (também conhecida como pasta Itens Recuperáveis) – quando você remove itens de uma caixa de correio, é para onde eles vão.
As figuras 1 e 2 mostram a aparência do processo de exclusão para itens e pastas em uma caixa de correio.
Figura 1. Processo para excluir itens de uma caixa de correio
Figura 2. Processo para excluir pastas de uma caixa de correio
Você pode excluir itens e pastas de três maneiras diferentes, dependendo de quão "permanente" você gostaria que a exclusão fosse.
Tabela 1: Opções para excluir itens usando o EWS
| Opção | O que acontece |
|---|---|
| Mover para a pasta Itens Excluídos |
Essa é a maneira menos permanente de excluir itens. Isso é como colocar um pedaço de papel na lixeira ao lado da sua mesa. Você pode pegá-lo facilmente se precisar dele novamente. Você pode usar qualquer operação de exclusão que implemente a movimentação para a opção de pasta Itens Excluídos para executar essa ação. Você também pode usar a operação MoveItem ( Item.Move()) ou a operação MoveFolder ( Folder.Move()) para mover um item ou pasta para a pasta Itens Excluídos. |
| Exclusão reversível |
O item é movido para a pasta Exclusões na lixeira. Isso é como esvaziar sua lixeira em seu contêiner de meio-fio. Você ainda pode acessar o item se precisar, mas é um pouco mais difícil. Para obter mais informações sobre a lixeira (também chamada de pasta Itens Recuperáveis) e cenários como descoberta eletrônica ou retenções de litígio, consulte a Pasta Itens Recuperáveis no TechNet. Exclusões reversível não são recomendadas para aplicativos destinados ao Exchange 2007. No Exchange 2007, as exclusões reversível são tratadas definindo um pouco sobre o item para indicar que ele será movido para a lixeira em um momento não especificado. Não há suporte para passagens de exclusão reversível ou pesquisas de itens que foram excluídos temporariamente por meio da operação FindItem no Exchange Online, no Exchange Online como parte do Office 365 e nas versões do Exchange a partir do Exchange 2010. OBSERVAÇÃO: as pastas não podem ser excluídas temporariamente. |
| Exclusão irreversível |
O item ou pasta é excluído permanentemente. Os itens excluídos são colocados na pasta Limpezas da lixeira. Isso é como quando o caminhão de reciclagem esvazia sua lixeira à beira da rua. Os itens não podem ser acessados de um cliente de email como o Outlook ou o Outlook Web App e, a menos que haja uma retenção definida na caixa de correio, os itens serão excluídos permanentemente após um período definido. Você pode ler mais sobre a retenção de itens no artigo Configurar cotas de retenção de itens excluídos e itens recuperáveis. OBSERVAÇÃO: as pastas não são colocadas na pasta Limpezas quando são excluídas com dificuldade. As pastas excluídas de forma permanente são removidas da caixa de correio. |
A movimentação para a pasta Itens Excluídos e as opções de exclusão permanente são transacionais, o que significa que, quando a chamada de serviço Web for concluída, o item será movido para a pasta Itens Excluídos ou para a lixeira.
Para ajudá-lo a entender melhor o ecossistema de pastas que são usadas para armazenar itens excluídos, a figura a seguir mostra a hierarquia de pastas que podem conter itens excluídos. Os nomes de pasta são como aparecem no tipo de esquema DistinguishedFolderIdNameType ou na enumeração WellKnownFolderName na API Gerenciada do EWS.
Figura 3. Hierarquia de pastas que contêm itens excluídos
Tabela 2: Pastas que contêm itens excluídos
| Nome da pasta | Introduzido no | Descrição |
|---|---|---|
| deleteditems |
Exchange 2007 |
A pasta Itens Excluídos padrão. Os itens permanecem nessa pasta até que sejam excluídos de forma reversível ou permanente ou até que um período de retenção seja excedido. Então eles são movidos para uma pasta na lixeira. As pastas excluídas são colocadas na pasta Itens Excluídos e, quando são excluídas de forma reversível ou permanente, elas são permanentemente removidas da caixa de correio e não podem ser recuperadas. |
| recoverableitemsroot |
Exchange 2010 |
A raiz da lixeira ou a pasta Itens Recuperáveis. O acesso à lixeira foi implementado no EWS no Exchange 2010. O nome de exibição dessa pasta é "Itens Recuperáveis". |
| recoverableitemsdeletions |
Exchange 2010 |
A pasta principal da lixeira de uma caixa de correio. Itens e itens excluídos temporariamente movidos da pasta Itens Excluídos por uma política de retenção são colocados nessa pasta. O nome de exibição dessa pasta é "Exclusões". |
| recoverableitemsversions |
Exchange 2010 |
Onde as versões mais antigas de um item são armazenadas. Versões antigas de um item são criadas quando um item é atualizado. As versões de item de rascunho não são salvas nessa pasta. O nome de exibição dessa pasta é "Versões". |
| recoverableitemspurges |
Exchange 2010 |
Onde os itens removidos da pasta Exclusões são armazenados. Todos os itens excluídos do repositório são movidos para essa pasta. O nome de exibição dessa pasta é "Limpezas". |
| archiveddeletedtitems |
Exchange 2010 |
A pasta Itens Excluídos padrão para uma caixa de correio de arquivo morto. |
| archiverecoverablesitemsroot |
Exchange 2010 |
A pasta de lixeira raiz de uma caixa de correio de arquivo morto. Itens arquivados que são excluídos temporariamente são movidos para uma subpasta nesta pasta. |
| archiverecoverableitemsdeletions |
Exchange 2010 |
A pasta principal da lixeira de uma caixa de correio de arquivo morto. Itens arquivados movidos para a lixeira são colocados aqui. |
| archiverecoverableitemsversions |
Exchange 2010 |
Onde as versões mais antigas de itens arquivados são armazenadas. |
| archiverecoverableitemspurges |
Exchange 2010 |
Onde os itens que são excluídos da pasta Exclusões de arquivo morto na lixeira são armazenados. Todos os itens arquivados excluídos do repositório são movidos para essa pasta. |
Como fazer excluir itens?
Use um dos seguintes procedimentos para indicar se um item deve ser movido para a pasta Itens Excluídos ou executar uma exclusão temporária ou uma exclusão difícil:
O tipo simples DisposalType , se você usar o EWS para acessar o Exchange.
A enumeração DeleteMode, se você usar a API Gerenciada do EWS.
Você pode usar várias operações EWS diferentes ou métodos de API Gerenciada do EWS para excluir itens e pastas de uma caixa de correio.
Tabela 3: operações EWS e métodos de API gerenciada do EWS para excluir itens
| Operação do EWS | Método da API Gerenciada do EWS | Introduzido no | Função |
|---|---|---|---|
| Operação DeleteFolder |
Método Folder.Delete |
Exchange 2007 |
Exclui pastas de uma caixa de correio. Com o EWS, você pode excluir pastas em lote. Com a API Gerenciada do EWS, você só pode excluir uma única pasta por chamada. |
| Operação DeleteItem |
Método Item.Delete Método ExchangeService.DeleteItems |
Exchange 2007 |
Exclui itens de uma caixa de correio. |
| Operação EmptyFolder |
Método Folder.Empty |
Exchange 2010 |
Exclui todos os itens em uma pasta e, opcionalmente, exclui todas as subpastas em uma pasta. |
| Operação ApplyConversationAction |
Método Conversation.EnableAlwaysDeleteItems Método Conversation.DeleteItems |
Exchange 2010 |
Define uma ação de exclusão de processamento em mensagens de email em uma conversa para que elas sejam excluídas. |
| Operação DeleteUserConfiguration |
Método UserConfiguration.Delete |
Exchange 2010 |
Exclui um item associado à pasta e o move para a lixeira. |
| Operação CreateItem |
Método Appointment.Accept Método Appointment.AcceptTentatively Método Appointment.CancelMeeting Appointment.Decline Método MeetingRequest.Accept Método MeetingRequest.AcceptTentatively Método MeetingRequest.Decline |
Exchange 2007 |
Move indiretamente um item para a pasta Itens Excluídos sempre que uma resposta a uma solicitação de reunião é enviada ou a resposta é definida no compromisso. O tipo de exclusão não está definido nesta operação. As mensagens da reunião são movidas para a pasta Itens Excluídos quando um objeto de resposta é processado com êxito pelo serviço. |
Você também pode mover itens para a pasta Itens Excluídos usando regras de Caixa de Entrada. Por exemplo, você pode criar regras que têm uma ação de exclusão.
Alguns pontos a serem observados sobre a exclusão de itens:
Excluir uma ocorrência de um item recorrente não dispara uma movimentação para a pasta Itens Excluídos ou para a lixeira. Isso resulta em uma atualização para o item mestre recorrente da série recorrente.
Não é possível excluir pastas padrão da caixa de correio.
Evite excluir reuniões ou mensagens de reunião, como solicitações de reunião e atualizações de reunião. Em vez disso, responda a esses itens usando objetos de resposta. Dessa forma, os itens de calendário associados são atualizados para refletir as ações do respondente ou do organizador.
A chave de alteração de um item não é atualizada quando o item é movido para a pasta Itens Excluídos ou Exclusões.
Se você executar uma exclusão forçada em um item e, em seguida, chamar uma operação SyncFolderHierarchy ou o método syncFolderHierarchy EWS Managed API, ou uma operação SyncFolderItems ou o método SyncFolderItems , uma entrada de alteração Delete será retornada. Se você mover um item para a pasta Itens Excluídos, uma entrada de alteração de atualização será retornada. Isso ocorre porque o item ou pasta terá um novo valor da propriedade ParentFolderId . Leia mais sobre sincronização se a sincronização de itens excluídos fizer parte do seu cenário.
Saiba mais sobre como excluir itens
Notificações de pull para eventos de caixa de correio relacionados à exclusão do EWS no Exchange
Manipulação de erros relacionados à exclusão no EWS no Exchange
Confira também
- Pastas e itens no EWS no Exchange
- Desenvolver clientes do serviço web para o Exchange
- Pasta Itens Recuperáveis
- Recuperação de item único no Exchange Server 2010
- Exchange 2013: Excluir uma série recorrente programaticamente dos servidores Exchange
- Exchange 2013: Excluir tarefas de uma conta em servidores Exchange programaticamente
- Exchange 2013: Pastas vazias em servidores Exchange programaticamente
- Exchange 2013: Excluir pastas programaticamente dos servidores Exchange
- Exchange 2013: Excluir vários itens programaticamente dos servidores Exchange
- Exchange 2013: Excluir contatos programaticamente dos servidores Exchange
- Excluir compromissos e cancelar reuniões usando o EWS no Exchange
- Gerenciar configurações de aplicativo persistente usando o EWS no Exchange