Acesso a pastas públicas com o EWS no Exchange
Saiba como utilizar o EWS e a API Gerida do EWS para aceder a pastas públicas e encaminhar pedidos de pastas públicas no Exchange.
As pastas públicas fornecem um repositório partilhado de itens aos quais os utilizadores na sua organização podem aceder. Office 365, Exchange Online e versões no local do Exchange a partir do Exchange 2013 introduzem uma nova arquitetura para pastas públicas. As pastas públicas no Exchange utilizam um design de caixa de correio especializado (em vez de uma base de dados de pasta pública) para armazenar a hierarquia de pastas públicas e o conteúdo de pastas públicas. As permissões de pastas públicas são geridas através do Controle de Acesso Baseado em Funções (RBAC).
As tecnologias de acesso de cliente, como os Serviços Web exchange (EWS) e a API Gerida do EWS, fornecem acesso programático à hierarquia de pastas públicas e aos itens de conteúdo numa base de dados de pasta pública. Este artigo fornece informações sobre como pode utilizar o EWS e a API Gerida do EWS para aceder a pastas públicas, pastas públicas e dados de pastas públicas.
Operações EWS e métodos de API Gerida do EWS para acesso a pastas públicas
A maioria das principais operações do EWS suporta o acesso a pastas públicas. Pode utilizar as operações de pastas e itens e os métodos da API Gerida do EWS listados na tabela seguinte para trabalhar com pastas públicas.
Para obter informações sobre os métodos da API Gerida do EWS, veja Espaços de nomes da API Gerida do EWS.
| Operação do EWS | Método da API Gerenciada do EWS |
|---|---|
|
Operação CreateFolder |
Folder.Save() |
|
Operação UpdateFolder |
Folder.Update() |
|
Operação DeleteFolder |
Folder.Delete() |
|
Operação MoveFolder1 |
Folder.Move() |
|
Operação CopyFolder2 |
Folder.Copy() |
|
Operação GetFolder |
Folder.Bind() |
|
EmptyFolder operação3 |
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 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 em 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 Exchange Server 2010.
3 Esta operação só é aplicável a pastas públicas no Exchange 2010.
4 A pesquisa indexada em texto completo numa única pasta pública através da opção de pesquisa QueryString é suportada em versões do Exchange a partir do Exchange 2013.
5 A operação ConvertId não converte corretamente identificadores de pastas públicas do identificador EWS para o identificador do arquivo. Pode atualizar manualmente o identificador que é devolvido como solução.
As seguintes operações 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 (não suportado). Pode utilizar CreateFolder com a operação CopyItems para implementar a funcionalidade de operação CopyFolder .
EmptyFolder (não suportado). Pode utilizar o FindItem com a operação DeleteItem para implementar a funcionalidade de operação EmptyFolder .
MoveFolder (parcialmente suportado). Não pode mover pastas entre pastas privadas e públicas. Pode mover pastas entre pastas privadas e públicas no Exchange 2007 e no Exchange 2010. Pode mover pastas numa pasta pública em todas as versões do Exchange.
O EWS e a API Gerida do EWS não suportam a seguinte funcionalidade para pastas públicas:
Utilizar SyncFolderHierarchy. Utilize as operações FindFolder, GetFolder, FindItem e GetItem para sincronizar itens e pastas numa caixa de correio de pasta pública.
Pesquisas profundas de uma hierarquia de pastas públicas. Utilize chamadas de operação FindFolder recursivas para percorrer a hierarquia de pastas públicas.
Utilizar a operação CreateFolderPath para criar uma hierarquia de pastas para pastas públicas. Terá de utilizar a operação CreateFolder para cada nível de pasta numa hierarquia de pastas distinta quando segmentar uma caixa de correio de pasta pública.
Utilizar a operação CreateItem para guardar cópias de mensagens de e-mail enviadas. Em vez disso, utilize a operação MoveItem para mover uma cópia da mensagem para uma pasta pública.
Cenários para utilizar o EWS e a API Gerida do EWS para trabalhar com pastas públicas
As pastas públicas permitem muitos cenários importantes para os utilizadores da caixa de correio do Exchange. Pode capacitar os utilizadores através do EWS e da API Gerida do EWS para implementar soluções personalizadas para aceder e utilizar pastas públicas e respetivos conteúdos.
Aceder programaticamente a mensagens de e-mail que tenham sido enviadas para listas de distribuição
Os utilizadores da caixa de correio do Exchange podem utilizar pastas públicas para armazenar mensagens de e-mail que são enviadas para listas de distribuição. Esta é uma forma conveniente de guardar o histórico de listas de distribuição. Pode utilizar a operação FindItem no EWS ou os métodos ExchangeService.FindItems() e Folder.FindItems() na API Gerida do EWS para aceder às mensagens de e-mail da lista de distribuição armazenada.
Partilhar mensagens de e-mail importantes e outros itens de caixa de correio
Os utilizadores da caixa de correio podem utilizar pastas públicas como um repositório partilhado para itens de caixa de correio. Diferentes utilizadores numa organização podem partilhar mensagens de e-mail ou contactos importantes através de pastas públicas. O EWS pode fornecer acesso a estes itens de caixa de correio partilhada. Pode utilizar a operação MoveItem no EWS ou o método Item.Move() na API Gerida do EWS para mover mensagens de e-mail, contactos e outros itens de caixa de correio para dentro e para fora de uma pasta pública.
Debates públicos com itens de publicação
As pastas públicas são um contentor conveniente para post items. Os itens de publicação fornecem uma forma de utilizar conversações por tópicos sem ter de enviar mensagens de e-mail entre utilizadores. Os utilizadores podem utilizar pastas públicas e publicar itens para alojar e manter conversações por tópicos entre diferentes utilizadores de caixas de correio numa organização. Desta forma, os utilizadores da caixa de correio podem aceder ao histórico partilhado de uma conversação que utiliza itens de publicação mesmo que não façam parte da conversação. Pode utilizar a operação CreateItem no EWS ou o método Item.Save() na API Gerida do EWS para criar e responder a itens post armazenados numa pasta pública.
Encaminhar pedidos de pastas públicas
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 numa caixa de correio, enquanto o conteúdo da pasta pública é armazenado noutra. E cada um destes servidores pode ser diferente do servidor de caixa de correio do utilizador que pede as informações. Nestas situações, é importante incluir os cabeçalhos X-AnchorMailbox e X-PublicFolderMailbox adicionais nos seus pedidos de pasta pública para receber informações precisas sobre pastas públicas.
O valor para X-AnchorMailbox e X-PublicFolderMailbox pode ser diferente consoante esteja a efetuar um pedido relacionado com a hierarquia de pastas ou o conteúdo da pasta. A tabela seguinte identifica o procedimento a seguir para cada método de API Gerida do EWS ou operação EWS.
Métodos da API Gerida do EWS e operações do EWS para encaminhar pedidos de pastas públicas
| Ao chamar estes métodos | Ao chamar estas operações | Utilizar este procedimento |
|---|---|---|
|
Folder.FindFolders Folder.Delete Folder.Update Pasta.Mover |
CreateFolder FindFolder DeleteFolder UpdateFolder MoveFolder |
Encaminhar pedidos de hierarquia de pastas públicas |
|
Item.Bind Item.Update Item.Copy Item.Mover Item.Delete Folder.Bind Folder.FindItems |
CreateItem GetItem UpdateItem CopyItem MoveItem DeleteItem GetFolder FindItem |
Encaminhar pedidos de conteúdo de pastas públicas |
Diferenças de versão
No Exchange 2007 e no Exchange 2010, a operação ConvertId funciona conforme esperado ao converter identificadores de pastas públicas do identificador EWS para o identificador do arquivo.