Alterações nas propriedades personalizadas no Outlook

Prática recomendada: adicionar campos personalizados de forma programática

Várias APIs podem ser usadas para adicionar campos personalizados programaticamente a itens. Para fazer isso, use o método UserProperties.Add na biblioteca de objetos do Outlook ("Outlook.Application"). O código a seguir ilustra essa prática recomendada.

Set myProp = myItem.UserProperties.Add("MyPropName", olText)

Você também pode usar a biblioteca de objetos CDO ("MAPI. Sessão") para adicionar campos personalizados. Para obter mais informações, visite o seguinte site da MSDN:

http://msdn2.microsoft.com/en-us/library/ms527518.aspx Para desenvolvedores do C++, o MAPI Estendido pode ser usado para adicionar propriedades nomeadas. Para obter mais informações, visite o seguinte site da MSDN:

http://msdn2.microsoft.com/en-us/library/ms529684.aspx

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

O Outlook confia em grande parte em formulários personalizados publicados. No entanto, o Outlook não confia em formulários não publicados ou formulários únicos. Isso inclui arquivos .oft. Portanto, ao criar uma solução de formulário personalizado, recomendamos que você publique o formulário personalizado. Você deve projetar o formulário para que o formulário não se torne um formulário único. Enquanto um formulário for publicado, o formulário não será afetado pela alteração no Outlook.
 
Quando você publica um arquivo .oft em um repositório diferente, o repositório padrão permite criar propriedades nesse repositório. Além disso, quando você cria um formulário personalizado que tem propriedades personalizadas e o publica na biblioteca ou pasta de formulários apropriados, as propriedades personalizadas são criadas nos repositórios afetados.

Prática recomendada: implantação programática de formulários personalizados

Se você estiver desenvolvendo um formulário personalizado do Outlook que será usado por outras pessoas, há poucas abordagens que você pode usar. A abordagem que você usa depende de vários fatores. Esses fatores incluem o tipo de formulário, quem usará o formulário, onde o formulário será usado e assim por diante. Normalmente, se um formulário personalizado for usado por muitas pessoas, recomendamos que você publique o formulário na Biblioteca de Formulários Organizacionais. No entanto, se isso não for possível, talvez você queira publicar o formulário em uma pasta compartilhada ou na Biblioteca de Formulários Pessoais de alguns usuários. Você pode instalar programaticamente um formulário personalizado usando o método CreateItemFromTemplate na biblioteca de objetos do Outlook. Você usa o método CreateItemFromTemplate para abrir um arquivo .oft e publicar 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 abrirem

Você pode salvar formulários personalizados do Outlook como arquivos .oft. Esses formulários podem conter campos personalizados, alterações na interface do usuário e código VBScript (Microsoft Visual Basic Scripting Edition) personalizado para adicionar funcionalidade ao formulário. Embora o Outlook já contenha recursos que impedem a execução do código VBScript em arquivos .oft, o Outlook agora também restringe o uso de arquivos .oft. Se um arquivo .oft contiver propriedades personalizadas e o usuário não tiver usado essas propriedades personalizadas anteriormente, as propriedades personalizadas não estarão no repositório padrão do usuário. O Outlook não renderizará o formulário personalizado quando o usuário clicar duas vezes no arquivo. No entanto, para que o Outlook abra um formulário personalizado armazenado como um arquivo .oft, clique em Arquivo, clique em Novo e clique em Escolher Formulário. Em seguida, você pode alterar o local para Modelos de Usuário no Sistema de Arquivos e, em seguida, clicar em Procurar para abrir o arquivo .oft. O formulário será aberto e você poderá salvar as propriedades personalizadas no repositório padrão.

Não recomendado: use a chave de registro AllowNamedProps

Algumas organizações podem ter motivos válidos para ter determinadas propriedades personalizadas disponíveis em toda a organização. Se vários repositórios forem usados, talvez você queira garantir que um conjunto de propriedades personalizadas possa ser adicionado a todos os repositórios. Portanto, o Outlook 2003 SP2 e versões posteriores dão suporte a chaves de registro do lado do cliente que especificam quais propriedades personalizadas podem ser criadas. Para especificar quais propriedades personalizadas devem ser habilitadas, as propriedades personalizadas são definidas na seguinte chave do registro: HKEY_CURRENT_USER\Software\Microsoft\Office\<versão>\Outlook\AllowedNamedProps\

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

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

<guid>

> <Nome da Propriedade

"Kind" (dword)

"ID" (dword)
"Tipo" (dword) Os seguintes espaços reservados são usados na estrutura de chave do registro:

• <guid>: contém o GUID que especifica o conjunto de propriedades. Os campos ou propriedades personalizados do Outlook que você usa em um formulário personalizado do Outlook têm o GUID {00020329-0000-0000-C000-0000000000046}. No MAPI, o GUID é chamado de PS_PULIC_STRINGS. No entanto, os programas MAPI personalizados podem ter seus próprios GUIDs para propriedades personalizadas.

• <Nome da Propriedade>: especifica o nome da propriedade. Se a propriedade for nomeada por uma cadeia de caracteres, o <Nome da Propriedade> será o nome da cadeia de caracteres real da propriedade. Se a propriedade for nomeada por uma ID, o valor dessa chave de registro será ignorado. No entanto, você deve dar à propriedade um nome exclusivo para que a propriedade possa ser armazenada no registro. Se a chave Kind estiver definida como 1 ou for <> 0, o nome da chave do registro determinará o nome da propriedade. Se a chave Kind não for igual a 1, esse nome da chave do registro será ignorado.

• "Kind" (dword): especifica se a propriedade é nomeada por uma ID ou por uma cadeia de caracteres. Se o valor for 0, a propriedade será nomeada por uma ID. O nome é um valor numérico especificado por uma ID. Se o valor for 1, a propriedade será nomeada por uma cadeia de caracteres. Essa configuração é a configuração padrão quando "Kind" não está presente.

• "ID" (dword): contém o nome da ID de uma propriedade nomeada por uma ID. Essas informações serão necessárias se a chave Kind estiver definida como 0. Se a chave Kind estiver definida como 1, essas informações serão ignoradas.

• "Tipo" (dword): especifica o tipo de propriedade.

Essa chave do registro é necessária, mas a chave do registro não é usada no momento. A tabela a seguir lista os valores possíveis dessa chave de registro com base no tipo MAPI.

Veja a seguir um exemplo de como definir uma propriedade nomeada por cadeia de caracteres:

Nome: "MyStringFieldName1"

Tipo: PT_LONG

[HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\AllowedNamedProps\{00020329-0000-0000-C000-000000000046}\MyStringFieldName1] "Type"=dword:00000003
Veja a seguir um exemplo de como definir uma propriedade nomeada por ID:

ID: 0x0330

Tipo: PT_LONG

[HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\AllowedNamedProps\{00020329-0000-0000-C000-000000000046}\MyMAPIProp1] "Kind"=dword:000000000 "ID"=dword:00000330 "Type"=dword:00000003


Para esses dois exemplos, o registro é semelhante ao seguinte no Editor do Registro:


{00020329-0000-0000-C000-00000000000046}
 

MyStringFieldName1

Tipo = 3
MyStringFieldName2

Tipo = 3
{00020329-0000-0000-C000-00000000000046}

MyMAPIProp1

Tipo = 0
ID = 330

Tipo = 3
MyMAPIProp2

Tipo = 0
ID = 331
Tipo = 3

Não recomendado: habilitar novamente a capacidade de criar propriedades

Três chaves de registro podem ser implantadas em computadores cliente para desabilitar o bloqueio de propriedades personalizadas e reverter o Outlook ao seu comportamento anterior. Essas chaves de registro têm suporte por políticas de grupo. As seguintes chaves de registro podem reverter o Outlook 2003 ao seu comportamento anterior:

Observação As chaves do registro a seguir não reverter o Outlook 2007 ao seu comportamento anterior.

• AllowTNEFtoCreateProps (HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "AllowTNEFtoCreateProps"=dword:000000000): se o valor for 0, o TNEF/MIME não poderá criar novas propriedades personalizadas que não sejam do Outlook. Esse valor é o valor padrão. Se o valor for 1, o TNEF/MIME poderá criar novas propriedades personalizadas que não sejam do Outlook.

• AllowMSGFilestoCreateProps: se o valor for 0, arquivos .msg e arquivos .oft não poderão criar novas propriedades personalizadas que não sejam do Outlook. Esse valor é o valor padrão. Se o valor for 1, arquivos .msg e arquivos .oft poderão criar novas propriedades personalizadas que não sejam do Outlook.

• DisallowTNEFPreservation: para facilitar a migração para esse novo comportamento, o Outlook preserva o TNEF original quando as propriedades personalizadas não são criadas. O TNEF original é salvo em um fluxo binário no item 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
  A configuração do registro controla se o Outlook cria a propriedade PR_TNEF_UNPROCESSED_PROPS.
  
  Observe que a propriedade PR_TNEF_UNPROCESSED_PROPS é removida de uma mensagem quando você insere uma mensagem em outra mensagem como um anexo. A propriedade PR_TNEF_UNPROCESSED_PROPS também é removida quando você encaminha uma mensagem ou responde a uma mensagem.