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 :
|
| 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.