Acesso a pastas públicas com o EWS no Exchange
Saiba como usar o EWS e a API gerenciada do EWS para acessar pastas públicas e encaminhar solicitações de pasta pública no Exchange.
As pastas públicas fornecem um repositório compartilhado de itens que os usuários em sua organização podem acessar. O Office 365, o Exchange Online e as versões locais do Exchange, começando com o Exchange 2013, introduzem uma nova arquitetura para pastas públicas. As pastas públicas do Exchange usam um design de caixa de correio especializado (em vez de um banco de dados de pasta pública) para armazenar a hierarquia de pastas públicas e o conteúdo da pasta pública. As permissões de pasta pública são gerenciadas por meio do controle de acesso baseado em função (RBAC).
As tecnologias de acesso para cliente, como os serviços Web do Exchange (EWS) e a API gerenciada do EWS, oferecem acesso programático à hierarquia de pastas públicas e a itens de conteúdo em um banco de dados de pasta pública. Este artigo fornece informações sobre como você pode usar o EWS e a API gerenciada do EWS para acessar pastas públicas e pastas públicas e dados de pasta pública.
Operações do EWS e métodos da API gerenciada do EWS para acesso à pasta pública
A maioria das operações do EWS principal dão suporte ao acesso à pasta pública. Você pode usar as operações de item e de pasta e os métodos da API gerenciada do EWS listados na tabela a seguir para trabalhar com pastas públicas.
Para obter informações sobre os métodos da API gerenciada do EWS, consulte EWS Managed API namespaces.
| Operação do EWS | Método de API gerenciada do EWS |
|---|---|
| Operação CreateFolder |
Folder. Save () |
| Operação UpdateFolder |
Folder. Update () |
| Operação DeleteFolder |
Folder. Delete () |
| Operação1 do MoveFolder |
Folder. Move () |
| Operação2 do CopyFolder |
Folder. Copy () |
| Operação GetFolder |
Folder. Bind () |
| Operação de EmptyFolder3 |
Folder. Empty () |
| Operação FindFolder |
ExchangeService. FindFolders () Folder. FindFolders () |
| Operação CreateItem |
Item. Save () |
| Operação MoveItem |
Item. Move () |
| Operação CopyItem |
Item. Copy () |
| Operação UpdateItem |
Item. Update () |
| Operação DeleteItem |
Item. Delete () |
| Operação de FindItem4 |
ExchangeService. FindItems () Folder. FindItems () |
| Operação GetItem |
Item. Bind () |
| Operação convertid5 |
ExchangeService. convertid () ExchangeService. ConvertIds () |
1 a movimentação de pastas entre uma pasta pública e uma pasta privada não está disponível nas versões do Exchange a partir do Exchange 2013.
2 esta operação só é aplicável a pastas públicas no exchange Server 2007 e no exchange Server 2010.
3 essa operação só é aplicável a pastas públicas no Exchange 2010.
4 a pesquisa indexada de texto completo em uma única pasta pública por meio da opção de pesquisa de QueryString é suportada em versões do Exchange a partir do Exchange 2013.
5 a operação convertid não converte corretamente identificadores de pasta pública do identificador EWS no identificador de repositório. Você pode atualizar manualmente o identificador que é retornado como uma solução alternativa.
As operações a seguir não são suportadas ou são parcialmente suportadas para pastas públicas em versões do Exchange a partir do Exchange 2013:
CopyFolder (sem suporte). Você pode usar CreateFolder com a operação CopyItems para implementar a funcionalidade de operação CopyFolder .
EmptyFolder (sem suporte). Você pode usar o FindItem com a operação DeleteItem para implementar a funcionalidade de operação do EmptyFolder .
MoveFolder (parcialmente suportado). Não é possível mover pastas entre pastas privadas e públicas. Você pode mover pastas entre pastas privadas e públicas no Exchange 2007 e no Exchange 2010. Você pode mover pastas dentro de uma pasta pública em todas as versões do Exchange.
O EWS e a API gerenciada do EWS não oferecem suporte à seguinte funcionalidade para pastas públicas:
Usando o SyncFolderHierarchy. Use as operações FindFolder, GetFolder e SyncFolderItems para sincronizar itens e pastas em uma caixa de correio de pasta pública.
Pesquisas de passagem profunda de uma hierarquia de pastas públicas. Use as chamadas recursivas de operação do FindFolder para percorrer a hierarquia de pastas públicas.
Usando a operação createfolderpath para criar uma hierarquia de pastas para pastas públicas. Você precisará usar a operação CreateFolder para cada nível de pasta em uma hierarquia de pastas distintas ao direcionar uma caixa de correio de pasta pública.
Usando a operação CreateItem para salvar cópias de mensagens de email enviadas. Em vez disso, use a operação MoveItem para mover uma cópia da mensagem para uma pasta pública.
Cenários para usar o EWS e a API gerenciada do EWS para trabalhar com pastas públicas
As pastas públicas permitem vários cenários importantes para usuários de caixa de correio do Exchange. Você pode habilitar usuários usando o EWS e a API gerenciada do EWS para implementar soluções personalizadas para acessar e usar pastas públicas e seu conteúdo.
Acessar programaticamente mensagens de email enviadas para listas de distribuição
Os usuários de caixa de correio do Exchange podem usar pastas públicas para armazenar mensagens de email enviadas a listas de distribuição. Essa é uma maneira conveniente de salvar o histórico de lista de distribuição. Você pode usar a operação FindItem no EWS ou nos métodos ExchangeService. FindItems () e Folder. FindItems () na API gerenciada do EWS para acessar mensagens de email de lista de distribuição armazenadas.
Compartilhar mensagens de email importantes e outros itens de caixa de correio
Os usuários de caixa de correio podem usar pastas públicas como um repositório compartilhado para itens de caixa de correio. Diferentes usuários em uma organização podem compartilhar mensagens de email importantes ou contatos usando pastas públicas. O EWS pode fornecer acesso a esses itens de caixa de correio compartilhada. Você pode usar a operação MoveItem no EWS ou o método Item. Move () na API gerenciada do EWS para mover mensagens de email, contatos e outros itens de caixa de correio para dentro e para fora de uma pasta pública.
Discussões públicas com itens de postagem
As pastas públicas são um contêiner conveniente para postar itens. Os itens post fornecem uma maneira de usar conversas encadeadas sem ter que enviar mensagens de email entre usuários. Os usuários podem usar pastas públicas e postar itens para hospedar e manter conversas encadeadas entre diferentes usuários de caixa de correio em uma organização. Dessa forma, os usuários de caixa de correio podem acessar o histórico compartilhado de uma conversa que usa itens post, mesmo que eles não sejam parte da conversa. Você pode usar a operação CreateItem no EWS ou o método Item. Save () na API gerenciada do EWS para criar e responder a itens de postagem armazenados em uma pasta pública.
Roteamento de solicitações de pasta pública
O conteúdo da pasta pública pode ser armazenado em vários servidores de caixa de correio. A hierarquia de pastas públicas pode ser armazenada em uma caixa de correio, enquanto o conteúdo da pasta pública é armazenado em outra. E cada um desses servidores pode ser diferente do servidor de caixa de correio para o usuário que está solicitando as informações. Nessas situações, é importante incluir os cabeçalhos X-AnchorMailbox e X-PublicFolderMailbox adicionais em suas solicitações de pasta pública para receber informações precisas sobre pastas públicas.
O valor do X-AnchorMailbox e do X-PublicFolderMailbox pode diferir, dependendo se você está executando uma solicitação relacionada à hierarquia de pastas ou ao conteúdo da pasta. A tabela a seguir identifica o procedimento a seguir para cada método da API gerenciada do EWS ou operação do EWS.
Métodos da API gerenciada do EWS e operações do EWS para roteamento de solicitações de pasta pública
| Ao chamar esses métodos | Ao chamar essas operações | Use este procedimento |
|---|---|---|
| Folder. FindFolders Pasta. Delete Pasta. Update Folder. move |
CreateFolder FindFolder DeleteFolder UpdateFolder MoveFolder |
Roteamento de solicitações de hierarquia de pasta pública |
| Item. bind Item. Update Item. Copy Item. move Item. Delete Folder. bind Folder. FindItems |
CreateItem GetItem UpdateItem CopyItem MoveItem DeleteItem GetFolder FindItem |
Roteamento de solicitações de conteúdo de pasta pública |
Diferenças de versão
No Exchange 2007 e no Exchange 2010, a operação convertid funciona como esperado ao converter identificadores de pasta pública do identificador do EWS para o identificador de repositório.