Alterações às propriedades personalizadas no Outlook

Este artigo efectua as seguintes acções:

• Fornece uma descrição geral das propriedades personalizadas.
• Explica como foi alterado o comportamento de propriedades personalizadas no Outlook 2003 SP2 e em versões posteriores do Outlook.
• Aborda alguns procedimentos recomendados para criar novas propriedades e alguns métodos que não recomendamos.

Acerca das propriedades personalizadas

Propriedades personalizadas são utilizadas por programas de correio electrónico, como, por exemplo, o Outlook, para adicionar informações a uma mensagem. Normalmente, estas informações adicionais são utilizadas por um programa de correio electrónico para um fim específico. No entanto, existem outras formas que propriedades personalizadas podem ser utilizadas. Por exemplo, as propriedades personalizadas podem ser adicionadas a mensagens ou itens se utilizar formulários personalizados do Outlook e os formulários contêm campos personalizados. Propriedades personalizadas são frequentemente utilizadas para adicionar mais informações para fins de controlo. Propriedades personalizadas também são utilizadas para adicionar dados que um utilizador não tem a ver. Uma solução personalizada pode também adicionar propriedades personalizadas a itens normais. Uma solução personalizada adiciona programaticamente propriedades personalizadas a uma mensagem ou um item sem necessitar de um formulário personalizado.

Propriedades personalizadas podem permanecer como no formato de ficheiro .msg e o formato de ficheiro .oft no Outlook. Além disso, as propriedades personalizadas podem permanecer como a mensagens enviadas através da Internet se o remetente utiliza a opção Enviar utilizando o formato RTF do Outlook de correio electrónico. Esta opção encapsula a secção MAPI a mensagem no TNEF (Transport Neutral Encapsulation Formatar) e, em seguida, o TNEF é descodificado quando a mensagem é recebida.

Um emissor pode enviar a mensagem de correio electrónico com propriedades personalizadas nos seguintes cenários:

• Um formulário personalizado único é enviado. Em formulários único, o formulário está incorporado na mensagem. O formulário não está publicado noutro local. Para obter mais informações acerca dos formulários única, clique no número de artigo que se segue para visualizar o artigo na Microsoft Knowledge Base:
  290657  (http://support.microsoft.com/kb/290657/ ) Descrição das definições de formulário e formulários único no Outlook 2002
• Um formulário personalizado publicado é enviado. Neste caso, o formulário personalizado não é enviado uma vez que o formulário não está incorporado na mensagem. No entanto, quaisquer propriedades personalizadas que foram utilizadas no formulário ainda estão incluídas na mensagem.

Nota Existem várias formas para fazer referência a propriedades personalizadas, dependendo do contexto no qual as propriedades personalizadas são utilizadas. Na interface de utilizador do Outlook, como, por exemplo, no Selector de campos , propriedades personalizadas são referidas como campos definidos pelo utilizador ou campos personalizados. Na biblioteca de objectos Outlook, propriedades personalizadas podem ser referidas como propriedades de utilizador ou como propriedades definidas pelo utilizador após a colecção UserProperties . Em MAPI, campos personalizados são referidos como propriedades com nome. MAPI fornece uma funcionalidade para efectuar o seguinte:

• Atribuir nomes de propriedades
• Mapear os nomes para os identificadores exclusivos
• Tornar o mapeamento persistente

Para obter mais informações sobre como propriedades com nome são implementadas em MAPI, visite o seguinte Web site da MSDN: Nota Num ambiente do Exchange, o termo "armazenar" conforme utilizada neste artigo se refere a uma caixa de correio toda armazene (base de dados). O termo não faz referência para arquivo de caixa de correio de um utilizador individual. Poderão existir bases de um ou mais caixas de correio dados do Exchange numa organização.

Alterações de comportamento no Outlook

A implementação de MAPI no Outlook foi alterada para controlo personalizado como propriedades podem ser criadas. Para garantir a utilização consistente de propriedades personalizadas, as propriedades personalizadas já devem ser utilizadas na organização ou no cliente Outlook. Assim que propriedades personalizadas estão a ser utilizadas ou registadas, as propriedades personalizadas podem ser livremente transmitidas para outros clientes do Outlook ou para servidores que executem o Exchange Server. As propriedades personalizadas também podem ser enviadas através da Internet.

Mensagens de correio electrónico são normalmente enviadas em formato MIME através da Internet. Quando o Outlook recebe uma mensagem de correio electrónico da Internet, a mensagem é convertida numa representação de MAPI. Seguem-se exemplos de protocolos de correio electrónico da Internet:

• MENU DE CONTEXTO
• IMAP
• HTTP (Hotmail)

Por predefinição, o Outlook já não permite correio da Internet criar novas propriedades personalizadas. Apenas propriedades que já estão criadas no arquivo de entrega de correio predefinido são preservadas para receber mensagens de correio electrónico. Esta alteração afecta principalmente as mensagens enviadas em TNEF encapsulado (Winmail.dat), onde o remetente utilizou a opção Enviar utilizando o formato RTF do Outlook . No entanto, as mensagens da Internet que contêm propriedades de cabeçalho de mensagem X também são afectadas.

Nota Mensagens que contêm propriedades personalizadas que são enviadas na organização do Exchange não são afectadas por estas alterações.

Propriedades personalizadas também podem ser guardadas em ficheiros .msg e nos ficheiros oft. Se um utilizador abrisse um ficheiro .msg com propriedades personalizadas, as propriedades personalizadas não são guardadas para o arquivo predefinido quando a mensagem é guardada, reencaminhadas e assim sucessivamente. Normalmente, os ficheiros .oft são utilizados para criar cópias de formulários personalizados do Outlook. Com ficheiros .oft, o novo comportamento aplica-se a todos os tipos de itens. O formulário personalizado não abrirão. Em vez disso, a mensagem aparecerá no formulário predefinido para esse tipo de item específico.

Em resumo, esta alteração na estrutura pode causar dois procedimentos para ocorrer:

• O Outlook ignora propriedades personalizadas não existente. Se uma propriedade personalizada não existir no arquivo de entrega, a propriedade não será criada e respectivo valor serão perdido. Se a propriedade personalizada já existir no arquivo de entrega, o valor é persistente. Esta alteração se aplica aos seguintes:
  • Mensagens de correio electrónico de Internet com TNEF e as respectivas mensagens incorporadas.
  • Mensagens S/MIME.
  • ficheiros de .msg quando larga o ficheiro .msg para uma janela de item do Outlook para adicionar o ficheiro para outro item. Esta alteração também se aplica a ficheiros .msg quando largar o ficheiro de .msg numa janela principal do Outlook para adicionar o ficheiro para uma pasta ou na janela do Microsoft Word quando utiliza o Word como editor de correio electrónico.
  • ficheiros de .msg que um utilizador faz duplo clique ou clica com o botão direito do rato para abrir.
• O Outlook ignora a definição do formulário única. Se um único formulário especifica uma propriedade personalizada e que a propriedade personalizada não existe no arquivo de entrega, o único formulário não é apresentado. Em vez disso, o utilizador verá o formulário predefinido para esse tipo de item específico. Esta alteração aplica-se a mensagens de correio electrónico da Internet que contenham uma definição de formulário único que é encapsulada no TNEF. Esta alteração também se aplica a .oft ficheiros que um utilizador faz duplo clique ou clica com o botão direito do rato para abrir.

Procedimentos recomendados e outras formas de criar novas propriedades

Existem várias formas que pode estruturar e desenvolver soluções personalizadas. Algumas destas abordagens são consideradas os procedimentos recomendados. Outras abordagens também poderão funcionar, mas recomendamos que as abordagens por motivos de um ou mais.

Procedimento recomendado: adicionar campos personalizados através de programação

Pode ser utilizadas várias APIs programaticamente adicionar campos personalizados aos itens. Para o fazer, utilize o método UserProperties.Add na biblioteca de objectos do Outlook ("Outlook.Application"). O seguinte código ilustra este exercício melhor. também pode utilizar a biblioteca de objectos CDO ("MAPI.Session") para adicionar campos personalizados. Para mais informações, visite o seguinte site da Web MSDN:Para programadores de C++, Extended MAPI pode utilizada para adicionar propriedades com nome. Para mais informações, visite o seguinte site da Web MSDN:

Procedimento recomendado: utilização publicados formulários personalizados que contêm campos personalizados

O Outlook em grande parte fidedignidades publicados formulários personalizados. No entanto, Outlook não confiar os formulários não publicados ou formulários único. Isto inclui ficheiros oft. Por conseguinte, quando estrutura uma formulário personalizado solução, recomendamos que publique o formulário personalizado. Deve criar o formulário para que o formulário não ficar um único formulário. Enquanto um formulário for publicado, o formulário não será afectado pela alteração do Outlook.
Para mais informações sobre formulários único e formulários como único pode ser criado inadvertidamente, clique no número de artigo que se segue para visualizar o artigo na base de dados de conhecimento da Microsoft:
Quando publica um ficheiro .oft para uma loja diferente, o arquivo predefinido permite-lhe criar propriedades nesse arquivo. Além disso, quando criar um formulário personalizado com propriedades personalizadas e publicá-la para a biblioteca de formulários adequado ou pasta, as propriedades personalizadas são criadas nos arquivos de afectado.

Procedimento recomendado: por programação implementar formulários personalizados

Se estiver a desenvolver um formulário personalizado do Outlook que será utilizado por outros utilizadores, existem algumas abordagens que pode utilizar. A abordagem que utiliza depende de vários factores. Estes factores incluem o tipo de formulário, que irá utilizar o formulário, onde o formulário vai ser utilizado, e assim sucessivamente. Normalmente, se um formulário personalizado será utilizado por muitas pessoas, recomendamos que publique o formulário na biblioteca de formulários organizacionais. No entanto, se não for possível, poderá publicar o formulário numa pasta partilhada ou na biblioteca de formulários pessoais de alguns utilizadores. Pode instalar programaticamente um formulário personalizado, utilizando o método CreateItemFromTemplate na biblioteca de objectos do Outlook. Utilize o método CreateItemFromTemplate para abrir um ficheiro .oft e, em seguida, publicar o formulário utilizando o método PublishForm . Neste caso, um ficheiro .oft não é afectado pelas alterações de propriedades personalizadas.

Não recomendável: implementar ou enviar ficheiros .oft para os utilizadores abram

Pode guardar formulários personalizados do Outlook como .oft ficheiros. Estes formulários podem conter campos personalizados, as alterações de 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 o código VBScript .oft ficheiros de execução, Outlook agora também restringe a utilização de ficheiros .oft. Se um ficheiro .oft contém propriedades personalizadas e o utilizador não utilizou anteriormente as propriedades personalizadas, as propriedades personalizadas não estão no arquivo de predefinido do utilizador. O Outlook não fará com que o formulário personalizado quando o utilizador faz duplo clique no ficheiro. No entanto, para que o Outlook abra um formulário personalizado que é armazenado como um ficheiro .oft, clique em ficheiro , clique em Novo e, em seguida, clique em Escolher formulário . Pode, em seguida, alterar a localização para Modelos do utilizador no sistema de ficheiros e, em seguida, clique em Procurar para abrir o ficheiro .oft. O formulário será aberto e pode guardar as propriedades personalizadas para o arquivo predefinido.

Não recomendável: utilizar a chave de registo AllowNamedProps

Algumas organizações podem ter motivos válidos para que determinadas propriedades personalizadas disponíveis em toda a organização. Se forem utilizados vários arquivos, convém Certifique-se de que um conjunto de propriedades personalizadas pode ser adicionado para todos os arquivos. Por este motivo, Outlook 2003 SP2 e versões posteriores suportam chaves de registo do cliente que especificam as propriedades personalizadas podem ser criadas. Para especificar as propriedades personalizadas que devem ser activadas, as propriedades personalizadas são definidas na seguinte chave de registo:

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

<GUID> Os seguintes marcadores de posição são utilizados na estrutura de chave do registo:

• <GUID >: contém o GUID que especifica o conjunto de propriedades. Campos personalizados do Outlook ou propriedades, que utiliza no formulário personalizado do Outlook todas tem o GUID {00020329-0000-0000-C000-000000000046}. Em MAPI, o GUID é referido como PS_PULIC_STRINGS. No entanto, programas MAPI personalizados podem ter os seus próprios GUID para propriedades personalizadas.
• <Property Name >: Especifica o nome da propriedade. Se a propriedade nome por uma cadeia, o <Property Name > é o nome real da cadeia de caracteres da propriedade. Se a propriedade nome por um ID, o valor desta chave de registo é ignorado. No entanto, tem de atribuir a propriedade um nome exclusivo para que a propriedade pode ser armazenada no registo. Se a chave Kind estiver definida para 1 ou está <> 0, o nome de chave de registo irá determinar o nome da propriedade. Se a chave Kind não é igual a 1, este nome de chave de registo será ignorado.
• "Tipo" (dword): Especifica se a propriedade é denominada por um ID ou por uma cadeia. Se o valor for 0, a propriedade terá o nome por um ID. O nome é um valor numérico que é especificado por um ID. Se o valor for 1, a propriedade terá o nome por uma cadeia. Esta definição é a predefinição quando ? tipo ? não está presente.
• "ID" (dword): contém o nome de ID de uma propriedade com o nome por um ID. Esta informação é necessária se a chave Kind estiver definida como 0. Se a chave Kind estiver definida como 1, esta informação é ignorada.
• "Tipo" (dword): Especifica o tipo de propriedade.

Esta chave de registo é necessária, mas a chave de registo não é utilizada actualmente. 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 denominada por cadeia:Segue-se um exemplo de como definir uma propriedade de nome por ID:
Para estes dois exemplos, o registo é semelhante à seguinte no Editor de registo:

{00020329-0000-0000-C000-000000000046}

{00020329-0000-0000-C000-000000000046}

Não recomendável: Re-enable a capacidade de criar propriedades

Três chaves de registo podem ser implementadas para computadores cliente para desactivar o bloqueio de propriedades personalizadas e reverter o Outlook para o respectivo 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 reverter 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, TNEF/MIME não é possível criar novas propriedades personalizadas não-Outlook. Este valor é o valor predefinido. Se o valor for 1, TNEF/MIME podem criar novas propriedades personalizadas não-Outlook.
• AllowMSGFilestoCreateProps : Se o valor for 0, ficheiros .msg e .oft ficheiros não é possível criar novas propriedades personalizadas não-Outlook. Este valor é o valor predefinido. Se o valor for 1, ficheiros .msg e ficheiros .oft podem criar novas propriedades personalizadas não-Outlook.
• DisallowTNEFPreservation : para facilitar a migração para este novo comportamento, o Outlook mantém TNEF original quando propriedades personalizadas não são criadas. TNEF original é guardado na sequência binária no item que é guardado. O Outlook utiliza a seguinte tag de propriedade para guardar a sequência:
  PR_TNEF_UNPROCESSED_PROPS PROG_TAG (PT_BINARY, 0X0E9C).
  O
  HKEY_CURRENT_USER\Software\Microsoft\Office\11.0\Outlook\Options\Mail] "DisallowTNEFPreservation "=dword:00000000
  definição controlos se o Outlook cria a propriedade PR_TNEF_UNPROCESSED_PROPS do registo.
  
  Nota A propriedade PR_TNEF_UNPROCESSED_PROPS é removida de uma mensagem quando incorporar uma mensagem de outra mensagem como anexo. A Propriedade PR_TNEF_UNPROCESSED_PROPS também é removida quando reencaminha uma mensagem ou responde a uma mensagem.