Implementando tabelas One-Off

Aplica-se a: Outlook 2013 | Outlook 2016

Seu provedor pode implementar uma ou mais tabelas únicas. Uma tabela única é uma lista de resumo de modelos únicos usados para criar destinatários, diretamente em um contêiner ou na lista de destinatários de uma mensagem de saída. Um modelo único é um formulário que os usuários empregam para inserir dados relevantes para um determinado tipo de endereço. Quando o usuário termina de trabalhar com o modelo, o provedor cria o novo destinatário e o adiciona à mensagem. Normalmente, cada modelo lida com um único tipo de endereço. No entanto, é possível que um modelo lide com vários tipos ou que vários modelos lidem com o mesmo tipo.

Seu provedor deve dar suporte ao método OpenEntry para cada modelo incluído na tabela única. A implementação de OpenEntry deve recuperar uma tabela de exibição para o modelo. O MAPI usa a tabela de exibição para tornar o modelo visível para o usuário.

Embora a maioria das linhas em tabelas únicas represente modelos, algumas das linhas podem ser usadas para categorizar ou agrupar modelos. Se uma linha em uma tabela única representa ou não um modelo é indicado pelo valor de sua coluna PR_SELECTABLE (PidTagSelectable). As linhas que representam modelos têm a coluna PR_SELECTABLE definida como TRUE; linhas que não representam modelos o têm definido como FALSE.

O MAPI define três tipos de tabelas únicas:

• Uma tabela única que reflete os modelos compatíveis com um contêiner individual

• Uma tabela única que reflita todos os modelos compatíveis com o provedor

• Uma tabela única que reflita todos os modelos compatíveis com todos os provedores do perfil e alguns com suporte MAPI

Os dois primeiros tipos são implementados por provedores que dão suporte aos destinatários de criação, em uma mensagem ou em um contêiner. Seu provedor pode incluir o mesmo conjunto ou um conjunto diferente de modelos em suas tabelas únicas. A principal diferença entre os dois tipos é que sua tabela de provedor deve incluir modelos para criar destinatários que podem ser usados em mensagens de saída e sua tabela de contêiner deve incluir modelos para criar destinatários a serem adicionados ao seu contêiner. Um contêiner pode dar suporte apenas a um conjunto restrito de modelos, mas a tabela única do provedor deve incluir todos os modelos compatíveis com o provedor.

O terceiro tipo de tabela única é implementado pelo MAPI; os provedores obtêm acesso a ele chamando IMAPISupport::GetOneOffTable. A tabela única MAPI é a união de todas as tabelas do provedor; Inclui todos os modelos compatíveis com todos os provedores no perfil. Ele também inclui modelos compatíveis com MAPI. Seu provedor pode usar essa tabela no lugar da tabela solicitada para um contêiner. No entanto, os modelos nesta tabela também podem ser usados para criar destinatários para mensagens de saída.