Pastas e itens no EWS no Exchange

Saiba mais sobre pastas e itens de caixa de correio e como a API Gerenciada do EWS ou o cliente EWS as representa.

As pastas são o elemento organizador de uma caixa de correio do Exchange. As pastas podem conter itens de caixa de correio, como mensagens de email, contatos, compromissos, reuniões e tarefas, ou podem conter outras pastas. O Exchange inclui diferentes tipos de pastas, mas os tipos de pasta são semelhantes uns aos outros. A principal diferença entre eles é o tipo de item que eles contêm.

Os itens, no entanto, têm tipos exclusivos. Cada tipo de item tem um conjunto diferente de propriedades ou esquema para defini-lo. Neste artigo, discutiremos os tipos de pastas e itens disponíveis e as diferenças entre eles.

Folders

Todas as pastas derivam da mesma classe base ou tipo base, da classe Pasta na API Gerenciada do EWS ou do tipo Pasta no EWS. A figura a seguir mostra as classes de API Gerenciada do EWS e tipos EWS.

Figura 1. Classes de pasta de API Gerenciada do EWS e tipos de pasta EWS

A principal diferença entre cada uma das classes de pasta e os tipos de pasta é que você só pode criar um determinado tipo de item em cada tipo de pasta. Outra diferença está em como o cliente exibe informações em uma pasta. Por exemplo, o Exchange permite que você crie compromissos na pasta Calendário. Você pode mover outros tipos de itens para a pasta Calendário depois de criá-los, mas o Outlook não os exibirá. O Outlook exibe apenas itens de calendário, como compromissos e reuniões na pasta Calendário, mesmo que exista outro tipo de item na pasta.

Tabela 1. Classes de pasta de API Gerenciada do EWS e tipos de pasta EWS

Classe de API Gerenciada do EWS	Tipo EWS	Valor FolderClass	Contém	Observações
Folder	Folder	Ipf. Nota	Email mensagens ou pastas.	Esta é a classe ou tipo de pasta genérica para as seguintes pastas WellKnownFolderName da API Gerenciada do EWS e pastas EWS DistinguishedFolderId : Raiz (sub-árvore IPM) NonIpmSubtree Caixa de Entrada Itens excluídos Rascunhos Diário Observações Caixa de saída Itens enviados Pasta mensagem Lixo Email Caixa Postal
CalendarFolder	CalendarFolder	Ipf. Nomeação	Compromissos e reuniões.	Quando um usuário responde a uma solicitação de reunião, o compromisso é adicionado à API Gerenciada do EWS WellKnownFolderName.Calendar ou somente ao EWS DistinguishedFolderId.CalendarFolder . Estas são as únicas pastas que dão suporte à interação automática com solicitações e respostas de reunião. Essa classe de pasta ou tipo de pasta dá suporte ao uso de exibições de calendário para retornar compromissos e reuniões com base em uma data de início e uma data de término usando o método EWS Managed API Folder.FindItem e a classe CalendarView , ou a operação EWS FindItem e o elemento CalendarView .
ContactsFolder	ContactsFolder	Ipf. Contato	Contatos e listas de distribuição.	Nenhuma.
SearchFolder	SearchFolder	Ipf. Nota	O conteúdo é determinado por uma restrição ou filtro. As pastas de pesquisa não têm subpastas.	Os itens que atendem aos critérios de pesquisa não estão realmente contidos na pasta de pesquisa; em vez disso, eles estão localizados em outro lugar na caixa de correio. Para garantir que as pastas de pesquisa estejam disponíveis no Outlook, crie-as na pasta Finder.
TasksFolder	TasksFolder	Ipf. Tarefa	Contém itens de trabalho a serem concluídos.	Nenhuma.

Estrutura de pastas

As pastas fornecem uma estrutura de caixa de correio. Isso inclui o Subtree do IPM, conhecido como Top of Information Store no EWS, onde a maioria dos usuários interage com sua caixa de correio, bem como pastas de sistema que a maioria dos usuários nunca vê, que estão no Subtree ou Raiz não IPM no EWS. A figura a seguir mostra a estrutura da pasta para um usuário e indica quais pastas são para os itens do usuário e quais são pastas do sistema.

Figura 2. Pastas de item e sistema em uma caixa de correio

Pastas bem conhecidas

Das pastas em uma caixa de correio, algumas são pastas especiais. Isso equivale a pastas conhecidas na API Gerenciada do EWS ou pastas distintas no EWS. Algumas dessas pastas têm restrições no nome da pasta, onde estão localizadas na estrutura da pasta e se podem ser excluídas. Outras pastas "genéricas" (não especiais) não têm as mesmas restrições. É importante que você esteja familiarizado com as pastas conhecidas ou distintas a seguir, pois elas são o sistema raiz, o usuário e as pastas de pesquisa e são aplicáveis à maioria das implementações.

Tabela 2. Pastas primárias conhecidas e distintas

Nome amigável	Valores da API Gerenciada do EWS WellKnownFolderName	Valores EWS DistinguishedFolderId	Descrição
Raiz (Subtree não IPM)	WellKnownFolderName.Root	DistinguishedFolderId.root	Contém a pasta raiz de uma caixa de correio, também conhecida como Subtree não IPM. Essa pasta não tem pai e você não pode mover, copiar, renomear ou excluí-la. Cada repositório de mensagens contém apenas uma pasta raiz.
Repositório de Informações (Subtree do IPM)	WellKnownFolderName.MsgFolderRoot	DistinguishedFolderId.msgfolderroot	Contém a caixa de entrada e outras pastas de usuário.
Localizador (pastas de pesquisa)	WellKnownFolderName.SearchFolders	DistinguishedFolderId.searchfolders.	Contém pastas de pesquisa visíveis no Outlook.

Para obter uma lista completa dos valores da propriedade WellKnownFolderName da API Gerenciada do EWS, consulte a enumeração WellKnownFolderName . Para obter uma lista completa dos valores EWS DistinguishedFolderId , consulte DistinguishedFolderId.

Propriedades de pasta

Na API Gerenciada do EWS, as propriedades da pasta são todas derivadas da classe Pasta base. E no EWS, todas as pastas usam os elementos de pasta disponíveis no tipo Pasta . A maioria das propriedades e elementos relacionados à pasta são simples (ID da pasta pai, nome de exibição e assim por diante), mas alguns exigem um pouco mais de explicação.

As seguintes ressalvas se aplicam à propriedade EWS Managed API Folder.FolderClass ou ao elemento EWS FolderClass :

• Se definido, o valor da propriedade ou elemento deve concordar com a classe derivada ou o tipo da pasta. Por exemplo, a propriedade ou elemento FolderClass não pode indicar que a pasta é uma pasta Contatos enquanto a classe ou o tipo da pasta indica que a pasta é uma pasta Calendário.

• Você pode criar pastas de um tipo específico sem definir a propriedade ou elemento FolderClass ou criar uma pasta com o tipo de pasta genérico e especificar a propriedade ou elemento FolderClass . Ambas as opções criam o mesmo resultado.

• Depois de definir o valor FolderClass criando um tipo específico de pasta ou definindo a propriedade FolderClass ou o elemento em si, você não poderá alterá-lo. Por exemplo, você não pode alterar um IPF. Observe pasta para um IPF. Entre em contato com a pasta. No entanto, você pode alterá-lo para um IPF. Pasta Note.Contoso.

• Qualquer valor FolderClass que não usa um dos prefixos predefinidos é tratado como um IPF. Pasta Observação. Por exemplo, um valor FolderClass de IAmAFolderClass é tratado como um IPF. Pasta Observação.

O valor da classe de pasta é extensível. Isso significa que os valores de FolderClass padrão listados na Tabela 1 são tratados como prefixos e você pode adicionar valores personalizados. Por exemplo, você pode criar uma pasta com um valor FolderClass de IPF. Contact.Contoso e ele é tratado como uma pasta Contatos.

Você pode determinar quais permissões o cliente tem nas pastas, como excluir, ler e modificar, usando a propriedade EWS Managed API Folder.EffectiveRights ou o elemento EWS EffectiveRights .

Pastas públicas

As pastas públicas são feitas para acesso compartilhado e oferecem um jeito fácil e eficaz de coletar, organizar e compartilhar informações com outros pessoas no seu grupo de trabalho ou organização. Você também pode usar pastas públicas para arquivar o conteúdo do grupo de distribuição. Para obter informações detalhadas sobre pastas públicas, consulte Acesso de pasta pública com o EWS no Exchange.

Pastas ocultas

Todas as pastas que o Exchange cria na raiz da caixa de correio estão ocultas e você pode usar a API Gerenciada do EWS ou o EWS para ocultar pastas adicionais no Repositório de Informações Superior. Para obter mais informações sobre pastas ocultas, consulte Trabalhar com pastas ocultas usando o EWS no Exchange.

Pastas de pesquisa

As pastas de pesquisa são como pastas regulares, exceto que elas têm uma propriedade ou elemento que define o filtro de pesquisa. Você pode criar pastas de pesquisa em qualquer pasta em uma caixa de correio do Exchange e criá-las da mesma forma que você cria qualquer outra pasta. No entanto, para que uma pasta de pesquisa apareça no Outlook, Outlook Web App ou Outlook Live, os objetos SearchFolder que você cria usando a API Gerenciada do EWS devem estar localizados na pasta WellKnownFolderName.SearchFolders e os tipos SearchFolder que você cria usando o EWS devem estar localizados na pasta DistinguishedFolderId.SearchFolders. Se a pasta de pesquisa for criada em um local diferente, ela ainda estará disponível e você poderá exibi-la em aplicativos cliente personalizados.

Itens

O EWS no Exchange usa Itens para representar mensagens de email individuais, compromissos, reuniões, contatos, listas de distribuição, tarefas, postagens e outros itens, em uma caixa de correio. Os itens são fortemente tipado, o que significa que eles têm uma classe ou esquema associado específico, ou não fortemente tipado, também conhecidos como itens genéricos. Itens genéricos são objetos Item nos tipos de API Gerenciada do EWS e item no EWS. Itens comuns como mensagens de email, contatos, listas de distribuição, postagens e tarefas são fortemente tipados e você pode definir propriedades ou elementos esquematizados específicos neles.

Tabela 3. Itens fortemente tipado

Tipo de item de API Gerenciada do EWS	Elemento item EWS
Compromisso	CalendarItem
Contato	Contato
ContactGroup	DistributionList
EmailMessage	Mensagem
Item de postagem	Item de postagem
Tarefa	Tarefa

Os itens fortemente tipado pela API Gerenciada do EWS derivam da classe item base. No entanto, você geralmente trabalha com um dos tipos derivados listados na Tabela 3 e não com a classe Item diretamente. No entanto, quando você trabalha com a classe ItemCollection , pode trabalhar diretamente com instâncias da classe Item . Nesse caso, você deve implementar a lógica que determina o tipo de item no repositório que a instância da classe Item representa. Para trabalhar com esse item, você deve se associar ao item usando uma instância da classe que representa o item.

Itens em pastas

Algumas pastas têm restrições sobre os tipos de itens que podem conter. Essas são restrições que o banco de dados da caixa de correio do Exchange aplica a pastas, não limitações de exibição do cliente.

Tabela 4. Restrições de item para pastas

Classe Pasta de API Gerenciada do EWS	Tipo de pasta EWS	Restriction
Classe Pasta Base	Folder	Você só pode criar novos objetos EWS Managed API EmailMessage e objetos PostItem , ou tipos de mensagem EWS ou tipos postItem , nas pastas genéricas. Você pode mover outros tipos de item para pastas genéricas, mas o cliente pode não exibi-los.
CalendarFolder	CalendarFolder	Você só pode criar novos objetos EWS Managed API Appointment e tipos EWS CalendarItem na pasta Calendário. Você pode mover outros tipos de item para a pasta Calendário, mas o cliente pode não exibi-los.
ContactsFolder	ContactsFolder	Você só pode criar novos objetos EWS Managed API Contact e ContactGroup , ou tipos de Contato EWS ou DistributionList na pasta Contatos. Você pode mover outros tipos de item para a pasta Contatos, mas o cliente pode não exibi-los
SearchFolder	SearchFolder	Sem restrições. Os itens não estão realmente localizados na pasta Pesquisar; eles estão localizados em outro lugar na caixa de correio.
TasksFolder	TasksFolder	Você só pode criar novos objetos da Tarefa de API Gerenciada do EWS ou tipos de tarefa EWS na pasta Tarefas. Você pode mover outros tipos de item para a pasta Tarefas, mas o cliente pode não exibi-los

Atualização de versões anteriores do produto

As pastas permaneceram inalteradas em versões anteriores e atuais do produto. Observe, no entanto, que versões anteriores do Exchange usam pastas gerenciadas para executar o gerenciamento de registros de mensagens (MRM). Exchange Online, Exchange Online como parte de Office 365 e versões do Exchange a partir do Exchange 2013 usam políticas de retenção para MRM. Você pode atualizar pastas gerenciadas para usar políticas de retenção.

Os itens não foram alterados nas versões anteriores e atuais do produto.

Nesta seção

• Trabalhar com pastas usando o EWS no Exchange

• Trabalhar com pastas ocultas usando o EWS no Exchange

• Trabalhar com itens de caixa de correio do Exchange usando o EWS no Exchange

• Excluir itens usando o EWS no Exchange

• Exportar e importar itens usando o EWS no Exchange

Confira também

• Desenvolver clientes do serviço web para o Exchange
• Introdução ao uso dos serviços Web no Exchange
• Visão geral de design do cliente EWS para o Exchange