Alterações às propriedades personalizadas no Outlook

Melhor prática: Adicionar campos personalizados programaticamente

Várias APIs podem ser utilizadas para adicionar programaticamente campos personalizados a itens. Para tal, utilize o método UserProperties.Add na biblioteca de objetos do Outlook ("Outlook.Application"). O código seguinte ilustra esta melhor prática.

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

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

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

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

Melhor prática: utilizar formulários personalizados publicados que contenham campos personalizados

O Outlook confia em grande parte nos formulários personalizados publicados. No entanto, o Outlook não confia em formulários não publicados ou formulários pontuais. Isto inclui ficheiros .oft. Por conseguinte, quando cria uma solução de formulário personalizada, recomendamos vivamente que publique o formulário personalizado. Deve estruturar o formulário para que o formulário não se torne um formulário único. Desde que um formulário seja publicado, o formulário não será afetado pela alteração no Outlook.
 
Quando publica um ficheiro .oft num arquivo diferente, o arquivo predefinido permite-lhe criar propriedades nesse arquivo. Além disso, quando cria um formulário personalizado que tem propriedades personalizadas e o publica na biblioteca ou pasta de formulários adequada, as propriedades personalizadas são criadas nos arquivos afetados.

Melhor prática: implementar formulários personalizados através de programação

Se estiver a desenvolver um formulário personalizado do Outlook que será utilizado por outras pessoas, existem poucas abordagens que pode utilizar. A abordagem que utiliza depende de vários fatores. Estes fatores incluem o tipo de formulário, quem utilizará o formulário, onde o formulário será utilizado, etc. Normalmente, se um formulário personalizado for utilizado por muitas pessoas, recomendamos que publique o formulário na Biblioteca de Formulários Organizacionais. No entanto, se isso não for possível, poderá querer publicar o formulário numa pasta partilhada ou na Biblioteca de Formulários Pessoais de alguns utilizadores. Pode instalar programaticamente um formulário personalizado com o método CreateItemFromTemplate na biblioteca de objetos do Outlook. Utilize o método CreateItemFromTemplate para abrir um ficheiro .oft e, em seguida, publique o formulário com o método PublishForm. Neste caso, um ficheiro .oft não é afetado pelas alterações de propriedades personalizadas.

Não recomendado: Implementar ou enviar ficheiros .oft para os utilizadores abrirem

Pode guardar formulários personalizados do Outlook como ficheiros .oft. Estes formulários podem conter campos personalizados, alterações da interface de utilizador e código personalizado do Microsoft Visual Basic Scripting Edition (VBScript) para adicionar funcionalidade ao formulário. Embora o Outlook já contenha funcionalidades que impedem a execução do código VBScript em ficheiros .oft, o Outlook agora também restringe a utilização de ficheiros .oft. Se um ficheiro .oft contiver propriedades personalizadas e o utilizador não tiver utilizado anteriormente essas propriedades personalizadas, as propriedades personalizadas não estão no arquivo predefinido do utilizador. O Outlook não irá compor o formulário personalizado quando o utilizador fazer duplo clique no ficheiro. No entanto, para que o Outlook abra um formulário personalizado armazenado como um ficheiro .oft, clique em Ficheiro, clique em Novo e, em seguida, clique em Escolher Formulário. Em seguida, pode alterar a localização para Modelos de Utilizador no Sistema de Ficheiros e, em seguida, clicar em Procurar para abrir o ficheiro .oft. O formulário será aberto e pode guardar as propriedades personalizadas no arquivo predefinido.

Não recomendado: utilize a chave de registo AllowNamedProps

Algumas organizações podem ter motivos válidos para ter determinadas propriedades personalizadas disponíveis em toda a organização. Se forem utilizados vários arquivos, poderá querer certificar-se de que um conjunto de propriedades personalizadas pode ser adicionado a todas as lojas. Por conseguinte, o Outlook 2003 SP2 e versões posteriores suportam chaves de registo do lado do cliente que especificam as propriedades personalizadas que podem ser criadas. Para especificar que propriedades personalizadas devem ser ativadas, as propriedades personalizadas são definidas sob a seguinte chave de registo: HKEY_CURRENT_USER\Software\Microsoft\Office\<versão>\Outlook\AllowedNamedProps\

Nota Nesta chave de registo, <versão> é um marcador de posição para a versão do Outlook que está a utilizar. 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 registo para uma entrada no registo é:

<> GUID

<Nome da Propriedade>

"Kind" (dword)

"ID" (dword)
"Type" (dword) Os seguintes marcadores de posição são utilizados na estrutura da chave do registo:

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

• <Nome da Propriedade>: especifica o nome da propriedade. Se a propriedade for nomeada por uma cadeia, o nome da propriedade <> é o nome de cadeia real da propriedade. Se a propriedade for nomeada por um ID, o valor desta chave de registo é ignorado. No entanto, tem de atribuir um nome exclusivo à propriedade para que a propriedade possa ser armazenada no registo. Se a chave Kind estiver definida como 1 ou for <> 0, o nome da chave do registo determinará o nome da propriedade. Se a chave Kind não for igual a 1, este nome de chave de registo será ignorado.

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

• "ID" (dword): contém o nome do ID de uma propriedade com o nome de um ID. Estas informações são necessárias se a chave Kind estiver definida como 0. Se a chave Kind estiver definida como 1, estas informações são ignoradas.

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

Esta chave de registo é necessária, mas a chave de registo não é atualmente utilizada. A tabela seguinte lista os valores possíveis desta chave de registo com base no tipo MAPI.

Segue-se um exemplo de como definir uma propriedade com nome por cadeia:

Nome: "MyStringFieldName1"

Tipo: PT_LONG

[HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\AllowedNamedProps\{00020329-0000-0000-C000-000000000046}\MyStringFieldName1] "Type"=dword:00000003
Segue-se um exemplo de como definir uma propriedade com nome 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


Nestes dois exemplos, o registo é semelhante ao seguinte no Editor de Registo:


{00020329-0000-0000-C000-000000000046}
 

MyStringFieldName1

Tipo = 3
MyStringFieldName2

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

MyMAPIProp1

Tipo = 0
ID = 330

Tipo = 3
MyMAPIProp2

Tipo = 0
ID = 331
Tipo = 3

Não recomendado: reativar a capacidade de criar propriedades

Podem ser implementadas três chaves de registo em computadores cliente para desativar o bloqueio de propriedades personalizadas e reverter o Outlook para o comportamento anterior. Estas chaves de registo são suportadas por políticas de grupo. As seguintes chaves de registo podem reverter o Outlook 2003 para o comportamento anterior:

Nota As seguintes chaves de registo não revertem o Outlook 2007 para o comportamento anterior.

• AllowTNEFtoCreateProps (HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "AllowTNEFtoCreateProps"=dword:00000000): se o valor for 0, o TNEF/MIME não consegue criar novas propriedades personalizadas que não sejam do Outlook. Este valor é o valor predefinido. Se o valor for 1, a TNEF/MIME pode criar novas propriedades personalizadas que não sejam do Outlook.

• AllowMSGFilestoCreateProps: se o valor for 0, os ficheiros .msg e os ficheiros .oft não podem criar novas propriedades personalizadas que não sejam do Outlook. Este valor é o valor predefinido. Se o valor for 1, os ficheiros .msg e os ficheiros .oft podem criar novas propriedades personalizadas que não sejam do Outlook.

• DisallowTNEFPreservation: para facilitar a migração para este novo comportamento, o Outlook preserva a TNEF original quando as propriedades personalizadas não são criadas. A TNEF original é guardada num fluxo binário no item guardado. O Outlook utiliza a seguinte etiqueta de propriedade para guardar 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:000000000
  A definição de registo controla se o Outlook cria a propriedade PR_TNEF_UNPROCESSED_PROPS.
  
  Nota A propriedade PR_TNEF_UNPROCESSED_PROPS é removida de uma mensagem quando incorpora uma mensagem noutra mensagem como anexo. A propriedade PR_TNEF_UNPROCESSED_PROPS também é removida quando reencaminha uma mensagem ou responde a uma mensagem.