Alterações nas propriedades personalizadas no Outlook

Este artigo faz o seguinte:

• Fornece uma visão geral de propriedades personalizadas.
• Explica como o comportamento de propriedades personalizadas foi alterado no Outlook 2003 SP2 e em versões posteriores do Outlook.
• Discute algumas práticas recomendadas para criar novas propriedades e alguns métodos que não é recomendável.

Sobre propriedades personalizadas

Propriedades personalizadas são usadas por programas de email, como o Outlook, para adicionar mais informações a uma mensagem. Normalmente, essa informação adicional é usada por um programa de email para uma finalidade específica. No entanto, há outras maneiras que propriedades personalizadas podem ser usadas. Por exemplo, propriedades personalizadas podem ser adicionadas a mensagens ou itens se você usar formulários personalizados do Outlook e os formulários contêm campos personalizados. Propriedades personalizadas são usadas com freqüência para adicionar mais informações para fins de controle. Propriedades personalizadas também são usadas para adicionar dados um usuário não tem a ver. Uma solução personalizada também pode adicionar propriedades personalizadas a itens regulares. Uma solução personalizada programaticamente adiciona propriedades personalizadas à mensagem ou item sem a necessidade de um formulário personalizado.

Propriedades personalizadas podem ser mantidas no formato de arquivo .msg e o formato de arquivo .oft no Outlook. Além disso, as propriedades personalizadas podem ser mantidas a emails que são enviados pela Internet se o remetente usa a opção Enviar usando formato de RTF do Outlook . Esta opção encapsula a seção MAPI a mensagem em TNEF (Transport Neutral Encapsulation Format) e, em seguida, o TNEF é decodificado quando a mensagem é recebida.

Um remetente pode enviar um email com propriedades personalizadas nas seguintes situações:

• Um formulário one-off personalizado é enviado. Formulários one-off, o formulário é incorporado na mensagem. O formulário não é publicado em outro lugar. Para obter mais informações sobre formulários one-off, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
  290657  (http://support.microsoft.com/kb/290657/ ) Descrição das definições do formulário e formulários one-off no Outlook 2002
• Um formulário personalizado publicado é enviado. Nesse caso, o formulário personalizado não será enviado porque o formulário não está incorporado na mensagem. No entanto, as propriedades personalizadas que foram usadas no formulário ainda são incluídas na mensagem.

Observação Há várias maneiras para se referir a propriedades personalizadas, dependendo do contexto no qual as propriedades personalizadas são usadas. Na interface do usuário do Outlook, como no Seletor de campos , propriedades personalizadas são chamadas como campos definidos pelo usuário ou como campos personalizados. Na biblioteca de objeto do Outlook, propriedades personalizadas podem ser referenciadas como propriedades de usuário ou como propriedades definidas pelo usuário após a coleção UserProperties . Em MAPI, campos personalizados são denominados como propriedades nomeadas. MAPI fornece um recurso para fazer o seguinte:

• Atribuir nomes às propriedades
• Mapear os nomes para identificadores exclusivos
• Tornar o mapeamento persistentes

Para obter mais informações sobre como propriedades nomeadas são implementadas em MAPI, visite o seguinte site da MSDN: Observação Em um ambiente do Exchange, o termo "armazenar" como usado neste artigo se refere a uma caixa de correio inteira armazene (banco de dados). O termo não faz referência a postal um usuário individual. Pode haver um ou mais Exchange bancos de caixa de correio dados em uma organização.

Alterações de comportamento no Outlook

A implementação de MAPI no Outlook foi alterada para controle personalizado como propriedades podem ser criadas. Para garantir a consistência no uso de propriedades personalizadas, propriedades personalizadas já devem ser usadas na organização ou no cliente Outlook. Assim que propriedades personalizadas estão sendo usadas ou são registradas, as propriedades personalizadas podem ser livremente transmitidas para outros clientes do Outlook ou para servidores que estão executando o Exchange Server. As propriedades personalizadas também podem ser enviadas pela Internet.

Mensagens de email normalmente são enviadas no formato MIME pela Internet. Quando o Outlook recebe uma mensagem de email da Internet, a mensagem é convertida em uma representação de MAPI. A seguir é exemplos de protocolos de email de Internet:

• POP
• IMAP
• HTTP (Hotmail)

Por padrão, Outlook não habilita o correio da Internet criar novas propriedades personalizadas. Somente propriedades que já foram criadas no armazenamento de entrega de email padrão são preservadas para mensagens de email de entrada. Essa alteração afeta principalmente as mensagens enviadas em TNEF encapsulado (Winmail.dat), onde o remetente usou a opção Enviar usando formato de RTF do Outlook . No entanto, mensagens de Internet que contêm propriedades de cabeçalho X-mensagens também são afetadas.

Observação Mensagens que contêm propriedades personalizadas que são enviadas em uma organização do Exchange não são afetadas por essas alterações.

Propriedades personalizadas também podem ser salvos em arquivos .msg e nos arquivos .oft. Se um usuário abre um arquivo .msg que tenha propriedades personalizadas, as propriedades personalizadas não serão salvas para o armazenamento padrão quando a mensagem é salva, encaminhadas e assim por diante. Normalmente, .oft arquivos são usados para fazer backup de formulários personalizados do Outlook. Com arquivos .oft, o novo comportamento aplicada a todos os tipos de itens. O formulário personalizado não será aberto. Em vez disso, a mensagem será exibida no formulário padrão para esse tipo de item específico.

Em resumo, essa alteração no design pode fazer com que duas ações ocorram:

• O Outlook ignora propriedades personalizadas não existente. Se uma propriedade personalizada não existir no armazenamento de entrega, a propriedade não será criada e seu valor serão perdido. Se a propriedade personalizada já existir no armazenamento de entrega, seu valor é mantido. Essa alteração se aplica ao seguinte:
  • Internet mensagens de email que possuem TNEF e suas mensagens incorporadas.
  • Mensagens S/MIME.
  • arquivos .msg quando você soltar o arquivo .msg em uma janela de item do Outlook para adicionar o arquivo a outro item. Essa alteração também se aplica aos arquivos .msg quando você soltar o arquivo .msg na janela principal do Outlook para adicionar o arquivo em uma pasta ou na janela do Microsoft Word ao usar o Word como editor de email.
  • arquivos .msg que um usuário clica duas vezes ou clicar com o botão direito do mouse para abrir.
• O Outlook ignora a definição de formulário one-off. Se um formulário one-off Especifica uma propriedade personalizada e que a propriedade personalizada não existe no armazenamento de entrega, o formulário one-off não é processado. Em vez disso, o usuário verá o formulário padrão para esse tipo de item específico. Essa alteração se aplica às Internet mensagens de email que contenham uma definição de formulário one-off que é encapsulada em TNEF. Essa alteração também se aplica aos arquivos .oft que um usuário clica duas vezes ou clicar com o botão direito do mouse para abrir.

Práticas recomendadas e outras maneiras de criar novas propriedades

Há uma variedade de maneiras de projetar e desenvolver soluções personalizadas. Algumas dessas abordagens são consideradas práticas recomendadas. Outras abordagens também podem funcionar, mas não recomendamos essas abordagens por motivos de um ou mais.

Prática recomendada: adicionar campos personalizados por meio de programação

Diversas APIs pode ser usadas para adicionar campos personalizados programaticamente a itens. Para fazer isso, use o método PropriedadesDoUsuário.Adicionar na biblioteca de objeto do Outlook ("Outlook.Application"). O código a seguir ilustra essa melhor prática. você também pode usar a biblioteca de objetos CDO ("MAPI.Session") para adicionar campos personalizados. Para obter mais informações, visite o seguinte site da MSDN:Para desenvolvedores de C++, MAPI estendido pode usado para adicionar propriedades nomeadas. Para obter mais informações, visite o seguinte site da MSDN:

Prática recomendada: usar publicado formulários personalizados que contêm campos personalizados

O Outlook amplamente relações de confiança publicados formulários personalizados. No entanto, o Outlook não confia formulários não-publicados ou formulários one-off. Isso inclui arquivos .oft. Portanto, quando você cria uma solução de formulário personalizado, é altamente recomendável que você publique o formulário personalizado. Você deve criar o formulário para que o formulário não se tornar um formulário one-off. Desde que um formulário é publicado, o formulário não será afetado pela alteração no Outlook.
Para obter mais informações sobre formulários one-off e formulários one-off como podem ser criados acidentalmente, clique no número abaixo para ler o artigo na Base de dados de Conhecimento da Microsoft:
Quando você publica um arquivo .oft para um armazenamento de diferente, o armazenamento padrão lhe permite criar propriedades no armazenamento. Além disso, quando você cria um formulário personalizado que tenha propriedades personalizadas e publicá-lo a biblioteca de formulários apropriado ou a pasta, as propriedades personalizadas são criadas no armazenamentos afetados.

Prática recomendada: programaticamente implantar formulários personalizados

Se você estiver desenvolvendo um formulário personalizado do Outlook que será usado por outras pessoas, há algumas abordagens que você pode usar. A abordagem que você usar depende de vários fatores. Esses fatores inclua o tipo de formulário, que usarão o formulário, onde o formulário será usado, e assim por diante. Normalmente, se um formulário personalizado será usado por muitas pessoas, recomendamos que você publicar o formulário na biblioteca de formulários organizacionais. No entanto, se não for possível, convém publicar o formulário em uma pasta compartilhada ou na biblioteca de formulários particulares de alguns usuários. Você pode instalar programaticamente um formulário personalizado usando o método CreateItemFromTemplate na biblioteca de objeto do Outlook. Você usa o método CreateItemFromTemplate para abrir um arquivo .oft e, em seguida, publique o formulário usando o método PublishForm . Nesse caso, um arquivo .oft não é afetado pelas alterações de propriedades personalizadas.

Não recomendado: implantar ou enviar arquivos .oft para os usuários abram

Você pode salvar formulários personalizados do Outlook como .oft arquivos. Esses formulários podem conter campos personalizados, alterações de interface do usuário e código personalizado do Microsoft Visual Basic Scripting Edition (VBScript) para adicionar funcionalidade ao formulário. Embora o Outlook já contém recursos que o código VBScript em .oft arquivos impedir a execução, Outlook agora também restringe o uso de arquivos .oft. Se um arquivo .oft contém propriedades personalizadas e o usuário não usou anteriormente essas propriedades personalizadas, as propriedades personalizadas não estão no armazenamento do padrão do usuário. O Outlook não processará o formulário personalizado quando o usuário clica duas vezes no arquivo. No entanto, para que o Outlook abrir um formulário personalizado que é armazenado como um arquivo .oft, clique em arquivo , clique em novo e, em seguida, clique em Escolher formulário . Você pode alterar o local para Modelos do usuário no sistema de arquivos e clique em Procurar para abrir o arquivo .oft. O formulário será aberto e você pode salvar as propriedades personalizadas para o armazenamento padrão.

Não recomendado: usar a chave de registro AllowNamedProps

Algumas organizações podem ter razões válidos para que algumas propriedades personalizadas disponíveis em toda a organização. Se forem usados vários armazenamentos, convém para se certificar de que um conjunto de propriedades personalizadas pode ser adicionado para todos os armazenamentos. Portanto, Outlook 2003 SP2 e versões posteriores oferecem suporte chaves do registro de cliente que especificar quais propriedades personalizadas podem ser criadas. Para especificar quais propriedades personalizadas devem ser ativadas, propriedades personalizadas são definidas na seguinte chave do Registro:

Observação Nessa chave do registro <version > é um espaço reservado para a versão do Outlook que você está usando. Para o Outlook 2003, o número de versão é 11.0. Para o Outlook 2007, o número de versão é 12.0. O número de versão aumenta em versões posteriores do Outlook.

A estrutura de chave do Registro geral para uma entrada no registro é:

<GUID> Os seguintes espaços reservados são usados na estrutura de chave de registro:

• <GUID >: contém o GUID que especifica o conjunto de propriedades. Campos personalizados do Outlook, ou propriedades, que você usar em um formulário personalizado do Outlook todos os tem o GUID {00020329-0000-0000-C000-000000000046}. MAPI, o GUID é chamado PS_PULIC_STRINGS. Entretanto, os programas MAPI personalizados podem ter seus próprios GUIDs para propriedades personalizadas.
• <Property Name >: Especifica o nome da propriedade. Se a propriedade for chamada por uma seqüência de caracteres, o <Property Name > é o nome real seqüência de caracteres da propriedade. Se a propriedade for chamada por um ID, o valor desta chave do registro será ignorado. No entanto, você deve dar a propriedade um nome exclusivo para que a propriedade pode ser armazenada no registro. Se a chave Kind é definida como 1 ou é 0, o nome da chave do Registro <> determinar o nome da propriedade. Se a chave Kind não é igual a 1, esse nome de chave do registro será ignorada.
• "Tipo" (dword): Especifica se a propriedade é chamada por uma identificação ou por uma seqüência de caracteres. Se o valor for 0, a propriedade será nomeada por uma identificação. O nome é um valor numérico que é especificado por uma identificação. Se o valor for 1, a propriedade será nomeada por uma seqüência de caracteres. Essa configuração é a configuração padrão quando ? tipo ? não estiver presente.
• "ID" (dword): contém o nome de identificação de uma propriedade chamada por uma identificação. Essa informação será necessária se a chave Kind é definida como 0. Se a chave Kind é definida como 1, essa informação será ignorada.
• "Tipo" (dword): Especifica o tipo de propriedade.

Essa chave do registro é necessária, mas a chave do Registro não é usada atualmente. A tabela a seguir lista os possíveis valores dessa chave do registro com base no tipo MAPI.Este é um exemplo de como definir uma propriedade chamada por seqüência:Este é um exemplo de como definir uma propriedade chamada-por-ID:
Para esses dois exemplos, o registro aparece semelhante à seguinte no Editor do Registro:

{00020329-0000-0000-C000-000000000046}

{00020329-0000-0000-C000-000000000046}

Não recomendado: reabilitar a capacidade de criar propriedades

Três chaves do Registro podem ser implantadas em computadores cliente para desativar o bloqueio de propriedades personalizadas e reverta o Outlook para seu comportamento anterior. Essas chaves do Registro são compatíveis com as diretivas de grupo. As seguintes chaves do Registro podem reverter o Outlook 2003 para o seu comportamento anterior:

Observação As seguintes chaves do Registro não reverter o Outlook 2007 para o seu comportamento anterior.

• AllowTNEFtoCreateProps (
  HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "AllowTNEFtoCreateProps"=dword:00000000
  ): se o valor for 0, TNEF/MIME não é possível criar novas propriedades personalizadas do Outlook não. Esse valor é o valor padrão. Se o valor for 1, / MIME do TNEF pode criar novas propriedades personalizadas não do Outlook.
• AllowMSGFilestoCreateProps : se o valor for 0, arquivos .msg e .oft arquivos não podem criar novas propriedades personalizadas não do Outlook. Esse valor é o valor padrão. Se o valor for 1, arquivos .msg e arquivos .oft podem criar novas propriedades personalizadas não do Outlook.
• DisallowTNEFPreservation : para facilitar a migração para esse novo comportamento, o Outlook preserva o TNEF original quando propriedades personalizadas não são criadas. O TNEF original é salvo em um fluxo binário no item que é salvo. O Outlook usa a seguinte marca de propriedade para salvar o fluxo:
  PR_TNEF_UNPROCESSED_PROPS PROG_TAG (PT_BINARY, 0X0E9C).
  O
  HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "DisallowTNEFPreservation "=dword:00000000
  Registro determina se a propriedade PR_TNEF_UNPROCESSED_PROPS o Outlook cria.
  
  Observação A propriedade PR_TNEF_UNPROCESSED_PROPS é removida de uma mensagem quando você incorpora uma mensagem a outra mensagem como um anexo. A Propriedade PR_TNEF_UNPROCESSED_PROPS também será removida quando você encaminha uma mensagem ou resposta a uma mensagem.